← 返回列表
⚠ 装前注意
这是一个独立版本化的 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、日志或验收导出文件。