dsh-atc 0.0.0-stage → 0.16.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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dsh-atc contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,244 @@
1
- # Temporary Holding Version
1
+ # Agent 空管中心(dsh-atc)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ <p align="center">
4
+ <img src="assets/icon-256.png" width="112" alt="Agent 空管中心">
5
+ </p>
6
+
7
+ DeepSeek Harness 的 Agent 空管中心:在**左侧栏**加一行(和「插件」「自动化任务」并列),点开就是全屏面板,一屏看完**本机所有 agent** 正在干什么。
8
+
9
+ 零 token —— 宿主侧只读本地会话存储、纯本地推断状态,不经过任何模型。
10
+
11
+ ## 它解决什么
12
+
13
+ 同时用 DSH / codex / opencode / WorkBuddy / Trae / MiniMax 时,注意力会被切成 N 份。这个插件把「谁在跑、谁停了、谁在等我」压到一屏。
14
+
15
+ ## 数据源
16
+
17
+ | 工具 | 存储 | 读取方式 |
18
+ |---|---|---|
19
+ | dsh | `$DSH_HOME/sessions/<workspace>/<session>/session.v4.jsonl.zstd` + `$DSH_HOME/storages/workspace.json` | 目录 mtime + 工作区映射 |
20
+ | codex | `~/.codex/sessions/**/rollout-*.jsonl` | 文件 mtime + 头部 `cwd` / `model_provider` |
21
+ | opencode | `~/.local/share/opencode/opencode.db` | sqlite(`session` + `message.time_updated`) |
22
+ | workbuddy | `~/.workbuddy/workbuddy.db` | sqlite(`sessions.status/last_activity_at`) |
23
+ | gemini | `~/.gemini/tmp/<project>/chats/session-*.json` | 每 chat 一个 JSON,mtime + `.project_root` |
24
+ | zcode | `~/.zcode/cli/db/db.sqlite` | sqlite(`session` + `message.time_updated`,与 opencode 同构) |
25
+ | minimax | `~/.minimax/v2/sqlite/runtime-state.sqlite` | sqlite(`local_runtime_sessions.status/updated_at_ms` + 记录里的 `workspaceDir`) |
26
+
27
+ 读不了的会单独标出来,而不是假装不存在:看板探测 14 个候选工具,**能读的进列表,不能读的进 chip 行的第二段**(悬停显示路径 + 读不了的原因)。任何一个源失败只降级该源,不影响整板。
28
+
29
+ ## 读不了的 agent
30
+
31
+ 探测到但读不了的工具,会在 chip 行末尾以虚线 chip 出现,悬停显示探测到的路径和原因;**可读但为空的源不出现**——空库不代表这个 agent 坏了,没必要占一行。
32
+
33
+ 典型情况是 **Trae**:它的会话存在一个加密数据库里,明文读不到,所以在看板上显示为 `trae 已加密`。
34
+
35
+ 三条解法,按「干净程度」排:
36
+
37
+ 1. **装 TRAE CLI** —— CLI 会把会话写成 `~/.trae/cli/sessions/` 下的明文 jsonl,与控制台现有解析器同构。**解析器已经写好**(`collectTraeCli`),装上 CLI 就会自动出现在列表里。
38
+ 2. **让它自己导出** —— 社区 MCP 服务 [`mcp-session-saver`](https://www.npmjs.com/package/mcp-session-saver) 可在 IDE 里说一句「保存当前会话」,把对话落成 Markdown,再让看板读那个目录即可,**零逆向**。
39
+ 3. **解密数据库** —— [`Oh-My-Trae/trae-db-decrypt`](https://github.com/Oh-My-Trae/trae-db-decrypt) 做的是进程发现 + 内存扫描拿密钥。能work,但要读进程内存、随版本失效、风险自担,**不集成进插件**。
40
+
41
+ 同类工具官方也确认过这条边界:加密库暂不支持查看,界面只给 Markdown 导出([1](https://forum.trae.cn/t/topic/52906)、[2](https://forum.trae.cn/t/topic/174212/4))。
42
+
43
+ ## 界面怎么排
44
+
45
+ 本机能有 500+ 条历史会话,**平铺等于没有信息**。所以整页从「一眼看全貌」开始,再落到「谁在等我」:
46
+
47
+ ```
48
+ ┌ Agent 空管中心 [本地推断·零 token] 更新于 11:02 [今天|近7天|近30天|全部] [⟳ 刷新]
49
+ ├ 6 个 KPI:在跑 3 · 等你 0 · 失败 0 · 完成 38 · 本机会话 524 · 接入的 agent 4/4
50
+ ├ 活跃度(热力图) │ Agent 分布(字形 + 排行条)
51
+ ├ 状态分布(分段条:在跑 / 完成 / 刚停 / 无动静)
52
+ ├ 会话 124 [搜索标题、工作区…] [最近更新 | 按工具 | 按工作区]
53
+ │ agent 全部 124 · ● dsh 40 · > opencode 40 · ■ workbuddy 40 │ 状态 在跑 3 · 失败 1 · 完成 38 …
54
+ ├ ✓ 没有需要你处理的 ← 有事时才出现,且永远在最前
55
+ ├ ▾ 正在跑 3 > opencode 1 · ■ workbuddy 2 ← 卡片网格
56
+ ├ ▾ 最近动过 7 ■ workbuddy 3 · ● dsh 3 · > opencode 1
57
+ └ ▸ 更早 114 点开查看 ← 默认折叠,展开最多 60 张卡片
58
+ ```
59
+
60
+ 每个会话是一张卡片:标题 + 相对时间、日期、agent / 工作区标签、状态药丸、上下文占用条。
61
+
62
+ 判据:`needs-you`/`failed` → 第一段;`running` → 第二段;其余按 `recentMinutes` 切「最近动过 / 更早」。组标题上的数字是条数,右边是各 agent 分布。顶部的「本机共 524 个会话,只取最近 124 个」说明每个源最多取 `perSource` 条。
63
+
64
+ 热力图的周数是算出来的:按当前结果里最早的一条会话撑开(4–10 周),既不留大片空白,也不编造没有的历史。
65
+
66
+ ## agent 靠字形区分,不靠颜色
67
+
68
+ 八个色相装不下九个 agent:总有两个撞在一起,色弱用户则一个都分不出。所以每个 agent 有一个**专属轮廓**,颜色只做冗余补充:
69
+
70
+ | agent | 记号 | agent | 记号 |
71
+ | --- | --- | --- | --- |
72
+ | dsh | ● 实心圆 | minimax | △ 空心三角 |
73
+ | codex | ⬡ 空心六边形 | trae | ○ 空心圆环 |
74
+ | opencode | > 尖括号 | claude | ✳ 八向米字 |
75
+ | workbuddy | ■ 实心圆角方 | 其他/未接入 | ◌ 虚线圆环 |
76
+ | gemini | ✦ 四角星 | zcode | Z 字形 |
77
+
78
+ 这些是**抽象记号,不是品牌 Logo** —— 不臆造任何厂商的商标。同一套记号贯穿全页:筛选胶囊、卡片标签、Agent 分布的排行条、分组标题右侧的 agent 构成,扫一眼就能对上。
79
+
80
+ 同一批记号因此替代了两样东西:
81
+
82
+ - **环形图换成排行条**。九个 agent 挤进一个环就是九条细缝的纯颜色,是最难分辨的形态;排行条里「形状=是谁、条长=多少、颜色=重复一遍」。
83
+ - **状态颜色仍然保留**。状态那一维本来就带文字(在跑 / 失败 / 完成),颜色是语义色的补充,不承担识别职责。
84
+
85
+ ## 筛选
86
+
87
+ 右上角的时间窗口(今天 / 近 7 天 / 近 30 天 / 全部)作用在**最后活动时间**上;「会话」区可按标题、工作区、agent 搜索。
88
+
89
+ 筛选胶囊分成两组:**agent**(哪些 agent)和**状态**(哪些状态)。点一下是选中,**再点一下同一个胶囊就取消** —— 选不掉的筛选是坑。各组数字是**分面计数**:算当前这组的分布时,另一组不参与,所以切来切去数字不会变成一片 0。
90
+
91
+ 状态组只给四个值得筛的状态:**在跑 / 等你 / 失败 / 完成**。`刚停` 和 `无动静` 是兜底桶("最近没动静"),筛它们等于把「更早」那一段再翻一遍,所以不做成胶囊 —— 但卡片上的状态药丸照样显示这两个状态。默认全部时间、全部状态,不藏任何东西;筛完可以「清空筛选」复原。
92
+
93
+ ## 跳转
94
+
95
+ - **DSH 卡片**:点一下直接切到那个会话(`uiWorkspace.openSession`)
96
+ - **其它卡片**:复制该卡片的工作区路径,方便去对应工具里找
97
+ - 卡片底部的状态药丸与相对时间来自宿主推断,不代表工具本身在跑
98
+
99
+ ## 为什么没有花费
100
+
101
+ 不做跨 agent 的花费统计。唯一有对账本的是 DSH 自己(`dsh-cost-meter` 的 `ledger.json`),codex / opencode / WorkBuddy 没有可比的记账,把其中一家的钱放进「多 Agent 汇总」会误导,所以这一栏整个去掉了。每行只显示各源**自己真的能提供**的信息(见下方「额度 / 上下文」)。
102
+
103
+ ## 标星与隐藏
104
+
105
+ - **标星**:点卡片右上角的 ☆(或右键「标星并置顶」),这一条会从状态分档里提到最上面的「标星」分组,不管它现在是完成还是刚停。星存在浏览器本地(`dsh-atc:starred`),磁盘上的数据一个字节都不动。
106
+ - **隐藏**:右键「从看板移除」,这条从看板消失,底部出现「已移除 N 条 · 恢复」。同样是显示层,随时可撤回。
107
+
108
+ 顶部三张行动卡的计数**只统计屏幕上剩下的行**,所以隐藏或筛选之后,数字不会和列表打架。
109
+
110
+ ## 发现与自动接入
111
+
112
+ 插件认识的工具写在 `lib/sources.mjs` 里(声明式 spec:哪些表名、哪些列名算「会话库」)。除此之外,宿主启动 12 秒后会在后台遍历一次应用目录,把没见过的库按**内容**打分并匹配 spec:
113
+
114
+ - 形状完全对上(表名 + id/时间列都在)→ **自动并入看板**,行上标 `自动发现`,不需要你做任何事
115
+ - 只是「有张 sessions 表」→ 不并入,也不猜,只在空状态里列为候选
116
+ - 文件头不是 SQLite(加密容器)→ 标「读不了」
117
+
118
+ 结果缓存在 `$DSH_HOME/atc-discovered.json`,6 小时过期;轮询(每 5 秒)**从不触发扫描**,只读那 9 条固定路径。
119
+
120
+ ## 可调参数
121
+
122
+ 宿主每次轮询都会读 `$DSH_HOME/atc.json`(不存在就用默认值),**改完不用重启**:
123
+
124
+ > 改名之前叫 `fleet-board.json`,仍然兼容:两个文件都存在时以 `atc.json` 为准。
125
+
126
+ ```json
127
+ { "perSource": 40, "runningSeconds": 120, "recentMinutes": 30, "attentionHours": 24 }
128
+ ```
129
+
130
+ | 键 | 作用 |
131
+ |---|---|
132
+ | `perSource` | 每个源最多取多少条(影响「显示 N」) |
133
+ | `runningSeconds` | 无自带状态时,多少秒内有动静算「在跑」 |
134
+ | `recentMinutes` | 「最近动过 / 更早」的分界 |
135
+ | `attentionHours` | 失败态只在这么多小时内算「要你处理」,更早的失败是历史 |
136
+ | `autoDiscover` | 发现扫描命中已知形状的库时,是否自动并入看板(默认 `true`) |
137
+
138
+ 模板见 [atc.example.json](atc.example.json)。
139
+
140
+ ## DSH 的状态来自日志事件
141
+
142
+ DSH 的存储里没有状态列,所以它的「在跑 / 完成 / 失败」不看文件时间,而是读会话日志里最后那一对事件:
143
+
144
+ ```
145
+ turn/start → 有未结束的轮次 ⇒ 在跑
146
+ turn/end.reason.kind → completed / error / aborted / approval / …
147
+ ```
148
+
149
+ 映射:`approval|blocked` → 等你,`error` → 失败,`aborted|interrupted` → 已停;`completed` 只表示「这一轮结束了」,所以按时间衰减成刚停 / 无动静,不会一直挂着「在跑」。
150
+
151
+ 代价是每次会话有写入时要多解一小段日志尾部(倒退最多 24 帧就停),并且按 mtime 记忆 —— 40 个会话冷启 270 ms、热 23 ms。
152
+
153
+ ## 状态词典
154
+
155
+ 各源的自带状态按这套规则映射,不猜:
156
+
157
+ | 原始状态 | 归到 |
158
+ |---|---|
159
+ | `working` / `active` | 在跑 |
160
+ | `error` | 失败(且只在 `attentionHours` 内进「要你处理」) |
161
+ | `terminated` | 已停 |
162
+ | `completed` / `archived` | 完成 |
163
+ | `waiting` / `pending` / `confirm` / `approv` | 等你 |
164
+ | 其余 | 按最后活动时间推断 |
165
+
166
+ **「无动静」不是归档。** 它是兜底状态:该存储没有自带状态、而且已经很久(默认 > `recentMinutes` = 30 分钟)没有任何动静。真正归档的会话,如果存储自带 `archived`,会落在**完成**里;存储不给状态、只是很久没动的,就落在**无动静**。每个状态药丸都有 tooltip 说明它是怎么来的。
167
+
168
+ ## 状态怎么来的
169
+
170
+ 全部宿主侧推断,不调模型:
171
+
172
+ - 存储自带状态(如 WorkBuddy 的 `sessions.status`)优先,命中 `wait/pending/confirm/approv` → **等你**
173
+ - 否则按最后活动时间:< 2 分钟 → **在跑**;< 30 分钟 → **刚停**;更久 → **无动静**
174
+
175
+ 「等你」和「失败」计入 tab 标题上的数字,所以收起时也能看到有几条要处理。
176
+
177
+ ## 额度 / 上下文
178
+
179
+ 每行第二行的小字是各源**实际能提供**的信息,不编造:
180
+
181
+ | 源 | 显示 | 来源 |
182
+ |---|---|---|
183
+ | workbuddy | `ctx 25% · 17.3 点` | `session_usage` 的 `used/size` 与 `credit_json` |
184
+ | codex | `volcengine` | rollout 头部的 `model_provider` |
185
+ | dsh / opencode | 无 | 其存储不提供 per-session 成本 |
186
+
187
+ ## 安装(desktop profile)
188
+
189
+ ```powershell
190
+ # 1. 备份
191
+ Copy-Item "$env:USERPROFILE\.dsh\profiles\desktop\package.json" `
192
+ "$env:USERPROFILE\.dsh\profiles\desktop\package.json.bak"
193
+
194
+ # 2. 在 package.json 里加两处
195
+ # dependencies."dsh-atc" = "link:/path/to/dsh-atc"
196
+ # dsh.profile.bundles 追加 "dsh-atc"
197
+
198
+ # 3. 用 runtime 自带 pnpm 装(不要用系统 pnpm)
199
+ $rt = "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies"
200
+ cd "$env:USERPROFILE\.dsh\profiles\desktop"
201
+ & "$rt\node\bin\node.exe" "$rt\pnpm\bin\pnpm.cjs" install
202
+ ```
203
+
204
+ **必须重启桌面端**:宿主侧插件只在启动时组合进 profile,热加载不生效。
205
+
206
+ ## 使用
207
+
208
+ 左侧栏(和「插件」「自动化任务」并列)会多一行「**空管**」,点开就是面板。图标右上角出现小圆点表示有需要你处理的事。
209
+
210
+ ## 本地开发
211
+
212
+ ```powershell
213
+ node scripts/probe.mjs # 不开 DSH,直接打印面板数据(dry run)
214
+ node --test tests/contract.test.mjs # 宿主路由 + 客户端接线的契约测试
215
+ node scripts/render-check.mjs # 用真 React 把真数据渲染成 HTML,产出 render-check.html
216
+ node scripts/export-icon.mjs 512 # 把 assets/icon.svg 渲染成透明底 PNG
217
+ node scripts/audit-privacy.mjs # 发布前脱敏自查(非零退出即不合格)
218
+ node --check lib/index.js # 语法检查
219
+ ```
220
+
221
+ `npm publish` 前会自动跑 `check → test → audit:privacy`(`prepublishOnly`)。脱敏自查拦三类东西:**绝对路径**(含当前用户的 home 目录)、**一次性观察**(文件体量、文件头、表名这类只对某台机器成立的细节)、**疑似密钥与个人邮箱**。
222
+
223
+ 改了 `lib/` 要重启桌面端;改了 `client/client.js` 刷新页面即可(link 安装,文件就地生效)。
224
+
225
+ ### 真机无头验证(不碰 desktop profile)
226
+
227
+ ```powershell
228
+ # 1. 建一个独立测试 profile(CLI 可管理,desktop 不行)
229
+ dsh --profile fleet-test --from-default-profile web --dump-config
230
+ dsh plugin --profile fleet-test add "link:/path/to/dsh-atc"
231
+
232
+ # 2. 起一个独立 web 实例
233
+ dsh --profile fleet-test --port 60200 --no-open
234
+
235
+ # 3. 无头 Edge 打开、点开左侧栏的「空管」、截图
236
+ node scripts/live-check.mjs 'http://127.0.0.1:60200/?token=<token>' `
237
+ '--click=空管'
238
+ ```
239
+
240
+ `live-check.png` 是当次面板截图,`__dshFleetBoard.registered` 为 true 表示客户端在真宿主里注册成功。
241
+
242
+ ## 卸载
243
+
244
+ 删掉 `package.json` 里那两处,重跑 pnpm install,重启。
Binary file
Binary file
Binary file
@@ -0,0 +1,66 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="256" height="256" role="img" aria-label="Agent 空管中心">
2
+ <title>Agent 空管中心</title>
3
+ <defs>
4
+ <linearGradient id="tile" x1="0" y1="0" x2="0.35" y2="1">
5
+ <stop offset="0" stop-color="#1b2437"/>
6
+ <stop offset="1" stop-color="#090d15"/>
7
+ </linearGradient>
8
+ <linearGradient id="steel" gradientUnits="userSpaceOnUse" x1="8.6" y1="0" x2="15.4" y2="0">
9
+ <stop offset="0" stop-color="#7d93b8"/>
10
+ <stop offset="0.45" stop-color="#d3e0f5"/>
11
+ <stop offset="1" stop-color="#6f86ac"/>
12
+ </linearGradient>
13
+ <linearGradient id="wave" gradientUnits="userSpaceOnUse" x1="14" y1="4" x2="21.2" y2="15">
14
+ <stop offset="0" stop-color="#6f9bf7" stop-opacity="0.9"/>
15
+ <stop offset="1" stop-color="#6f9bf7" stop-opacity="0.3"/>
16
+ </linearGradient>
17
+ <radialGradient id="lamp" cx="0.5" cy="0.5" r="0.5">
18
+ <stop offset="0" stop-color="#f0a44a" stop-opacity="0.75"/>
19
+ <stop offset="1" stop-color="#f0a44a" stop-opacity="0"/>
20
+ </radialGradient>
21
+ <filter id="soft" x="-120%" y="-120%" width="340%" height="340%">
22
+ <feGaussianBlur stdDeviation="5"/>
23
+ </filter>
24
+ <filter id="glow" x="-160%" y="-160%" width="420%" height="420%">
25
+ <feGaussianBlur stdDeviation="11"/>
26
+ </filter>
27
+ </defs>
28
+
29
+ <rect width="256" height="256" rx="58" fill="url(#tile)"/>
30
+
31
+ <!-- tracked contacts: one per agent on the fleet -->
32
+ <g filter="url(#glow)" opacity="0.4">
33
+ <circle cx="60" cy="60" r="8" fill="#4c7cf3"/>
34
+ <circle cx="33" cy="99" r="8" fill="#2f9e6f"/>
35
+ <circle cx="29" cy="141" r="8" fill="#d98324"/>
36
+ <circle cx="46" cy="180" r="8" fill="#7c5cf0"/>
37
+ <circle cx="78" cy="208" r="8" fill="#e05fa8"/>
38
+ </g>
39
+ <g>
40
+ <circle cx="60" cy="60" r="6" fill="#4c7cf3"/>
41
+ <circle cx="33" cy="99" r="6" fill="#2f9e6f"/>
42
+ <circle cx="29" cy="141" r="6" fill="#d98324"/>
43
+ <circle cx="46" cy="180" r="6" fill="#7c5cf0"/>
44
+ <circle cx="78" cy="208" r="6" fill="#e05fa8"/>
45
+ </g>
46
+
47
+ <!-- the tower, same glyph as the sidebar row -->
48
+ <g transform="translate(118 128) scale(9.5) translate(-12 -8.7)">
49
+ <!-- broadcast waves -->
50
+ <g fill="none" stroke="url(#wave)" stroke-linecap="round">
51
+ <path d="M16.9 6.2a4.2 4.2 0 0 1 0 6.1" stroke-width="1.15"/>
52
+ <path d="M19.1 4.1a7.4 7.4 0 0 1 0 10.3" stroke-width="0.95" opacity="0.6"/>
53
+ </g>
54
+ <!-- mast + antenna -->
55
+ <g fill="none" stroke="url(#steel)" stroke-width="1.05" stroke-linecap="round">
56
+ <path d="M12 2.4v2.6"/>
57
+ <rect x="9" y="5" width="6" height="2.8" rx="1" fill="#c9d8f2" fill-opacity="0.18"/>
58
+ <path d="M10.2 7.8 9.4 15M13.8 7.8 14.6 15"/>
59
+ <path d="M8.6 15h6.8"/>
60
+ </g>
61
+ </g>
62
+
63
+ <!-- beacon on the antenna -->
64
+ <circle cx="118" cy="68" r="13" fill="url(#lamp)"/>
65
+ <circle cx="118" cy="68" r="4" fill="#f0a44a"/>
66
+ </svg>
@@ -0,0 +1,6 @@
1
+ {
2
+ "perSource": 40,
3
+ "runningSeconds": 120,
4
+ "recentMinutes": 30,
5
+ "attentionHours": 24
6
+ }