dsh-ai-studio 2.5.3 → 3.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -6
- package/lib/client.js +7377 -4083
- package/lib/index.js +6903 -2869
- package/package.json +5 -3
package/README.md
CHANGED
|
@@ -2,11 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
> 即装即用的 DeepSeek Harness AI Studio：**工作室仪表盘、Agent 派单、token 预算、决策台、支线/契约冲突、worktree 代码执行、项目、角色、任务、验收、合并治理**，一个独立页面。
|
|
4
4
|
|
|
5
|
-
当前版本 **
|
|
5
|
+
当前版本 **3.12.0**，已在 **DSH 0.2.1-rc.2** 上完成端到端验证（Web/桌面安装、页面渲染、任务创建、验收门禁、合并治理、工作室仪表盘、Agent 派单与结构化回执、token 计量、决策台、支线/契约冲突自动升级、git worktree 代码编辑与自动提交、Host 独立验证、独立 AI 评审、自动集成分期、文档同步与不可逆决策门禁、ADR 草稿与写入、人工触发的 Git merge 与合并后回归、合并失败升级与回滚、改修票诊断/计划门禁、失败 2 次自动升级与重拆、合并前验证门禁、项目知识/模块契约、契约越界护栏、集成/playtest ticket、真实项目 dogfood、数据导出/导入恢复、Claude Code / Codex CLI 执行器、项目包导出/导入、切换 DSH 页面后保持 Studio 导航位置）。
|
|
6
6
|
|
|
7
|
-
|
|
8
7
|
|
|
9
|
-
|
|
10
8
|
|
|
11
9
|
## 它是什么
|
|
12
10
|
|
|
@@ -43,6 +41,51 @@ Studio 把 DSH 从「一个会话」扩展成「一间工作室」：
|
|
|
43
41
|
- **2.4 外部执行器**：角色可以选择 DSH Agent、Claude Code 或 Codex CLI；Claude/Codex 必须在对应机器上先登录，Host 在 worktree 内以 headless 模式运行并归一化回执。
|
|
44
42
|
- **2.5 项目包**：设置页「导出项目包」生成 tar.gz（`studio.json` + `project.bundle` + `manifest.json` + 迁移说明 + SHA-256），「导入项目包」校验后 clone 并重绑；不含 API Key。
|
|
45
43
|
- **2.5.1 导航保持**：切到 DSH 对话再回 Studio，保留上次的页签和打开的任务，不再跳回初始页。
|
|
44
|
+
- **2.6 阶段门禁**：新项目从 `discovery` 开始，Owner 完成检查项/产物后依次进入 `architecture → prototype → development`；已有项目保持 `development`。代码项目未进入持续开发不能派单。
|
|
45
|
+
- **2.7 触发收件箱**：外部事件先进入 Trigger Inbox；同一 `threadKey` 归入 Thread，后续事件可关联到已有任务；由人确认转任务，不自动派单或合并。
|
|
46
|
+
- **2.8 研讨会**：记录各角色的独立意见、反对、风险和推荐；2.8.1 增加「AI 独立评审」，每个参与角色独立调用 DSH Agent，形成汇总与 Owner 决策；不自动合并。
|
|
47
|
+
- **2.9 原型 Demo 门禁**：从原型验证进入持续开发前，必须登记 `demo` 产物（路径、URL 或 playtest 记录），或写 Owner 豁免理由。
|
|
48
|
+
- **2.10 Provider Profiles**：角色可以绑定命名执行配置（DSH / Claude Code / Codex + provider + model），派单、独立评审和 Workshop 共用同一解析。
|
|
49
|
+
- **2.11 Provider 健康度**：按 Profile 聚合成功/失败、token、最近错误；运行失败会把状态标为 `degraded`，不自动切换。
|
|
50
|
+
- **2.12 Provider 诊断**：显示失败率、失败原因分布、最近 5 次运行；对 `degraded` Profile 给出备用建议，不自动切换。
|
|
51
|
+
- **2.13 人工备用切换**：确认后把绑定降级 Profile 的角色改绑到建议 Profile；不自动 failover，改绑留审计事件。
|
|
52
|
+
- **2.14 Run 执行快照**：每次 Run 记录 providerProfileId / executor / provider / model；后续改绑不会改变历史归属。
|
|
53
|
+
- **2.15 Provider 实时探测**：检查 DSH provider/model 是否存在、外部 CLI 是否可执行；结果只展示，不自动切换。
|
|
54
|
+
- **2.16 Trigger Webhook**：GitHub/CI/IM 通过 HMAC 签名进入收件箱；repo/label/author/mention 规则过滤，人工确认转任务。
|
|
55
|
+
- **2.17 手动 Demo 记录**：记录入口、启动命令、验证步骤、结果、截图和备注；不执行命令，不自动截图。
|
|
56
|
+
- **2.18 Workshop AI 汇总草稿**：生成共识、分歧、未决问题、候选方案；不覆盖原始意见，不写 Owner 决策。
|
|
57
|
+
- **2.19 入门引导与项目模板**：新手清单；Web / 游戏 / CLI 工具模板自动创建角色和首批任务；PWA 暂缓。
|
|
58
|
+
- **3.0 公司级组合治理**：组合预算、跨项目优先级、角色覆盖聚合；只从项目状态派生。
|
|
59
|
+
- **3.0.1 客户端拆分（一）**：抽出 `lib/format`、`components/ui`、`views/Company|Boardroom|Knowledge|Team`。
|
|
60
|
+
- **3.0.2 客户端拆分（二）**：抽出 `views/MissionView`、`components/TaskPanels`、`components/Forms`、`components/RecentEvents`；`StudioPage` 降到 2,186 行。
|
|
61
|
+
- **3.0.3 Store 拆分（一）**：抽出 `store/read-model`、`store/validation`、`store/migration`；`store.ts` 降到 4,797 行。
|
|
62
|
+
- **3.0.4 Store 拆分（二）**：抽出 `store/inputs`、`store/seed`、`store/errors`，并拆出 Tasks/Merge/Settings/States；`store.ts` 4,272 行，`StudioPage` 1,528 行。
|
|
63
|
+
- **3.0.5 Store 拆分（三）**：抽出 `store/templates`、`store/lookups`；`store.ts` 降到 3,993 行。
|
|
64
|
+
- **3.0.6 有状态域拆分（一）**：Provider Profile 域抽成 service；`store.ts` 降到 3,878 行。
|
|
65
|
+
- **3.0.7 有状态域拆分（二）**：Merge 域抽成 service；`store.ts` 降到 3,598 行。
|
|
66
|
+
- **3.0.8 有状态域拆分（三）**：Trigger / Webhook / Thread 域抽成 service；`store.ts` 降到 3,277 行。
|
|
67
|
+
- **3.0.9 有状态域拆分（四）**：Task 域抽成 service；`store.ts` 降到 2,969 行。
|
|
68
|
+
- **3.1.0 质量门禁拆分**：评审与 Host 验证抽成 service；`store.ts` 降到 2,815 行。
|
|
69
|
+
- **3.1.1 Run 生命周期拆分**：Run / 失败升级 / 契约护栏抽成 service；`store.ts` 降到 2,112 行。
|
|
70
|
+
- **3.1.2 Workshop / Demo 拆分**：Workshop 与手动 Demo 抽成 service；`store.ts` 降到 1,817 行。
|
|
71
|
+
- **3.1.3 微型文件收敛**：context / errors / ids 合并为 `store/core.ts`；Store 文件数 18 → 16。
|
|
72
|
+
- **3.1.4 Mission 视图拆分**：Trigger / Stage / Workshop / Demo 独立；MissionView 1,740 → 568 行。
|
|
73
|
+
- **3.1.5 任务组件拆分**：TaskPanels 拆成 Board / Drawer / RunPanels / MergePanel。
|
|
74
|
+
- **3.1.6 表单拆分**：Forms 拆成 Task / Role / Project / Decision 和 ModalShell。
|
|
75
|
+
- **3.1.7 决策域拆分**：Decision / ADR / 合并后决策抽成 service；`store.ts` 降到 1,577 行。
|
|
76
|
+
- **3.1.8 项目/阶段/目录域拆分**：Project、Stage Gate、Role、Module 抽成 service；`store.ts` 降到 1,017 行。
|
|
77
|
+
- **3.2.0 客户端动作拆分**：52 个 API handler 抽成 `studio-actions.ts`；`StudioPage` 降到 888 行。
|
|
78
|
+
- **3.2.1 收尾整理**：RecentEvents 并入 Mission；项目介绍与文档校对。
|
|
79
|
+
- **3.3.0 执行层绑定**：boot nonce、项目包按项目、taskId 校验、提交绑定、schema 27、local Git 身份。
|
|
80
|
+
- **3.4.0 运行隔离**：worker/review 显式挂载 `standard`；worker 限制 creator/子代理工具；评审/研讨会只读；Run 记录预设/审批/沙箱。
|
|
81
|
+
- **3.5.0 反馈修复**：可选字段接受 `null`；`/verify` 只跑任务保存的命令；Bearer timing-safe；boot/verify 限流；CI 校验 lib。
|
|
82
|
+
- **3.6.0 评审证据**：Run 保存真实 patch；评审注入 patch + base/branch；契约越界在提交前拦截。
|
|
83
|
+
- **3.7.0 运行数据**：Run 输出外置到 `runs/<id>.txt`；state 留 2KB 预览；回执 JSON 多块解析。
|
|
84
|
+
- **3.8.0 超时与风险分级**：任务可设超时；超时状态保留 worktree；`riskTier` 的 trivial 任务有 Host 验证时可跳独立评审。
|
|
85
|
+
- **3.9.0 PRD/架构冻结**：Owner 主动冻结、版本 Hash、漂移检测、StageGate 绑定、领域模型、需求决策记录。
|
|
86
|
+
- **3.10.0 冻结变更单**：关联冻结版本、原因、影响、Owner 接受/拒绝。
|
|
87
|
+
- **3.11.0 结构整理**：router/styles 拆分、CHANGELOG、check-docs、README 首屏重写。
|
|
88
|
+
- **3.12.0 文档路径修复**：换仓库自动迁移绝对路径，文档路径强制相对根目录。
|
|
46
89
|
- **角色薪资与预算**：角色可配置模型和单任务/每日 token 预算；项目可配置总 token 预算。
|
|
47
90
|
- **项目**：一个项目边界，下面有角色和任务。
|
|
48
91
|
- **角色**：持久的职责契约（使命、职责、决策权），不是人设卡。
|
|
@@ -62,6 +105,10 @@ Studio 把 DSH 从「一个会话」扩展成「一间工作室」：
|
|
|
62
105
|
|
|
63
106
|
如果侧栏没有出现「AI 工作室」，优先检查这三处是否一致。
|
|
64
107
|
|
|
108
|
+
完整工作流、开发用法和术语注释见：
|
|
109
|
+
|
|
110
|
+
- [项目介绍与开发指南](https://github.com/mjw0531/dsh-ai-studio/blob/main/docs/06-项目介绍.md)
|
|
111
|
+
|
|
65
112
|
## 安装
|
|
66
113
|
|
|
67
114
|
### 方式 A：桌面端（推荐）
|
|
@@ -100,7 +147,7 @@ cd D:\dsh-ai-studio\packages\dsh-studio
|
|
|
100
147
|
pnpm pack
|
|
101
148
|
```
|
|
102
149
|
|
|
103
|
-
把生成的 `dsh-ai-studio-
|
|
150
|
+
把生成的 `dsh-ai-studio-3.12.0.tgz` 发给对方，在 **Add plugin** 里填 tarball 路径即可。
|
|
104
151
|
|
|
105
152
|
## 使用
|
|
106
153
|
|
|
@@ -114,11 +161,9 @@ pnpm pack
|
|
|
114
161
|
6. **团队**：新增角色，写使命/职责/决策权，并配置模型与 token 预算。
|
|
115
162
|
7. **设置**：绑定/更换代码仓库，查看 DSH 版本、兼容状态、数据目录和能力边界。
|
|
116
163
|
|
|
117
|
-
|
|
118
164
|
|
|
119
165
|
Task Room 里，验收项、证据和状态推进是同一份事实：没勾完、没证据，就无法验收通过。
|
|
120
166
|
|
|
121
|
-
|
|
122
167
|
|
|
123
168
|
合并队列把「验收通过」和「合入主干」分开：提案先评审，批准后才记录合并；打回会把任务退回执行中。
|
|
124
169
|
|