前言¶
DeepSeek Harness（DSH）提供了「插件化」的扩展能力，但默认只有一个对话窗口，缺少项目级、团队级的治理与协作机制。当团队从单人调试转向多人协作、从实验性尝试转向长期维护时，对话窗口难以承载角色分工、任务派单、验收门禁、合并治理等结构化流程。dsh-ai-studio 在 DSH 之上构建了一个多角色 AI Studio：把「一个聊天窗口」变成一间有工作室仪表盘、Agent 派单、token 预算、决策台、支线/契约冲突、worktree 代码执行、项目、角色、任务、验收、合并治理的工作室。
插件定位¶
dsh-ai-studio 是一个工作流类 DSH 插件，由维护者 mjw0531 开发，当前版本 2.5.3。它不依赖 DSH 私有 Remote 代码生成，只依赖 Web Server 路由、client slots 和 React，可在 DSH 0.2.1-rc.2 及以上版本运行。
插件将「酒馆」成熟之处（内容与运行时分离）映射到项目与权限体系：世界书映射为 Project Book（检索层），角色卡映射为角色契约的一部分，预设映射为运行时配置，正则映射为确定性 Hook，群聊映射为多独立会话 + 结构化消息 + 共享产物。
核心能力¶
项目与角色管理¶
- 项目：创建/切换项目，任务和角色归属项目。
- 角色：配置使命、职位、职责、决策权、模型与 token 预算。
- 任务：记录目标、负责人、验收人、优先级、分支、验收标准、证据。
仪表盘与派单¶
- 公司仪表盘：跨项目组合、老板收件箱、角色负载、风险雷达、交付流和 token 消耗；金额成本等报价接入后再显示。
- Agent 分析派单：Task Room 把任务派给负责人角色，Agent 返回结构化回执；回执缺
summary/evidence时任务退回可开始，不能进入验收。 - 薪资与预算：角色配置模型、单任务/每日 token 预算；项目配置总 token 预算。
验收与合并治理¶
- 验收门禁：任务完成前必须勾完所有验收项，并至少记录一条证据；完成后锁定。
- 合并提案：验收通过后可提交合并提案，记录摘要、风险、回滚、评审备注和合并提交。
- 批准/打回/合并：记录审计事件。
- 人工触发 Git merge：已批准提案可在 Task Room 执行真实
git merge --no-ff；要求当前在 base、工作区干净、分支存在；冲突自动 abort，不自动 push。 - 合并后回归：merge 成功后自动在 repo 执行任务验证命令，记录 pass/fail 和输出；失败不会自动回滚。
- 合并失败升级：回归失败自动生成决策台决策，附 merge commit、回滚命令和修复选项。
- 合并回滚：回归失败的 merge 可人工触发
git revert，记录 rollback commit；不 reset/push。
决策台与支线管理¶
- 决策台：Agent 的项目级决策自动进入待裁决；Owner 批准/拒绝并记录结论与理由，Agent 不能替 Owner 拍板。
- 支线/契约冲突：派单自动登记支线；两条支线改同一契约且内容不同时，自动升级为待裁决决策。
代码执行与验证¶
- worktree 代码执行：项目绑定 git 仓库后，每个任务自动创建独立 worktree 和分支；Agent 在里面改代码，Run 记录 diff，主工作区不被直接修改。
- Host 独立验证：Task Room 的验证命令由 Host 在 worktree 内执行，记录退出码/输出并写 evidence；不依赖 Agent 会话，也不会自动通过验收。
- 评审同族提示：评审模型与实现模型相同时，Task Room 警告共享盲点。
知识层与契约护栏¶
- 知识层：PRD/INVARIANTS/MODULES 只读查看；Module 契约卡记录职责、接口摘要、允许/禁止路径和依赖，派单时进入 Agent 上下文。
- 契约护栏：代码 Run 改动契约文件、禁止路径或越出允许的
src//test/路径时，任务自动 blocked 并生成决策。 - 工作流护栏：Task 记录模块/契约/票类型；连续失败 2 次自动 blocked 并升级决策；代码项目没有通过的验证不能提交合并提案。
闭环 ticket 与集成¶
- 闭环 ticket：集成/playtest ticket 标记；连续失败 2 次自动生成 Architect 重拆 ticket（backlog），不只是留一个决策。
- 自动集成分期：每完成 3 个任务自动生成一张 backlog 集成/playtest ticket，不自动派单。
文档与决策记录¶
- 文档同步门禁：项目绑定 PRD/INVARIANTS/MODULES 时，任务 done 前必须勾选「文档已同步」。
- 不可逆决策：Decision 可标记不可逆；批准时必须写结论和理由。
- ADR 草稿：不可逆决策批准后自动生成 Markdown ADR 草稿，保存在决策记录，不自动写文件。
- ADR 落盘：人工确认后写入
docs/adr/，自动编号，幂等。
数据持久化与导出¶
- 本地持久化：
$DSH_HOME/studio/studio.json，重启不丢；首次运行自动生成演示项目。 - 数据导入：页面「导入」恢复备份；Host 先备份原文件，校验 schema 后替换。
- 项目包：设置页导出/导入
tar.gz（状态 + git bundle + manifest + SHA-256 + 迁移说明）。
安装与启用¶
插件在 packages/dsh-studio 目录。
桌面端安装：
- 下载或 clone 项目仓库。
- 在 DSH 中进入 Plugins → Add plugin。
- 本地目录填
D:\dsh-ai-studio\packages\dsh-studio（请根据实际路径调整）。 - 点击 Enable now。
- 刷新页面。
Web profile 安装示例：
dsh plugin --profile web add "D:\dsh-ai-studio\packages\dsh-studio"
dsh --profile web
详细安装、打包分发、安全说明见 插件 README；完整操作步骤见 使用说明书；兼容性、升级、备份见 兼容性与安装。
典型用法¶
- 创建或切换项目，配置项目 token 预算。
- 创建角色，配置使命、职责、模型与预算。
- 在 Task Room 创建任务，填写验收标准。
- Agent 分析派单并返回结构化回执，回执需包含
summary与evidence。 - Host 在 worktree 中执行验证命令，记录退出码/输出并写 evidence。
- 验收通过后提交合并提案，Owner 批准/打回。
- 人工在 Task Room 执行
git merge --no-ff，冲突自动 abort。 - 合并成功后自动执行回归验证，失败则生成决策台决策与回滚方案。
适用场景与注意¶
- 适合需要结构化工作流、验收门禁、合并治理的团队。
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 需要 DSH 0.2.1-rc.2 及以上版本。
- 需要本地 git 仓库配合 worktree 与合并流程。
生态背景¶
DSH 理念是「一切皆插件」，社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
参考¶
- 目录页：https://www.skillhub.cn/plugins/mjw0531/dsh-ai-studio
- GitHub：https://github.com/mjw0531/dsh-ai-studio
- 插件 README：packages/dsh-studio/README.md
