Obsidian Stats logoObsidian Stats

Ziping

by Sofqi
5
4
3
2
1
New Plugin
Install Code

Description

Ziping Bazi Layout Plugin - This plugin has not been manually reviewed by Obsidian staff.

Reviews

No reviews yet.

Stats

stars
210
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

📖 简介

子平排盘 是一款专为 Obsidian 设计的专业八字排盘插件，集成了传统子平八字命理学算法。支持自动排盘、真太阳时校准、大运流年流月分析、案例保存等功能，适合命理研究、个人记录和学习辅助。

✨ 功能特性

🔢 智能八字排盘

  • 自动排盘：根据出生年月日时自动计算年、月、日、时四柱
  • 真太阳时校准：内置 400+ 城市经纬度数据库，自动计算真太阳时
  • 公历/农历支持：支持公历日期输入和农历日期转换
  • 精确到分钟：支持精确的出生时间输入和时辰调整

📊 命理分析

  • 十神关系：自动分析各柱天干的十神关系（正官、偏官、正印、偏印等）
  • 大运排算：精确计算起运时间和大运走势（含交运日期描述）
  • 流年分析：查看各年的流年干支和运势变化
  • 流月分析：按月查看流月干支和十神
  • 小运计算：支持小运排算
  • 纳音五行：显示六十甲子纳音
  • 十二长生：分析十二长生状态（沐浴、冠带、临官等）
  • 藏干十神：分析地支藏干及对应的十神
  • 旬空查询：自动计算旬空

🧩 代码块渲染

本插件支持在笔记中直接嵌入排盘结果：

代码块视图完全独立渲染，使用 Shadow DOM 隔离主题样式，确保在不同主题下显示一致。支持大运/流年/流月点选交互，与侧边栏视图体验完全一致。

🖼️ 左侧固定面板（Live Preview）

代码块首行写入 left 指令，即可在实时预览模式下生成固定在编辑器左侧的浮动面板：

  • 面板透明无边框，不占用正文空间，正文自动向右让位
  • 阅读视图中自动切换为内联渲染，不遮挡内容
  • 实时预览 ↔ 阅读模式切换时面板自动隐藏/显示

🔄 流年-光标双向同步

  • 点击面板/侧边栏/代码块中的流年 → 文档光标自动跳转到对应的 \t- {year}年 行
  • 光标移到 \t- {year}年 行 → 所有视图同步选中该流年（面板、侧边栏、代码块）
  • 支持小运（起运前逐年）的流年同步

💾 案例管理

  • 一键保存：将排盘结果保存为结构化的 Markdown 文件
  • YAML Frontmatter：自动生成标准化的元数据头
  • 灵活路径：自定义案例保存目录，支持标签系统
  • 排盘码识别：自动识别笔记中的排盘码，一键加载

🎛️ 界面

  • 侧边栏视图：集成在 Obsidian 右侧边栏，随时调用
  • 左侧固定面板：实时预览中吸附在编辑器左侧，独立于文档流
  • 代码块内嵌：在笔记中直接渲染八字信息
  • 命令面板：支持 Obsidian 命令面板快速操作
  • 功能区图标：一键打开排盘界面

🔧 安装

方法一：社区插件市场

  1. 打开 Obsidian 设置 → 社区插件
  2. 搜索 "Ziping" 或 "子平排盘"
  3. 点击安装并启用

方法二：BRAT 安装

  1. 安装并启用 BRAT 插件
  2. 在 BRAT 设置中添加 Beta 插件：https://github.com/Dyse-Sofqi/ziping
  3. 选择 Latest version，确认后等待自动安装

方法三：手动安装

  1. 从 Releases 下载最新版本
  2. 解压到 .obsidian/plugins/ziping/ 目录
  3. 在 Obsidian 设置中启用插件

🚀 快速开始

侧边栏排盘

  1. 点击左侧功能区的 DNA 图标 或在命令面板搜索 "打开排盘"
  2. 在右侧边栏中输入出生日期、时间、性别
  3. 点击 "排盘" 按钮查看完整八字信息
  4. 交互式点选大运/流年/流月查看详情
  5. 点击 "保存" 将结果保存为笔记

代码块渲染

在笔记中写入排盘码代码块即可自动渲染：

一行一个排盘码，支持同时渲染多个排盘。

排盘码格式

YYYY.MM.DD-HH.MM-G
部分 说明 示例
YYYY 出生年份（4 位） 1990
MM 出生月份（2 位） 05
DD 出生日期（2 位） 15
HH 出生小时（2 位，24 小时制） 10
MM 出生分钟（2 位） 30
G 性别：Y = 男，X = 女 Y

⚙️ 设置选项

设置项 说明 默认值
案例路径 案例文件保存目录 命例
真太阳时 是否启用真太阳时校准 关闭
经度 所在经度 120
纬度 所在纬度 35
省份 选择省份 -
城市 选择城市（自动填充经纬度） -

📝 案例文件格式

保存后的案例文件结构：

---
title: "张三"
author: ""
tags: [八字/命例/朋友]
created: 2026-06-21T12:00:00
modified: 2026-06-21T12:00:00
aliases: []
---

#### 1990.05.15-10.30-Y，张三

乾造：庚午年、辛巳月、甲子日、乙巳时

```ziping
1990.05.15-10.30-Y
```

- 小运
	- 1990年1岁庚午(小运丙寅)
	- 1991年2岁辛未(小运丁卯)
	- 1992年3岁壬申(小运戊辰)
	- 1993年4岁癸酉(小运己巳)

- 2004年15岁甲子
	- 2005年16岁乙丑
	- 2006年17岁丙寅
	...

🔄 版本历史

版本 说明
1.3.0 CM6 ViewPlugin 左侧固定面板、流年-光标双向同步（全部视图）、阅读/LP 模式切换适配、小运流年匹配修复
1.2.5 恢复 Shadow DOM 隔离，消除全部插件审核报错
1.2.4 修复 ESLint 违规：替换 any 类型、补充 API 声明、更新 minAppVersion
1.2.3 修复代码块渲染交互与大运切换逻辑
1.2.0 新增流月分析、干支历显示、代码块渲染

❓ 常见问题

Q: 排盘结果和网上的其他排盘工具不一致？ A: 不同排盘工具可能使用不同的算法参数（如起运时间计算规则、节气时刻判断等）。本插件基于 paipan.js 引擎，算法透明可追溯。

Q: 代码块显示不正确？ A: 请确认排盘码格式为 YYYY.MM.DD-HH.MM-Y/X。如果是 Obsidian 主题样式干扰，请确保插件已更新到 v1.2.5+（使用 Shadow DOM 隔离）。

Q: 如何修改保存路径？ A: 在插件设置中的"案例路径"项修改，支持绝对路径或相对于仓库的路径。

🤝 支持

如有问题或建议，欢迎提交 Issue 或 Pull Request。

如果这个插件对你有帮助，欢迎赞赏支持：

赞赏码

📄 License

MIT

Sponsors