Renhuai123/ziwei-doushu

▲ 13,956 stars today★ 10,706⑂ 2,138

紫微斗数开源排盘引擎 — 基于倪海厦《天纪》体系,含完整排盘算法、四化系统、格局知识库、古籍原文数据

About Renhuai123/ziwei-doushu

Renhuai123/ziwei-doushu is an open-source project on GitHub, mainly written in TypeScript. 紫微斗数开源排盘引擎 — 基于倪海厦《天纪》体系,含完整排盘算法、四化系统、格局知识库、古籍原文数据 It currently holds 10,706 stars and 2,138 forks with 14 open issues, and was last pushed on 2026-10-27 (repository created 2026-05-01).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository Renhuai123/ziwei-doushu · default branch main · size 2689 KB · watchers 44 · source: GitHub REST API and repository README

README

紫微斗数 · 开源排盘引擎

算法是公开的传统智慧,不应该被锁在围墙里

CI License: MIT Dataset: CC BY 4.0

中文 · English

一、项目理念:紫微斗数是中国传统命理学的瑰宝,倪海厦老师在《天纪》中系统梳理了正宗的紫微斗数体系。我们希望通过技术手段让更多人接触和学习这门学问。

开源排盘算法和知识库,是因为我们相信:算法是公开的传统智慧,不应该被锁在围墙里。真正的价值在于解读的深度、用户体验的打磨、以及持续运营的积累。

二、项目信息:基于倪海厦《天纪》教学体系的紫微斗数排盘系统,包含完整排盘算法、四化系统、格局知识库、古籍原文数据,以及一套完整开源的紫微斗数解读数据:v4.0 解读数据集——67.5 万张命盘 × 13 维 = 877 万段解读,正文约 204 亿字,解压后 56.6 GB(2026-10-15 发布)。

| 数据集 | 命盘 | 解读段数 | 解压后 | 覆盖年份 | 每张盘解读字数 | |---|---|---|---|---|---| | v4.0 解读数据集(2026-10-15) | 674,976 | 8,774,688 | 56.6 GB | 1950–2026(只含真实日期) | 约 3.0 万字 | | v3.0 样本数据集 | 518,400 | 6,739,200 | 33.1 GB | 1924–1983 | 约 2.1 万字 | | 变化 | +30% | +30% | +71% | +17 年 | +44% |

v3.0 每张盘解读字数按 2,160 张盘抽样估算,其余数字为全量统计;两版每张盘都是 13 维。

在线体验:ouranic.cn,排盘、AI 解读、命盘历史全部开放。

注:关于六亲判断
> 紫微斗数在六亲(父母、兄弟、子女等)判断上存在一定局限。倪师在《天纪》中指出:“斗数批六亲本来就比较差一点。”(2上 · 00:25:27)在传统术数中,铁板神数在核对六亲方面有其独特优势(2上 · 00:03:15);倪师仍以紫微斗数为核心,是因为它能结合地理、环境与人事进行综合判断,形成“上知天文、下知地理、中知人事”的完整体系(2上 · 00:25:43)。因此,与六亲相关的分析仅供参考;ouranic.cn 上父母、兄弟、子女三个维度也附有同样的说明。

---

目录

| | 章节 | 一句话 | |---|------|--------| | 一 | 本轮更新 | 倪师《天纪》紫微 17 集 160 万帧逐帧精读做完并入本仓:17 集康奈尔笔记、344 条公开摘要、片源上限 | | 二·新 | 13 维解读数据集 v4.0 | 2026-10-15 新版断语,67.5 万命盘,按年份下载 | | 二 | 51.8 万命盘样本数据集 | 规格、下载、用途、许可 | | 三 | 快速开始 | 克隆到跑起来 | | 四 | 排盘引擎 | 能做到什么、文件怎么分、古籍数据 | | 五 | 倪师《天纪·紫微斗数》原话 | 14 讲 + 2 段补充、1848 条,一图看全,每条可回放 | | 五·新 | 160 万帧逐帧精读 | 17 集 1,604,675 帧怎么读、成绩与片源上限、公开摘要、研究目录导览 | | 六 | 界面是一份 Demo | 不是线上那套,差距写明 | | 七 | 开源边界 | 什么开源、什么不开源 | | 八 | 维护节奏与贡献 | 同步节奏、issue / PR 口径 | | 九 | 协议 | 代码 MIT / 数据 CC BY 4.0 / 古籍公版 / 倪师原话非商用 / 研究目录代码 MIT、文档 CC BY 4.0 | | 十 | 关于与联系 | 项目理念、技术栈、联系方式 |

---

一、本轮更新(2026-11-13)

本轮把倪师《天纪》紫微 17 集、1,604,675 帧的逐帧精读做完并入本仓:逐帧层 133,731 窗全部跑满,17 集康奈尔笔记全部出稿,公开摘要 344 条要点发布。原姊妹仓 nishi-ziwei-video-reading 连同提交历史并到 research/nishi-video-reading/,原仓库归档只读,后续更新都在本仓。

本轮更新总览

1. 规模:一帧不漏 —— 17 集共 1,604,675 帧,每帧有 sha256 清单,不抽帧;逐帧层(DeepSeek,每窗 12 帧)共 133,731 窗,2026-11-13 全部跑满(试点时只有 P17、P05 两集 16,876 窗)。指代层 2,805 道题由 Claude 看原帧逐题盲标,全部标完。

2. 17 集康奈尔笔记出稿 —— 1,734 个提示、6,413 条笔记,每条标依据(口述 / 叠图 / 板书 / 指代 / 推断)和帧号。〔口述〕里引的倪师原话 14,825 段,14,824 段在字幕里原字找到(剩 1 段只在语音里,已注明);拿不准的 2,613 处单列「待核」,不混进正文。笔记正文放在私有仓库。

3. 公开摘要 17 集、344 条要点 —— 在 research/nishi-video-reading/summaries/,每集一份,每条附时间码,点开跳到 B 站原视频那一秒;倪师原话只引短句,不放截图。

4. 写明片源上限 —— 视频本身给不出的三项:「这里 / 这个」约四成看不出指哪(全量 2,805 题里 42.5%);粉笔板书六成多认不出(小考样本 228 个字位里 64%);最清楚的电子叠图只占全片 29.1% 时长(全量)。详见第五·新章。

5. 目录与边界 —— research/nishi-video-reading/ 里是方案与两轮独立终审、小考五个实验的设计与成绩、全部脚本和提示词、按时间的工作记录(每个数字的出处)和公开摘要;不含视频画面、帧图片和讲课原话的整段转写。tsconfig.json 已把 research/ 排除在类型检查之外。许可见第九章。

上一轮更新(2026-10-15)

本轮跟随网站 2026-10-15 发版(网站内容版本 ca268829f7a9):

本轮更新总览

1. 发布 13 维解读数据集 v4.0 —— 674,976 张命盘(公历 1950–2026 年每一个真实日期 × 12 时辰 × 男女)× 13 维 = 8,774,688 段解读,正文约 204 亿字。解压后 56.6 GB(v3.0 为 33.1 GB,增加 71%),压缩后只有 161 MB,按年份分 77 个文件,可以只下需要的年份,也可以一次下全年份总包。下载见 Release v4.0-13d,规格和字段见第二·新章。发布前 77 个文件逐个解压,与原始数据逐字节比对一致。

2. 13 维断语按倪师原话与《全书》原文逐句校正(断语库仍不开源,校正结果体现在 v4.0 数据集里):

3. 排盘引擎同步(PR #39)—— dst-cn.ts 新增 chinaDSTSpan(year),查某年中国夏令时起止;cities.ts 补全省直辖县级单位与新疆兵团各市的经度(神农架、海南各市县、阿拉尔等),出生地选这些城市时真太阳时校正可用。

4. 许可 —— DATASET-LICENSE 适用范围加上 v4.0;写明解读里引用的倪师原话不在数据授权范围内,与第五章倪师原话的 CC BY-NC-SA 4.0 一致。v3.0 样本数据集及其条款不变。

2026-11-08 补充:新开公开仓 nishi-ziwei-video-reading——用多家大模型把倪师《天纪》紫微 17 集共 160 万帧逐帧精读一遍,方案、脚本、考试成绩和踩过的坑全过程公开,边做边更新,近期动态看那里。(11-13 已并入本仓 research/nishi-video-reading/)
2026-11-02 补充:晚子时换日改按真太阳时判断,与时辰支同一口径(#63)——填了出生地时,东经 100° 钟表 23:30(真太阳时 22:10,亥时)留在本日,不再排成「次日亥时」;不填出生地不做校正,结果不变,线上 ouranic.cn 也是这个口径。闰月归属参数写错时当场报错,不再静默按「归本月」排盘(#71)。感谢 Bortlesboat、xunguangzlj-cloud 提交,Verchiel666 复核。
2026-10-31 补充:线上平台更名 OURANIC,网址由 metisziwei.com 迁到 ouranic.cn(运营主体北京王多鱼科技有限责任公司,京ICP备2026069066号-1);旧网址会自动跳转,本仓库的代码、数据集与许可都不变。
2026-10-27 补充:排盘引擎同步——true-solar-time.ts 支持海外出生地:传 utcOffsetMinutes(出生地时区的固定标准偏移),按当地时区中央经线做经度修正,国内不传时结果逐位不变;新增 clock-adjust.ts,把夏令时、或当年时区与现在不同时的钟表读数换成标准时间(跨日不改,交给用户),建议做成用户亲手点、可撤销的按钮,不要自动改。顺带更正:中国夏令时引擎只判定、从不自动扣除,此前「引擎能力」表写成「自动扣除」,有误。
2026-10-24 补充:项目理念移到页首——标题下居中一句「算法是公开的传统智慧,不应该被锁在围墙里」,紧接两段理念原文(前标「项目理念」),原有介绍段前标「项目信息」;第十章「项目理念」改为指向页首。
2026-10-20 补充:星曜亮度默认改为《斗数全书》,与主流排盘软件默认一致,此前默认的「现代修正 v2」仍可在流派设置里选;补齐天姚、天刑、天喜、大耗、解神、截空、副截、旬空的亮度,月德不再标亮度。用 5 张金标准盘逐宫核对,星曜落宫与亮度全部吻合。注意:v4.0 数据集(10-15)是按旧默认「现代修正 v2」生成的,其中亮度字和少量随亮度变化的解读句会与新默认不同。
2026-10-06 ~ 10-07 补充:README 加「注:关于六亲判断」(倪师原话 + 出处链接,中英两份);网站链接加渠道码 ?from=;同步倪师原话语料勘误(主星南斗、北斗归属)。

再上一轮更新(2026-09-21)

2026-10-03 补充:倪师《天纪·紫微斗数》原话 1848 条单独成章(第五章);合并外部贡献 #29(时辰序号校验);引擎拒绝不存在的公历日期,数据集补字段口径与已知问题;提交 package-lock.json;站点地址改为可配置;合盘演示改用本地引擎起盘、AI 接口缺失时明确提示;补齐贡献指南、行为准则、问题与 PR 模板;新增英文简介 README.en.md;去掉两个用不上的部署工具包(vercel CLI、@cloudflare/next-on-pages),依赖从 483 个减到 185 个;随后升级到 Next.js 16 修掉 postcss 漏洞,GitHub 安全提醒从 51 条清零。
本轮更新总览

时隔三个月,本仓库完成一次完整更新(PR #28,26 个文件、+2736 / −108 行):

1. 排盘引擎同步到线上口径 —— algorithm.ts 从 181 行到 641 行,另更新 sihua / types / constants / patterns / cities / famous;新增 8 个模块(1367 行):

| 模块 | 作用 | |------|------| | true-solar-time.ts | 真太阳时校正(经度差 + 均时差) | | dst-cn.ts | 中国 1986–1991 夏令时 | | clock-adjust.ts | 钟表读数换成标准时间(夏令时 / 当年时区不同) | | lunar-solar.ts | 农历 / 公历互转与闰月边界 clamp | | school-data.ts / school-tables.generated.ts / school-config.ts | 星曜亮度流派数据与对照表、闰月与晚子时口径配置 | | shier-shen.ts | 十二神煞 | | yunxian-context.ts | 运限上下文(含童限) |

2. 补上回归测试与 CI —— 此前本仓库没有任何测试。现在 5 条排盘回归,npm test 一条命令跑完,每次 push 与 PR 在 GitHub Actions 上自动跑。

3. 修掉样本时辰注释错位(#26)—— famous.ts 里 11 条名人样本有 7 条的时辰注释与 hour 索引不符(hour 一直是时辰地支索引 0–11,不是 0–23 的小时数)。已改正并加回归钉住。

4. 积压 issue 从 18 条清到 4 条,留下的都是还在走的。

5. 文档与许可 —— 新增 DATASET-LICENSE;README 补齐引擎能力清单、维护节奏、开源边界;修正两处不实描述(数据集「口径与线上完全一致」、界面「完整的 Next.js 15 前端」)。

---

二·新、13 维解读数据集 v4.0(2026-10-15)

下载位置:本仓库右侧 Releases → v4.0-13d

v4.0 用 2026-10-15 版网站断语库重新生成:13 个分析维度的断语已按倪海厦《天纪》逐字稿与《紫微斗数全书》原文逐句校正——查不到出处的引文删去或换成逐字可查的原话(倪师原话注明《天纪》集数与时间码),不会发生的四化相关句子删去,有条件的断语写明条件。

规格

| 项目 | 说明 | |------|------| | 命盘数 | 674,976 张(公历 1950–2026 年 × 真实每月天数 × 12 时辰 × 男女) | | 解读段数 | 8,774,688 段(每张盘 13 维) | | 维度 | 命格总览、性格、感情、事业、财运、健康、兄弟、子女、迁移、人际、田宅、福德、父母 | | 大小 | 解压后 56.6 GB;压缩后 161 MB(77 个年份文件,zstd;另有一个全年份总包 ziwei-interp-v4-all.tar) | | 正文 | 约 204 亿字,每张盘约 3.0 万字 | | 生成方式 | 排盘引擎 + 断语库确定性生成,不经 AI,同一输入恒得同一输出 | | 内容版本 | ca268829f7a9(与网站同期的 ANALYSIS_CONTENT_VERSION) |

每行一张盘(JSON Lines),字段:

| 字段 | 含义 | |------|------| | k | 键:YYYY-MM-DD-时辰序号-性别,如 1990-01-01-0-male | | y / m / d | 公历出生日期;只含真实存在的日期(不再有 2 月 30 日之类) | | h | 时辰序号 0–11(子 = 0 …… 亥 = 11),不是钟点;对照表见上一节 | | g | male / female | | ms | 命宫第一颗主星;命宫无主星时为 null | | t | 各维字数 | | c | 13 维解读全文(Markdown),键为 overview / personality / love / career / wealth / health / family / children / move / friends / home / spirit / parents |

口径说明

下载与解压

# 一次下全部:gh release download v4.0-13d --repo Renhuai123/ziwei-doushu -p "ziwei-interp-v4-all.tar"

只要某几年就只下那几年,例如 1990 年

zstd -d --long=27 year-1990.jsonl.zst # 得到 year-1990.jsonl shasum -a 256 -c SHA256SUMS.txt --ignore-missing # 校验

--long=27 必须带上(压缩时用了长窗口)。Windows 可用 zstd 官方发布包 里的 zstd.exe,参数相同。

引文说明

解读里引用的倪海厦《天纪》原话不属于本数据集的授权范围:它们是为说明断语出处而注明集数与时间码的简短引用,著作权归原权利人;要把这些原话单独成批使用,按第五章倪师原话的 CC BY-NC-SA 4.0 处理。《紫微斗数全书》原文属公有领域。

许可

与 v3.0 相同:CC BY 4.0,可自由商用,唯一要求是保留来源标注(上面「引文说明」里的倪师原话除外),完整条款见 DATASET-LICENSE。引用时请写:

本项目使用了 紫微斗数开源解读数据集 v4.0(674,976 张命盘 × 13 维)
来源:https://github.com/Renhuai123/ziwei-doushu
作者:王多鱼AI

---

二、51.8 万命盘样本数据集

下载位置:本仓库右侧 Releases 页面

我们开源了一套完整的紫微斗数命盘样本数据集,覆盖 51.8 万种排盘组合(年 60 × 月 12 × 日 30 × 时 12 × 性别 2),每条样本包含完整的命盘结构和基于倪海厦体系的解读文本。

2.1 数据规格

| 项目 | 说明 | |------|------| | 样本数量 | 518,400 条 | | 总大小 | 压缩后 5.5 GB(分 3 卷),解压后 33.1 GB | | 体系 | 倪海厦《天纪》正统(纯飞星派已下线) | | 内容 | 命盘 JSON + 13 主题解读文本(命格总览、财运、事业、感情、健康等) | | 验证 | 男女命差异化 100%、健康含子午流注 100%、女命含妇科保养 100% | | 口径 | 由 v3 版排盘引擎 + 当期断语库生成;线上引擎在持续更新,新版输出与本数据集可能有差异 |

字段口径(每条样本由 birthInfo 生成,常被看错的是 hour):

| 字段 | 含义 | |------|------| | birthInfo.year / month / day | 公历出生日期:1924–1983 年(一个完整甲子),每月取 1–30 日 | | birthInfo.hour | 时辰序号 0–11,不是 0–23 点钟:子 = 0、丑 = 1 …… 亥 = 11 | | birthInfo.gender | male / female | | birthInfo.longitude | 固定 120(东经 120°,未做各地真太阳时校正) | | 文件名 YYYY-MM-DD-hHH-性别.json | 其中 hHH 同样是时辰序号,例如 h11 是亥时,不是上午 11 点 |

时辰序号与钟点对照:

| 序号 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | |---|---|---|---|---|---|---|---|---|---|---|---|---| | 时辰 | 子 | 丑 | 寅 | 卯 | 辰 | 巳 | 午 | 未 | 申 | 酉 | 戌 | 亥 | | 钟点 | 23–1 | 1–3 | 3–5 | 5–7 | 7–9 | 9–11 | 11–13 | 13–15 | 15–17 | 17–19 | 19–21 | 21–23 |

23:00–23:59 出生(晚子时)按次日排盘、时辰取 0;00:00–00:59 出生(早子时)按当日排盘、时辰同样取 0。

已知问题:约 2,520 条样本的日期并不存在。 生成时每个月都取了 1–30 日,所以 2 月 30 日,以及非闰年的 2 月 29 日也生成了样本,共 105 个日期 × 12 时辰 × 2 性别 = 2,520 条,占 0.49%。v3 引擎遇到这类日期不报错,而是顺延成 3 月 1–2 日排盘,所以这些样本的内容与对应的 3 月 1–2 日样本重复。使用时请过滤掉:month = 2 且 day = 30,或 month = 2 且 day = 29 且该年不是闰年。引擎从 2026-10-03 起会直接拒绝不存在的日期,下一版数据集不会再有这类样本。

2.2 下载方式

前往 Releases 下载以下文件:

ziwei-samples-v3-part1.zip.001  (1.9 GB)
ziwei-samples-v3-part2.zip.002  (1.9 GB)
ziwei-samples-v3-part3.zip.003  (1.8 GB)
SHA256SUMS.txt                  (校验文件)

下载后合并解压:

# macOS / Linux
cat ziwei-samples-v3-part*.zip.* > combined.zip
unzip combined.zip

Windows (PowerShell)

Get-Content ziwei-samples-v3-part*.zip.* -Encoding Byte -ReadCount 0 | Set-Content combined.zip -Encoding Byte Expand-Archive combined.zip

2.3 用途

2.4 数据许可与引用

📂 完全开源 · 可自由商用 —— 你可以在任何项目里使用这套数据,包括但不限于:

无需付费、无需申请、无需事先告知。

唯一的要求是保留数据来源标注(attribution):

本项目使用了 紫微斗数开源样本数据集 v3.0(518,400 条)
来源:https://github.com/Renhuai123/ziwei-doushu
作者:王多鱼AI

放在哪里都行:

仅此一条,其余都自由。完整条款见 DATASET-LICENSE。希望这套数据能帮你做出好东西 —— 做出来记得来小红书 / 抖音 / 闲鱼 @王多鱼AI 打个招呼 👋

---

三、快速开始

# 克隆
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu

安装依赖

npm install

配置环境变量(只看排盘可以跳过;AI 配置仅在你自己实现了 /api/* 接口时才用得上)

cp .env.example .env.local

启动开发服务器

npm run dev

本地验证:

npm run typecheck   # TypeScript 全量类型检查
npm test            # 排盘引擎回归(768 盘 × 紫微铁律、夏令时、立春边界、红鸾天喜、样本时辰一致性、时辰序号边界、日期合法性、同宫双四化)

每次 push 与 PR 都会在 GitHub Actions 上跑同一套(见 .github/workflows/ci.yml)。

注意:开源版不含后端 API 路由。排盘、命盘展示、合盘起盘都在浏览器里用本仓库的引擎完成,不需要任何 API Key。AI 解读(/api/interpret)和合盘 AI 分析(/api/heming)需要你自己实现接口;没实现之前,这两处会直接提示「开源版不含该接口」,配置 API Key 也不会变成可用(#30 就是这个原因)。

---

四、排盘引擎

排盘内核全部在 lib/ziwei/。

4.1 能做到什么(与常见排盘库的差异)

| 能力 | 说明 | |------|------| | 真太阳时校正 | 按出生地经度算时差 + 均时差,避免东西向差一个时辰 | | 中国夏令时 | 1986–1991 年的夏令时区间自动判定(只判定、不自动扣除;钟表读数由用户确认后用 clock-adjust.ts 换成标准时间) | | 闰月四种口径 | 闰月归前月 / 归后月 / 按日切分 / 按本月,可配置,不写死一派 | | 晚子时换日 | 23:00–23:59 按次日排盘、00:00–00:59 按本日;填了出生地时按真太阳时判断(与时辰同一口径);换日策略可切换 | | 星曜亮度 7 档 | 庙 / 旺 / 得 / 利 / 平 / 不 / 陷,另保留 3 档粗分类做显示降级 | | 亮度流派可切换 | 不同流派(含主流排盘软件的不同版本)对辅星亮度判法不一致,做成开关而非写死 | | 四化与飞星 | 生年四化、大限 / 流年四化、飞星自化 | | 十二神煞 | 本命层按生年支起,流年层改按流年支起 | | 格局判定 | 1100+ 行规则库(紫府同宫、日月并明、七杀朝斗等) |

4.2 文件怎么分

| 文件 | 说明 | |------|------| | algorithm.ts | 完整排盘流程:安命宫、定五行局、安十四主星、安辅星、排大限流年 | | constants.ts | 天干地支、十四主星、辅星常量 | | sihua.ts | 四化飞星系统(禄权科忌),含各天干四化对照表 | | patterns.ts | 1100+ 行格局知识库:紫府同宫、日月并明、七杀朝斗等经典格局判定规则 | | heming-knowledge.ts | 合盘方法论:倪师体系下双盘比对逻辑 | | types.ts | TypeScript 类型定义 | | cities.ts | 中国城市经纬度,用于真太阳时校正 | | famous.ts | 历史名人命盘示例数据 | | school-data.ts / school-tables.generated.ts / school-config.ts | 星曜亮度流派数据与对照表、闰月与晚子时口径配置 | | shier-shen.ts | 十二神煞(本命按生年支起、流年层按流年支起) | | true-solar-time.ts | 真太阳时校正(经度差 + 均时差) | | dst-cn.ts | 中国 1986–1991 夏令时年份与区间 | | clock-adjust.ts | 钟表读数按分钟平移成标准时间(跨日不改) | | yunxian-context.ts | 运限上下文(含童限处理) | | lunar-solar.ts | 农历 / 公历互转与闰月边界 clamp |

4.3 古籍原文(lib/classics/)

4.4 SEO 知识图谱(lib/seo/)

14 主星 × 12 宫位的结构化知识数据,可用于内容生成或知识库构建。

---

五、倪师《天纪·紫微斗数》原话

倪海厦《天纪·紫微斗数》一图看全

倪海厦《天纪》紫微斗数部分的原话共 1848 条:正课 14 讲(第 2–15 讲上半)加 2 段补充,按讲分成 16 个文件,放在 docs/tianji-ziwei/。每条都带出处时间,点一下就跳回 B 站原视频的那一秒。

---

五·新、160 万帧逐帧精读(2026-11-13)

目录:research/nishi-video-reading/(原姊妹仓 nishi-ziwei-video-reading,2026-11-13 连同提交历史并入本仓)

做了什么:用多家大模型把倪海厦《天纪》紫微斗数 17 集讲课视频一帧不漏地读一遍(1,604,675 帧),把他讲的方法、板书、后期贴上的电子命盘、「这里 / 这个」指的是哪,整理成每条都能指回集号、时间码和帧号的康奈尔笔记。之所以逐帧:视频里大量信息不在字幕里——黑板上写了什么、指着哪一宫说「这里」、剪辑贴上的命盘标了什么,只看字幕会丢一半。

怎么做(一句一层):

几条规矩:只依据视频本身,不掺《紫微斗数全书》等外来材料;看不清就写「视频未显示」,不猜、不按紫微知识补字;每一层先用小样本考(小考 5 个实验),门槛事先定好,不过线就改方案、不降标准。

成绩

| 项 | 结果 | |---|---| | 逐帧层 | 133,731 / 133,731 窗,2026-11-13 全部跑满 | | 指代层 | 2,805 / 2,805 道题标完 | | 康奈尔笔记 | 17 / 17 集出稿:1,734 个提示、6,413 条 | | 引文核对 | 〔口述〕里引的原话 14,825 段,14,824 段在字幕里原字找到(剩 1 段只在语音里,已注明) | | 待核 | 拿不准的 2,613 处单列,不混进正文 |

片源上限:有些信息视频本身就给不出,不是没做,全部写明。

| 项 | 数字 | 样本 | |---|---|---| | 「这里 / 这个」看不出指哪 | 2,805 道题里 1,191 道(42.5%)看不出或拿不准;能确定的 1,614 道里,真在指 816 道(占全部 29.1%)、口头用法 798 道(28.4%) | 全量:17 集全部题目 | | 粉笔板书认不出 | 228 个字位里 146 个(64%) | 只有小考样本(30 个板书格);全量没有逐字转写板书,笔记只录看得清的 | | 电子叠图(印刷字,最清楚)只占时长 | 53,491 秒里 15,586 秒(29.1%) | 全量:17 集每秒 1 帧打分 |

公开摘要:17 集每集一份、共 344 条要点,见 summaries/。倪师原话只引短句,每条附时间码,点开跳到 B 站那一秒;不放截图和视频画面,不公开从命盘反推的生辰。摘要是对讲课内容的学习整理,不代表我们的判断,也不构成医疗、婚姻、投资等建议。笔记正文在私有仓库。

研究目录导览

| 位置 | 内容 | |---|---| | README.md | 总说明:为什么做、流程图、片源上限、各步进度 | | summaries/ | 17 集公开摘要 | | docs/工作记录.md | 按时间的全过程:做了什么、每个数字的出处、走过的弯路 | | docs/ 其余文件 | 方案与两轮独立终审、小考五个实验的报告、标注说明、叠图定稿说明、康奈尔笔记模板 | | prompts/、scripts/ | 提示词与全部脚本:抽样、逐帧层调度、本机预处理、指代盲标、按句拼接、切块、校验渲染、叠图处理、出图 |

各家接口的钥匙不在仓库里;脚本里的路径按我们本机的目录写,复现时请改成自己的。许可见九、协议。

---

六、界面是一份 Demo

界面代码在 app/ 与 components/。仓库里的界面是一套最小可运行示例,作用是把排盘引擎跑起来、把盘画出来,方便你在它基础上做自己的产品。线上商业版的界面不在开源范围内,两者差距很大:

| 页面 / 组件 | 本仓库(Demo) | 线上商业版 | |------|------|------| | 排盘页 app/chart/page.tsx | 75 行 | 1227 行 | | 解读面板 InsightPanel | 467 行 | 5088 行 | | 命盘方格 ChartBoard | 285 行 | 1334 行 | | 宫位格 PalaceCell | 201 行 | 1192 行 | | 合盘页 app/heming/page.tsx | 368 行 | 1937 行 |

Demo 能跑通的:出生信息表单、命盘方格与宫位详情、本命 / 大限 / 流年切换、古籍阅读器(全文搜索)、命理百科(14 主星 × 12 宫位)、亮暗主题、移动端适配。

Demo 里没有的:线上重做过的交互界面、AI 流式解读、合盘图谱、分享卡片,以及断语内容本身(db-analysis.ts 是占位实现)。也就是说,Demo 画得出盘,但给不出线上那套解读。

---

七、开源边界:什么不在里面

| | 内容 | |---|---| | ✅ 开源 | 排盘引擎(lib/ziwei/)、古籍公版原文(lib/classics/)、SEO 知识图谱(lib/seo/)、Demo 界面、51.8 万样本数据集、13 维解读数据集 v4.0、160 万帧逐帧精读的方法 / 脚本 / 提示词与 17 集公开摘要(research/nishi-video-reading/) | | ❌ 不开源 | 断语库(lib/ziwei/db-analysis.ts 是占位,线上是上万行的 13 主题断语)、AI 解读 prompt、后端 API(/api/interpret 等)、用户系统(登录 / 会员 / 支付)、服务端安全(签名、防刷、水印)、部署配置、160 万帧精读的康奈尔笔记正文(私有仓库)与视频画面 / 帧图片 |

如果你需要 AI 解读能力,可以参考 lib/ziwei/patterns.ts 和 heming-knowledge.ts 里的知识库,结合任意 LLM 自行构建 prompt。

---

八、维护节奏与贡献

这个仓库是排盘引擎 + 数据集的开放快照,不是一个全职维护的开源产品,说清楚免得大家猜:

---

九、协议

本仓库分五部分授权。除倪师原话目录不许商用外,其余都是宽松协议,商用没有限制:

| 内容 | 协议 | 简单说 | |------|------|--------| | 代码(lib/、app/、components/) | MIT License | 拿去随便用,保留 LICENSE 文件即可 | | 数据(Releases 中的 51.8 万样本数据集 v3.0、13 维解读数据集 v4.0) | CC BY 4.0 · 要求 attribution | 商用也行,注明数据来源即可 | | 古籍原文(骨髓赋、紫微斗数全集 / 全书等) | Public Domain | 古书都是公有领域,不存在版权 | | 倪师原话(docs/tianji-ziwei/) | CC BY-NC-SA 4.0 | 可以引用、转载,注明出处;不许商用,改编后用同样协议 | | 研究目录(research/nishi-video-reading/,160 万帧逐帧精读) | 代码 MIT;文档 CC BY 4.0(沿用原仓库) | 代码拿去随便用;文档转载注明出处;其中引用的倪师原话短句不在授权内 |

研究目录里的倪师原话:公开摘要和文档里引用的倪师原话短句不在上表 MIT / CC BY 4.0 的授权范围内,著作权归原权利人,只作学习引用;要把这些原话单独成批使用,按第五章倪师原话的 CC BY-NC-SA 4.0 处理。

一句话:代码和数据拿去用,商用也行,把来源链接带上就行;倪师原话只限非商业的学习研究(数据集解读、研究目录里引用的倪师原话同样不在授权范围内)。

---

十、关于与联系

项目理念

见本页开头。想自己搭?代码都在这里,拿去用。嫌麻烦?来 ouranic.cn 直接用。

技术栈

联系

GitHub Stars & Activity

10,706Stars
2,138Forks
14Open issues
TypeScriptLanguage

GitHub Popularity

GitHub stars10,706
Forks2,138
Open issues14
Primary languageTypeScript
LicenseMIT
Stars gained today13,956
Created2026-05-01
Last pushed2026-10-27

Trending History

Monthly boardrank #22 · ▲ 13,956 stars

Related GitHub Projects

1

ChromeDevTools / chrome-devtools-mcp

TypeScript★ 57,370⑂ 4,834▲ 717 stars
→
2

tashfeenahmed / freellmapi

TypeScript★ 53,114⑂ 7,448▲ 579 stars
→
3

motiondivision / motion

TypeScript★ 35,252⑂ 1,554▲ 76 stars
→
4

dream-num / univer

TypeScript★ 26,949⑂ 2,444▲ 988 stars
→
5

motion-canvas / motion-canvas

TypeScript★ 19,968⑂ 916▲ 111 stars
→
6

ag-ui-protocol / ag-ui

TypeScript★ 18,303⑂ 1,888▲ 355 stars
→
7

assistant-ui / assistant-ui

TypeScript★ 13,258⑂ 1,344▲ 75 stars
→
8

elder-plinius / G0DM0D3

TypeScript★ 12,488⑂ 2,905▲ 66 stars
→

More Trending Repositories