dsh-session-manager 0.5.1 → 0.5.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.
- package/CHANGELOG.md +247 -218
- package/README.md +139 -158
- package/README.zh.md +137 -166
- package/lib/annotation-store.js +41 -1
- package/lib/client.js +2772 -1953
- package/lib/index.js +134 -2
- package/lib/session-files.js +15 -2
- package/package.json +2 -2
package/README.zh.md
CHANGED
|
@@ -1,166 +1,137 @@
|
|
|
1
|
-
# dsh-session-manager — DeepSeek Harness 会话管理器
|
|
2
|
-
|
|
3
|
-
[English](README.md) | 中文
|
|
4
|
-
|
|
5
|
-
[](https://www.npmjs.com/package/dsh-session-manager)
|
|
6
|
-
[](https://github.com/hkkz9522/dsh-session-manager)
|
|
7
|
-
[](https://github.com/hkkz9522/dsh-session-manager/actions/workflows/ci.yml)
|
|
8
|
-
[](https://awesome-dsh-plugin.com)
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
本插件是 Cordis 插件，peer dependency 为 `cordis: ">=4.0.0-rc <5"`。
|
|
139
|
-
|
|
140
|
-
## 开发
|
|
141
|
-
|
|
142
|
-
- `lib/index.js` 是 host 端 ESM 插件，`lib/client.js` 是 Web 客户端 bundle，无需构建步骤。
|
|
143
|
-
- 提交修改前请运行：
|
|
144
|
-
|
|
145
|
-
```powershell
|
|
146
|
-
npm run check
|
|
147
|
-
npm test
|
|
148
|
-
npm run check:package
|
|
149
|
-
git diff --check
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
测试使用隔离临时目录和真实插件入口，不操作真实会话。CI 在 Windows/Linux、Node 22.15.0/24 上执行相同检查。
|
|
153
|
-
|
|
154
|
-
可选集成检查：在 DSH Web 已运行的测试环境中执行 `node scripts/smoke-test.mjs`；它会请求实际服务，不属于默认单元测试。
|
|
155
|
-
|
|
156
|
-
发布记录见 [CHANGELOG.md](CHANGELOG.md)。
|
|
157
|
-
|
|
158
|
-
## 致谢
|
|
159
|
-
|
|
160
|
-
感谢每一位安装和使用 dsh-session-manager 的用户，也感谢提交 Issue 与 Pull Request 帮助改进本插件的朋友们。
|
|
161
|
-
|
|
162
|
-
本插件已被 [dsh-market](https://github.com/dsh-market/dsh-market) 和 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 收录。欢迎提出修改意见。
|
|
163
|
-
|
|
164
|
-
## 开源许可
|
|
165
|
-
|
|
166
|
-
[MIT](LICENSE)
|
|
1
|
+
# dsh-session-manager — DeepSeek Harness 会话管理器
|
|
2
|
+
|
|
3
|
+
[English](README.md) | 中文
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/dsh-session-manager)
|
|
6
|
+
[](https://github.com/hkkz9522/dsh-session-manager)
|
|
7
|
+
[](https://github.com/hkkz9522/dsh-session-manager/actions/workflows/ci.yml)
|
|
8
|
+
[](https://awesome-dsh-plugin.com)
|
|
9
|
+
|
|
10
|
+
## 0 简介
|
|
11
|
+
|
|
12
|
+
DSH Web 会话管理：删除、归档、跨工作区移动、迁移预设；收藏、待看、搜索、排序、设置优先级、添加标签和备注；批量处理。欢迎至 GitHub 提意见。
|
|
13
|
+
|
|
14
|
+
## 1 功能
|
|
15
|
+
|
|
16
|
+
### 1.1 会话生命周期管理
|
|
17
|
+
|
|
18
|
+
- **删除**：不可逆操作，UI 始终要求二次确认。subagent 会话和尚未落盘的空白会话占位不能删除。
|
|
19
|
+
- **归档 / 移出归档**：把会话移出或移回主列表，不删除磁盘内容。
|
|
20
|
+
- **移动至工作区**：跨工作区移动时保留历史、标题、归档状态和派生会话关系，同时把 `cwd` 重写为目标工作区，并就地更新 live writer 的 header，使挂起的工具调用继续落到新路径。
|
|
21
|
+
- **迁移 Agent 预设**：原预设被改名或删除导致会话无法恢复时，可修复该会话。迁移会就地重写最后一条 `agent-preset/selected` 事件（若从未记录则修改会话 header），不改动历史消息。
|
|
22
|
+
|
|
23
|
+
### 1.2 会话快捷管理
|
|
24
|
+
|
|
25
|
+
- **收藏 / 待回看**：长期标记和手动提醒；不会随归档或会话结束自动清除。
|
|
26
|
+
- **搜索**：按标题、会话 ID、备注、标签不区分大小写匹配，自动去除首尾空格，不读取聊天历史。
|
|
27
|
+
- **筛选与排序**：工作区（全部 / 未分组 / 具体）与归档状态（全部 / 未归档 / 已归档）可叠加；可叠加收藏 / 待回看、标签和优先级筛选；排序支持最近更新（默认）、最早更新、最新创建、最早创建以及**优先级（1 → 5）**。
|
|
28
|
+
- **优先级**：下拉 **1 最高、2 高、3 普通、4 低、5 最低**，**默认 3（普通）**；旧数据中的 `null` 归一化为 3。
|
|
29
|
+
- **标签 / 备注**：每会话最多 20 个标签（每个 ≤ 32 字符）、备注最多 2000 字符。英文 `,` 与中文 `，` 都是分隔符，首尾空白被去除，重复标签按大小写不敏感合并。
|
|
30
|
+
- **AI 整理（手动、可选）**：标签 / 备注编辑窗口内的 **复制 Prompt** 把结构化提示复制到剪贴板，**导入** 解析剪贴板 JSON（可识别 Markdown 代码块、对话包裹、智能引号、孤立反斜杠和开头 BOM），按相同规则校验后填入字段；两者都不会自动调用模型。
|
|
31
|
+
- 标记保存在 `dsh-session-manager/annotations.v1.json`，按会话 ID 关联；同源浏览器标签页通过 `BroadcastChannel` 同步；保存可跨进程崩溃恢复，版本冲突会提示"载入最新内容"。
|
|
32
|
+
|
|
33
|
+
### 1.3 批量处理
|
|
34
|
+
|
|
35
|
+
- **批量模式入口**：在会话管理窗口顶部点击 **批量处理** 切换按钮，行左侧出现复选框，工具栏出现 **全选当前筛选 / 清空选择** 和 **批量按钮区**；退出批量模式会清空当前选中。
|
|
36
|
+
- **批量按钮区** 列出所有批量动作：
|
|
37
|
+
- **标记切换**：**归档 / 取消归档 / 收藏 / 取消收藏 / 待回看 / 取消待看**。
|
|
38
|
+
- **变更操作**：**添加标签 / 清空标签 / 设置优先级 / 移动至工作区 / 迁移预设 / 删除会话**。
|
|
39
|
+
- **执行流程**：非破坏性操作（归档 / 取消归档 / 收藏 / 取消收藏 / 待回看 / 取消待看 / 添加标签 / 清空标签 / 设置优先级 / 移动至工作区 / 迁移预设）立即执行，结果按会话逐条展示在 **结果对话框** 的 **成功 / 失败 / 跳过** 分组里，并提供 **重试失败项** 一键把失败 ID 重新加入选中；破坏性操作（**删除会话**）先弹 **预览对话框** 列出受影响的会话，再显示进度条，最后给出逐条结果。
|
|
40
|
+
|
|
41
|
+
## 2 UI入口
|
|
42
|
+
|
|
43
|
+
### 2.1 标题栏入口
|
|
44
|
+
|
|
45
|
+
标题栏右侧对**当前会话**提供：**归档 / 移出归档**、**标签 / 备注**、**移动至工作区**、**删除会话**。
|
|
46
|
+
|
|
47
|
+
### 2.2 会话管理入口与界面
|
|
48
|
+
|
|
49
|
+
从 DSH 侧边栏底部进入 **会话管理**，可浏览全部会话、切换工作区、按标题 / ID / 备注 / 标签搜索、应用筛选与排序，并对每条会话执行 **打开 / 归档 / 移出归档 / 标签 / 备注 / 移动 / 迁移预设 / 删除** 操作。窗口顶部承载工作区选择、归档筛选、收藏 / 待回看、标签、优先级筛选与排序控件，以及匹配 / 总数计数和"重置筛选"。
|
|
50
|
+
|
|
51
|
+
### 2.3 批量管理入口
|
|
52
|
+
|
|
53
|
+
会话管理窗口顶部的 **批量处理** 按钮即是入口：点一下进入批量模式，行左侧出现复选框，工具栏出现 **全选当前筛选 / 清空选择** 和 **批量按钮区**；再点一次退出批量模式。
|
|
54
|
+
|
|
55
|
+
## 3 安装
|
|
56
|
+
|
|
57
|
+
### 3.1 从官方插件管理入口安装
|
|
58
|
+
|
|
59
|
+
进入 DSH 应用内的 **插件管理**，搜索 `dsh-session-manager` 并安装。
|
|
60
|
+
|
|
61
|
+
### 3.2 从 dsh-market 安装
|
|
62
|
+
|
|
63
|
+
```powershell
|
|
64
|
+
dsh plugin --profile web add npm:dsh-session-manager
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### 3.3 从 GitHub 安装
|
|
68
|
+
|
|
69
|
+
```powershell
|
|
70
|
+
dsh plugin --profile web add github:hkkz9522/dsh-session-manager
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
安装后重启 DSH Web；若浏览器仍加载旧的客户端代码，请使用 `Ctrl+Shift+R` 强制刷新。
|
|
74
|
+
|
|
75
|
+
### 3.4 本地开发 / 运行时注入
|
|
76
|
+
|
|
77
|
+
```text
|
|
78
|
+
dev_inject_plugin {"dir": "<本仓库的绝对路径>"}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## 4 安全说明
|
|
82
|
+
|
|
83
|
+
- **删除不可恢复**，UI 始终要求二次确认；删除前校验会话 ID、目录边界和工件 header，不允许通过路径穿越、符号链接或 junction 操作其他目录。
|
|
84
|
+
- 移动和迁移预设保留 live session / agent；只有删除才会取消运行并释放会话。移动会更新保存的 cwd 和 live writer 的 header。
|
|
85
|
+
- 会话管理列表隐藏 subagent 会话，移动接口也拒绝 subagent；尚未落盘的空白会话不能跨工作区移动。
|
|
86
|
+
- 冷会话重写保留原工件格式（V1 / V2 / V3 / V4 都可读，绝不强制升级）。损坏或截断的 Zstd 日志、缺少完整尾行的 JSONL 会拒绝移动 / 重写，不会把部分历史当作完整日志保存。
|
|
87
|
+
- 迁移预设按"备份 → 发布 → 回滚"分阶段处理。如果回滚失败，会保留恢复文件并在错误中报告路径；不要删除这些文件。
|
|
88
|
+
- 启动扫描不完整时跳过工作区归属修复；完整扫描也不会清除仍在内存中或扫描期间新加入的会话。
|
|
89
|
+
- 同一会话的插件写操作按顺序执行；请求体限制为 64 KiB。该队列不替代 DSH 自身的持久化写入协调。
|
|
90
|
+
|
|
91
|
+
## 5 兼容性
|
|
92
|
+
|
|
93
|
+
| 插件版本 | 已验证 DSH 版本 |
|
|
94
|
+
| ------ | ------------- |
|
|
95
|
+
| 0.5.2 | v0.1.7-rc.1 |
|
|
96
|
+
| 0.5.1 | v0.1.6-alpha.2 |
|
|
97
|
+
| 0.4.11 | v0.1.5-rc.2 |
|
|
98
|
+
| 0.4.10 | v0.1.5-rc.1 |
|
|
99
|
+
| 0.4.9 | v0.1.5-rc.1 |
|
|
100
|
+
| 0.4.7 | v0.1.5-rc.1 |
|
|
101
|
+
| 0.4.6 | 0.1.3-alpha.2 |
|
|
102
|
+
| 0.4.4 | 0.1.3-alpha.2 |
|
|
103
|
+
| 0.4.1 | 0.1.3-alpha.2 |
|
|
104
|
+
| 0.4.0 | v0.1.2-rc.1 |
|
|
105
|
+
| 0.1.2 | v0.1.0-rc.7 |
|
|
106
|
+
| 0.1.1 | v0.1.0-rc.7 |
|
|
107
|
+
| 0.1.0 | v0.1.0-rc.7 |
|
|
108
|
+
|
|
109
|
+
运行时要求 Node.js 22.15+（22.x）或 24+，以提供内置 Zstd 支持。
|
|
110
|
+
|
|
111
|
+
本插件是 Cordis 插件，peer dependency 为 `cordis: ">=4.0.0-rc <5"`。
|
|
112
|
+
|
|
113
|
+
## 6 开发
|
|
114
|
+
|
|
115
|
+
- `lib/index.js` 是 host 端 ESM 插件，`lib/client.js` 是 Web 客户端 bundle，无需构建步骤。
|
|
116
|
+
- 提交修改前请运行：
|
|
117
|
+
|
|
118
|
+
```powershell
|
|
119
|
+
npm run check
|
|
120
|
+
npm test
|
|
121
|
+
npm run check:package
|
|
122
|
+
git diff --check
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
测试使用隔离临时目录和真实插件入口，不操作真实会话。CI 在 Windows / Linux、Node 22.15.0 / 24 上执行相同检查。
|
|
126
|
+
|
|
127
|
+
可选集成检查：在 DSH Web 已运行的测试环境中执行 `node scripts/smoke-test.mjs`；它会请求实际服务，不属于默认单元测试。
|
|
128
|
+
|
|
129
|
+
发布记录见 [CHANGELOG.md](CHANGELOG.md)。
|
|
130
|
+
|
|
131
|
+
## 7 致谢
|
|
132
|
+
|
|
133
|
+
感谢每一位安装和使用 dsh-session-manager 的用户，也感谢提交 Issue 与 Pull Request 帮助改进本插件的朋友们。本插件已被 [dsh-market](https://github.com/dsh-market/dsh-market) 和 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 收录。欢迎提出修改意见。
|
|
134
|
+
|
|
135
|
+
## 8 开源许可
|
|
136
|
+
|
|
137
|
+
[MIT](LICENSE)
|
package/lib/annotation-store.js
CHANGED
|
@@ -142,7 +142,47 @@ export function createAnnotationStore(directory, { io = fs, lockWaitMs = 1500 }
|
|
|
142
142
|
return next;
|
|
143
143
|
}));
|
|
144
144
|
},
|
|
145
|
-
|
|
145
|
+
batchUpdate(ids, patch, expectedRevisions) {
|
|
146
|
+
const normalized = normalizeAnnotationPatch(patch);
|
|
147
|
+
const idList = Array.from(new Set((Array.isArray(ids) ? ids : []).filter(id => typeof id === 'string' && id.trim() !== '').map(id => id.trim())));
|
|
148
|
+
if (idList.length === 0) throw fail('sessionIds 必须是非空数组');
|
|
149
|
+
if (idList.length > 200) throw fail('单次批量最多 200 条');
|
|
150
|
+
for (const id of idList) assertSessionId(id);
|
|
151
|
+
return enqueue(() => withLock(async () => {
|
|
152
|
+
const state = await read();
|
|
153
|
+
const nextSessions = { ...state.sessions };
|
|
154
|
+
const items = [];
|
|
155
|
+
let success = 0, failed = 0, skipped = 0;
|
|
156
|
+
for (const id of idList) {
|
|
157
|
+
try {
|
|
158
|
+
const previous = Object.hasOwn(nextSessions, id) ? nextSessions[id] : DEFAULT_ANNOTATION;
|
|
159
|
+
const expected = expectedRevisions instanceof Map ? expectedRevisions.get(id) : undefined;
|
|
160
|
+
if (expected !== undefined) {
|
|
161
|
+
if (!Number.isSafeInteger(expected) || expected < 0) throw fail('标记版本号无效');
|
|
162
|
+
if (expected !== previous.revision) throw fail('标记已被其他窗口修改，请载入最新内容后再保存', 'annotation-conflict');
|
|
163
|
+
}
|
|
164
|
+
if (Object.keys(normalized).every(key => JSON.stringify(previous[key]) === JSON.stringify(normalized[key]))) {
|
|
165
|
+
items.push({ sessionId: id, status: 'success', annotation: { ...previous }, unchanged: true });
|
|
166
|
+
success++;
|
|
167
|
+
continue;
|
|
168
|
+
}
|
|
169
|
+
const next = { ...previous, ...normalized, revision: previous.revision + 1, updatedAt: Date.now() };
|
|
170
|
+
if (!Number.isSafeInteger(next.revision)) throw fail('标记版本号已超出范围', 'annotations-unavailable');
|
|
171
|
+
nextSessions[id] = next;
|
|
172
|
+
items.push({ sessionId: id, status: 'success', annotation: next });
|
|
173
|
+
success++;
|
|
174
|
+
} catch (error) {
|
|
175
|
+
const code = error && typeof error.code === 'string' ? error.code : undefined;
|
|
176
|
+
items.push({ sessionId: id, status: 'failed', code, error: error && error.message ? error.message : String(error) });
|
|
177
|
+
failed++;
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
const anyChanged = items.some(item => item.status === 'success' && !item.unchanged);
|
|
181
|
+
if (anyChanged) await publish({ version: 1, sessions: nextSessions });
|
|
182
|
+
return { summary: { total: idList.length, success, failed, skipped }, items };
|
|
183
|
+
}));
|
|
184
|
+
},
|
|
185
|
+
async remove(id) {
|
|
146
186
|
assertSessionId(id);
|
|
147
187
|
// A plugin that has never used annotations should not create a directory
|
|
148
188
|
// just because an ordinary session was deleted.
|