八字五行手串定制ZiFan1117/bazidiy

BaziDIY 八字五行手串定制

基于 DeepSeek Harness（dsh） 的八字五行手串定制助手。把「八字排盘 → 喜用神 → 珠子匹配 → 款式方案」这一套需要专业玄学与工艺知识的手艺，做成一个 AI 可用的插件，让用户通过对话即可定制一条五行手串。

本项目是 dsh 的插件集合，依赖 dsh 运行（@deepseek-ai/dsh- 0.1.1-rc.x）。不包含 dsh 本体，也不内置任何 API Key——模型 Key 由使用者在 dsh 层自行配置。

设计理念：确定性工具 + LLM 编排

AI 大模型是「概率生成」，直接让它算八字、配珠子，会一本正经地胡说八道。本项目的核心原则是分层：

| 层 | 谁来管 | 说明 |
|---|---|---|
| 对不对（八字排盘、五行喜用神、珠子匹配、款式求解） | 确定性工具（代码） | 有客观对错，由规则引擎精确计算，禁止 LLM 自算 |
| 好不好（怎么解释、怎么推荐、说话的温度） | LLM | AI 只负责编排流程、解释结果、做个性化推荐 |

一句话：把「算账」交给工具，把「聊天」交给 AI。

架构

dsh 内核（agent-loop + session-log + tools 注册表 + LLM 适配 + Web UI）
▲                              ▲
│ preset 组合                   │ client 插件
│ agent.cordis.yml              │ @bazidiy/ontology/client
┌────┴────────────┐           ┌──────┴─────────────┐
│ 手串定制助手角色 │           │ 手串 SVG 渲染       │
│ （编排 + 话术）  │           │ 换珠子编辑器        │
└─────────────────┘           └────────────────────┘
│ 调用工具
▼
@bazidiy/ontology（host 半区）
5 个确定性工具 + 珠子数据 + 静态资源

目录结构

atoms/                       # 【唯一真源】每个原子一个文件夹：文档+代码+测试+资源 同夹
bazidiy.kb/                # 知识本体原子：atom.md · impl/(绑定) · tests/ · assets/beads(35图)
bazidiy.calculate_chart/   #   · tools/
bazidiy.infer_verdict/     #  （…其余每个原子同构：atom.md · detail.json · impl/ · tests/）
…（共 16 个 bazidiy. 原子）＋ bazidiy.plugin/   # 插件装配原子：impl/(壳代码) · pkg/(打包配置)
__shared/                  # 跨原子共享（bazidiy.framework 契约/判据 + 集成测试）
tools/
sync-atoms.mjs             # 原子真源 → 组装 .build/ontology（src/_atoms + tests + assets + persona）
gen-ossie-db.mjs           # 建库+自检（源在 atoms/bazidiy.kb/kb/ossie/data）
gen-bindings.mjs           # DB → atoms/bazidiy.kb/impl 绑定 + kb/*.ttl
ossie-validate.mjs         # Apache Ossie 官方 validator（4 文档闸）
contract-check.mjs         # 原子契约回归（先跑 sync 组装 .build）
check-imports.mjs          # 引用纪律：原子真源只允许相对/裸包 import
check-encoding.mjs         # 编码闸：UTF-8 无 BOM + 无 GBK mojibake 残码
check-deps.mjs             # 依赖透明闸：atom.md/detail.json 的 deps == 真实 import（--fix 回写）
.build/ontology              # 组装视图（gitignore；发布/打包输入）
dist/                        # 产物（tgz）

规则：改代码/测试/资源只动 atoms//…；发布/回归前 node tools/sync-atoms.mjs。桌面插件由组装视图打包，桌面端安装为快照不受重构影响。

五个工具

| 工具 | 输入 | 输出 | 说明 |
|---|---|---|---|
| calculate_bazi | 公历生日、时辰、性别 | bazi_result | 八字四柱 + 日主五行 |
| propose_designs | 珠子限定、腕围、日主五行、月支五行 | design_proposal | 喜用神 + 珠子分类 + 款式方案 |
| generate_design | 款式、珠子序列、腕围、说明 | design_result | 最终手串方案（校验珠子全称） |
| save_design | 方案数据 | design_saved | 按会话保存方案 |
| load_design | — | design_loaded | 恢复当前会话的方案 |

工具只做确定性计算，不调 LLM。generate_design 会拒绝缩写珠子名（如「小叶紫檀」必须全称）。

角色（preset）

atoms/bazidiy.assistant_preset/impl/agent.cordis.yml 定义了一个「手串定制助手」角色（persona），通过 system prompt 约束 AI：

- 严格流程：缺信息先问 → 算八字 → 提方案 → 用户确认款式 → 出图 → 用户想换则换款（不重算八字）
- 硬约束：禁止 AI 自己算旺衰/编造珠子名/展示八字内部细节/每次回复超过 150 字
- AI 的自由：从工具返回的多个方案里挑最合适的、用通俗话解释五行、按用户偏好换款

在 dsh 中加载

本项目是 dsh 的插件，需在 dsh 环境内加载（开发源码或对应 npm 包环境）：

1. 将 packages/ontology 作为 dsh 的 workspace 包（或 npm 依赖）加入
2. 在 dsh 的 packages/bundle/web-app/cordis.patch.yml 挂载 client 半区（name: '@bazidiy/ontology'）
3. 将 atoms/bazidiy.assistant_preset/impl（agent.cordis.yml + preset.yml）放进 dsh 的 preset 扫描目录（如桌面端 ~/.dsh/.agent-presets/bazidiy/），新会话即可选「八字手串定制」persona。

依赖的 dsh 包（peerDependencies）：@deepseek-ai/dsh-tools、dsh-host-webserver、dsh-storage-domain、dsh-client-ui-tool、dsh-client-ui-slots、dsh-client-runtime 等（对应 dsh 0.1.1-rc.x）。

模型 Key

本项目不内置、不管理任何 API Key。使用者在 dsh 层通过环境变量 DEEPSEEK_API_KEY（优先级最高）或 dsh 的凭据文件配置自己的 Key，与插件完全解耦。

许可

GPL-3.0 © BaziDIY