dsh-conversation-overview 1.4.1 → 1.4.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/.scratch/test.mjs +1358 -0
- package/README.md +59 -4
- package/package.json +6 -2
package/README.md
CHANGED
|
@@ -38,7 +38,7 @@ CLI 安装后重启 `dsh` 生效（方式一/二安装后刷新浏览器页面
|
|
|
38
38
|
|
|
39
39
|
安装后在「设置 → 会话概览」或插件行内配置中调整选项；对话页刷新即可看到「概览」标签页与右侧边栏入口。
|
|
40
40
|
|
|
41
|
-
>
|
|
41
|
+
> 注意：若此前用 `link:` 装过本地开发副本（同名包指向你的工作目录），请先移除再安装本包——两者使用相同的插件行 id（`conversation-overview`）与插槽 key，不应同时启用。判断方法：`grep dsh-conversation-overview ~/.dsh/profiles/web/package.json`，出现 `link:/…` 即为开发版。
|
|
42
42
|
|
|
43
43
|
**插件更新**：
|
|
44
44
|
|
|
@@ -78,14 +78,69 @@ CLI 安装后重启 `dsh` 生效（方式一/二安装后刷新浏览器页面
|
|
|
78
78
|
|
|
79
79
|
## 开发与测试
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
### 代码结构
|
|
82
82
|
|
|
83
|
-
|
|
83
|
+
包内**没有构建步骤**，两个源文件直接就是发布物：
|
|
84
|
+
|
|
85
|
+
| 文件 | 运行位置 | 职责 |
|
|
86
|
+
| --- | --- | --- |
|
|
87
|
+
| `index.js` | Host（Node） | schemastery 配置字段定义、`dsh-resource://` 资源定位与 Host 侧数据接口 |
|
|
88
|
+
| `client.js` | 浏览器（Web UI） | 概览页/侧边栏 UI、会话事件折叠、标签页注册，以 `window.__ModuleLoader__` 工厂函数形式被加载 |
|
|
89
|
+
|
|
90
|
+
改完文件后：Host 侧（`index.js`、`cordis.patch.yml` 的配置项）需要**重启 DSH** 才生效；纯客户端（`client.js`）**刷新页面**即可。
|
|
91
|
+
|
|
92
|
+
### 本地调试安装
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# 让 profile 直接引用本地目录（改完刷新即生效，不必反复装包）
|
|
96
|
+
dsh plugin --profile web add link:/absolute/path/to/dsh-conversation-overview
|
|
97
|
+
|
|
98
|
+
# 确认装的是开发版而不是 npm 版
|
|
99
|
+
grep dsh-conversation-overview ~/.dsh/profiles/web/package.json # 应看到 link:/…
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### 运行测试
|
|
103
|
+
|
|
104
|
+
测试脚本随包发布，无需构建、无需联网。它会在 Node 里用桩（stub）替代浏览器环境——`window`、`localStorage`、`React`——然后加载 `client.js`，对**真实会话日志**做一遍完整折叠并断言结果。
|
|
84
105
|
|
|
85
106
|
```bash
|
|
86
|
-
|
|
107
|
+
# 默认自动取本机最近的 2 个会话日志
|
|
108
|
+
npm test
|
|
109
|
+
|
|
110
|
+
# 或指定任意日志（可传多个，跨会话、跨工作区都行）
|
|
111
|
+
node .scratch/test.mjs ~/.dsh/sessions/<workspace>/<session-id>/session.v4.jsonl.zstd \
|
|
112
|
+
~/.dsh/sessions/<workspace>/<other-session-id>/session.v4.jsonl.zstd
|
|
87
113
|
```
|
|
88
114
|
|
|
115
|
+
- 依赖 **Node ≥ 20** 与 **`zstdcat`**（日志是 zstd 压缩的；macOS：`brew install zstd`）。
|
|
116
|
+
- 会话日志位置：`~/.dsh/sessions/<工作区>/<session-id>/session.v4.jsonl.zstd`，每一轮对话都在里面。
|
|
117
|
+
- 全部通过时输出 `ALL TESTS PASSED`，并列出实际检查了哪几个日志；任一断言失败会直接给出断言信息与所在行号。
|
|
118
|
+
|
|
119
|
+
### 测试覆盖范围
|
|
120
|
+
|
|
121
|
+
共 16 组、约 460 条断言，全部离线运行：
|
|
122
|
+
|
|
123
|
+
| # | 覆盖内容 |
|
|
124
|
+
| --- | --- |
|
|
125
|
+
| 1 | `zh`/`en` 词典键完全对齐（少一个键就失败，避免界面出现原始 key） |
|
|
126
|
+
| 2 | `apply()` 在 mock `ctx` 上注册了哪些标签页/插槽，以及每个配置开关的显隐效果 |
|
|
127
|
+
| 3 | 用真实日志跑完整折叠：待办、关键步骤、产物、引用、统计、里程碑 |
|
|
128
|
+
| 4 | 地址解析、助手提及、变更事件等纯函数 |
|
|
129
|
+
| 5 | 文件类型分类与工作区变更聚合 |
|
|
130
|
+
| 6 | OpenViking 预览与 Markdown 渲染 |
|
|
131
|
+
| 7 | frontmatter、面包屑、引用排序 |
|
|
132
|
+
| 8 | 按轮次折叠（`latest` / `all` 两种范围）与上下文快照 |
|
|
133
|
+
| 9 | 全量引用识别（正文里出现过的资源是否都被收集） |
|
|
134
|
+
| 10 | 关键步骤流与轮次导航轨的联动刻度 |
|
|
135
|
+
| 11 | 「新标签打开」确实落到宿主自己的 Markdown 文档页 |
|
|
136
|
+
| 12 | 「本轮结论」只在该轮结束后出现 |
|
|
137
|
+
| 13 | 结论自动打开：只在观察到该轮实际运行后打开一次（刷新不会重开） |
|
|
138
|
+
| 14 | 子代理相关界面只在真有子代理工作时出现（压缩里程碑不算） |
|
|
139
|
+
| 15 | 文档标签刷新后仍能恢复正文（结论/计划快照镜像到 `localStorage`） |
|
|
140
|
+
| 16 | 代理身份判定：`origin: "subagent"` 才是子代理，分叉/续聊会话算主会话 |
|
|
141
|
+
|
|
142
|
+
> 这些断言同时充当回归护栏：改动 `client.js` 的折叠或显隐逻辑后先跑 `npm test`，比在浏览器里逐个点要快得多。
|
|
143
|
+
|
|
89
144
|
## License
|
|
90
145
|
|
|
91
146
|
MIT © 2026
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-conversation-overview",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "DeepSeek Harness (DSH) plugin: an Overview tab beside Chat/Trajectory plus a right-sidebar page summarizing session progress (goal, todos, key steps), artifacts, and references, with per-turn scoping, OpenViking memory preview, and quick-nav linkage.",
|
|
6
6
|
"keywords": [
|
|
@@ -40,8 +40,12 @@
|
|
|
40
40
|
"icon.svg",
|
|
41
41
|
"README.md",
|
|
42
42
|
"LICENSE",
|
|
43
|
-
"assets/overview.png"
|
|
43
|
+
"assets/overview.png",
|
|
44
|
+
".scratch/test.mjs"
|
|
44
45
|
],
|
|
46
|
+
"scripts": {
|
|
47
|
+
"test": "node .scratch/test.mjs"
|
|
48
|
+
},
|
|
45
49
|
"engines": {
|
|
46
50
|
"dsh": ">=0.2.1-rc.2",
|
|
47
51
|
"node": ">=20"
|