前言¶

DeepSeek Harness 的设计理念是「一切皆插件」。当智能体需要提供命理排盘能力时，传统做法要么在本地维护多套逻辑，要么接入外部 API。对于需要稳定、可控、本地计算的场景，更现实的方式是让插件把整套规则和视图都带进来。

dsh-metaphysics 是一个把六套命理体系装进 Harness 的插件：四柱八字、紫微斗数、六爻、梅花易数、大六壬、塔罗牌。它既提供 Agent 工具（通过对话调用），也提供 Web 面板（侧栏显示）。所有计算在本地完成，不收集数据，结果仅供文化娱乐参考。

功能概览¶

插件把六种体系按「命盘」与「卦象 / 牌阵」两类组织，每种体系都有对应的排盘面板和结构化解读模块。

四柱八字（bazi）¶

• 四柱、藏干、十神、纳音、空亡（逐柱）
• 十二长生：地势（日干对各支）、自坐（各柱干对本支）
• 神煞 42 颗，分 7 类：贵人、文星、婚姻、性情、事业、凶煞、格局；每颗星附查法依据，界面悬停可见
• 日主旺衰：月令权重 + 通根 + 天干帮扶，量化分档并给出依据
• 格局与用神：月令取格（建禄 / 阳刃 / 月劫 / 十神格）＋ 特格（化气 / 专旺 / 从格）＋ 十神组合，每条附判定依据；用神取扶抑为主 + 调候提示，并列出喜忌十神
• 行运吉凶：大运、流年按喜忌五行与十神加权评分，分大吉 / 吉 / 平 / 忌 / 大忌五档，悬停可看逐项理由
• 干支关系：五合、相冲、相克；六合、三合半合、三会半会拱会、冲、害、破、刑
• 大运、流年（含与原局地支的关系）、真太阳时（按出生地经度修正）

紫微斗数（ziwei）¶

• 农历（定朔 + 冬至置闰）、命宫、身宫、五行局
• 紫微 / 天府、十四主星、六吉六煞、禄存天马、49 颗星曜
• 十四主星庙旺得利平不陷：按《紫微斗数全书》系通行表标注，庙旺标绿、得利平标灰、不陷标红
• 四层十二神：长生、博士、将前、岁前
• 生年四化、宫干自化、大限、小限、流年（命宫、三方四正、流禄流羊流陀）、斗君
• 格局识别 34 条，附判定依据与吉 / 忌倾向
• 大限一览：十二限排序列出宫位、年龄区间、宫干四化落宫、三方主星；流年四化：逐年给出四化星落宫与命宫三方主星
• 流月 / 流日 / 流时：由流年斗君逐级下推；每层给落宫、宫干四化落宫与三方四正
• 宫位点击展开详情：点任一宫摊开该宫完整星曜、宫干四化、四层十二神、大限 / 小限，并把三方四正同步描边；空宫标注「借对宫 XX」

六爻（liuyao）¶

• 摇卦或手动爻值、本卦 / 变卦、纳甲、六亲、六神、世应
• 面板：本卦与变卦并列对照，真爻线渲染（阳整、阴断、动描红），世应与动爻一目了然
• 只需起卦时刻（取日辰定六神、月建定旺衰），与出生时间无关

梅花易数（meihua）¶

• 时间起卦（年月日时数）或数字起卦（两数取余，可手动指定动爻）
• 本卦 / 互卦 / 变卦 / 错卦 / 综卦五盘齐出；本卦上下卦分块标「体」「用」
• 体用生克按五行判吉凶：用生体大吉、比和吉、体克用吉、体生用耗、用克体凶

大六壬（daliuren）¶

• 月将加时起天地盘（4×4 方盘：天盘大字、地盘小字、天将右下）
• 四课（干上 / 支上递推，标注生克与天将）、九宗门发三传（贼克 · 元首 · 重审 · 比用 · 涉害 · 遥克 · 昴星 · 别责 · 八专 · 伏吟 · 返吟）
• 昼夜贵人（以天盘临方定顺逆）、旬空标注、格局名与断语

塔罗（tarot）¶

• 78 张全牌、正逆位、1 / 3 / 5 张牌阵（面板可直接选牌阵，换张数自动重抽）
• 每张牌给编号、牌阶级、核心义与牌阵位义；解读 6–8 段（逐牌、大阿卡纳占比、元素分布、宫廷牌、正逆位比例、关键牌、建议）
• 明确标注体系：RWS 编号、黄金黎明元素归属、逆位取「弱化 / 未顺 / 内化」而非凶断

解析与详解（interpret）¶

每个体系的排盘结果下方都会跟一个「解析与详解」模块，把盘面翻译成可看懂、可照着做的事。

• 结构化输出：{ moduleType, system, title, lead, dimensions[], sections[], disclaimer }；moduleType 为 natal（命盘）/ divination（卦象）/ card（牌阵），dimensions 固定五个维度
• 五个维度：整体运势、工作与职业选择、事业发展、爱情与感情、健康状况——每项给「解读 + 行动建议」
• 卦象（六爻 / 梅花 / 大六壬）额外给：卦名与卦辞大意、爻辞与动爻、体用关系、互卦与变卦、落到生活里
• 塔罗额外给：整盘连贯解读（把几张牌串成一条线，避免各张互相矛盾）与牌面结构（大阿卡纳占比、元素分布、正逆位）
• 文案口径：第二人称、温和，只给倾向与建议，不作绝对判断；底部保留理性参考的免责提示
• 解读区可折叠：内容较长（五维度 + 体系模块），点标题栏或箭头即可展开 / 收起；宽屏默认展开、窄屏默认收起，手动切过之后按你的选择来

所问之事与询问方向（六爻 / 梅花 / 大六壬 / 塔罗）¶

问事的体系要先说清问什么，解读才有落点：

• 所问之事：必填，支持多行，占位示例「用一句话描述所问之事，例如：今年是否适合换工作？」；不填就起卦会给提示，不会给一份没有落点的解读
• 询问方向：下拉选择——综合（默认）、财运、事业、感情、健康、学业、出行。选项表 DIRECTIONS 由 engine/interpret.js 导出，界面与解析层共用一份
• 联动方式：interpret(result, { question, direction })。所选方向对应的维度会被提到最前并标注「最贴近你的问题」，正文点明你所问的事，引语也会回显
• 不重摇卦：改问题或方向只重出解读，卦象本身不动
• 命盘类（八字 / 紫微）不问事，不显示这两项，也不会出现回显行

安装与启用¶

从 npm 安装：

dsh plugin install dsh-metaphysics

或在 Harness 的「插件」面板里搜索 dsh-metaphysics。

从本地目录安装：

dsh plugin install /path/to/dsh-metaphysics

从 tgz 安装：

dsh plugin install ./dsh-metaphysics-0.6.0.tgz

安装后重启 Harness，侧栏会出现太极图标，点开是排盘面板，支持以上六类体系。

对话与面板用法¶

对话里¶

直接说：

• 「排个八字：1990-05-12 14:30，女，河北石家庄」
• 「排紫微盘：1996-01-19 07:40，男，新疆喀什」
• 「帮我起一卦，问这个项目能不能成」
• 「梅花易数，报两个数 17 和 29」
• 「起个六壬课，问这周谈判顺利吗」
• 「抽三张塔罗，问这份工作要不要接」

模型会调用 metaphysics_chart 工具，参数 system 取 bazi / ziwei / liuyao / meihua / daliuren / tarot。

注意：八字与紫微要出生时间；六爻、梅花、六壬只要起卦时刻（通常就是当下），与出生时间无关。

面板¶

重启后侧栏出现太极图标，点开是排盘面板，支持以上四类。

深色与导出¶

• 深色主题：跟随系统（prefers-color-scheme），盘面与页面同时切换，只换一套 CSS 变量，元素规则一行不改
• 打印永远是浅色：深色主题下直接打印会得到一整页耗墨的深底 PDF，所以深色规则用 @media screen 限定
• 存为 PDF / 打印：结果下方有按钮，走浏览器原生打印（不引第三方库）；A4 纵向、隐藏输入区与按钮、盘面与解读不被撕页、四化色块保留颜色。折叠着的「解析与详解」在打印时会自动展开，不会只印出一个标题栏

精度与口径¶

• 节气：Meeus 低精度太阳黄经，与公开历书相差 −3 ~ −8 分钟；出生时刻距「节」不足 15 分钟时会提示复核
• 农历：定朔（Meeus 第 49 章，误差约 1 分钟）＋ 冬至所在月为十一月 ＋ 无中气置闰
• 真太阳时：经度差 + 均时差；内置 34 个省会 ＋ 200 个地级市坐标（±0.2°），地址更细时可开「联网精确到区县」（Nominatim）。只按经度修正，未含历史时区与夏令时：海外出生请先把当地钟表时间换算成东八区标准时再输入
• 紫微四化：中州派常用表（庚干作太阳禄、武曲权、太阴科、天同忌）
• 日主旺衰：量化算法，非唯一流派

数据与隐私¶

• 全部计算在本地完成
• 唯一可能的网络请求：开启「联网精确到区县」时的 OpenStreetMap Nominatim 查询；失败即回退内置坐标表
• 不收集、不上传任何数据

生态与维护¶

dsh-metaphysics 由维护者 xuanfu-web 长期维护，开源在 GitHub。安装前建议检查源码与许可证（MIT），确认权限与兼容性。

插件遵循 DSH 的「一切皆插件」理念，与 DeepSeek / 幻方无官方从属关系，社区目录是独立站点。

快速链接¶

• 目录页：https://www.skillhub.cn/plugins/xuanfu-web/dsh-metaphysics
• GitHub：https://github.com/xuanfu-web/dsh-metaphysics
• 本地计算、不收集数据、仅供文化娱乐参考