dsh-team-employees

dsh-team-employees

把 DeepSeek Harness 从「一个助手」变成一个多员工协同团队：有工牌、有花名册、有一条内容流水线、有一道只有人能按的闸门，还有一个会动的办公室界面。

• 员工——五个 agent preset（模式）。给每个员工一张工牌：人设 + 工具集（模型由会话选择）。情报、选题、成稿、数据四个内容岗，外加一个代码审核岗。
• 花名册——$DSH_HOME/team/employees.json。谁在岗、什么岗位、模型备注，写在一个 JSON 里。
• 内容流水线——素材登记 → 打分 → 写稿 → 制作计划 → 人工裁决 → 发布包 → 真实发布确认 → 回采 → 重算权重。每个阶段只认特定的前置阶段，谁都不能跳。
• 办公室——侧边栏一个图标，整页看到六个部门在干嘛：上钟中、待命、空岗、等你。状态来自真实会话，不是装饰动画。
• 员工管理——「设置 → 员工」里增删改花名册，缺工牌时会给出可复制的配置片段。
• 长期研究职责（0.5.0）——本地独立后台定时检查公开网页，用真实 Harness headless 模型生成简报，保留上次记忆并提示变化。关闭桌面应用后继续运行；电脑关机或休眠时无法继续。

它为什么不是又一个「AI 助手壳子」

三个设计上的取舍，决定了它跟同类东西不一样：

人工工具闸门。 ctx.tools.guard() 拦截员工调用 content_gate；状态机拒绝自动离开 review，发布包要求署名审核记录。办公室提供人工审核入口。具有本机文件/终端权限的员工仍可能直接改数据，因此这不是系统级权限隔离。

能用代码做的，不外包给模型。 切片、转码、排期全是确定性任务，content_render 只登记参数，不调 ffmpeg、更不烧 token。模型只干「判断」和「写」。

状态诚实。 「上钟中」的判据是那个员工的会话当前真的开着 turn；账本读不到就说读不到，不编数字；平台收入是美元、账本是人民币，没设汇率就不算净额，两个原值都留着。

装上

需要 Node 20+ 和一个能跑的 DeepSeek Harness。

方式一：本地目录链接（改代码最方便）

git clone https://github.com/syc67169-source/dsh-team-employees.git
cd dsh-team-employees
node bin/link-into-profile.mjs --dry-run   # 先看要改什么，不写盘
node bin/link-into-profile.mjs             # 装进 desktop profile

脚本只做三件事，都会打印出来：给 ~/.dsh/profiles/<profile>/package.json 加一条 link: 依赖、把插件名追加进 dsh.profile.bundles、在 profile 的 node_modules 里建软链（原文件先备份成 package.json.team.bak）。完全退出 DSH 再打开后生效；卸载用 --remove。

方式二：手动改 profile（不想跑脚本）

在 ~/.dsh/profiles/<profile>/package.json 里加一条依赖和一条 bundle：

{
  "dependencies": { "dsh-team-employees": "github:syc67169-source/dsh-team-employees" },
  "dsh": { "profile": { "bundles": ["…原有的…", "dsh-team-employees"] } }
}

然后在那个 profile 目录里 pnpm install。桌面端注意：dsh plugin --profile desktop 会被 CLI 拒绝（官方设计如此），手动或走脚本。

装上之后

0. 完全退出 DSH 再打开（客户端界面模块在启动时组图）。
1. 侧边栏出现「办公室」图标 → 点进去是六个部门的工位。
2. 「设置 → 员工」能看到花名册，可以增删改。
3. 新建会话 → 模式下拉里出现五位员工。
4. 选「情报员工·阿研」，问她「团队里现在有谁」→ 她调 team_roster。再让她登记一条素材 → 回办公室页刷新，情报部那个工位会显示「上钟中」。

先验收长期研究第一版

进入 办公室 → 长期研究员工 → 新建长期职责，选择员工，填写目标和 1–5 个无需登录的公开网址，再设置间隔与每日模型唤醒上限。保存后默认暂停。

点击 立即执行一次 建立第一份简报；查看最近记忆、来源和完整报告。点击 启用定期检查 才开始持续运行：内容未变跳过模型，发生变化生成新简报与面板提示。点击 暂停 会取消正在执行的任务。

这是本地第一版，一次只运行一个职责；使用 headless 配置的模型，员工模型备注不负责路由。支持文本、HTML、JSON、RSS/Atom，暂不支持需要登录或浏览器渲染的网页。详情与验收步骤见 长期研究使用与验收。

员工与工具

团队通用工具（dsh-team-employees/tools）：team_roster 看花名册、team_log 写一条工作记录、team_inbox 读别人做到哪了。

内容流水线工具（dsh-team-employees/content）：content_new、content_score、content_script、content_render、content_queue、content_gate（仅人）、content_publish、metrics_pull、weights、cost_report。

设计与字段细节见 docs/内容流水线编排设计.md。

数据在哪

$DSH_HOME/team/
├── employees.json          花名册
├── journal.jsonl           团队工作日志（成员之间靠它交接）
├── content/
│   ├── index.jsonl         摘要索引
│   └── <id>/               item.json / events.jsonl / script.md / render.json / publish.json
└── metrics/
    ├── <id>.json           单条回采结果
    └── weights.json        权重表（中位数比值，全表能手算）

全部是纯文本，直接看、直接改、直接进版本控制都行。

自检

npm test          # 112 项；自动测试使用隔离目录与模型夹具，不消耗真实模型额度

• test/smoke.mjs——团队工具的注册契约、Host 的 /team/api、办公室状态机（上钟/待命/空岗/人工岗怎么算出来的）、浏览器兜底页、客户端包的槽位注册与界面渲染。
• test/content.smoke.mjs——流水线状态机、闸门、记账、权重表。

本机装了 dsh 时，会用 dsh 自己的 schema 校验器验证工具契约（DSH_TOOLS_ENTRY 可指定位置）；没装就自动跳过那几条并明确打印说明，其余断言照跑。客户端界面是在一个最小 React 运行时里真渲染过的，所以 CI 不需要浏览器。

看设计不用启动 DSH：

npm run preview   # 三个界面渲染成静态 HTML 到 docs/preview.html
npm run shot      # 有 Chrome 时顺便重截 docs/images/ 里的图

目录结构

dsh-team-employees/
├── cordis.patch.yml        挂载清单：1 个 Host 行 + 5 个员工 preset
├── employees.json          花名册样例（安装时复制到 $DSH_HOME/team/）
├── lib/
│   ├── index.js            Host：/team 接口 + 办公室数据 + 浏览器兜底页
│   ├── client.js           客户端：侧边栏入口 + 办公室整页 + 设置里的员工管理
│   ├── store.mjs           团队数据读写（花名册 + 日志）
│   ├── tools.js            Agent 工具：team_roster / team_log / team_inbox
│   ├── content.mjs         流水线数据层：状态机 + 队列 + 回采 + 权重
│   ├── content-tools.js    流水线工具 + 人工闸门
│   └── usage.mjs           读本地账本（$DSH_HOME/.dshw-usage.json）
├── bin/link-into-profile.mjs
├── tools/                  预览与截图
└── test/                   两套自检 + 最小 React 运行时

加一个员工 / 加一个工位

加员工（改花名册，界面里就能做）：$DSH_HOME/team/employees.json 加一条。

加工位（要改配置）：cordis.patch.yml 里复制一个 preset-employee-* 块，改 id（小写字母数字连字符）、name、order、人设和工具集；如果要让他守一段流水线，再在 lib/index.js 的 DEPARTMENTS 里加一行。设置页在缺工牌时会给出可以复制的片段，但不会替你改配置文件。

员工花名册的 model 仅作备注，不会切换模型。实际模型请在对应会话的模型选择器中设置；当前插件没有员工级模型路由。

边界与风险

• 闸门只挡员工，不挡你。 它防的是「员工自我放行」，不是防你手滑。
• exec.agent 是宿主内部字段。 这是目前唯一能区分「人 vs 员工」的手段，闸门押在它上面。升级 DSH 后请重跑自检确认它还在拦。
• 账本是 best-effort。 .dshw-usage.json 由宿主写，不是公开契约；读不到就退回「读不到」，不编数字。
• 不代发、不批量多账号、不绕平台风控。 发布这一步刻意留给人：content_publish 只写本地发布包，不接触任何平台接口。
• bin/render.mjs 还没写。 content_render 只登记参数；真正的 ffmpeg 转码是下一步。
• 版本跟着 DSH 走。 针对 0.2.0-rc.2 的运行时写的，宿主接口变动时需要跟着改；自检会告诉你哪一条不对了。

许可

MIT，见 LICENSE。

联系与交流

用这个插件遇到问题、想提需求，或者只是想要一起交流一些AI有关的问题——扫码加我：

QQ：3657854368（EasonS）

稳定性修复（2026-10-04）

• JSON 写入使用唯一临时文件；条目、花名册、回采、权重以跨进程目录锁串行化。旧 revision 保存会被拒绝。
• 锁等待最长 15 秒，失败时不会覆盖数据。若进程崩溃留下 .lock，先关闭所有使用该数据目录的 Harness/脚本，再核对 owner.json 的 PID 已退出并移除相应锁目录。不会根据过期时间自动抢走锁。
• 索引保留每个 id 的最新摘要；队列先去重再筛选，统计包含全部条目。事件历史仍保留在条目内。
• content_publish 只准备发布包，条目保持待发布。办公室中署名审核、填写真实发布链接/记录并确认后，才进入 published；回采只接受已经确认发布的平台。可为同一条内容准备多个平台。
• 人工操作接口复用宿主认证并校验来源，防止跨站请求。它不是抵御具有本机文件/终端权限的代理的安全沙箱。
• 停止以全局账本前后差额自动归因内容成本。队列显示的是已关联记录，不是完整实际支出；旧成本记录未经重新审计，金额为 0 不代表免费。
• 办公室复用一次条目和账本读取；日志从尾部读取；请求 15 秒超时、卸载时取消，前次请求完成后再轮询。
• 制作阶段依然只生成制作计划，尚未实现媒体渲染器；审核时必须自行检查实际成片。