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 个确定性工具 + 珠子数据 + 静态资源

目录结构

packages/
  ontology/                  # 本体插件（单包，含 host 半区 + client 半区）
    src/                     # host 半区：工具、规则引擎、数据
      index.ts               # 注册 5 个工具
      bazi.ts                # 八字排盘（纯日历数学）
      wuxing.ts              # 旺衰 / 喜用神推理
      solver.ts              # 款式求解（珠子组合枚举）
      propose.ts             # 本体一链推理
      designs.ts             # 保存/恢复方案（storage domain）
      assets.ts              # /beads 静态路由 + catalog
      data/                  # 珠子库 / 五行规则 / 款式模板（schema v3）
      client/                # client 半区：SVG 渲染 + 换珠子编辑器
    assets/beads/            # 35 张珠子图片
    tests/                   # 7 个测试文件
  presets/
    bazidiy/                 # preset：手串定制助手角色
      agent.cordis.yml       # persona + 工具集 + 严格流程
      preset.yml             # 显示元数据

五个工具

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

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

角色（preset）

presets/bazidiy/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. 将 presets/bazidiy 放进 dsh 的 preset 扫描目录（apps/cli/config/agent-presets/），并设 default: bazidiy

依赖的 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