会话监督与反思插件集acosmi/dsh-plugin

dsh-plugin

DeepSeek Harness（DSH）的社区插件集合。

英文：README.en.md

社区插件，不是 DeepSeek 官方产品。 不存在官方背书、审核或商店收录。DeepSeek Harness 尚在 developer preview，兼容性随时可能破坏；请按发布逐个锁定版本，不要裸装 latest。

插件列表

| 插件 | 版本 | 状态 | 构建 / 测试 |
| --- | --- | --- | --- |
| dsh-session-supervisor | 0.1.0-beta.0 | 开发者预览 | 自包含 pnpm 包 |
| dsh-dream-reflection | 0.1.0-rc.1 | 发布候选（本地开发） | 在 DeepSeek Harness checkout 内构建与测试 |
| dsh-browser-automation | 0.1.0-rc.1 | 本地验收通过（未发布 npm） | 自包含 pnpm workspace；每文件 100% 覆盖率硬闸门；真实 Harness 安装验收 |

dsh-session-supervisor

面向活跃 DeepSeek Harness 会话的、可持久、有预算的生命周期监督插件：维护事务、incident 状态机、预算台账与持久收据，只依据会话生命周期事实做判断。见 README.md（英文：README.en.md）。

自包含 pnpm 包，开发与 CI 都在插件目录内运行：

cd plugins/dsh-session-supervisor
pnpm install
pnpm run typecheck
pnpm run test          # vitest；pnpm run coverage 为 100% 覆盖率硬闸门
pnpm run build

兼容基线：npm 钉版 @deepseek-ai/dsh- 0.1.0-rc.6、Node ^22.19.0 || >=24.0.0、pnpm ≥ 10。详见 docs/compatibility.md。

dsh-dream-reflection

定时做梦反思插件：对同一工作区的顶层会话做有界、脱敏、可追溯的定期反思，生成结构化反思卡片；卡片先进入隔离区（quarantine），只有人类通过 /dream approve 批准的卡片才会作为动态上下文进入后续模型请求。见 README.zh.md。

本包作为树外插件在 DeepSeek Harness checkout 内开发与测试：其 tsconfig.json 与 vitest.config.ts 解析 Harness 源码平面（../../tsconfig.base.json、../../vitest.shared.ts），node_modules/@deepseek-ai/ 是指向 Harness 包目录的 symlink。因此构建与测试命令需在 Harness checkout 内执行，详见 CONTRIBUTING.md。兼容基线：Harness 0.1.0-rc.5、Node ^22.19 || >=24。

dsh-browser-automation

隔离式公共网页浏览器自动化插件族：在隔离 Chromium 上下文中打开公共网页、读取有界语义快照、执行受控交互并获取截图，不继承用户登录态、配置或秘密。四个包（Service Definition / Playwright Provider / 工具 Consumer / Profile Bundle）构成完整 capability seam；写动作逐次人工批准并在动作现场 TOCTOU 复验，全链 egress 与操作级网络租约。见 README.md（英文：README.en.md）。

自包含 pnpm workspace，开发与验收都在插件目录内运行：

cd plugins/dsh-browser-automation
pnpm install
pnpm run typecheck
pnpm run test          # vitest；含真实 Chrome 集成（无 Chrome 时自跳过）
pnpm run test:coverage # 每文件 100% 覆盖率硬闸门
pnpm run build
node scripts/exports-check.mjs

真实 Harness 验收（在 DeepSeek Harness checkout 内运行，隔离 DSH_HOME）：node plugins/dsh-browser-automation/scripts/acceptance.mjs —— CLI 安装 → 组合 → 官方 boot() 挂载断言 → tarball 打包/安装 → keyless 只读调用 → 卸载，全链路 exit 0。兼容基线：Harness 本地 master（47f94385）、Node ^22.19.0 || >=24.0.0、pnpm 11（corepack 钉版）、Chrome 151（macOS 实测）；其余平台见 docs/compatibility.md。

仓库布局

plugins/                        每个插件一个目录，各自为自包含包
dsh-session-supervisor/       pnpm 包；.github/ 保留其独立仓库形态的 CI 配置
dsh-dream-reflection/         源码包（构建/测试平面位于 Harness checkout 内）
dsh-browser-automation/       自包含 pnpm workspace（四个包 + 验收脚本）
.github/workflows/              集合级 CI（只有仓库根级的 workflows 会被执行）

CI 说明。 GitHub Actions 只执行仓库根 .github/workflows 下的工作流。各插件目录内保留自己的独立 CI 配置，供将来插件被拆分为独立仓库时使用；本集合内实际生效的 dsh-session-supervisor 流水线是 .github/workflows/session-supervisor-ci.yml。test:profile-install smoke 步骤刻意不进入集合流水线：它需要旁边 Harness 源码 checkout 里的真实 dsh CLI —— 本地可把 DSH_BIN 指向真实 dsh 可执行文件来运行。

安全

每个插件自带安全文档：dsh-session-supervisor 的 SECURITY.md / 威胁模型；dsh-dream-reflection 的 SECURITY.md / THREAT_MODEL.md；dsh-browser-automation 的 SECURITY.md / 威胁模型。请按各插件的披露政策报告漏洞，不要在公开 issue 里贴利用细节。

许可证

各插件按其自身条款许可 —— 目前三者均为 MIT，见各插件目录内的 LICENSE。仓库级文件亦为 MIT（根目录 LICENSE）。