dsh-compact-relay 0.3.1 → 0.3.3
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 +15 -0
- package/README.en.md +4 -2
- package/README.md +4 -2
- package/ROADMAP.md +1 -0
- package/TUTORIAL.md +2 -1
- package/lib/client.js +7 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,21 @@
|
|
|
4
4
|
|
|
5
5
|
（暂无新改动）
|
|
6
6
|
|
|
7
|
+
## 0.3.3（2026-10-20，跨平台补丁版）
|
|
8
|
+
|
|
9
|
+
- **Windows 适配**：完整的测试套件（smoke 53 / handoff 35 / plugin-load 13 / contract 17 / compact-log）已在 Windows 11 + Node 24.22 实测全部通过。
|
|
10
|
+
- **测试跨平台修复**：`handoff` 的「目录不可写」用例改用「普通文件当父目录」制造 ENOTDIR（Windows 没有 `/dev/null` 语义）；`contract` 的交接目录断言按 `path.resolve` 比较（Windows 上 `/tmp` 会被解析为 `C:\tmp`）。
|
|
11
|
+
- **构建脚本**：`scripts/build-client.mjs` 忽略隐藏文件与 macOS 资源分叉（`._*`），拷贝/打包后的源码在 Windows 上也能通过 `--check`。
|
|
12
|
+
- **文档**：README（中英）与 DEVELOPMENT 注明测试需要 Node 22.15+（`node:module.registerHooks`）；TUTORIAL 常见问题补充「headless / QQ 桥接链路不加载指示灯与命令」；ROADMAP 明确不做桥接链路接管。
|
|
13
|
+
- 运行时功能与 0.3.2 一致。
|
|
14
|
+
|
|
15
|
+
## 0.3.2（2026-10-20，补丁版，行为无变化，仅设置页文案与链接）
|
|
16
|
+
|
|
17
|
+
- 设置页「帮助」区新增 npm 包页面外链（https://www.npmjs.com/package/dsh-compact-relay）；「使用教程」「反馈 / 提 bug」两条外链指向的 GitHub 地址已确认可用。
|
|
18
|
+
- 设置页「关于与危险操作」新增联系方式 `cfanzx@136.com` 与 npm 包页面入口。
|
|
19
|
+
- 链接未配置时的占位文案由「准备中」改为「未配置链接」（仅在用户手动清空 `links.tutorial` / `links.feedback` 时出现）。
|
|
20
|
+
- 其余功能与 0.3.1 一致。
|
|
21
|
+
|
|
7
22
|
## 0.3.1 — 2026-10-20（首个公开版：安全修复 + 架构调整 + M4/M5 体验 + 测试台 + UX 修复）
|
|
8
23
|
|
|
9
24
|
> 0.3.1 是首个公开版本（0.3.0 只用于内部发布准备、从未公开发布），汇总 0.2.x 以来的全部实现与真机验证。分四块：**安全与正确性修复**（M1/M2 安全修复、P3-01～14、BUG-001/004/007/008、P2-3/4）、**功能**（A1 九段交接单/预览卡、A4 配置 schema、A5 接力链、A6 压缩历史、A8 client 可维护性、A9 边界回正）、**体验**（M4 浮层材质/焦点/取消、菜单瘦身、设置页两行说明与三级颜色）、**测试与工程**（A7 mock/契约测试台、P2-T3/T4、e2e 真实压缩 + P2-T1 旧摘要合并、A10 状态帧成本基线）。
|
package/README.en.md
CHANGED
|
@@ -6,9 +6,10 @@
|
|
|
6
6
|
|
|
7
7
|
[简体中文](README.md) · English
|
|
8
8
|
|
|
9
|
+
[](https://www.npmjs.com/package/dsh-compact-relay)
|
|
9
10
|
[](https://www.deepseek.com/harness/)
|
|
10
11
|
[](LICENSE)
|
|
11
|
-
[](CHANGELOG.md)
|
|
12
13
|
|
|
13
14
|
</div>
|
|
14
15
|
|
|
@@ -66,7 +67,7 @@ Running `/pin` marks messages that must be preserved during compaction. Pinned m
|
|
|
66
67
|
|
|
67
68
|
## Installation
|
|
68
69
|
|
|
69
|
-
**Requirements**: DSH Desktop or `dsh web` 0.2.x (tested on 0.2.1-rc.2), Node.js 22
|
|
70
|
+
**Requirements**: DSH Desktop or `dsh web` 0.2.x (tested on 0.2.1-rc.2), Node.js 22+ (the plugin uses the runtime bundled with DSH). Running the source test suite requires Node **22.15+** (the harness uses `node:module.registerHooks`). The suite is verified on macOS and Windows 11 (Node 24.22).
|
|
70
71
|
|
|
71
72
|
```sh
|
|
72
73
|
dsh plugin --profile desktop add dsh-compact-relay
|
|
@@ -117,6 +118,7 @@ The first time a session is opened, the ring plays a brief highlight animation w
|
|
|
117
118
|
- **Does not modify prompts or model replies**: history is replaced only when the user explicitly confirms a compaction or runs a handoff.
|
|
118
119
|
- **Summary quality depends on the underlying model**: summaries use a structured nine-section template with format validation and a single retry, but output quality remains limited by the selected model.
|
|
119
120
|
- **Local storage only**: plugin state is stored in `~/.dsh/compact-relay.json` and handoff documents in `~/.dsh/handoffs/`; no external data is synchronized.
|
|
121
|
+
- **Tied to the desktop composer**: the ring indicator, `/bc` and `/handoff` depend on the DSH composer and slash-command system. They are not loaded in headless sessions or in bridge links such as QQ/WeChat, where `/bc` is treated as an ordinary message. That is a limitation of the bridge link, not a plugin failure.
|
|
120
122
|
- **UI language limitation**: the current UI is Simplified Chinese only; an English UI is planned with no fixed schedule.
|
|
121
123
|
|
|
122
124
|
## Version and license
|
package/README.md
CHANGED
|
@@ -6,9 +6,10 @@
|
|
|
6
6
|
|
|
7
7
|
简体中文 · [English](README.en.md)
|
|
8
8
|
|
|
9
|
+
[](https://www.npmjs.com/package/dsh-compact-relay)
|
|
9
10
|
[](https://www.deepseek.com/harness/)
|
|
10
11
|
[](LICENSE)
|
|
11
|
-
[](CHANGELOG.md)
|
|
12
13
|
|
|
13
14
|
</div>
|
|
14
15
|
|
|
@@ -66,7 +67,7 @@
|
|
|
66
67
|
|
|
67
68
|
## 安装
|
|
68
69
|
|
|
69
|
-
**环境要求**：DSH 桌面版或 `dsh web` 0.2.x（已于 0.2.1-rc.2 测试通过），Node.js 22
|
|
70
|
+
**环境要求**：DSH 桌面版或 `dsh web` 0.2.x（已于 0.2.1-rc.2 测试通过），Node.js 22+（插件跟随 DSH 自带运行时）。若要在源码里跑测试，需要 Node **22.15+**（测试脚手架用到 `node:module.registerHooks`）。测试已在 macOS 与 Windows 11（Node 24.22）实测全部通过。
|
|
70
71
|
|
|
71
72
|
```sh
|
|
72
73
|
dsh plugin --profile desktop add dsh-compact-relay
|
|
@@ -117,6 +118,7 @@ dsh plugin --profile desktop add github:cfanzx/dsh-compact-relay
|
|
|
117
118
|
- **不篡改提示词与模型回复**：插件仅在用户明确确认压缩或执行交接时替换对应历史记录。
|
|
118
119
|
- **摘要质量取决于底层模型**：摘要生成采用九段式结构化模板并包含格式校验与单次重试机制，但最终产出质量仍受限于所选模型的能力。
|
|
119
120
|
- **纯本地存储**：插件状态保存于 `~/.dsh/compact-relay.json`，交接文档保存于 `~/.dsh/handoffs/`，无任何外部数据同步。
|
|
121
|
+
- **依附桌面输入框**：环形指示器、`/bc`、`/handoff` 依附 DSH 的输入框与斜杠命令；headless 会话或 QQ / 微信等桥接链路不会加载它们，在这些链路里发 `/bc` 会被当成普通消息——这是桥接链路的能力边界，不是插件故障。
|
|
120
122
|
- **界面语言限制**：当前版本用户界面仅提供简体中文，英文界面已列入后续计划（排期未定）。
|
|
121
123
|
|
|
122
124
|
## 版本状态与开源许可
|
package/ROADMAP.md
CHANGED
package/TUTORIAL.md
CHANGED
|
@@ -58,8 +58,9 @@
|
|
|
58
58
|
- **压缩到一半取消了**：历史不会变、锁会释放；已发出的模型请求可能仍计费。
|
|
59
59
|
- **换模型后阈值变了**：阈值按窗口比例算，小窗口模型会自动变小，这是预期。
|
|
60
60
|
- **设置保存了但没变**：设置栏保存即时生效；改代码或 profile 配置才需要重启 DSH。
|
|
61
|
+
- **在 headless / QQ 桥上发 `/bc` 没反应**：指示灯和 `/bc`、`/handoff` 依附桌面输入框与斜杠命令，headless 会话和 QQ / 微信桥接链路不会加载它们，`/bc` 会被当成普通消息。插件本身不报错、也不额外烧模型调用；要在电脑上开 DSH 桌面版才能用。
|
|
61
62
|
|
|
62
63
|
## 5. 更多
|
|
63
64
|
|
|
64
65
|
- 安装、完整说明见仓库 `README.md`；设计文档见 `ARCHITECTURE.md`。
|
|
65
|
-
- 遇到 bug / 想提改进：到仓库 Issues
|
|
66
|
+
- 遇到 bug / 想提改进：到仓库 Issues 提一条（设置页「帮助」区的「反馈 / 提 bug」入口会直接打开）；也可以发邮件到 cfanzx@136.com。
|
package/lib/client.js
CHANGED
|
@@ -3103,8 +3103,10 @@ window.__ModuleLoader__.load({
|
|
|
3103
3103
|
h(
|
|
3104
3104
|
'div',
|
|
3105
3105
|
{ style: { display: 'flex', gap: 18, flexWrap: 'wrap', marginBottom: 18 } },
|
|
3106
|
-
githubLink('使用教程（GitHub）', form.links?.tutorial, '
|
|
3107
|
-
githubLink('反馈 / 提 bug（GitHub Issues）', form.links?.feedback, '反馈 / 提 bug
|
|
3106
|
+
githubLink('使用教程（GitHub）', form.links?.tutorial, '使用教程：未配置链接'),
|
|
3107
|
+
githubLink('反馈 / 提 bug（GitHub Issues）', form.links?.feedback, '反馈 / 提 bug：未配置链接'),
|
|
3108
|
+
// 2026-10-20：0.3.1 已发布到 npm，帮助区直接给包页面入口。
|
|
3109
|
+
githubLink('npm 包页面', 'https://www.npmjs.com/package/dsh-compact-relay', ''),
|
|
3108
3110
|
),
|
|
3109
3111
|
),
|
|
3110
3112
|
sectionHeading('关于与危险操作'),
|
|
@@ -3114,7 +3116,9 @@ window.__ModuleLoader__.load({
|
|
|
3114
3116
|
h('p', { style: settingsHintStyle }, `版本：${version || '—'}`),
|
|
3115
3117
|
h('p', { style: settingsHintStyle }, `设置文件：${settingsPath || '—'}`),
|
|
3116
3118
|
h('p', { style: { ...settingsHintStyle, marginTop: 8 } }, '输入框左侧的上下文指示灯：看容量、提醒压缩/交接、锁住重要消息；到线了用 /bc 或 /handoff，重要内容用 /pin 锁住。'),
|
|
3117
|
-
h('p', { style: settingsHintStyle }, '遇到 bug
|
|
3119
|
+
h('p', { style: settingsHintStyle }, '遇到 bug 或想提改进：走上面「帮助」里的 GitHub Issues；也欢迎直接发邮件。'),
|
|
3120
|
+
h('p', { style: settingsHintStyle }, '联系方式：cfanzx@136.com（合作、安全问题，以及不便公开讨论的事项）。'),
|
|
3121
|
+
h('p', { style: settingsHintStyle }, 'npm 包页面：https://www.npmjs.com/package/dsh-compact-relay'),
|
|
3118
3122
|
h('p', { style: settingsHintStyle }, '致谢：DeepSeek Harness；设置栏实现参考了 dsh-plugin-memory；也谢谢帮忙测试的朋友们。'),
|
|
3119
3123
|
h('div', { style: { display: 'flex', alignItems: 'center', gap: 10, marginTop: 20, paddingTop: 14, borderTop: '1px dashed var(--dsw-alias-border-l2, rgba(127,127,127,0.25))', flexWrap: 'wrap' } },
|
|
3120
3124
|
h('span', { style: { fontSize: 12, fontWeight: 600, color: 'var(--dsw-alias-state-error-primary, #d92d20)' } }, '危险操作'),
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-compact-relay",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.3",
|
|
4
4
|
"description": "DeepSeek Harness 上下文指示器插件：提供容量监控、压缩预览与确认、九段式交接单生成及消息锁定功能。 · Context indicator for DSH: preview-then-confirm compaction, 9-section session handoff, and pinned messages.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|