agentic-control-plane/dsh-acp-plugin
30最近提交 2026年8月14日
dsh-acp-plugin DSH 插件
dsh-plugin-acp 是一个原生 Cordis 插件，在 DeepSeek Harness 中拦截工具调用以执行策略决策。它在每次调用前检查策略，记录允许、阻止及原因。插件支持交互式和无人值守模式，并具有不同的失败姿态。
如何安装 dsh-acp-plugin DSH 插件
dsh plugin --profile <your-profile> add dsh-plugin-acp来源命令需要人工核对。复制不会执行命令。
dsh-acp-plugin DSH 插件数据来源
dsh-acp-plugin DSH 插件快照日期：2026年8月16日
discovered
dsh-acp-plugin DSH 插件能做什么
- 工具调用前策略决策：允许、拒绝或请求批准。
- 工具调用后输出扫描，支持服务器端阻止或阴影模式通知。
- 通过 YAML 或环境变量可配置管理基础 URL、代理层级和超时时间。
- 优雅的失败处理：交互式会话失败开放（带警告），无人值守会话失败关闭。
- 无需构建步骤、无依赖、纯 ESM，可直接通过 npm 或 GitHub 安装。
dsh-acp-plugin DSH 插件适合哪些场景
- 对 DSH 代理的每个工具调用强制执行组织安全策略。
- 审计所有工具调用决策，用于合规性和故障排查。
- 在无人值守自动化工作流中阻止未经授权的操作。
- 在完全阻止前，通过阴影模式逐步测试策略执行效果。
- 集成自托管或云端的 Agentic Control Plane 网关。
dsh-acp-plugin DSH 插件适合谁
- 需要对 AI 代理行为进行治理和策略控制的团队。
- 在生产环境中使用 DeepSeek Harness 且有合规要求的企业。
dsh-acp-plugin DSH 插件的限制
- 需要有效的 ACP 令牌或凭证文件才能运行。
- 依赖于 Agentic Control Plane 服务（云端或自托管）可达。
- 不支持输入重写，仅支持执行前和执行后检查。
- 阴影模式仅记录将被阻止的内容，不实际阻止。
dsh-acp-plugin DSH 插件的仓库 README 摘录
以下文字摘自 dsh-acp-plugin DSH 插件的上游仓库 agentic-control-plane/dsh-acp-plugin 的 README，版权归原作者，仅作引用。
This is a native Cordis plugin on dsh's typed interception points, not a shell-hook shim. It registers on: - `tools/pre-execute` — the policy decision. `allow` lets the call through, `deny` blocks it with the reason in the trajectory, `ask` hands off to dsh's own approval flow. - `tools/post-execute` — output scanning. A server-side block turns the result into corrective feedback; shadow-mode notices surface what enforcement *would* have done. ## Install ```sh dsh plugin --profile <your-profile> add dsh-plugin-acp export ACP_BEARER_TOKEN=gsk_... # or keep it in ~/.acp/credentials dsh --profile <your-profile> ``` No build step, no dependencies, plain ESM. Installing from git works too (`dsh plugin add github:agentic-control-plane/dsh-acp-plugin`) and needs no build allowance. Get a key at [cloud.agenticcontrolplane.com](https://cloud.agenticcontrolplane.com). No key? The plugin says so loudly and stays out of the way — it never bricks a session. ## Configuration Override the row in your profile's `cordis.patch.yml`: ```yaml - id: acp name: dsh-plugin-acp config: governBase: https://govern.agenticcontrolplane.com # or your self-hosted gateway agentTier: interac
阅读完整 README仓库许可: MIT
dsh-acp-plugin DSH 插件常见问题
如何安装 ACP 插件？
运行 `dsh plugin --profile <your-profile> add dsh-plugin-acp`。然后设置 `ACP_BEARER_TOKEN` 环境变量，或将凭证保存在 `~/.acp/credentials` 中。之后使用你的配置文件启动 DSH，插件即可激活。
如果控制平面不可达会发生什么？
对于交互式会话，工具调用会继续，但会记录 `[ACP] ⚠ UNGOVERNED` 警告，并将一条记录写入 `~/.acp/lapse.log`。对于无人值守代理，调用会被阻止（失败关闭），以防止未经治理的操作。
如何配置管理基础 URL？
你可以设置 `ACP_GOVERN_BASE` 环境变量，或在配置文件的 `cordis.patch.yml` 中通过 `governBase` 配置项设置。默认值为 `https://govern.agenticcontrolplane.com`，你可以指向自托管网关。
这个插件和 Claude Code 钩子有什么区别？
本插件是原生 Cordis 插件，使用 DSH 的类型化拦截点，提供完整的策略执行。Claude Code 钩子（`@deepseek-ai/dsh-hooks-claude-code`）运行未修改的 `hooks.json`，配合 `govern.mjs` 工作，支持拒绝和请求审批，但不支持输入重写。原生插件是推荐路径。
使用这个插件需要密钥吗？
是的，你需要一个来自 Agentic Control Plane 的令牌。可以在 [cloud.agenticcontrolplane.com](https://cloud.agenticcontrolplane.com) 获取密钥。没有密钥时，插件会发出大声警告并保持不干扰，不会导致会话崩溃，但不会执行任何策略。