# ziping

**Repository Path**: sofqi/ziping

## Basic Information

- **Project Name**: ziping
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-14
- **Last Updated**: 2026-10-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="https://img.shields.io/badge/Obsidian-Plugin-7C3AED?style=flat-square&logo=obsidian" alt="Obsidian Plugin"/>
  <img src="https://img.shields.io/github/v/release/Dyse-Sofqi/ziping?style=flat-square" alt="Version"/>
  <img src="https://img.shields.io/badge/minAppVersion-1.5.0-7C3AED?style=flat-square" alt="minAppVersion"/>
  <img src="https://img.shields.io/github/license/Dyse-Sofqi/ziping?style=flat-square" alt="License"/>
</p>

<h1 align="center">子平排盘 · Ziping Bazi</h1>
<p align="center"><b>专业八字排盘工具 · Professional Bazi (Four Pillars) Calculator for Obsidian</b></p>

<p align="center"><a href="README.en.md"><img src="https://img.shields.io/badge/English-7C3AED?style=flat-square" alt="English"/></a></p>

---

## 📖 简介

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

## ✨ 功能特性

### 🔢 智能八字排盘

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

### 📊 命理分析

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

### 🧩 代码块渲染

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

<pre><code>```ziping
2026.06.21-12.00-Y
```
</code></pre>

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

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

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

<pre><code>```ziping
left
1990.05.15-10.30-Y
```
</code></pre>

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

### 🔄 流年-光标双向同步

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

### 💾 案例管理

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

### 🎛️ 界面

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

## 🔧 安装

### 方法一：社区插件市场

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

### 方法二：BRAT 安装

1. 安装并启用 [BRAT](obsidian://show-plugin?id=obsidian42-brat) 插件
2. 在 BRAT 设置中添加 Beta 插件：`https://github.com/Dyse-Sofqi/ziping`
3. 选择 Latest version，确认后等待自动安装

### 方法三：手动安装

1. 从 [Releases](https://github.com/Dyse-Sofqi/ziping/releases) 下载最新版本
2. 解压到 `.obsidian/plugins/ziping/` 目录
3. 在 Obsidian 设置中启用插件

## 🚀 快速开始

### 侧边栏排盘

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

### 代码块渲染

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

<pre><code>```ziping
1990.05.15-10.30-Y
2001.08.20-14.45-X
```
</code></pre>

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

### 排盘码格式

```
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` |
| 省份 | 选择省份 | - |
| 城市 | 选择城市（自动填充经纬度） | - |

## 📝 案例文件格式

保存后的案例文件结构：

````markdown
---
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](https://github.com/Dyse-Sofqi/ziping/issues) 或 Pull Request。

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

![赞赏码](zanshang.jpg)

---

## 📄 License

MIT