MOSS 研发工作台 yangsong608/dsh-moss-workbench

AI 研发工作台 · dsh-moss-workbench

DeepSeek Harness 插件。把一句需求变成可执行、可审查、可计费的研发流程；执行者是 MOSS 智能员工。

版本 2.0.0 · 适配 dsh 0.2.1-rc.2 · 状态目录 ~/.dsh/dsh-moss-workbench/

它解决什么

大部分「AI 研发看板」停在两件事：把任务画成卡片，把智能体的输出贴进对话框。真正难的是后半段：

- 任务凭什么算完成（步骤与验收条件）；
- 产物能不能交付（规范性、可读性、交叉审查）；
- 钱花在谁身上（按员工、模型、项目归因）；
- 出错时能不能查（attempt、审计、预算熔断、边界检查）；
- 多个项目会不会互相踩（工作区、预算、任务定位）。

这个插件把上述五件事做成宿主侧的硬约束，而不是提示词里的建议。

12 个视图

| 视图 | 作用 |
| 总览 | 项目组合、健康度、需要你决策的事项、班组负载 |
| 需求 | 需求/目标/约束/验收/场景/班组/工作区/预算 → 生成计划草稿 |
| 计划 | 依赖图（列 = 层级）、步骤、负责人与估时、风险、预估成本、批准执行 |
| 调度 | 员工泳道（真实时间轴）、就绪/阻塞/异常队列、任务抽屉 |
| 指挥中心 | 2D 场景里的 MOSS 工位、实时状态、异常面板 |
| 监控 | 任务趋势、成本燃烧、事件流、成员负载、审查状态 |
| 产物 | 规范/可读/综合评分、验收覆盖、findings、正文、交叉审查、导出 |
| 成本 | 项目/全部项目花费、预算与熔断、按员工/模型、最近调用、价目表 |
| 班组 | 成员卡（模型/成本/负载）、角色库、成员提示词 |
| 安全 | 策略、审计日志、项目边界、输入告警 |
| 联动 | 个人工作台连接状态、需求导入、交付导出、边界说明 |
| 设置 | 主题、并行、步骤门、自动交叉审查、团队提示词、价目覆盖、危险操作 |

快速开始

安装到 desktop profile（link: 方式，改代码后重新构建/重启）
dsh plugin --profile desktop add "link:/abs/path/AI研发工作台"

重启 DeepSeek Harness，侧边栏出现「AI研发」。

首次进去是空态：需求 → 生成计划 → 批准 → 调度。没有智能体时，可在设置里打开「演示推进」按 40× 速跑完流程。

七个能力的落地方式

1. 系统提示词：分层装配，可审计

lib/prompts.js 把提示词拆成四层：

全局边界（8 条硬约束） └ 角色层（语气 / 关注点 / 交付结构 / 反模式 / 交叉审查镜头） └ 成员层（座右铭、专长、追加提示词） └ 任务层（目标、上游依赖、步骤、验收条件、工具回执）

- 角色层是资产：7 个角色各有 focus、deliverable（按 doc/code/test/chart 分）、antiPatterns、crossLens。
- 任务层把 steps 与 attemptId 写进去，模型知道「做到第几步、怎么交回执」。
- 认领任务时 moss_claim_task 直接返回完整提示词；界面任务抽屉也能查看并复制。
- 全局边界同时写进引擎校验（步骤门、工作区、预算），不是只靠提示词自觉。

2. 形象：六姿态 + 场景，透明叠加

assets/ 下 6 张 360×360 立绘（待命/专注/思考/审核/受阻/收官）与 1 张指挥中心底图。立绘用 mix-blend-mode: screen 叠加在场景上，暗部自然消失，只留光带与轮廓；执行中的工位有浮动与外环旋转。

3. 模型与成本：按员工记账

- 每个成员可配 modelId；架构师默认 Pro，其余默认 Flash。
- 价目表在 lib/models.js，口径对齐本机 dsh-cost-meter 1.9.15（人民币 / 百万 token，分 cacheHit / input / output）。
- 峰谷按北京时间工作日 09:00–12:00、14:00–18:00 判定；是否打折由 settings.offPeakDiscount 决定（默认 1，只提示不改价）。
- 任务完成时：有实测 usage 就按实测记「实测」，没有就按角色产出率估算并标「估算」；两者都写进台账。
- 预算：达 80% 预警，达 100% 停止派发；可显式放开 allowOverBudget。
- 设置页可覆盖任意模型单价（企业折扣、协议价），历史记录不重算。

4. 调度与多项目

- 任务 = DAG 节点，deps 未全部完成时物理不可认领（blocked）。
- 每次派发生成 attemptId；转派先作废旧 attempt，迟到回执被拒。
- 一名 MOSS 同时只持有一个 running 任务。
- 步骤门：4–6 个步骤必须逐个打勾；force 跳过会写审计。
- 多项目：任务、预算、工作区、成本、产物全部按项目隔离；projectId 可省略时按任务 id 自动定位。
- 工作区绑定：绝对路径 + realpath 校验；禁止根目录、系统目录、敏感文件。

5. 产物审查：三条独立结论

lib/review.js 全部是确定性规则，不调用模型：

- 规范性：按 kind（doc/code/test/chart/link）给不同检查项与权重；文档查标题、分节、风险、来源、占位符、长度。
- 可读性：句长、段长、标题深度、列表/表格/代码比例、链接合法性、重复标题。
- 验收覆盖：把验收条件切成实词二元组，命中原产物才算覆盖。
- 交叉审查：换一个角色视角（产品看范围、架构看取舍与失败路径、质量看证据、发布看回滚）。

综合分 = 规范 45% + 可读 25% + 交叉 20% + 覆盖 10%；fail 会阻止「可交付」结论，并列出可执行 findings。

6. 安全与边界

宿主侧强制，不依赖前端：

| 风险 | 手段 |
| 路径越界 | realpath + 相对路径校验 + 目录/扩展名/敏感文件白名单 |
| 凭证泄漏 | 输入与产物扫描（sk-/AKIA/Bearer/JWT/私钥/password=），日志脱敏 |
| 提示词注入 | 指令型模式扫描；命中内容降级为「不可信材料」，不进入指令区 |
| 资源滥用 | 请求体 500 KB、读取 256 KB、产物 200 KB、固定窗口限流 |
| CSRF | 写操作要求进程级 nonce（自定义请求头） |
| 预算失控 | 80% 预警 / 100% 停止派发 |
| 越权完成 | attempt + 步骤门 + 项目状态检查 |

所有关键动作（计划批准、认领、转派、强制跳过、预算调整、工作区绑定、审查、导出、删除）都进审计，最近 400 条滚动保留。

7. 与个人工作台联动

lib/workbench.js 只通过 /workbench-api 通信，不碰对方的 SQLite：

- 读：拉取空间与未完成任务，选中一条 → 生成研发项目（标题+描述+标签成为需求）。
- 写：项目/产物导出为一条「研发交付」任务，追加到指定空间；整份写回带 revision，409 时重读一次重试。
- 不删除、不改状态、不改优先级；联动失败只记审计，不阻塞研发。

详细分析见 docs/个人工作台联动分析.md（在工作区 docs 目录）。

主题同步与 Agent 执行（宿主集成）

主题跟随 DSH

语义色全部消费宿主 --dsw-alias-* token（带 fallback），深浅模式跟随 body[data-ds-dark-theme]——在 DSH 设置里切换外观（含字号/字体）即时生效，插件不再自管主题。顶栏三键（MOSS/550W/OpenCode）只切换品牌点缀色（光带/强调色），不改背景与文字。本地预览无宿主 token 时用内联 light token 表（?dark=1 可模拟深色）。

用 DSH 内置 AI Agent 执行任务

任务抽屉可把「执行模式」切到 agent，点「用 Agent 执行」即调用宿主 ctx.sessionController 走真实会话闭环：

create({ cwd: 项目工作区, sessionId }) → selectModel（员工 modelId 覆盖 model 字段，provider/reasoningEffort 继承宿主 agentDefaultModel.currentSelection()）→ prompt（角色系统提示词 + 任务简报，requestId 幂等）→ follow/轮询取结算与 usage → 产物登记进审查管线，成本按真实 token 计。

要点：
- 基于项目工作区：create 的 cwd 绑定项目工作区，dsh-agent-instructions 自动加载项目 AGENTS.md 规约链；未绑定工作区的项目拒跑（与产物登记同一约束）。
- 一个任务一个会话（moss-<projectId>-<taskId>），会话持久留档，可回看。
- 手动完成表单继续可用，两种模式并存；步骤门对 agent 同样生效。
- 员工 modelId 用 roster 页的价目表键；未知键自动回退宿主默认模型并记事件。
- 预览用 ?agent=fake 演练整条链路（不依赖真实宿主）。

设计与证据：docs/17-主题与Agent集成-增量设计.md。

模型工具（19 个）

moss_plan · moss_approve · moss_create_project · moss_board · moss_projects · moss_claim_task · moss_step · moss_complete_task · moss_fail_task · moss_reassign_task · moss_add_task（向执行中项目追加任务）· moss_report（生成/落盘项目复盘报告）· moss_prompt · moss_review_artifact · moss_cost · moss_employees · moss_workspace · moss_security · moss_remember（沉淀经验到员工/项目记忆）

典型 agent 循环：

moss_board → moss_claim_task(taskId) → 按返回的提示词执行 → moss_step × N → moss_complete_task({ attemptId, artifactName, content, inputTokens, outputTokens })

自测

npm run check # 10 个 JS 文件语法
npm run verify # 152 项：计费/提示词/审查/安全/引擎/联动/HTTP/客户端 apply
npm run preview # http://127.0.0.1:4310 预览（真实 React + 真实引擎 + 演示数据）
npm run ui-test # 46 项：CDP 驱动 Chrome，12 导航、需求→计划→批准→打勾→完成→审查
npm run host-test -- --url "http://127.0.0.1:3099/?token=..." # 真实 DSH 页面 8 项

本轮实测：verify 152/152，日志确认注册 19 个工具。

结构

lib/
engine.js 状态机：项目/任务/步骤/attempt/预算/成本/审查/审计 models.js 价目、峰谷、成本计算、token 估算 prompts.js 四层提示词装配 review.js 规范性/可读性/覆盖/交叉审查 security.js 路径边界、凭证/注入扫描、限流、脱敏 workbench.js 个人工作台读写 roles.js 7 个角色定义 scenarios.js 6 个流程场景 + 成员 + 姿态 index.js HTTP 路由（nonce/限流/审计）+ 19 个工具 client/ client.js 单文件浏览器 bundle（React 只从宿主取） assets/ 6 姿态立绘 + 场景底图 scripts/ verify / preview / ui-test / host-test

边界

- 不调用大模型：谁干活由接入的 agent 或人决定；插件负责编排、约束、证据与账本。
- 审查是启发式规则，不能替代真实测试与代码评审。
- 成本是"按 token 价目"的核算，不等于账单；企业折扣请在设置里覆盖单价。
- 单进程状态；多实例不会共享 state.json。
- 立绘是静态图 + CSS 动效，没有骨骼动画。