dhicoc/chinese-traditional-wisdom-skill

Chinese Traditional Wisdom Skill 中国传统文化整体智慧咨询 Skill

面向人生困惑、健康调养、事业决策、婚恋、择居、占问与传统文化学习的本地参考工具。

🌐 English

Stable release: v1.0.0 · Changelog · Release Notes

能做什么 · 开始使用 · 准备哪些信息 · 如何理解结果 · 进阶使用

传统文化参考，非绝对预测。 本 Skill 提供结构化计算、传统文化解释与建设性建议；不构成医疗诊断、治疗方案、投资建议或对现实结果的保证。

这是什么

Chinese Traditional Wisdom Skill 是一个本地优先的传统文化咨询 Skill。它帮助你把问题整理为适合查询的输入，使用本地确定性引擎生成可复核的盘面、日期、干支或规则结果，再将这些结果与传统文化解释、现实中的审慎建议分层呈现。

你可以将它用于理解传统文化框架，也可以把它当作一次咨询的辅助工具：先看结构化事实，再看传统解释，最后结合自己的实际处境作出判断。

你的问题
  → 选择合适的传统文化场景
  → 本地引擎计算可复核事实
  → 传统文化解释与建设性建议
  → 明确限制、免责声明与下一步行动

• 本地优先：核心计算在本地运行，不需要把完整生辰上传至远程服务。
• 不让模型猜算：盘面、干支、数值、映射与规则匹配由本地引擎产生；模型不得自行推演或补全。
• 结果可区分：区分本地计算事实、传统解释和现实建议，避免把文化阐释误当作确定结论。
• 适合持续使用：可在 Dashboard 浏览，也可由支持本地 Skill 的 AI Agent 调用。

能做什么

Dashboard 完整功能目录

Dashboard 当前提供以下 24 个工作区；其中计算型页面直接调用本地 TypeScript 引擎，知识型与本地存储页面会明确标示其参考或数据边界。

Dashboard 还提供：全局生辰资料管理、真太阳时核验/民用时间降级状态、命令面板导航、页面摘要复制、结构化报告导出，以及本地历史记录。

关于工具数量： Dashboard 的 24 个工作区是面向使用者的页面入口；项目另有 32 个本地 CLI 工具，其中包含真太阳时预处理、底层排盘/日用计算、体质问卷和多种联合分析。CLI 工具可与 Dashboard 页面一对多对应，完整名称、输入契约与可运行 fixture 见 tool-index.md。

开始使用

方式一：在 Dashboard 中使用

适合希望浏览盘面、修改输入并查看可视化结果的用户。

完整安装会同时安装 TypeScript 权威运行时和 Python 离线交叉验证依赖：

scripts\setup.bat
pnpm dev

Linux/macOS：

./scripts/setup.sh
pnpm dev

也可只在已经完成依赖安装的环境中直接进入 Dashboard：

cd apps/visual
pnpm dev

项目使用 Node 24.12.x、pnpm 10.26.1 与 pnpm-lock.yaml 固定依赖版本；不要生成或提交 package-lock.json。打开本地地址后，选择相应页面并填写必要信息。Dashboard 使用本地 TypeScript 引擎计算；结果中的 local-exact、local-approx、民俗体验、演示或降级状态会说明其计算口径与可用性。

方式二：通过 AI Agent 使用 Skill

将本仓库作为本地 Skill 安装或加载后，先让 Agent 阅读 SKILL.md 与 RULES.md。Agent 应当：

1. 先理解你的问题、场景和所缺信息；缺少必要输入时向你追问，而不是猜填。
2. 选择本地工具计算确定性事实；不得把模型记忆或参考文本冒充为本次计算结果。
3. 将计算事实、传统文化解释、现实建议和免责声明分开说明。

AI Agent 的完整调用约定见 README_AI.md。

准备哪些信息

不同场景所需信息不同。只提供与问题有关的信息即可；不确定的字段应明确说明，不要为了“凑全”而猜测。

关于真太阳时

民用出生时间不等于真太阳时。本 Skill 提供 resolve_true_solar_time 作为本地校正入口，但只有在地点与历史时区证据已经外部核验时，才能使用 trueSolarBirth 或 trueSolarResolution 并标记为真太阳时结果。

无法可靠核验时，可以在知情前提下使用民用时间路径：timeBasis: 'civil-unverified' 与 civilFallbackConfirmed: true。该结果必须显示“未完成真太阳时复核”，不能称为真太阳时结果。

如何理解结果

一次好的使用方式，是将输出分为三层阅读：

1. 本地计算事实：如四柱、日期、干支、宫位、映射、数值和规则关系。这些来自本次本地引擎结果。
2. 传统文化解释：如不同流派对结构的含义、象征和思考角度。它们属于文化参考，不是客观预测。
3. 现实行动建议：如沟通、记录、休息、寻求专业协助或重新评估选择。它们应保持建设性、非宿命化，并由你结合实际情况决定是否采用。

八字动态层

需要查看指定日期的大运、小运、流年、流月或流日时，使用既有 bazi_calculate 并提供严格格式的 transitDate: "YYYY-MM-DD"。结果仍为本次 ToolEnvelope，动态事实位于 ToolEnvelope.data.transit。

小运按虚岁定位。若 minor.source 为 lunar-exact，表示结果来自本地历法序列；若为 local-fallback，表示采用确定性本地降级规则，解读时必须披露。干支关系只说明可复核的规则事实，不能直接推出事业、婚恋、健康、财富或其他现实结果。

详细的动态层输入、输出和 claims 说明见 bootstrap/bazi-engine.md。

使用边界与隐私

• 不把传统文化结果当作绝对预测，也不以此替代个人判断、法律意见、财务建议或医疗服务。
• 健康问题出现症状、急性不适或持续困扰时，应优先就医；本 Skill 不提供诊断、处方或替代治疗建议。
• 不要在长期日志、公开案例或提交记录中保存完整生辰、精确地点或可识别身份信息。
• 不确定、不完整或无法核验的输入必须保留限制说明；不得将近似、演示或民用时间结果表述为精确结论。

完整伦理与安全规则见 RULES.md。

进阶使用

本地 CLI

开发者或支持 CLI 的 Agent 可直接运行本地工具：

cd apps/visual
pnpm install --frozen-lockfile
pnpm engine  

需要比较明确规则配置时，可运行：

pnpm engine:compare-rules src/__fixtures__/analysis/rule-comparison-bazi.success.json

engine:compare-rules 是 32 工具之外的独立只读分析入口，只比较结构化字段并列出每个规则来源，不推荐或裁定某一流派。

查询《周易》六十四卦时，可按编号、卦名、上下卦或六爻结构调用：

pnpm engine:iching-lookup src/__fixtures__/analysis/iching-lookup.success.json

engine:iching-lookup 同样不增加 registry 工具数；它只返回本地规范卦序、原文、错综互卦和显式动爻所成变卦，不由模型自行换算。

在尚未确定工具和参数时，可先运行只读规划器：

pnpm engine:plan --query "想看今年事业"

规划器不排盘、不计算，也不回显原始咨询内容；它只列出候选工具、缺失字段、风险提示和建议深度。输入方式和输出字段见 tool-index.md。

除 resolve_true_solar_time 直接返回 TrueSolarTimeResolution 外，CLI 返回 JSON ToolEnvelope。呈现确定性事实前，应只从本次 ToolEnvelope.data 提取结构化 claims，再调用对应本地 validate*Claims(data, claims) 核验；该校验不能验证自由文本、传统解释、建议或预测。

标准 success fixture、所有工具名与 CLI 示例见 tool-index.md。

关键资源

本地数据分片与性能预算

大型字义、古籍全文索引和解梦全量库均由源数据生成分片：字义 32 片、全文索引 4 片、解梦 22 片。pnpm check:bundle-budget 在生产构建后检查首屏、gzip chunk、分片源文件和已移除的 12MB 公共单文件，CI 不通过提高 Vite 告警阈值掩盖回归。

开发验证

改动引擎、输入契约、Dashboard 或公开文档后，在 apps/visual 运行：

pnpm typecheck
pnpm test:unit
pnpm test
node scripts/check-doc-contracts.mjs
pnpm build
pnpm test:e2e

文档契约检查会确保公开工具清单、CLI、fixture 和关键使用约定保持一致。仅修改文档时，至少运行文档契约检查与 git diff --check；完整质量门以根 package.json、.github/workflows/ci.yml 和 tool-index.md 为准。

仓库结构

apps/visual/
  scripts/run-engine.ts        # 本地 CLI 入口
  src/legacy/                  # 纯 TypeScript 引擎、ToolEnvelope 与校验器
  src/__fixtures__/local-tools/# CLI 标准输入样例
bootstrap/                     # 分领域使用说明
knowledge-base/                # 传统文化资料与本地确定性映射表
templates/                     # 报告模板
SKILL.md                       # Skill 主入口
RULES.md                       # 安全与伦理规则