MkaliezZ/dsh-agentfuse-plugin

AgentFuse

面向 AI 代理的确定性、故障关闭式工具调用授权——并附带证据。
状态： ALPHA · 正在寻找首个真实（非自用）部署

AgentFuse 是一个面向具备副作用能力的 AI 代理工具的预派发策略边界，移植自 DHMS AgentFuse Python 项目
（MkaliezZ/dhms-engine）。

AGENTFUSE_IS_A_DANGER_CLASSIFIER=false
AGENTFUSE_IS_A_POLICY_AND_AUTHORIZATION_BOUNDARY=true
AGENTFUSE_DECISIONS=allow|block
AGENTFUSE_DEFERRALS=ask
AGENTFUSE_FAILS_CLOSED=true

被阻止的调用是一项已完成的策略决策，并附带未执行证据——
绝不是一次失败的工具执行。证据携带原因代码、策略 id 以及
规范化参数哈希，绝不包含原始参数或凭据。

包

| 包 | 是什么 | 依赖于 |
|---|---|---|
| packages/core · @dhms-agentfuse/core | 框架无关的引擎：决策/证据词汇表、确定性策略解析、规范化哈希 | 无 |
| packages/dsh-agentfuse · @dhms-agentfuse/dsh-agentfuse | DeepSeek Harness 防护插件：经过测试的 tools/pre-execute 门控、DSH 配置 schema、持久化的 agentfuse/decision 会话事件，以及宿主拥有的审批延迟（askTools） | @dhms-agentfuse/core、DSH |

核心定义了有界策略词汇表；DSH 包是一个
实验性适配器。潜在的未来集成记录在
路线图中，但此处尚未实现。

快速开始（DeepSeek Harness）

cordis.yml (或 cordis.patch.yml 插入片段)
- id: agentfuse
name: '@dhms-agentfuse/dsh-agentfuse'
config:
defaultAction: block      # 故障关闭式兜底
denyTools: []             # 确定性阻止，始终优先
askTools: []              # 延迟至 DSH 人工审批链
allowTools: []            # 非空 = 仅这些名称可以运行
logDecisions: false       # 持久化证据；需要仓库内目录

有关策略顺序、审批集成以及安装路径（bundle + PR），请参阅
适配器 README。

跨适配器一致性

DSH 适配器使用提供商中立的 DHMS AgentFuse v3.6.2 fixture
快照，并带有源提交和 SHA-256 溯源信息。针对 DeepSeek Harness
提交 99f6f02fecdb7dff40c3fbc9470f5907c29f74ca，真实的集成
tools/pre-execute 路径记录了 11 个 PASS 和 3 个明确说明理由的 N/A 用例；
它并不声称覆盖未包装或未来的 DSH 路径。

请参阅适配器一致性说明
以及已检入的 fixture 溯源信息。

仓库布局

packages/
core/            @dhms-agentfuse/core — 零运行时依赖
dsh-agentfuse/   @dhms-agentfuse/dsh-agentfuse — DSH 适配器（bundle）
ROADMAP.md         阶段、版本线、停止线

与 DHMS 的关系

AgentFuse 是 DHMS（Digital Hyperthymesia
Memory Systems）的运行时执行控制线。该引擎是
dhms_agentfuse 的决策引擎和 agentfuse-evidence-schema-v0.1 的忠实 TypeScript 移植；
决策与执行仍然是分离的生命周期事实。

许可证

Apache-2.0。参见 LICENSE。