dsh-collab-workbench 0.1.1 → 0.1.2
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.
Potentially problematic release.
This version of dsh-collab-workbench might be problematic. Click here for more details.
- package/README.md +69 -89
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,133 +1,113 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 协作工作台 · Collaboration Workbench
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
DeepSeek Harness 的多 Agent 项目协作插件。通过自定义角色、项目群聊和任务调度，让不同职责的 Agent 在同一项目中协作，并保留执行记录与交付依据。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
npm 包名：`dsh-collab-workbench`。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## 核心功能
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
- **人员与角色**：创建自定义人员，设置职责描述和模型，为项目组织不同分工。
|
|
10
|
+
- **项目群聊**：在群内沟通，通过 @ 指定成员；群组关联项目工作目录。
|
|
11
|
+
- **任务管理与自动调度**：指派成员、设置优先级及前置依赖，系统按可用执行额度安排任务。
|
|
12
|
+
- **执行记录与恢复**：保存输入、执行状态、结果摘要和证据；支持显式重试、停止及有界的中断恢复。
|
|
13
|
+
- **群内权限审批**：在可明确关联的请求上，展示宿主原生审批入口；无法安全关联时回到原会话处理。
|
|
14
|
+
- **交付与记忆**：支持管理员最终交付，以及个人和团队记忆。
|
|
15
|
+
- **版本更新**：关于页手动检查更新，发现新版时显示侧栏云朵提示；安装前需要用户确认。
|
|
10
16
|
|
|
11
|
-
|
|
17
|
+
## 安装
|
|
12
18
|
|
|
13
|
-
|
|
19
|
+
本包是 **DeepSeek Harness 插件**，不是可单独运行的应用。需要已安装并可正常运行的 Harness，以及可用的模型配置。
|
|
14
20
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
- 任务执行只走持久调度路径：多任务号启动公告、未关联任务的执行成员 @ 不再回落另一套普通群会话；需明确 taskId。管理员协调保留，旧种子认领指示统一为独立执行汇报。
|
|
18
|
-
- 创建者身份从实际群会话推导并校验；无法确定创建者的自动通知署名“系统”，不再伪装成用户。
|
|
19
|
-
- 项目所有任务完成后，持久交接队列唤醒一名可用管理员进行最终复核，原成员回执不重复刷群。交接按项目任务版本去重，投递失败可恢复。负责人用 dwb_notify_user 完成最终交付，未完成任务不能提前交付，同版本不重复通知；新增/返工使旧交付失效。
|
|
20
|
-
- 升级时历史已完成项目只标记“待复核”，不自动重跑或批量唤醒旧项目，也不假定历史已经交付。以后新的完成转换会自动交接。
|
|
21
|
-
- 已有且唯一匹配项目目录的 SOPAI 工作项从工作台派生状态与证据；保留人工决策/调用历史和首页人工正文，不补造过去的记录。无项目工作项时不创建；匹配歧义/读写冲突明确记录错误。JSON 与首页分别原子更新，非跨文件事务，失败通过重试收敛。
|
|
22
|
-
- 审批与普通群消息按时间稳定穿插；审批结果原位更新，不再按待审批/已处理重排。原生授权能力、卡片样式和明暗主题令牌不变。
|
|
23
|
-
- execution.status 返回项目交付、工作项同步状态及交接队列，便于检查未交付和同步异常。
|
|
24
|
-
|
|
25
|
-
验证：`npm test` 与 `npm run build`。测试使用隔离临时台账及宿主依赖替身；不代表已在用户页面完成审批或明暗主题实测。替换已安装插件后，按安装结果要求重启 Harness，再刷新原页面。
|
|
21
|
+
在 Harness 的插件管理功能中，以 npm 包名安装并启用：
|
|
26
22
|
|
|
23
|
+
```text
|
|
24
|
+
dsh-collab-workbench
|
|
25
|
+
```
|
|
27
26
|
|
|
28
|
-
|
|
27
|
+
也可让 Harness 中的助手协助安装，示例：
|
|
29
28
|
|
|
30
|
-
|
|
29
|
+
> 请从 npm registry 安装并启用 dsh-collab-workbench 插件。
|
|
31
30
|
|
|
32
|
-
|
|
33
|
-
- 按当前 Session、callId、工具和原因关联；无法明确关联、同一调用存在多个未结请求、已取消或过期时禁用群内授权，保留“打开原会话”入口。审计 UUID 与 Client 本地交互 key 不混用。
|
|
34
|
-
- 宿主的 `approval/asked`、`approval/decided` 日志通过增量会话投影提供显示数据。已允许、已拒绝、取消及过期结果会同步到群内卡片；最近记录可查看，较早记录仍以原会话审计为准。
|
|
35
|
-
- 执行实例进入 `approval-wait`，任务仍属进行中但执行汇总显示“等待权限审批”；占用成员和并发额度，不触发无活动提醒、继续提示或自动重试。普通消息不会解除审批等待。
|
|
36
|
-
- 在原会话回答同一请求后，群内入口失效；在群内回答后，原请求也随即结算。终止任务会取消其请求，迟到结果不能复活任务。
|
|
37
|
-
- 刷新或重连后只复用宿主仍在等待的原始请求，不根据历史记录制造新的批准能力；宿主进程重启按原有有界恢复处理，旧卡片不可授权。
|
|
38
|
-
- 打开群时保留相关活动会话的 Client 引用以接收原生审批。切换群组或页签不会撤销尚未回答的原生请求；引用由插件后台维护，任务结束、群删除或插件卸载时释放。本版没有跨群全局审批收件箱。
|
|
39
|
-
- 页面刷新后使用新版界面。安装结果为 applied 不等于已经验证当前用户页面的视觉；明暗主题、批准、拒绝和取消已在隔离的真实 Harness + Chrome 中验证，未操作用户业务审批。
|
|
31
|
+
安装结果若提示重启，请先重启 Harness，再刷新页面。普通的 `npm install` 只下载 npm 包，不等于已在 Harness 中启用插件。
|
|
40
32
|
|
|
41
|
-
|
|
33
|
+
若遇到下载失败，检查本机及 Harness profile 的 registry、作用域 registry 和网络设置；指定公共 registry 不一定覆盖本机已有的作用域配置。
|
|
42
34
|
|
|
43
|
-
|
|
35
|
+
## 快速开始
|
|
44
36
|
|
|
45
|
-
|
|
37
|
+
1. 打开侧栏中的“协作工作台”。
|
|
38
|
+
2. 创建人员，为每人填写名称、职责及模型配置。
|
|
39
|
+
3. 创建项目群，选择成员、管理员和项目工作目录。
|
|
40
|
+
4. 在群中描述目标，通过 @ 指定人员沟通；创建任务并设置指派和依赖。
|
|
41
|
+
5. 查看任务状态与成员结果，处理必要的决策或权限审批，由管理员核验并完成最终交付。
|
|
46
42
|
|
|
47
|
-
|
|
48
|
-
2. 按高/中/低优先级、前置依赖和可用执行额度启动；默认全局最多 3 个执行，同一个角色最多 1 个。
|
|
49
|
-
3. 不同任务共享同一项目目录时顺序运行。同一个任务的多个指派成员可以协作并行；本版没有为每个成员自动建立 Git worktree。
|
|
50
|
-
4. 执行者用 `dwb_report_execution` 汇报。完成必须有摘要、依据，并处理完已经收到的新输入；一轮聊天结束不代表任务完成。
|
|
51
|
-
5. 全部当前指派成员完成后，任务自动变为“已完成”。等待、失败、暂停等详细状态独立保存在执行记录里，兼容原有任务界面的三种状态。
|
|
52
|
-
6. 失败、阻塞、长时间没有活动时，系统通过持久通知队列在群内提醒，不会仅在后台日志里留下错误。
|
|
43
|
+
任务执行需要使用者提供适用的模型和工具权限。系统记录的“已完成”基于执行成员汇报和程序条件，不替代对代码、测试及成果的独立验收。
|
|
53
44
|
|
|
54
|
-
|
|
45
|
+
## 五种预设角色类型
|
|
55
46
|
|
|
56
|
-
|
|
47
|
+
创建人员时可选择下列模板，也可以使用自定义类型和职责：
|
|
57
48
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
49
|
+
| 类型 | 默认职责 |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| 研发负责人 | 接收需求、分解任务、协调进度、验收交付 |
|
|
52
|
+
| 架构师 | 技术方案设计、架构评审 |
|
|
53
|
+
| 高级工程师 | 代码实现、联调、自测 |
|
|
54
|
+
| 测试工程师 | 测试用例设计、质量验证 |
|
|
55
|
+
| 产品经理 | 需求澄清、验收标准定义、价值把关 |
|
|
65
56
|
|
|
66
|
-
|
|
57
|
+
这些是**可选模板**，安装不会自动创建五名人员。每位用户的人员、职责、模型、群组和任务由其自行配置；发布者本机的角色及工作数据不随包分发。
|
|
67
58
|
|
|
68
|
-
##
|
|
59
|
+
## 更新方式
|
|
69
60
|
|
|
70
|
-
|
|
61
|
+
在工作台侧栏底部打开“关于”，点击“检查更新”。
|
|
71
62
|
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
-
|
|
77
|
-
- 删群先持久标记 deleting 并取消任务，再按精确 Session ID 清理；自定义项目目录与收养的工作区保留。
|
|
78
|
-
- 存在可恢复的任务 Session 时，不移动默认群目录；请先完成或停止任务。自定义目录只改群名。
|
|
63
|
+
- npm registry 来源的安装可查询新版本；有更新时出现侧栏云朵和更新入口。
|
|
64
|
+
- 更新需用户点击并确认，不会自动安装。
|
|
65
|
+
- 安装成功后按提示重启 Harness，再确认当前版本。
|
|
66
|
+
- 本地 tgz 或目录安装不提供 npm 在线更新，也不会擅自切换来源。
|
|
67
|
+
- 网络或 registry 异常只影响检查；不会因此删除工作台数据。
|
|
79
68
|
|
|
80
|
-
|
|
69
|
+
验证升级需先从 npm 安装较早版本，例如 `dsh-collab-workbench@0.1.1`，再在发布 0.1.2 后检查更新。同版本安装不会显示“发现新版”。
|
|
81
70
|
|
|
82
|
-
##
|
|
71
|
+
## 数据与权限边界
|
|
83
72
|
|
|
84
|
-
|
|
73
|
+
工作台台账默认位于 `$DSH_HOME/dsh-workbench/state.json`，保存人员、群组、任务及执行状态；记忆保存在同一数据目录下。工作数据不上传到 npm。Agent 使用模型和工具时的数据处理仍由使用者的 Harness、模型服务及工具配置决定。
|
|
85
74
|
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
75
|
+
- 安装或更新插件不会把发布者的人员、任务或会话复制给使用者。
|
|
76
|
+
- 升级保留原数据目录；重要项目建议先备份工作台数据和项目文件。
|
|
77
|
+
- 调度不会提高 Agent 权限，工具调用仍受 Harness 的授权与文件访问规则约束。
|
|
78
|
+
- 恢复任务时应先核对已有成果；不保证任意外部操作或文件修改恰好执行一次。
|
|
79
|
+
- 同一任务的多个成员可能同时工作；插件不会自动为每人建立 Git worktree，需合理划分文件范围。
|
|
90
80
|
|
|
91
|
-
|
|
81
|
+
### 与 SOPAI 的关系
|
|
92
82
|
|
|
93
|
-
|
|
94
|
-
|---|---|
|
|
95
|
-
| `dwb_task_execution` | 分页查询执行状态、结果依据和输入；用 inputId/inputOffset 续读长输入 |
|
|
96
|
-
| `dwb_report_execution` | 当前执行会话汇报自己的 running/waiting/blocked/completed/failed |
|
|
97
|
-
| `dwb_manage_execution` | 管理员显式 retry 或 stop |
|
|
83
|
+
**不需要安装 SOPAI Skill，工作台可独立使用。**
|
|
98
84
|
|
|
99
|
-
|
|
85
|
+
若群组项目目录中已经存在唯一匹配的 `.sopai/runs/<工作项>/work_item.json`，插件可将工作台状态、执行摘要和证据同步到该工作项及复核首页。没有匹配工作项时跳过，不自动创建 SOPAI 项目，不要求以 SOPAI 流程启动任务。
|
|
100
86
|
|
|
101
|
-
|
|
87
|
+
## 版本记录
|
|
102
88
|
|
|
103
|
-
|
|
89
|
+
### 0.1.2
|
|
104
90
|
|
|
105
|
-
|
|
91
|
+
- 重写面向使用者的说明：补充安装、快速开始、角色模板、更新方式和数据权限边界。
|
|
92
|
+
- 修正公开版本说明，移除混杂在首页中的内部开发版本记录。
|
|
93
|
+
- 更新 npm 简介；本次不更改任务调度或界面运行逻辑。
|
|
106
94
|
|
|
107
|
-
|
|
95
|
+
### 0.1.1
|
|
108
96
|
|
|
109
|
-
|
|
97
|
+
首次正式公开发布，包含协作工作台及关于页版本检查、用户确认更新功能。
|
|
110
98
|
|
|
111
|
-
##
|
|
99
|
+
## 开发
|
|
112
100
|
|
|
113
|
-
|
|
101
|
+
以下命令用于开发工作目录；npm 安装包不包含测试目录：
|
|
114
102
|
|
|
115
103
|
```bash
|
|
104
|
+
npm run build
|
|
116
105
|
npm test
|
|
117
106
|
npm run check
|
|
118
|
-
npm run test:native
|
|
119
107
|
```
|
|
120
108
|
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
`test:native` 使用临时 DSH_HOME、本地模拟模型和独立测试进程，验证真实桌面 Harness 的加载、稳定 Session、收件箱、工具所有权、多人完成及进程被终止后的原会话恢复。它不使用用户 profile、不调用外部模型，也不会留下替代用户 GUI 的服务器。脚本的桌面运行时路径需要与本机安装一致。
|
|
124
|
-
|
|
125
|
-
Host 依赖来自安装此包的 Harness，不为测试下载另一版本的内核。隔离业务测试使用遵守消息不可变性与事件形状的桩。
|
|
126
|
-
|
|
127
|
-
## 数据和边界
|
|
128
|
-
|
|
129
|
-
台账默认位于 `$DSH_HOME/dsh-workbench/state.json`，仍使用单文件原子替换，新增版本化保存排空机制；不能读取或损坏的台账会阻止写入，不会静默覆盖成空数据。记忆仍在同目录下的个人/团队 Markdown 中。
|
|
109
|
+
Host 依赖由 Harness 提供。隔离测试使用宿主替身；测试通过不等于已完成使用者环境的真实模型、权限审批、明暗主题或冷启动验收。
|
|
130
110
|
|
|
131
|
-
|
|
111
|
+
## 许可证
|
|
132
112
|
|
|
133
|
-
|
|
113
|
+
Apache-2.0。原创 SVG 图标随包以同一许可证提供。
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-collab-workbench",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.2",
|
|
4
|
+
"description": "DeepSeek Harness 多 Agent 协作工作台：自定义角色、项目群聊、任务自动调度、群内权限审批与执行恢复",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"dsh-plugin",
|
|
7
7
|
"deepseek-harness",
|