dsh-moss-workbench

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

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

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

它解决什么

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

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

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

12 个视图

快速开始

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

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

首次进去是空态：需求 → 生成计划 → 批准 → 调度。没有 agent 时，可在设置里打开「演示推进」按 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. 安全与边界

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

所有关键动作（计划批准、认领、转派、强制跳过、预算调整、工作区绑定、审查、导出、删除）都进审计，最近 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 动效，没有骨骼动画。