🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

whutzefengxie-ops/dsh-shadow-mind

DeepSeek Harnessspec-screened扫描:中风险在 GitHub 查看 ↗
⚠ 装前注意

这是一个独立版本化的 DeepSeek Harness 组合包。符合条件的 root agent…

基本兼容但装前注意:未发布到 npm registry,仅可从源码安装 · 最近上游提交 2026/9/20 · 已提供中文文档

DeepSeek Harness 的独立 Shadow 代理编排插件

综合分
34.1
GitHub 分
34.1
用户评分
—
★ Stars
6
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add whutzefengxie-ops/dsh-shadow-mind
未发布到 npm registry,仅可从源码安装,改用 GitHub 源安装
信任档位:已验证本站已于 4 天前真实安装成功(L4 · 真实安装)
是什么
dsh 原生插件 · market
装得上吗
本站已真实安装成功(L4 · 真实安装,非静态推断)
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 5 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

🟢实装验证通过· 2026/9/22
由本站实装验证器在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/22(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包@whutzefengxie-ops/dsh-shadow-mind(未发布到 npm,仅可源码安装)
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

未发布到 npm registry,仅可从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/22 08:27:20

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/cordis-plugin-loader@deepseek-ai/dsh-agent@deepseek-ai/dsh-agent-loop@deepseek-ai/dsh-agent-loop-testkit@deepseek-ai/dsh-api-remotes@deepseek-ai/dsh-atomic-write@deepseek-ai/dsh-brand@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-ui-commands@deepseek-ai/dsh-client-ui-conversation@deepseek-ai/dsh-client-ui-chat
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
dsh-shadow-mind

这是一个独立版本化的 DeepSeek Harness 组合包。符合条件的 root agent 工具轮次结束后,它会启动全新的后台 Shadow agent,校验结构化发现,把被接受的报告持久化转发给 root,并在 Web 界面中提供配置和执行证据。

版本兼容性

| dsh-shadow-mind | 所需 DSH 版本 | 说明 |
|----------------|--------------|------|
| v0.1.3–v0.1.4  | 0.1.6-alpha.2(已验证基线) | 校验器工厂与 Workspace 管理的 Session 导航 |
| v0.1.2         | 0.1.5-rc.2(已验证基线) | 修复 subagent setup 绑定与实时退化输出看门狗 |
| v0.1.1         | >=0.1.5-rc.1

开发时可安装本地 checkout:
sh
dsh plugin --profile web add /path/to/dsh-shadow-mind

安装后重启对应 profile。无需启动 Web 服务即可检查组合结果:
sh
dsh --profile web --dump-config

输出必须包含 shadow-mind-runtime 和 tool-shadow-mind。更新时用新的已审查 SHA 再执行一次 add;卸载命令是:
sh
dsh plugin --profile web remove @whutzefengxie-ops/dsh-shadow-mind

GitHub 安装直接使用仓库提交的 lib/。本包没有 prepare 脚本,不要求在 pnpm 中配置 allowBuilds。

配置

进入 设置 → 插件 → Shadow Mind。该页面提供:

- 超时、报告批处理、模型路由、reasoning effort、披露策略和长度上限等实时调度设置;
- 由 Markdown 保存的 Shadow 定义,包括名称、激活概率、模型过滤、运行模型、截获视窗、context 继承、think-first 执行、holdout 模式、工具和提示词;
- 当前所选 root Session 的最近审查终态;
- 定义目录和逐文件诊断。

定义保存在 $DSH_HOME/shadow-minds/.md。以下定义适合确定性验收:
markdown

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.

验收时把定义的 activation_probability 设为 1。省略 run_with_model 时 child 继承 root 的模型路由;如需单独模型,应填写完整的 provider/model。默认 Shadow 工具为 read、grep 和 glob;定义中的工具会扩展 allowlist,如果继承的 sandbox 允许,它们也可能具有写入能力。examples/shadow-minds/ 中默认禁用的 starter library 展示 anchored probe 词汇,安装过程绝不会自动把它写入 $DSH_HOME。

把 Shadow 绑定到 DSH 的模型

每个 Shadow 子代理都可以绑定 DSH 部署中已配置的供应商、模型与思考强度。设置页提供供应商 / 模型 / 思考强度三级联动下拉框(数据来自 DSH 实时 LLM 目录,含每个模型公布的适配器思考强度)。字段留空即继承默认:供应商/模型沿用主 agent 的路由,思考强度沿用所选模型的默认强度。磁盘与 wire 格式仍是 provider/model 路由字符串,因此面向模型的管理工具无需改动。

验证实际运行

只有包含至少一个持久化工具结果的已完成 root 轮次才会触发调度。在新会话中明确要求主 agent 读取一个仓库文件再分析。自动调度未覆盖的场景由一条人工命令兜底:/shadow new 在当前会话尚未准入任何 Shadow 运行前强制立即审查一次。此后由各轮次对话卡片接管运行控制:卡片上每个失败或中断运行的「重试」按钮针对该 Shadow 子代理重跑一次,卡片头部的「暂停审查/继续审查」按钮暂停或恢复本会话的调度(暂停同时取消已准入的运行)。活动运行、累计准入运行数与最近终态继续通过设置页与各轮次对话卡片查看。

Shadow 进入调度后,被审查的 root 回复下方会立即出现运行占位卡片;卡片会明确提示此时发送新消息会取消本轮审查。完成后,同一位置原位更新为报告、静默、无关、中断或失败终态,多轮审查不会合并到会话末尾。报告正文复用 DSH 的 Markdown 渲染,支持 GFM、表格、代码块和 TeX,并保留官方的不安全内容过滤。

被接受的报告会成为 root Session 中持久化的用户消息并触发 follow-up,但该 relay 只更新触发位置的既有卡片,不再生成尾部卡片。silent、not_relevant、aborted 和 failed 都有可见卡片,但不会注入主 agent,因此不会由展示状态形成 Shadow 循环。

需要分析生产问题时,在对应定义中设置 debug: true。$DSH_HOME/shadow-minds/logs/.jsonl 会按 run 记录准入、child 启动、取消请求、终态和报告投递,包含阶段、稳定原因码、取消来源与 provider stop reason。日志不记录 prompt、报告正文、工具参数、凭据、绝对路径或 stack;例如用户新消息取消为 USER_MESSAGE_RECEIVED,Shadow 超时为 SHADOW_TIMEOUT,无法归因给插件的 provider 中断为 PROVIDER_ABORTED。

问题快速定位

出现问题时通常只有两块碎片:子代理报错文本或子代理会话 id(childSessionId)。仓库自带零依赖定位工具,能把碎片还原成该次运行的完整现场(调试时间线、入参、子代理会话里的 LLM/工具失败证据):
sh
node tools/shadow-debug.mjs trace    # 追查单次运行
node tools/shadow-debug.mjs find                          # 按错误内容反查运行
node tools/shadow-debug.mjs runs [--failed] [--shadow ]               # 列出运行
node tools/shadow-debug.mjs health                                        # 体检 debug 开关与日志健康度

它自动定位 $DSH_HOME/shadow-minds/logs/.jsonl(运行时间线与入参元数据)、$DSH_HOME/shadow-minds/.md(定义与审查提示词)以及 $DSH_HOME/sessions///session.jsonl.zstd(子代理完整事件流,含 prompt、LLM 请求头、工具错误、turn 终止原因)。在 DSH 会话内运行时会从环境变量推断路径,无需传参。完整的定位流程、原因码/阶段速查表与“症状 → 证据位置”对照见问题快速定位指南;给 DSH 会话内 agent 使用的同名 skill 见 .agents/skills/shadow-debug/SKILL.md。

安全与限制

默认轨迹投影会移除推理、原始工具结果文本和工具参数。用户及 assistant 文本中的 prompt injection 仍然可能进入投影,因此工具 allowlist、继承的 sandbox、固定的 child approval 策略和披露上限仍是必要的安全控制。

定义按一个 Harness home 全局生效,不按 profile 或 workspace 隔离。Child Session 遵循 Harness 的持久化策略。并发 Shadow 之间没有共享事务;一旦启用写入型工具,它们可能与 root 或其他 Shadow 发生竞争。

已接受报告及其 anchored 卡片会在服务重启后恢复。运行计数、最近运行诊断、非 report 生命周期卡片和暂停状态属于当前进程。当前版本还会在重启时把 spentChars 清零,因此下一条真实用户消息到来前,重启可以重新打开已经达到的软预算或硬预算。

安装、启动与运行验收技术方案给出可复现的源码宿主部署、真实模型验收、重启检查与预算持久化整改步骤。目标架构、审查条件机制与审查质量方向记录当前运行时契约;技术方案保留 Pi 参考实现分析和独立发行拓扑。提交日志或更新安装 commit 前请阅读 SECURITY.md。

开发

devDependencies 通过 link: 指向本仓库同级的 DeepSeek Harness 0.1.6-alpha.2 源码(../deepseek-harness)。先准备 .github/workflows/ci.yml 固定的提交:
sh
corepack enable
git clone https://github.com/deepseek-ai/deepseek-harness.git ../deepseek-harness
git -C ../deepseek-harness checkout ddefc45fbc7f8e46dd73185e68295696d1297887
pnpm --dir ../deepseek-harness install --frozen-lockfile
pnpm --dir ../deepseek-harness run build:lib

再安装并检查本仓库(CI=1 用于跳过 pnpm 在需要重建 modules 目录时的交互确认):
sh
CI=1 pnpm install --frozen-lockfile
pnpm run check

lib/ 是需要审查并提交的发布产物;源码行为变化时必须同步更新。禁止提交本地 Harness 状态、凭据、Session、日志或验收导出文件。

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群