EchoUser005 / dsh-fate-spectrum

dsh-fate-spectrum

一个面向 DeepSeek Harness 的八字与紫微斗数确定性排盘插件。

将传统命理中的排盘事实转化为结构化、可复现、可被 AI Agent 直接调用的工具能力。

dsh plugin --profile web add dsh-fate-spectrum@0.1.0

https://github.com/user-attachments/assets/f0fac8c3-5ebe-4acf-a166-1f05a6f89b6f

每个人都希望活成自己命盘最好的样子。

dsh-fate-spectrum 想做的，是陪命主把命盘重新放回真实人生：看见自己的禀赋与节律，理解人生正在经过怎样的阶段，也看清那些更容易发生的高概率应象。

命理不该替你决定人生。它更像一张不断被现实校准的地图——迷茫时，帮你找到事情为什么会发生；走到关键路口时，陪你寻找更适合自己的解法；顺的时候知道顺从何来，逆的时候也能看见问题究竟卡在哪里。

未来，在命主明确授权后，记忆系统还可以记住这些真实发生过的因与果，让每一次对话都比上一次更懂你，一点点修正属于自己的 fate trajectory。

fate-spectrum 的长期规划

当前能力

• 四柱八字排盘：得到四柱、藏干、十神、纳音、旬空、十二长生、起运与大运等基础命盘事实。
• 紫微斗数排盘：得到十二宫、命身宫、命主身主、五行局、星曜亮度、四化与大限等基础命盘事实。
• 双盘同看：没有指定体系时，同时排出八字与紫微；也可以只看其中一套。
• 保留时间的不确定性：出生时辰未知，或恰好落在换日边界附近时，不会偷偷补成一个确定时间。不同候选盘会带着各自适用的时段交给 Agent，让能确定的先确定，不能确定的按条件分别理解。
• 缺什么就问什么：出生日期、性别、时辰状态或时区不足时，DSH 会先补问；不会为了尽快得到一张盘而猜测关键信息。

未来展望

• 干支历与周期上下文：把“下周”“下下周”“今年某一段时间”转换成明确日期范围、节气、流年、流月与逐日干支，让周期分析不再依赖临时搜索和手工查历。
• 真太阳时校准：结合出生地点、时区、经度与均时差，给出可追溯的实际排盘时间；校准跨过日期或换日边界时，明确告诉命主命盘发生了什么变化。
• 周报与分析 Skills：沉淀周报分析流程，把原局、运限和具体时间范围组织成 Agent 可调用的分析步骤。
• 案例、格局与经验 Knowledge：为 Agent 提供经过整理的佐证资料，支持格局分析和相似案例对照。
• 心智世界模型 Memory：在命主授权后，记录真实世界的因与果，实例化干支作用象意，并支持记忆的获取与更新。
• 命盘 A2UI：用受控的命盘视觉交互规则、组件、资产和变量，把全局命盘、局部干支作用与按需分析融入 Agent 人机交互；大运与流年的长期走势图、一年内的运势曲线、关键周期切换和候选盘差异，都可以成为 Agent 按意图调用的可交互视觉组件。

这些能力最终会连成同一件事：命盘负责提供坐标，现实负责给出反馈，Agent 帮助命主在一次次选择中，更清醒地走向适合自己的位置。

安装

从 npm 安装

已经安装 DSH 的情况下，把 dsh-fate-spectrum 加入日常使用的 Profile：

dsh plugin --profile web add dsh-fate-spectrum@0.1.0
dsh --profile web --dump-config
dsh web

--dump-config 中出现 dsh-fate-spectrum 和 fate-spectrum，说明 Bundle 已经进入当前 Profile。以后正常打开 DSH，就可以直接在对话里提出排盘或命理分析需求。

升级到最新兼容版本：

dsh plugin --profile web up dsh-fate-spectrum

从本地安装

下载或自行打包得到 .tgz 后，可以不经过 npm 注册表，直接安装同一份预构建 Bundle：

dsh plugin --profile web add ./dsh-fate-spectrum-0.1.0.tgz
dsh --profile web --dump-config

本地开发和 --patch 调试方式见 DSH 本地测试 SOP。

使用指南

直接告诉 DSH 想看什么就可以。只说“帮我排盘”，Agent 会补问排盘真正缺少的信息；没有指定八字或紫微时，默认同时计算两套命盘。

如果只记得大概时间，也可以如实说“接近晚上十一点，但不确定具体分钟”或者“时辰不知道”。插件会保留可能成立的候选盘，Agent 可以先分析共同事实，再解释不同时间条件下哪些结论会改变，不必为了得到一张完整命盘硬猜时辰。

当前最适合从原局、起运、大运、十二宫和大限开始理解自己的命盘。周运、月运和指定日期范围的连续分析，后续会由独立的干支历能力补齐时间上下文。

版本更新

最新版本

v0.1.0

先把命盘事实算清楚，为之后所有分析打下一张可信的底图：

• 支持四柱八字、紫微斗数，或默认同时排出两套命盘。
• 支持通行安星法与中州派，并明确记录采用的流派与闰月规则。
• 出生时辰未知或落在换日边界附近时，返回带适用时段的候选盘，不擅自填成一个确定时间。
• 信息不足时先补问；一套系统遇到可安全识别的问题时，另一套已经算出的可信结果仍会保留。

变更记录

• v0.1.0：加入四柱八字、紫微斗数、双盘计算与未知时辰候选，建立命盘计算的第一版基础能力。

核心技术

• 时间与历法边界：明确公历、农历、时区、闰月、早晚子时和换日规则；任何会改变命盘的约定都随结果一起保留。
• 八字计算引擎：分别计算四柱、藏干与十神、纳音、旬空、十二长生、起运和大运，不让模型自行补算干支事实。
• 紫微计算引擎：独立计算命身宫、十二宫、命主身主、五行局、星曜亮度、四化和大限；八字与紫微共享一次排盘任务，但不共享计算实现。
• 候选盘：未知时辰不是错误，也不是 00:00。八字保留真正会改变原局和大运的候选，紫微保留早子至晚子十三个时辰槽，并标出每种情况成立的时间范围。
• Tool 分层：程序使用可校验的工程 response，Agent 接收为推理整理过的 Observation。排盘事实、失败原因和下一步行动彼此分开，未来的 A2UI 也可以消费同一套稳定命盘数据。

隐私与边界

• 八字与紫微命盘在插件内离线计算，不依赖第三方排盘网站，也不会把出生信息发送给外部排盘服务。
• 出生信息会进入当前 DSH 对话与 Tool 调用；是否保留会话记录，取决于命主自己的 DSH Profile 与 Session 设置。插件本身不另建用户数据库、命盘缓存或出生信息日志。
• 只有经过命主明确授权的信息，才可以进入未来的个性化记忆。
• 命理提供的是观察、参照与可能性，不是对人生的宣判。
• 医疗、法律、金融和心理等高风险问题，仍应寻求相应专业人士的帮助。

开源许可

dsh-fate-spectrum 采用 MIT License 开源。你可以在许可证允许的范围内使用、修改与分发本项目。