能力合成引擎 helibeiqi/dsh-dcs-engine

dsh-dcs-engine (DCS)

Dynamic Capability Synthesis Engine —— 在运行时把零散基础工具合成为可命名、注册、复用、持久化的 DSH Capability。

定位

dsh-dcs-engine（DCS）是 DSH 协议栈的 Host 组合层，同时是五件套的 消费方与演示载体（credit engine）：

- CDP（ctx.cdpRegistry）— 消费语义（cognitive_style / semantic_tags / boundaries）做候选打分，不定义元数据
- 意图网络（ctx.intentNetwork）— 复用其 plan()，否则内置 rule 拓扑规划，不替代编排
- CSP（ctx.cspStore）— 仅写入 decision_trace，不描述思考
- ASP（ctx.aspGuard）— 注册前强制过审 side_effects，不自行审查
- universal-adapter — 仅消费其桥接进 ctx.tools 的 mcp::* 工具，不桥接

DCS 正交协同，不替代任何一件——它把既有的五件套「真正用起来」，并证明这套协议栈「被用起来」后能产生什么。

版本区间与警告

- DSH 版本区间：@deepseek-ai/cordis >= 0.1.0、@deepseek-ai/dsh-tools >= 0.1.0
- ⚠️ Developer Preview：M2 阶段 materializer 已可生成完整可部署的 dsh-cap-<id> 插件骨架（含 package.json / tsconfig.json / cordis.patch.yml / .cdp.json / capability.json / README.md / src/index.ts）；合成策略默认 rule（零 LLM）。
接口在 0.1.x 内可能变动，生产用途请等待 1.0 稳定版。

安装

从 GitHub 安装
dsh plugin --profile web add github:helibeiqi/dsh-dcs-engine

从 DSH 插件 registry 安装
dsh plugin --profile web add dsh-dcs-engine

本地路径安装
dsh plugin --profile web add "file:./dsh-dcs-engine"

配置字段

| 字段 | 说明 | 默认 |
| sources | 基础件来源，capabilitiesDir 产物/示例目录 | { capabilitiesDir: "./capabilities" } |
| synthesizer | 合成策略 strategy(rule/llm/hybrid)、fallbackToLLM、maxCandidates | { strategy: "rule", fallbackToLLM: true, maxCandidates: 20 } |
| registry | deduplicate(语义哈希去重)、autoRegisterTools(defineTool 包装) | { deduplicate: true, autoRegisterTools: true } |
| materializer | enabled(M2 完整插件骨架)、format(当前仅 plugin-skeleton) | { enabled: false, format: "plugin-skeleton" } |
| safety | requireAsp(无 ASP 拒绝)、blockOnFail(不通过拒绝注册) | { requireAsp: true, blockOnFail: true } |

⚠️ 配置仅识别上述五个字段。禁止 servers / pluginDirs / export / router / naming / schema 等。

端到端示例

意图：「分析 AAPL 下跌原因并生成中文报告」

1. DCS 取基础件池：dsh-quant-data-mcp::quote + 外部因果推断 mcp::causal_inference + docx_gen::create
2. 内置 rule 规划 input → transform → output 拓扑，生成 stock_causal_report CapabilitySpec
3. 过 ctx.aspGuard（side_effects: ["write-file"] → verdict: pass）
4. 注册为 capabilityRegistry 并以 defineTool 暴露
5. 调用：

const registry = ctx.get('capabilityRegistry');
const spec = await registry.synthesizeAndRegister('分析 AAPL 下跌原因并生成中文报告'); const report = await registry.invoke(spec.id, { symbol: 'AAPL' });

导出骨架（--persist 触发 materializer）：

npx tsx scripts/dcs-synthesize.ts --intent "分析 AAPL 下跌原因并生成中文报告" --persist
→ capabilities/stock_causal_report.capability.json

安全说明

- 合成产物注册前必须过 ctx.aspGuard；verdict=fail 且 safety.blockOnFail 时抛 SynthesisRejectedError。
- 无 ASP 且 safety.requireAsp=true 时拒绝注册（安全优先，asp_verdict: unknown）。
- side_effects 在 cdp 与 safety 两处对齐，供审查留痕。
- 所有文件 IO 经路径白名单（仅 capabilitiesDir / outDir）。

已知局限

- 合成策略默认 rule（零 LLM 开销）；hybrid / llm 依赖 ctx.llm 签名（best-effort，不强制）。
- materializer 生成的 src/index.ts 使用通用输入映射（{ ...userInput, ...predecessorOutputs }），需人工 refine 各步工具的精确参数 schema 与 guard 接线。
- 无 CDP 时退化为关键词匹配，语义精度有限。
- 无 ASP 时 safety.asp_verdict = "unknown"，requireAsp: true 下会拒绝注册。

License

MIT