子平排盘 · Ziping Bazi

专业八字排盘工具 · Professional Bazi (Four Pillars) Calculator for Obsidian

---

📖 简介

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

✨ 功能特性

🔢 智能八字排盘

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

📊 命理分析

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

🧩 代码块渲染

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

```ziping
2026.06.21-12.00-Y
```

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

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

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

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

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

🔄 流年-光标双向同步

• 点击面板/侧边栏/代码块中的流年 → 文档光标自动跳转到对应的 \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. 点击 "保存" 将结果保存为笔记

代码块渲染

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

```ziping
1990.05.15-10.30-Y
2001.08.20-14.45-X
```

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

排盘码格式

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.4.3	修复：自动激活视图时由标签页栏改为右侧边栏打开（getLeaf → getRightLeaf），对齐 manifest views 声明
1.4.2	修复：新标签页打开时左侧面板闪现偏移（面板初始化时先显示空面板再隐藏，导致正文右移闪烁）
1.4.1	修复：补齐 selectFolder() 后缺失的 eslint-enable 指令
1.4.0	设置：案例保存路径横向布局（文本框+清空+浏览按钮）、原生文件夹对话框、仓库名/相对路径显示、文件夹重命名自动同步路径
1.3.2	修复：子节点点击时逆向搜索流年行
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