dsh-shadow-mind：DeepSeek Harness 的并行认知运行时

前言¶

DeepSeek Harness（DSH）采用插件化架构，在开发多智能体工作流时，如果仅依赖单一主代理，往往难以实现独立的审查、事实核查或并行认知处理。dsh-shadow-mind 是一个移植自 pi-shadow-mind 的 DSH 插件，它在 DSH 运行时中实现了并行认知能力。

该插件在主代理的每个回合结束后，通过心跳调度器随机激活配置好的“阴影代理”。这些阴影代理拥有独立的责任、工具权限和运行超时，能够在主代理进行任务处理的同时，提供独立的视角和辅助工作。

核心功能¶

插件目前包含以下已实现的核心能力：

心跳调度：在主代理的每次回合结束后，根据配置的概率随机激活已启用的阴影代理。
受限工具阴影：阴影代理仅接收经过清理的主会话轨迹和显式的工具白名单。默认白名单为只读，可配置其他工具以扩大访问范围。
单次运行超时：每个阴影运行都有 timeout_seconds（或配置默认值）的限制，超时运行会被中断并释放槽位。
生命周期清理：通过 subagent/end 事件移除已完成的阴影运行，确保活跃计数准确。
管理工具：通过模型工具即可创建、更新、删除、列出、启用或禁用阴影定义。
配置工具：通过模型工具读写全局配置，写入前会验证合并结果。
暂停/恢复/纪元：支持 /shadow pause 和 /shadow resume 命令。暂停会终止正在运行的阴影；新的用户输入会递增纪元并取消上一纪元的运行。
自动切换：通过 /shadow auto on|off 命令控制心跳激活功能。
工具调用参数脱敏：在将工具调用参数转发给阴影代理前进行脱敏处理，防止凭证泄露。

安装与启用¶

DSH 插件通过 Cordis 组合（配置文件或代理预设）加载。安装步骤如下：

使用以下命令将包安装到指定的 DSH 配置文件中：

dsh plugin --profile web add @winterchenhuan/dsh-shadow-mind@latest

重启 DSH 服务，插件即可加载。

若用于本地开发，需先构建包：

cd /path/to/dsh-shadow-mind
npm install
npm run build
dsh plugin --profile web add /path/to/dsh-shadow-mind

配置¶

全局配置存储在 ~/.dsh/settings.yaml 的 shadow-mind: 节中。同时，阴影定义文件位于 ~/.dsh/agent/shadow-minds/ 目录下。

全局配置示例¶

shadow-mind:
  heartbeatProbability: 0.33
  maxParallelShadows: 2
  defaultShadowTimeoutSeconds: 120
  defaultThinkingLevel: low

主要配置项包括：
* heartbeatProbability：每次回合激活阴影的概率（0 到 1）。
* maxParallelShadows：允许同时运行的阴影数量上限。
* defaultShadowTimeoutSeconds：未在定义中设置超时时使用的默认秒数。

阴影定义示例¶

---
id: grounded-reviewer
name: Project Grounding Checker
enabled: true
activation_probability: 0.6
run_with_model: openai/gpt-5-mini
thinking_level: low
tools:
  - read
  - grep
  - glob
---

检查主代理的声明是否得到当前工作区的支持。如果没有值得报告的内容，回复：NOT_RELEVANT。

使用方法¶

安装并重启 DSH 后，通过 Web 界面启动服务：

dsh web

常用命令¶

插件通过 /shadow 命令提供统一的控制接口：

/shadow status：查看当前状态（激活/暂停、自动模式、纪元、运行数量等）及配置诊断。
/shadow list：列出已定义的阴影。
/shadow probe <id> [tools]：手动运行指定阴影（不等待心跳），可选指定工具列表。
/shadow auto on|off：开启或关闭心跳自动激活。
/shadow pause：暂停所有阴影运行。
/shadow resume：恢复阴影运行。

操作流程¶

使用 /shadow status 确认插件已加载。
使用 /shadow list 查看可用的阴影定义。
使用 /shadow probe grounded-reviewer 手动测试一个阴影是否正常工作。
在主代理对话中，只要自动模式开启，阴影将按配置概率在主代理回合后自动激活。

注意事项¶

当前状态：这是一个功能原型。核心的心跳调度、受限工具、超时、生命周期清理和管理工具均已验证可用。
写入权限：持久化写入受 DSH 审批服务控制，当该服务挂载时，操作需要用户批准。
安全机制：工具调用参数在转发给阴影前会被脱敏；工具结果会被总结。
许可协议：插件使用 MIT 许可证。作为插件，它以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。

该插件是 DSH 生态中实现多代理并行认知的实用组件，适合需要在主代理旁增加独立审查或计算能力的场景。相关文档与源码可参考 DeepSeek Harness 生态目录或 GitHub 仓库。