DSH Staff 员工制
把 DSH 的 Agent Teams 从「临时项目组」变成「有编制的员工」：员工有名字、岗位、职责边界、固定工位、任务账本，能拉群对话、互相质询，输入框上方还有一条常驻状态带。
它解决什么
| 痛点 | 未装之前 | 装上之后 |
|---|---|---|
| 成员会散 | 换会话就是另一支空团队 | 名册持久化，跨会话可查，staff_rebuild 出交接单 |
| 岗位靠临场说 | 每次 spawn 都要重新交代 | 6 种岗位模板，或写进档案复用 |
| 派活靠嘴 | 说完就忘 | 任务账本 + 优先级 + 截止 + 逾期提醒 |
| 员工互不来往 | 只能各干各的 | 群消息流，收到消息时能看到最近 6 条群历史 |
| 不知道谁在干什么 | 靠翻会话 | 输入框上方状态带 + staff_dashboard 看板 |
工具（19 个）
人事
| 工具 | 作用 |
|---|---|
staff_hire |
招人/调岗。同名再调即更新，保留历史任务；member 绑定工位；template 可选岗位模板 |
staff_rebuild |
生成员工交接单：还原成 spawn_teammate 参数，用于新会话重建 |
staff_list |
花名册，含各状态任务计数 |
staff_show |
单人档案 + 全部任务明细 |
staff_fire |
离职（软删除，档案与历史保留） |
派活
| 工具 | 作用 |
|---|---|
staff_assign |
派一条任务，支持 priority（high/normal/low）与 due |
staff_task_update |
状态流转：todo / doing / done / blocked |
staff_dispatch |
批量把待办投给员工并唤醒，支持 dryRun 预览 |
staff_autopilot |
自动驾驶开关：每分钟检查待办并唤醒一名员工，默认关闭，带每日上限 |
staff_dashboard |
全景看板：员工、待办分布、逾期与高优、群、阻塞项 |
群聊
| 工具 | 作用 |
|---|---|
group_create |
建群，2–8 名在册员工 |
group_update |
群改名、增删成员（数量仍限 2–8） |
group_send |
群发言，点名或全员；投递时附带最近 6 条群历史 |
group_read |
读群消息流 |
group_list |
群列表 |
group_delete |
解散群（confirm 必须显式传 true，防误删） |
维护
| 工具 | 作用 |
|---|---|
staff_export |
导出 JSON 备份（可回灌）或 Markdown 报告 |
staff_doctor |
数据自检（三级输出）：problems 必须修（存储损坏、孤儿任务、序号重复倒序）、warnings 可继续使用（备份恢复、离职成员、序号断档）、infos 现场信息 |
岗位模板
secretary（首席执行秘书）、researcher（研究助理）、engineer（工程师）、tester（测试负责人）、product（产品经理）、ops（运维/SRE）。
传 template 可省略 post 与 duty；显式传入时优先于模板。
DSH 内界面
三处挂载，全部是 DSH 界面的一部分，不引入独立站点：
| 位置 | 内容 |
|---|---|
| 侧栏底部 | 「员工」入口按钮，任何时候都能打开 |
| 输入框上方 | 状态带 员工 N · 待办 M · 群 K ▸，点击打开 |
| 全屏面板 | 员工中心：左侧通讯录按「群聊 → 在线员工 → 待重建工位 → 未绑定工位」分组，右侧员工详情与群列表；ESC 关闭 |
样式全部使用 DSH 主题 token（--dsw-alias-*），明暗主题自适应。数据 15 秒轮询一次。
工位有三态，界面用状态点颜色区分，不再笼统显示「离线」：
| 状态 | 判定 | 界面 | 处置 |
|---|---|---|---|
online |
teammate 在任一在线会话里 | 绿点·在线待命 | 直接投递 |
missing |
名册绑了名，但所有会话都找不到它（会话结束 teammate 就消失） | 橙点·工位缺失 | 发消息 / 点 ↑ 自动重建，或档案页「重建工位并上线」 |
unbound |
没有绑定 teammate | 灰点·未绑定工位 | 先 staff_hire(member=...) 绑定 |
快照的 employees[] 除原有 online 布尔外，新增 station 与 stationSessionId（在线时指向工位所在会话）。完整状态机与流程见 docs/流程与状态机.md。
文末新增 案例库、度量指标与并行协作规约：三条真实缺陷的现象→根因→修法→证据、每次交付必报的五项指标、多人协作的写入边界。
数据来自两个只读 HTTP 路由：
| 路由 | 作用 |
|---|---|
GET /staff-api/snapshot |
员工、未完成任务、群摘要、前端心跳状态 |
GET /staff-api/client-ping?from=react |
前端组件挂载时上报，source 区分 react / manual |
两个路由都只允许本机来源（127.0.0.1 / ::1），非本机返回 403——它们不参与 DSH 的认证链，必须靠来源地址兜底。
数据
| 文件 | 内容 |
|---|---|
~/.dsh/staff/roster.json |
员工档案与任务账本 |
~/.dsh/staff/groups.json |
群与消息流 |
~/.dsh/staff/exports/ |
staff_export 导出的备份与报告 |
均为原子写（临时文件 + rename），写操作进程内串行化，并发调用不会互相覆盖。
典型流程
1. staff_hire 招人（可只给 template），member 绑定工位
2. staff_assign 派活（可带 priority / due）
3. staff_dispatch 一键投递唤醒（先 dryRun 看一眼）
4. 员工自己 staff_task_update 置 done，send_message 回报
5. staff_dashboard 看全景
建群讨论：
1. group_create 拉 2–8 人
2. group_send 抛议题（不点名 = 全员，mention = 定向）
3. 员工收到消息时能看到最近 6 条群历史，可直接 group_send 在群内发言
4. group_read 回看整条讨论
架构边界（为什么某些事没做）
| 想做 | 结论 | 依据 |
|---|---|---|
| 真·常驻员工（跨会话在职） | 插件层做不到 | subagents.prompt 要求 exact live direct parent；员工工位是某 Lead 会话的子会话，换会话即失效。做成 root 级员工需改会话模型 |
| 后台无人值守自动干活 | 做了但默认关闭 | staff_autopilot 每分钟最多唤醒 1 人，有每日上限，内存态重启即停。自动唤醒 = 自动计费，必须人显式开启 |
| 侧栏完整 UI 面板 | 只做轻量状态带 | 完整面板需 Typert Remote + client 模块，且认证态下无法在本地验证渲染 |
已知限制
| 限制 | 说明 |
|---|---|
| 员工身份绑会话 | teammate 只在当前会话的 Team 里活着；名册持久，工位不持久，用 staff_rebuild 过渡 |
| 群历史是快照 | 投递时附带最近 6 条，不是实时订阅 |
| 群发即计费 | 每次群发真实唤醒每个成员，2 人 = 2 次模型运行 |
| UI 渲染未验证 | 组件已挂载到 conversation.input.dock，但本环境无浏览器认证态，需人工刷新确认 |
| 自动驾驶需人开 | 默认关闭，内存态，重启失效 |
本地验证（给维护者）
验证脚本会把数据写进 $DSH_HOME/staff/。不要在真实名册上直接跑——曾经因此把一名员工的职责覆盖成四个字。用隔离目录：
DSH_HOME=/tmp/dsh-staff-test node .verify.mjs
版本
| 版本 | 变更 |
|---|---|
| 0.1.0 | 名册 + 任务账本，6 个工具 |
| 0.2.0 | 群聊 + 工位绑定 + 群历史可见，10 个工具 |
| 0.3.0 | 写串行化、批量派发、全景看板，12 个工具 |
| 0.4.0 | 岗位模板（6 种）、员工交接单，13 个工具 |
| 1.0.0 | 群成员管理、任务优先级与截止、导出备份、数据自检，16 个工具 |
| 2.0.0 | DSH 内员工中心（侧栏入口 + 全屏面板）、HTTP 快照与心跳、自动驾驶（默认关），18 个工具 |
| 2.1.0 | 群解散工具 group_delete；群人数上限与 Agent Teams 对齐为 8 人 |
