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 下跌原因并生成中文报告」
- DCS 取基础件池：
dsh-quant-data-mcp::quote + 外部因果推断 mcp::causal_inference + docx_gen::create
- 内置 rule 规划
input → transform → output 拓扑，生成 stock_causal_report CapabilitySpec
- 过
ctx.aspGuard（side_effects: ["write-file"] → verdict: pass）
- 注册为
capabilityRegistry 并以 defineTool 暴露
- 调用：
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
