---

你对着主对话说「把设置页的保存按钮改成乐观更新」。主管把这句话拆成任务，派给前端，前端做完回报，审查卡一道质量门——这些角色不是临时工，而是常驻的、有名字有性格的员工。右侧边栏里，你能一眼看到谁在想、谁在干、谁卡住、谁交付了。

这个仓库是一个 DSH profile bundle，同时包含 Host 插件与 Web Client 插件。它不重新发明多智能体：成员名单、共享任务板、互发消息、持久化与重启恢复都来自官方的 @deepseek-ai/dsh-experimental-agent-team。本包补的是产品层——角色人格、一人一模型、办公室界面、派活通道、编制与自动化开关。

亮点

• 八个内置角色，七席默认阵容：阿策（产品）、小前（前端）、老后（后端）、小审（审查/测试）、小研（研究）、小设（设计）、老运（运维）常驻，第八席留给笔笔（文案）。每个角色有独立 persona、职责边界、汇报节奏和工具面。
• 一人一模型：provider::model[::effort] 精确指定；留空则动态跟随主对话，主对话换模型时员工跟着换。
• 办公室就在侧边栏：右侧边栏的 office tab，顶部统计 + 办公室 / 任务板 段控 + 44px 单列工位行。按侧边栏宽度做容器查询自适应，窄到 340px 只留头像环和状态点。
• 三条派活通道：输入框上方的工位条、@角色 浮层、以及不带 @ 的普通消息（交给主管拆解）。工位条和浮层都把任务直接写进员工会话，主对话只留一句回执。
• 工具面收窄：每位员工只带本职工具，一次请求的 tools schema 从 101 个 / 79KB 降到 20–34 个，平均省 73%。
• 编制与开关都可调：团队上限 8 人、自动组建三档、员工能否自主招人、每人能开几个临时工、主管是否亲手改文件——全部在 DSH 设置里改，多数开关下一次调用即生效。
• 复用官方底座：共享任务板、员工互发消息、成员持久化、重启恢复都由 Agent Teams 提供，本包只在其上做产品层。

快速开始

前置

• 已安装 DSH，且 dsh 在 PATH 里（dsh --help 能跑通）。
• Node.js ≥ 20。
• 一个 Web profile（下面以 web 为例）。
• Agent Teams bundle：@deepseek-ai/dsh-experimental-agent-team-profile。这是实验包，默认模板里没有：

dsh plugin --profile web add @deepseek-ai/dsh-experimental-agent-team-profile

安装

git clone https://github.com/keeptrue/dsh-work-team.git
cd dsh-work-team

# Host 代码 import 的两个包随 DSH 安装提供，不随仓库分发：
# 把它们软链进本目录的 node_modules
node scripts/link-host-deps.mjs

# 作为本地 bundle 装进 profile（同时写进 package.json 的 dsh.profile.bundles）
dsh plugin --profile web add link:"$PWD"

# 重启 Web 端
dsh web

link-host-deps.mjs 会从 dsh 二进制反推安装目录，把 @deepseek-ai/schemastery 与 @deepseek-ai/dsh-tools 链到 node_modules/@deepseek-ai/；重复执行是幂等的。装到别处时也可以 node scripts/link-host-deps.mjs --host /path/to/dsh-install。

验证

新开一个主对话，说「组建团队」。主管调用 team_start，七位员工逐个入职；输入框上方出现工位条，侧边栏「员工办公室」tab 里能看到每个人的状态。再问一句「现在团队在干什么」，主管用 team_status 汇总给你。

怎么用

组建团队

说法	发生什么
「组建团队」/「把团队补满」	主管调用 team_start，按默认阵容补齐到编制数，已存在的角色跳过
「招文案」	先把编制调到 8，再让主管 hire_teammate 招 writer
「研究员换成 GLM-5.3」	在 DSH 设置 → 团队设置里改对应模型字段，或让主管处理

team_start 只招内置角色；spawn_teammate 建的是临时协作者，不是正式员工。员工自己也能招人：缺角色时直接招（受编制上限），编制满时自动降级成一张「招聘申请」任务，由你拍板。

派活：三种方式

1. @ 浮层：输入框敲 @，继续打出能命中角色的字（@小、@阿策、@backend），候选浮层才弹出。已入职的排前面，未入职的灰显并标「未入职」。↑ / ↓ 选项，Enter 进入任务输入行，写完再 Enter。
2. 直接打 @ 前缀：不理浮层，直接敲 @小前 把登录页的按钮对齐修一下 回车。消息直接进小前的会话，主对话只留一句派单回执。
3. 普通消息：不带 @ 的走主管——它判断该谁做，简单任务直接交代，复杂任务先建共享任务再让员工认领。

裸 @、@src/、@README 这类没命中角色的输入不归本插件管，照旧交给官方的文件 / 会话菜单。

办公室面板

• 入口：点工位条的标题、会话标题栏的办公室按钮，或侧边栏「+」引导页里的「员工办公室」。
• 顶部统计：7/8 人 · 干活中 N · 等你回复 N · 团队已用 X。
• 段控：办公室 | 任务板(N)。任务板按 待办 / 进行中 / 已完成 / 被阻塞 分组，显示负责人、依赖与涉及文件。
• 状态八种：入职中、已就位、待命、干活中、等你回复、有新结果、异常结束、入职失败。
• 工位条：输入框上方常驻；悬停出名片（名字 / 角色 / 当前任务），点头像进会话，名片里的 ↗ 直接派活。触屏没有 hover，第一次点开名片、第二次进会话。

团队设置

在 DSH 设置 → 团队设置（排在「模型」之后、「插件」之前）。每位员工的模型、汇报频率和自动化开关都在这里，改动即时生效。

内置角色

团队名	中文名	角色	工具面
pm	阿策	产品经理 / 拆需求	核心 + 搜索 / 抓取 / 读图
frontend	小前	前端工程师	核心 + 浏览器 + 读图 + UI 渲染校验
backend	老后	后端工程师	核心 + 终端 + 后台作业
reviewer	小审	审查 / 测试	只读：无 write / edit
researcher	小研	研究员	只读 + 搜索 / 会话检索
designer	小设	设计师	核心 + 浏览器 + 生图 + UI 渲染校验
ops	老运	运维 / 脚本	核心 + 终端 + 后台作业 + 定时任务
writer	笔笔	文案 / 写作	核心 + 搜索 / 抓取 + 生图（默认阵容之外，需手动招）

别名可用：product → pm、fe → frontend、qa → reviewer、devops → ops、copy → writer。

配置

配置写在 profile 的 work-team 行，设置面板会通过 DSH Settings 持久化到 cordis.patch.yml。

字段	默认	说明
teamSize	7	团队编制，1–8
reporting	milestones	汇报频率：milestones 关键节点 / completion 只在完成时 / every-step 每一步
allowSelfHire	true	员工能否直接招人。逐次求值：关掉后工具仍在，调用被拒并说明原因；编制满时直招自动转成招聘申请
maxWorkersPerEmployee	2	每位员工同时能开的临时工（一次性 subagent）上限，0–4；0 = 禁止
trimEmployeeTools	true	按角色裁剪工具面。关掉后员工恢复宿主提供的全部工具
employeeStepBudget	24	员工「收敛预算」：约多少次工具调用内交付的软提示（0–60），80% 时先报卡点；0 = 省略
autoStart	off	自动组建：off / first-message（收到第一条消息后开始）/ immediate（新会话即开始）
dispatchPrefix	true	主对话里以 @角色 开头的消息由 Host 兜底转发给该员工；逐条消息读
leadHandsOff	false	主管不亲手改文件：write / edit 被拒并给出理由，read / grep / bash 照常
modelPm	空	阿策的模型
modelFrontend	空	小前的模型
modelBackend	空	老后的模型
modelReviewer	空	小审的模型
modelResearcher	空	小研的模型
modelDesigner	空	小设的模型
modelOps	空	老运的模型
modelWriter	空	笔笔的模型

模型值格式 provider::model，例如 workbuddy-cn::deepseek-v4.1-flash，也支持 provider::model::effort。空字符串表示跟随主对话：应用时刻钉住当时那条 route，之后主对话换模型会由 model/selection 事件重新钉一次。

生效时机：dispatchPrefix 逐条消息读；leadHandsOff、allowSelfHire、maxWorkersPerEmployee 每次调用求值；trimEmployeeTools 在设置保存后重新应用一次；autoStart 只在主管会话创建或恢复时判定一次；teamSize 在下一次招人时按新编制算。

架构

flowchart LR
  Boss["老板<br/>主对话"] -->|"team_start / dispatch_tasks"| Lead["主管 Lead<br/>拆活 · 派活 · 验收"]
  Boss -.->|"@小前 修登录页"| Emp
  Lead -->|"send_message"| Emp["员工 × 7<br/>persona · 模型 · 工具面"]
  Emp -->|"send_message 汇报"| Lead
  Lead <--> Board["共享任务板<br/>team_task_*"]
  Emp <--> Board
  Emp --> Workers["临时工<br/>subagent × 0–4"]
  Emp -.->|"agentTeam / subagentTiming / tokenUsage 投影"| UI

  subgraph UI["Web Client"]
    direction TB
    Dock["工位条<br/>conversation.input.dock"]
    Overlay["@ 派活浮层<br/>conversation.input.overlay"]
    Office["办公室 tab<br/>sidebar.right.pane.tab"]
    Settings["团队设置<br/>settings.section"]
  end

Host（index.js + lib/）

• Lead scope：老板指南、team_start / hire_teammate / dispatch_tasks / team_status、编制守卫、可选的 write / edit 逐次拦截。
• Employee scope：每次请求重拼的 persona、角色工具白名单、request_hire / hire_teammate、临时工上限守卫。
• agent/pre-step（主管会话）：@ 兜底转发与首条消息触发自动组建。
• 自动组建：后台两路并发补齐编制，带幂等锁，中途关档会在当前这位完成后停下。
• 模型同步：agent/created、插件重载、主对话 model/selection 变化三处触发。

Client（client.js）

• 注册 sidebar.right.pane.tab（办公室，页面型 tab）、conversation.input.dock（工位条）、conversation.input.overlay（@ 浮层）、conversation.session.header.actions（办公室按钮）、settings.section（团队设置）。
• 不新增 session event 类型：团队状态来自 agentTeam 投影，模型来自 modelSelection，耗时来自 subagentTiming，token 来自 tokenUsage。
• @ 派活走 sessions.retain + binding.session.prompt(..., 'queue') 直接写进员工会话，不经过主对话消息流。
• Q 版 SVG 头像 + CSS 状态动画，尊重 prefers-reduced-motion。

项目结构

dsh-work-team/
├─ index.js              Host 插件：工具、persona、模型同步、编制守卫、自动组建、@ 转发
├─ client.js             Web Client：工位条、办公室、任务板、设置、@ 浮层、头像动画
├─ lib/
│  ├─ roles.js           八个角色定义、默认阵容、别名、角色工具清单
│  ├─ toolset.js         工具白名单分组与按角色的 allow 集
│  ├─ personas.js        老板指南、员工 persona、入职话术
│  ├─ models.js          模型字符串解析、token / 时长格式化
│  ├─ autostart.js       自动组建状态机、补员计划、hands-off 规则
│  └─ dispatch.js        @ 角色解析、派单回执、失败降级文案
├─ locale/               插件显示元数据（zh / en）
├─ scripts/
│  ├─ link-host-deps.mjs 把 DSH 自带的依赖链进本目录
│  └─ measure-context.mjs 请求体积度量（system 字符数 / tools 字节数）
├─ test/                 191 项单测（node --test）
├─ docs/                 UI 规格与设计文档
├─ cordis.patch.yml      bundle 行与默认配置
└─ icon.svg

开发

npm test          # node --test test/  —— 191 项，全绿
npm run measure   # 量一次会话请求体积：system 字符数、tools 字节数、注入次数

测试覆盖：roles.test.js 与 toolset.test.js 测纯函数和工具白名单；host.test.js 测宿主接线（自动组建 / @ 转发 / 工具收口 / 临时工上限 / 满编降级）；model-apply.test.js 测员工模型应用（Agent 级选择、失败重试、幂等、主对话换模型后重钉）；client-roles.test.js、dock-fan.test.js、member-status.test.js、office-v5.test.js 测客户端状态机与布局约束。

改 lib/roles.js 的角色时记得同步 client.js 顶部的镜像 ROLES 表——两侧都按 id 取名字、配色和状态。

设计取舍

• 不做第十个多智能体框架。roster、任务板、消息、持久化都在 Agent Teams 里，重复实现只会让两边状态打架。本包只做角色、模型和界面。
• 工具裁剪是省 token，不是沙箱。它只决定员工看得见哪些工具；真正的权限边界是 DSH 的 permission preset / sandbox。bash 依然能写文件。
• 状态来自回合结算，不是未读位。平台把「非主会话的 running 结束」都记一次未读，入职那一回合也算——这正是「只说一句开启团队、七个人全显示有新结果」的来源。所以这里用 subagentTiming.settledMs 的单调累计值做阈值判定。
• @ 直派绕过主管。员工收到的是你打的那句原文：没有拆解、没有验收标准、没有分工。简单明确的活这样最快；复杂任务先不带 @ 说需求。

已知限制

• 成员名单只增不减。Agent Teams 把成员写进会话日志，设计上没有删除 / 改名 / 名字复用；要缩编就开新会话。
• 员工工具白名单是精确名单。宿主新增工具不会自动进来，工具改名后新名字不在名单里。探测不到时退化为部分裁剪或完全不裁剪，不会把员工裁到不能用。
• 临时工上限按 step 计。subagent 声明了并发安全，同一个 step 里并发发出的委派会在任何子会话出现前一起通过守卫，所以「上限 2」实际是「每 step 最多 2 个」；真正的全局天花板是 subagent 服务的 maxActiveSubagents。
• 模型切换只写 Agent 级选择。走 selectForNextRequest，不动主对话模型和 profile 默认值；代价是校验自己做，且入职那一回合仍跑旧路由，下一次请求才生效。
• 状态最多延迟 2 秒。客户端仅在页面可见时每 2 秒批量读一次投影；页面隐藏时不轮询，切回来立刻补读。
• 自动组建默认关，因为花 token。每位员工入职都要跑一次 turn。
• Agent Teams 是实验包。本插件依赖它的 tryMembership、spawnTeammate 和 agentTeam 投影，DSH 升级后需要回归。

版本

版本	主要内容
2.2	按角色裁剪工具面（一次请求平均 −73%）
2.1	员工临时工（每人 0–4 个）；员工自主招人，满编自动降级成招聘申请
2.0	办公室搬进右侧边栏；八种状态可视化；交接动画与容器查询布局
1.5	自动组建三档；@ 派活浮层与 Host 兜底转发；工具面收口

许可

MIT