DeepSeek Harness 插件：dsh-shadow-mind（后台影子代理审查）

前言¶

DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在多轮对话与工具执行的过程中，Root Agent（根代理）执行完一轮操作后，往往缺乏一个独立的、后台的审查机制来验证其发现或输出。dsh-shadow-mind 插件为 DSH 提供了一个独立的 bundle，在符合条件的 Root Agent 回合后启动全新的后台 Shadow Agents，验证其结构化发现，并将被接受的报告中继回 Root 会话，同时通过 Web UI 暴露配置和证据。

这是什么¶

这是一个由 whutzefengxie-ops 维护的独立版本化 DeepSeek Harness bundle。它利用 DeepSeek Harness 的扩展机制处理运行时、会话、子代理、权限和持久化。该插件旨在解决 Root Agent 在执行特定工具后缺乏自动审查的问题，通过启动独立的 Shadow Agents 进行后台审查，并将结果反馈给 Root 会话。

核心功能¶

后台代理启动: 在 Root Agent 完成符合条件的工具使用回合后，自动启动全新的后台 Shadow Agents。
结构化验证: 对 Shadow Agents 生成的发现进行结构化验证。
报告中继: 将通过验证的报告中继回 Root 会话。
Web UI 暴露: 在 Web UI 中暴露配置项和运行证据。
实时调度: 提供实时的调度设置，包括超时、报告批处理等。
Markdown 定义: 支持 Markdown 格式的 Shadow 定义文件。

安装与启用¶

安装前请确保 DSH 版本匹配。当前最新版本 v0.1.6 需要 DSH 0.2.0-rc.2。

安装插件：

    npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add github:whutzefengxie-ops/dsh-shadow-mind#v0.1.6

重启 Profile：安装完成后重启选定的 profile。
验证安装：运行以下命令检查配置是否生效，输出中应包含 shadow-mind-runtime 和 tool-shadow-mind。

    dsh --profile web --dump-config

移除插件：

    dsh plugin --profile web remove @whutzefengxie-ops/dsh-shadow-mind

典型用法¶

配置定义文件：
插件定义文件存储在 $DSH_HOME/shadow-minds/*.md。一个最小化的确定性接受定义示例如下：

    ---
    id: acceptance-reviewer
    name: Acceptance Reviewer
    enabled: true
    debug: false
    activation_probability: 1
    active_for_models:
      - '*'
    tools: []
    capture: since-compaction
    context: minimal
    think_first: true
    ---

    Review the completed task. If there is a concrete defect or missing requirement, return a concise report with verdict `challenge` or `gap` and only rendered sequence numbers in `refs`. Return `silent` when the review applies but adds nothing actionable, or `not_relevant` when it does not apply.

调试运行：
使用零依赖的调试工具追踪特定会话或运行：

    node tools/shadow-debug.mjs trace <childSessionId|runId|rootSessionId>

适用场景与注意¶

版本兼容性：v0.1.6 版本仅兼容 DSH 0.2.0-rc.2。旧版本插件需要对应版本的 DSH。
源码安全：GitHub 安装会使用提交的 lib/ 目录。该包没有 prepare 脚本，也不需要 pnpm allowBuilds 授权。
本地存储：Shadow 定义文件以 Markdown 格式存储在本地文件系统 $DSH_HOME/shadow-minds/*.md 中。
运行机制：运行时、会话、子代理等均使用 DeepSeek Harness 的扩展机制。

结尾¶

该插件适合需要在 Root Agent 执行后进行独立审查和验证的场景。更多配置细节和示例可参考 GitHub 仓库。