dsh-chinese-traditional-wisdom-skill

一句话定位

把"玄枢"中国传统文化咨询 Skill 打包成 dsh 插件，让你在 dsh 对话中直接调用本地八字、紫微、六爻、梅花、奇门、风水等 32 个传统术数引擎，所有确定性计算都在本地完成，完整生辰不外传。

核心能力

• 把 skills/ 目录下所有 SKILL.md 注册为 dsh 可发现的 Skill 资源（modelInvocable 与 userInvocable 均为 true），在对话里被路由调用
• 提供 32 个本地 TypeScript 排盘与日用工具（八字、紫微、六爻、梅花、奇门、大六壬、太乙、五运六气、二十八星宿、姓名五行、周公解梦、风水罗盘、流年飞星、八宅大游年、袁天罡称骨、每日黄历、九种体质辨识等）
• 真太阳时核验作为八字前置：经度、IANA 时区、历史 UTC 偏移、夏令时证据齐全才走 true-solar-verified 路径，否则显式标注"未完成真太阳时复核"并使用民用时间降级
• 输出严格分四层呈现：本地计算事实 / 传统文化解释 / 现实行动建议 / 免责声明，避免把文化阐释误当作确定性结论
• 提供 9 个联合分析工具（年度、月度、决策、空间时间、三式、择日、合婚等），按"轻度 / 标准 / 深度"三档融合深度调用
• 附带 24 个工作区的本地 Dashboard，可视化浏览盘面、修改输入并查看结果，浏览器端直接调用纯 TypeScript 引擎

技术实现

• 语言: JavaScript（ESM，`"type": "module"）+ 内嵌的 TypeScript 引擎（vendored 自 Skill 源仓库）
• 关键依赖: node:fs（扫描 skills/ 目录并读取 SKILL.md）、node:path / node:url（定位 SKILL.md 与资源根目录）、ctx.skills.registerProvider（向 dsh 注入 Skill 提供器）；依赖均为 Node 内置
• 架构模式: Cordis 插件 + Skill Provider 模式；apply(ctx) 注入 ['skills'] 能力面，调用 ctx.skills.registerProvider 注册一个延迟初始化的 provider，provider 内部递归遍历 skills/ 目录，把每个 SKILL.md 解析为 frontmatter（name / description）+ 正文，注册到 dsh Skill 总表里
• 入口文件: lib/index.js（插件主入口，导出 name、inject、apply）；Skill 内容主入口为 skills/SKILL.md

适用场景

想在 dsh 里聊八字排盘、紫微斗数、六爻占卜、奇门遁甲、梅花易数、风水罗盘、每日黄历、五运六气、中医体质辨识等传统文化话题，并希望排盘/起卦/择日结果在本地完成、原始生辰和咨询文本不上传远端的用户。普通健康、法律、投资、心理、职场问题不应当被自动术数化，Agent 会优先给出专业转介。配套的 Dashboard 适合需要可视化查看盘面、修改输入并对比不同候选时辰结果的用户。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:dhicoc/dsh-chinese-traditional-wisdom-skill

配置项

本插件无需额外配置。apply(ctx) 只做一件事：把 skills/ 下所有 SKILL.md 注册为 dsh 可调用的 Skill 资源。Skill 行为的所有开关（如 timeBasis、civilFallbackConfirmed、transitDate）都是 Skill 内部引擎调用 JSON 的入参，由 Agent 在对话中按需填写，不由用户在插件层配置。

常见问题

Q: 装上之后在 dsh 里怎么用？

A: 安装并重启 dsh web 后，在对话里直接用自然语言描述问题即可，例如"帮我用八字看一下 1990 年 X 月 X 日 X 时出生的四柱和喜用神"或"查一下今天的黄历宜忌"。Agent 会先追问缺失的输入（出生时间、性别、起卦方式等，不会猜填），再调用本地引擎出结果。

Q: 计算会联网吗？生辰会上传吗？

A: 不会。所有排盘、起卦、择日、体质等确定性计算都在本地的 TypeScript 引擎中运行；完整生辰、精确地点、原始问题不写入日志、不上传远端。Python 脚本（如 scripts/bazi_calc.py）只作为离线 oracle 做交叉验证，不参与对话计算的数据源。

Q: 健康、法律、投资类问题能用它判断吗？

A: 不能。Skill 明确把这些列为"高风险现实问题"路径：医疗急症先建议就医、自伤风险立即转介、投资借贷给专业意见、法律事项不替代持牌意见、结构性房屋改造先做建筑安全评估。命理结果只作为传统文化视角的文化参考，输出中必带免责声明，不会给你现实效果保证。

Q: 八字用的真太阳时和我的手机时间不一致怎么办？

A: Agent 必须先在外部核验出生经度、IANA 时区、出生当日 UTC 偏移和夏令时证据，再调用 resolve_true_solar_time 把 trueSolarBirth / trueSolarResolution 传回八字引擎。无法核验时显式标注"未完成真太阳时复核"并使用民用时间降级（timeBasis: 'civil-unverified'），不会用模型记忆自行猜测地点或历史时区。

Q: 它和 dsh 自带的 Skill 冲突吗？

A: 不冲突。插件通过 ctx.skills.registerProvider 注册一个独立的 Skill 来源（source: 'bundled'），模型按 Skill frontmatter 的 description 触发条件路由，不改写 dsh 自带的默认 Skill。新增一个就用一个，不会替换其他。

Q: 如何卸载？

A: 在 dsh profile 目录里同时从 package.json#dependencies 和 dsh.profile.bundles 移除 @dhicoc/dsh-chinese-traditional-wisdom-skill，再 pnpm install 即可。插件没有后台进程、没有持久化数据（默认不保存历史），不会有遗留痕迹。

Q: 它有 Dashboard 吗？

A: 有。源仓库里附带一个本地 Dashboard（24 个工作区），用 cd skills/apps/visual && pnpm dev 启动，可视化浏览盘面、修改输入并查看结果。Dashboard 直接调用浏览器端的纯 TypeScript 引擎，不经 CLI Runner；本地历史默认不保存，用户主动确认后才写入 localStorage，可一键清空。

Q: 怎么自测这个插件装好了没？

A: 在仓库根目录运行 node _selftest.mjs。它会用 mock 的 ctx.skills.registerProvider 验证 SKILL.md 能否被扫描到，以及 get() 能否正确返回正文，输出 candidates: N | unique: N 与 OK。失败时会打印 FAIL 并以非零状态退出。

上手难度

入门 — 装上就能在对话里用自然语言提问；如果想深入使用 Dashboard 或自行运行本地引擎 CLI，需要熟悉 pnpm 10.26.1 与 Node 24.12.x，但对纯对话用户无门槛。

已知问题与限制

• v1.0.0 中明确不实施的能力：细粒度安全文案扫描（P0-03）、能力状态四维拆分（P1-02）、riskSafetyGate 与执行阻断类安全 CLI（P3-04）、完整输入历史持久化——按产品决策保持"不保存"更严格
• 健康问题只作文化参考，不替代医疗；中医养生不得作为处方、剂量或疗效保证（见 skills/RULES.md 第 1 节）
• 真太阳时必须外部核验经度、IANA 时区、历史 UTC 偏移与夏令时证据；不能核验时只能走民用时间降级并显式标注（见 skills/RULES.md 第 7 节）
• Python 工具（skills/scripts/*.py）只作为离线 oracle 与命令行交叉验证，不作为对话计算数据源（见 skills/AGENTS.md Non-negotiable boundaries）
• 不提供远端账户、同步、服务端 session、持久 token 或远程计算；结果包固定 inputIncluded: false、replayable: false，不暴露原始输入也不可重放（见 skills/CHANGELOG.md v1.0.0 Privacy 段）
• 完整生辰、具体地点、可识别身份信息不写入日志、field-journal、fixture、报告或评测（见 skills/RULES.md 第 2 节）

把「玄枢 · 中华传统智慧」Skill 封装为 DeepSeek Harness（dsh） 插件，让你在 dsh 对话里直接调用一套本地优先的中国传统文化咨询工作流。

A dsh (DeepSeek Harness) Cordis plugin that packages the "Chinese Traditional Wisdom" Skill (玄枢) so you can invoke a local-first traditional-culture consultation workflow directly from a dsh conversation.

这是什么

本仓库是一个 dsh Cordis 插件（由 skill2dsh 生成），它把 Skill chinese-traditional-wisdom-ai-agent-workflow（产品名 玄枢）原样打包进 dsh。装上之后，当你在 dsh 里提出人生困惑、健康调养、事业决策、婚恋、择居、占问或传统文化相关问题时，dsh 会加载这个 Skill，由 AI Agent 按 SKILL.md 的路由规则调用本地确定性引擎完成排盘与推演，再分层输出事实、文化解释与现实建议。

玄枢本身是一个本地优先的传统文化参考工具：

• 核心计算（八字、紫微、六爻、梅花、奇门、大六壬、太乙、五运六气、体质、风水、姓名等）在本地纯 TypeScript 引擎中运行，不把完整生辰上传到远端。
• 模型不自行推演或补全干支 / 数值；所有确定性事实来自本次本地引擎结果（ToolEnvelope）。
• 输出严格区分「本地计算事实 / 传统文化解释 / 现实行动建议 / 免责声明」四层，避免把文化阐释误当确定结论。
• 附带一个 Dashboard（24 个工作区），可本地浏览盘面、修改输入并查看可视化结果。

⚠️ 传统文化参考，非绝对预测。本插件不构成医疗诊断、投资建议或现实结果保证。详见下方「使用边界」。

包含哪些能力

底层共 32 个本地 CLI 工具（时间校准 1 + 排盘 / 日用 22 + 联合分析 9），完整名称、输入契约与 fixture 见 skills/tool-index.md。

安装到 dsh

dsh plugin add github:dhicoc/dsh-chinese-traditional-wisdom-skill

该命令会把插件加入当前 profile 的 package.json（dependencies + dsh.profile.bundles）并安装到 node_modules/@dhicoc/。重启 dsh web 后即可在对话中调用。

手动安装：把 "@dhicoc/dsh-chinese-traditional-wisdom-skill": "github:dhicoc/dsh-chinese-traditional-wisdom-skill" 同时加入 profile 的 dependencies 与 dsh.profile.bundles，再 pnpm install。

在 dsh 中怎么用

安装并重启后，直接用自然语言描述问题即可，例如：

• “帮我用八字看一下 1990 年农历 X 月 X 日 X 时出生的四柱和喜用神”
• “想用六爻占一下要不要换工作”
• “紫微斗数排个盘”
• “查一下今天的黄历宜忌”

Agent 会先确认缺失的必要输入（出生时间、性别、起卦方式等，不会猜填），再调用本地引擎计算，最后分层给出结果。

仓库结构

lib/index.js          # dsh 插件扫描器：递归发现 skills/ 下的 SKILL.md，并用 ctx.skills.registerProvider 注册
skills/               # 原样 vendored 的玄枢 Skill 内容（SKILL.md + 配套 .ts/.py 资源 + Dashboard），未经转换器修改
  SKILL.md            # Skill 主入口：路由、调用顺序与输出规范
  RULES.md            # 伦理、隐私、健康与输入完整性边界
  apps/visual/        # Dashboard + 纯 TypeScript 引擎 + 测试
  bootstrap/          # 分领域使用说明（八字 / 紫微 / 六爻 / 梅花 / 风水 …）
  knowledge-base/     # 传统文化资料与本地确定性映射表
  tool-index.md       # 32 个本地工具清单、标准 fixture 与 CLI 参考
cordis.patch.yml      # dsh bundle 注册描述（id: chinese-traditional-wisdom-skill）
package.json

开发 / 自测

node _selftest.mjs     # 用 mock 的 ctx.skills 验证「发现 SKILL.md + get() 返回正文」

发布

本插件通过 GitHub Actions（.github/workflows/publish.yml）发布到 npm：

• 触发方式：推送 v* tag（如 v1.0.0）或在 GitHub 创建 Release。
• 发布命令：npm publish --access public，使用仓库 secret NPM_TOKEN 鉴权。
• 包名：@dhicoc/dsh-chinese-traditional-wisdom-skill。

使用边界与隐私

• 不把传统文化结果当作绝对预测，也不替代个人判断、法律意见、财务建议或医疗服务。
• 健康问题出现症状、急性不适或持续困扰时，应优先就医。
• 不在日志或提交中保存完整生辰、精确地点或可识别身份信息。
• 完整伦理与安全规则见 skills/RULES.md。

许可证

MIT