dsh-wdx-relief 0.3.2 → 0.4.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/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.4.0 — 2026-11-11
4
+
5
+ - 新增 **输入框上的一行**(默认开启):逐轮显示「这一轮在做什么、到哪了」,不再是「离开三分钟后」的会话级回顾。
6
+ - 四种语义独立开关:活动流水(`recapActivity`)、状态耗时(`recapTiming`)、思考预览(`recapReasoning`)、语义摘要(`recap`)。默认只开语义摘要,回到旧版一行概括的观感;前三项只读事件窗口,本地生成、零模型调用,需要时再打开,避免与会话里已有的工具卡片/耗时/推理重复交叉。
7
+ - 摘要参考 `@lanlance/pi-recap` 的门限:`recapMinTurns`(默认 3)、`recapCooldownTurns`(默认 3)、`recapSimilarityThreshold`(默认 0.7)、`recapMaxWords`(默认 40,中文按字算);`recapPlacement` 可选输入框上方 / 下方。
8
+ - `recapModelChain` 支持按顺序尝试 `provider/model`;留空自动挑便宜模型(flash / mini / lite / haiku 等),最后退回默认模型。模型失败时退回本地短拼接,并带 `degraded`。
9
+ - 这一行是纯 UI:只读 `deriveMessages()` 与事件窗口,模型调用走 `ctx.llm.stream`,不写会话、不注入 prompt、不进入模型上下文。
10
+ - 右侧栏 WDX Relief 页面改为 Tab:默认「没接住的事」,「旁问」单独一个 Tab,不再平铺。
11
+ - 旁问输入框改为 composer 风格:圆角卡片、底部模型位、右侧圆形发送/停止按钮;模型位来自 `ctx.modelDirectories`,选中的模型只影响旁问,不改主会话。宽度不够时模型名收成数据图标,只保留图标和下拉箭头。
12
+ - 移除旁问面板里重复的「不写入上下文」徽标和「只留在面板…」提示。
13
+ - 新增 **右侧栏「旁问」**:输入问题后用当前会话模型(或面板选的模型)回答,背景只取最近几轮文本;问答只存在面板内存里,不写会话、不写命令日志,也不进入模型上下文。
14
+ - 新增 `POST /api/wdx-relief/recap` 与 `POST /api/wdx-relief/btw`;旁问路由复用 `src/btw.js`,不产生命令生命周期。
15
+ - 旧 Host 未加载旁问路由时,面板显示「旁问路由未加载;请重启 DSH 后再试」,不再直接暴露 HTTP 404。
16
+ - `dsh.client.inject` 增加 `dsh-client-ui-sidebar-right`;Host 依赖保持 `connection` 与 `sessions`,不再注册 composer `/btw` 命令和 transcript 卡片。
17
+ - 更新 README、开发文档和 bundle 默认配置。
18
+
3
19
  ## 0.3.2 — 2026-11-09
4
20
 
5
21
  - 修复:Tab 填入预测后把输入删空,建议不会重新出现;现在只收起当前建议,同一轮缓存会重新给出,Esc 仍忽略本轮。
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # WDX Relief
2
2
 
3
- 降低 DSH 日常使用心智负担的小功能集合。目前两个功能,**全部设置都在这个插件的配置里**。
3
+ 降低 DSH 日常使用心智负担的小功能集合。目前六个功能,**全部设置都在这个插件的配置里**。
4
4
 
5
5
  > 侧边栏 **插件 → 已安装插件 → WDX Relief**,配置区在 bundle 页面下方。
6
6
  > 不往 DSH 的 Settings 导航里插入页面;字段都是插件自己的 `Config`,写入后持久化到 profile 的 `cordis.patch.yml`。
@@ -8,13 +8,17 @@
8
8
  ## 功能
9
9
 
10
10
  - **输入框下一句预测**:对话结束后用灰字猜你接下来要发的话,<kbd>Tab</kbd> 填入;打字隐藏,<kbd>Esc</kbd> 忽略。
11
+ - **输入框上的一行**(默认开启):逐轮显示「这一轮在做什么、到哪了」。默认只显示语义摘要(每几轮用一次便宜模型);活动流水、状态耗时、思考预览三项本地生成、零模型调用,按需开启。四类内容各有开关,这一行永不进入模型上下文。生成过的摘要会留在右侧 WDX Relief 面板里。
12
+ - **WDX Relief 页面**(右侧栏,默认开启):和 WDX Git 一样出现在右侧栏的工具列表里。页面用三个 Tab:默认是「没接住的事」,把过去会话里提醒过你、但你还没处理的事列成清单,点条目跳回原会话;「会话回顾」回看这个会话生成过的每一行摘要;「旁问」不进入主上下文。
13
+ - **旁问**:Tab 里的输入框和 composer 一样是圆角卡片,底部可以选旁问专用模型(窄的时候只显示模型图标)、右侧圆形按钮发送;问答只留在面板里,不写会话、不写命令日志,也不进入模型上下文,不改变主会话模型。
11
14
  - **回复风格**:长度 **短 / 标准 / 详细**;风格 **默认 / 专业 / 亲和 / 直接 / 跟随我的风格**;可加最多 2000 字的自定义指令。
12
15
  - **便于行动**(默认开启):先给结果和下一步;能一句说清的不写一段,术语先用白话说明;保留风险、失败条件和已授权该做的工作。
13
16
 
14
17
  ## 运行要求
15
18
 
16
19
  - DSH Web profile;插件依赖 `connection` 与 `sessions` 服务。
17
- - 已配置默认模型。预测会把最近几轮对话作为 prompt 发给当前默认模型;结果只用于输入框建议,不写入会话日志,也不触发 agent loop。
20
+ - 已配置默认模型。预测会把最近几轮对话作为 prompt 发给当前默认模型;旁问默认用当前会话模型,也可以在面板底部切到别的模型;「没接住的事」会把近期会话的尾部片段发一次,做归并判断。三者都不写入会话日志、不触发 agent loop。
21
+ - 语义摘要默认每 3 轮更新一次,先按你配置的便宜模型链尝试,再自动挑便宜模型,最后退回当前默认模型;模型失败时退回本地短拼接。活动流水、耗时、思考预览不调用模型。
18
22
 
19
23
  ## 安装
20
24
 
package/RELEASING.md CHANGED
@@ -1,104 +1,168 @@
1
1
  # 发布 WDX Relief
2
2
 
3
- 发布分两步:**先发 npm,再让 DSH 从 npm 安装/更新**。
3
+ 本文给维护者用。发布分两步:**先发 npm,再让 DSH 安装/更新**。
4
+ 整条流程固定在 `npm run release`(`scripts/publish-npm.sh`),和 WDX Git 同一套。
4
5
 
5
6
  ## 一次性准备
6
7
 
7
8
  1. 注册 npm 账号并开启 2FA。
8
- 2. 登录 npm 官方源(镜像不能发布):
9
+ 2. 登录 npm 官方源(不是 npmmirror,镜像不能发布):
9
10
 
10
11
  ```bash
11
12
  npm login --registry=https://registry.npmjs.org/
12
13
  npm whoami --registry=https://registry.npmjs.org/
13
14
  ```
14
15
 
15
- 3. 确认包名可用:
16
+ 3. 确认发布状态:
16
17
 
17
18
  ```bash
18
- npm view dsh-wdx-relief version --registry=https://registry.npmjs.org/
19
+ npm view dsh-wdx-relief dist-tags --json --registry=https://registry.npmjs.org/
19
20
  ```
20
21
 
21
- 返回 404 才表示可用;如果被占用,把 `package.json` 的 `name` 改成
22
- `@wdxtub/dsh-wdx-relief`,并同步改本文命令。
22
+ 包已存在(当前 `latest` 为 0.3.2)。首次发布才需要 404 检查;若包名被他人占用,
23
+ 把 `package.json` 的 `name` 改成 `@wdxtub/dsh-wdx-relief`,并同步替换本文命令。
23
24
 
24
- ## 浏览器 2FA 发布(固定方式)
25
+ 4. 工作区要干净(`git status`)。`npm version` 和发布脚本都依赖这一点。
25
26
 
26
- npm 账号开启了 `auth-and-writes` 2FA,非交互运行 `npm publish` 会直接报 `EOTP`。
27
- 本仓库用 `expect` 提供 PTY,让 npm 走浏览器认证:
27
+ ## 发布:`npm run release`(本仓库的固定方式)
28
+
29
+ 发布走浏览器 2FA,不收集 OTP:
28
30
 
29
31
  ```bash
30
- expect scripts/publish-npm.exp > /tmp/npm-publish-pty.log 2>&1 &
31
- tail -f /tmp/npm-publish-pty.log
32
+ npm run release -- --check # 预检:工作区、版本、测试、打包、登录
33
+ npm run release # 登录(如需要)→ 浏览器验证 → 发布 → 等 registry 同步
32
34
  ```
33
35
 
34
- 看到 `AUTH_BROWSER_OPENED` 后,在浏览器的 npm 认证页完成 2FA/Passkey;npm 会自动
35
- 取到 OTP 并继续发布。不要重复启动另一个发布。没有浏览器窗口时,从日志里取出
36
- `https://www.npmjs.com/auth/cli/...` 手动打开。
36
+ `npm run release` 会:
37
37
 
38
- ## 首次发布
38
+ 1. 要求工作区干净,并确认 `package.json` 版本尚未发布;
39
+ 2. 跑 `npm test` 和 `npm pack --dry-run`;
40
+ 3. `npm whoami` 失败时,用浏览器登录并等待用户完成验证;
41
+ 4. 用 PTY 跑 `npm publish`;看到 `Press ENTER` 自动回车并打印认证 URL,
42
+ 等待用户在浏览器完成 2FA/Passkey,然后自动继续;
43
+ 5. 认证类失败(401 / E401 / EOTP)自动重新登录并重试一次;
44
+ 6. 轮询 registry 直到该版本和 `dist-tags.latest` 都能查到,再打印 tarball。
39
45
 
40
- 先提交干净(`npm version` 需要干净的工作区):
46
+ 脚本不 commit、不 tag、不 push;这些仍由你确认后执行。
41
47
 
42
- ```bash
43
- git add .
44
- git commit -m "feat: initial WDX Relief release"
45
- npm test
46
- npm pack --dry-run
48
+ 关键点:
47
49
 
48
- # 可选但推荐:把 tarball 装进 DSH 走一遍真实安装
49
- npm pack
50
- # 插件页 → 添加插件 → 输入 tarball 绝对路径 → 安装 → 立即启用
51
-
52
- expect scripts/publish-npm.exp
53
- git tag -a v0.1.0 -m "v0.1.0"
54
- git push origin main --tags
55
- ```
50
+ - 不要直接非交互运行 `npm publish`:stdin 不是 TTY 时会抛 `EOTP`,auth URL 会被打码。
51
+ - 必须给 PTY;`expect` 的 `spawn` 提供它。`scripts/publish-npm.exp` 只匹配
52
+ `Press ENTER` / `+ <包名>@<版本>` / `Published` / `npm error`,不会误杀测试输出。
53
+ - 看到 `AUTH_BROWSER_OPENED` / `LOGIN_BROWSER_OPENED` 后,等用户在浏览器完成认证;
54
+ 不要另起一个发布进程。
55
+ - 如果浏览器没自动打开,从输出里取出 `https://www.npmjs.com/auth/cli/...`
56
+ 或 `https://www.npmjs.com/login?...` 让用户手动打开。
57
+ - 发布成功后脚本会等 registry 同步;新包第一次可能出现 `0.0.0-stage` 占位。
58
+ - `--check` 在版本已发布时会给出警告并继续检查,便于发布后复验环境。
56
59
 
57
- 发布后验证:
60
+ > 2FA 验证码在用户自己的验证器 App 里(1Password / Google Authenticator / Authy 等),
61
+ > npm 不会发短信/邮件。不要向用户索要验证码;优先走浏览器认证。只有用户主动提供
62
+ > OTP 时才可以用 `npm publish --otp=...`。
58
63
 
59
- ```bash
60
- npm view dsh-wdx-relief version --registry=https://registry.npmjs.org/
61
- ```
64
+ `publishConfig` 已指向 npm 官方源,脚本也显式带 `--registry`,不受本机镜像配置影响。
65
+ 先发 npm 再打 tag 也可以;tag 只是标记发布对应的代码。
62
66
 
63
67
  ## 后续版本
64
68
 
69
+ 语义化版本:
70
+
65
71
  - **patch**:修复 bug、文案、兼容性小修;
66
72
  - **minor**:新功能,0.x 阶段也用它;
67
73
  - **major**:破坏性变更。
68
74
 
69
75
  ```bash
70
- git status
71
- # 更新 CHANGELOG.md 并提交
72
- npm test
73
- npm version minor -m "chore: release v%s"
74
- expect scripts/publish-npm.exp
76
+ git status # 必须干净
77
+ # 先更新 CHANGELOG.md,并提交它
78
+ npm version patch -m "chore: release v%s"
79
+ npm run release -- --check # 可选:先预检
80
+ npm run release # 浏览器 2FA → 发布 → 等 registry
75
81
  git push --follow-tags
76
82
  ```
77
83
 
78
- 预发布:把 `scripts/publish-npm.exp` 里的 `npm publish` 参数改为 `--tag next`,
79
- 或直接运行:
84
+ `npm version` 会更新 `package.json`、创建 release commit 和 `vX.Y.Z` tag。
85
+ `npm run release` 不自动 commit / tag / push;发布后如需补 tag,再执行
86
+ `git tag -a vX.Y.Z -m "vX.Y.Z"`。
87
+ 在 GitHub 上基于该 tag 建 Release,把 `CHANGELOG.md` 对应段落贴进去即可。
88
+ 如果 `npm version` 因工作区不干净失败,先提交 CHANGELOG 等改动再重试。
89
+
90
+ 预发布版本:
80
91
 
81
92
  ```bash
82
- npm version 0.2.0-rc.1
93
+ npm version 0.5.0-rc.1
83
94
  npm publish --tag next --access public --registry=https://registry.npmjs.org/
84
- npm dist-tag add dsh-wdx-relief@0.2.0-rc.1 latest --registry=https://registry.npmjs.org/
85
95
  ```
86
96
 
97
+ 验证稳定后再把 `latest` 指过去:
98
+
99
+ ```bash
100
+ npm dist-tag add dsh-wdx-relief@0.5.0-rc.1 latest --registry=https://registry.npmjs.org/
101
+ ```
102
+
103
+ ## 发布后验证
104
+
105
+ ```bash
106
+ npm view dsh-wdx-relief dist-tags --json --registry=https://registry.npmjs.org/
107
+ npm view dsh-wdx-relief@0.4.0 version dist.tarball --registry=https://registry.npmjs.org/
108
+ ```
109
+
110
+ 必要时下载 tarball 检查 `package.json`:
111
+
112
+ ```bash
113
+ url=$(npm view dsh-wdx-relief@0.4.0 dist.tarball --registry=https://registry.npmjs.org/)
114
+ curl -sL "$url" -o /tmp/dsh-wdx-relief.tgz
115
+ tar -xOf /tmp/dsh-wdx-relief.tgz package/package.json | node -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>console.log(JSON.parse(s)))"
116
+ ```
117
+
118
+ 确认包含 `dsh.bundle.patch`、`dsh.client`、`engines.dsh`、`icon`,以及
119
+ README / CHANGELOG / locale / docs。
120
+
121
+ ## Release commit 与 tag
122
+
123
+ ```bash
124
+ git status
125
+ git add .
126
+ git commit -m "chore(release): vX.Y.Z"
127
+ git tag -a vX.Y.Z -m "vX.Y.Z"
128
+ ```
129
+
130
+ - tag 必须指向包含该版本代码的 commit。
131
+ - 是否 `git push origin main --tags` 由用户明确决定;不要默认推送。
132
+
87
133
  ## DSH 里安装新版本
88
134
 
89
- 插件页 → **添加插件** → `dsh-wdx-relief`(或精确版本 `dsh-wdx-relief@0.1.0`)→ 安装 → 立即启用。
135
+ **方式一:插件页**
136
+
137
+ 1. 打开 DSH 侧栏 **插件**;
138
+ 2. **添加插件** → 输入 `dsh-wdx-relief`(或精确版本 `dsh-wdx-relief@0.4.0`);
139
+ 3. 安装源选 npm 官方源;
140
+ 4. 安装完成后点 **立即启用**。
90
141
 
91
- 或让 agent 调:
142
+ **方式二:Agent / tool**
92
143
 
93
144
  ```text
94
145
  plugin_manager: action=install_bundle, target=dsh-wdx-relief
95
146
  ```
96
147
 
97
- 如果之前用本地 `link:` 或 tarball 装过开发版,插件页会视为已安装,直接装 npm 包会报
98
- `already-installed`;先在插件页移除旧版本,再安装 npm 包。
148
+ 从 npm 安装的第三方插件会保存精确版本;后续更新在插件详情的「版本」区块检查并更新。
149
+ 如果当前 DSH 不提供版本区块,就卸载后安装新的精确版本。
150
+
151
+ **如果你之前用本地目录 `link:` 安装过开发版,或用 tarball 试装过**,插件页会把它视为
152
+ 已安装,直接安装 npm 包会报 `already-installed`。先在插件页移除 WDX Relief,再按上面的
153
+ 步骤安装 npm 包;本地开发版可以之后用路径重新装回。
154
+
155
+ 发布失败或发现严重问题时,npm 版本号不能复用:
156
+
157
+ ```bash
158
+ npm deprecate dsh-wdx-relief@0.4.0 "请在 0.4.1 修复后使用" --registry=https://registry.npmjs.org/
159
+ ```
160
+
161
+ 发布满 72 小时后通常不能再 unpublish,只能发新版本并 deprecate 旧版本。
99
162
 
100
163
  ## 注意
101
164
 
102
- - npm 发布只保证能按包名安装;不会自动进入官方「发现」目录。
103
- - `engines.dsh` 声明兼容的 DSH 版本;不满足时 DSH 会在安装前拒绝。
104
- - 版本号发布后不可复用;有问题的版本只能 deprecate,再发新版本。
165
+ - npm 发布只保证能被「添加插件」按包名安装;**不会自动进入官方“发现”目录**。
166
+ 想进入官方目录,需要走 DSH 官方的插件收录/审核流程。
167
+ - `engines.dsh` 声明当前包兼容的 DSH 版本;DSH 会在安装前检查,不满足会直接拒绝。
168
+ - 第一次发布后,npm 版本号不可复用;有问题的版本只能 deprecate,不能覆盖。