@leiyi-works/dsh-feature-tweaks 0.3.0 → 0.5.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/README.md +68 -55
- package/client.js +2330 -77
- package/cordis.patch.yml +35 -41
- package/icon.svg +15 -7
- package/index.js +637 -85
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -1,87 +1,100 @@
|
|
|
1
1
|
# @leiyi-works/dsh-feature-tweaks · 功能微调
|
|
2
2
|
|
|
3
|
-
> DeepSeek Harness(DSH
|
|
3
|
+
> DeepSeek Harness(DSH)插件:**功能微调**与**菜单文件夹**合并后的单包。左侧菜单只留一个「功能微调」入口,页面内分「功能微调 / 菜单文件夹」两个标签页,各自是独立的设置页;功能微调的各项功能从此都能在页面里开关。不改任何核心包。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## 这个版本管什么(0.5.0)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
0.5.0 把原来的两个插件合并成一个:
|
|
8
8
|
|
|
9
|
-
|
|
|
10
|
-
|
|
11
|
-
|
|
|
12
|
-
|
|
|
9
|
+
| 原来 | 现在 |
|
|
10
|
+
|---|---|
|
|
11
|
+
| `@leiyi-works/dsh-feature-tweaks` 0.4.x(功能微调) | 本包的「功能微调」标签页 |
|
|
12
|
+
| `@leiyi-works/dsh-menu-folders` 0.16.0(菜单文件夹) | 本包的「菜单文件夹」标签页 |
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
- **入口只放在左侧菜单**:原来的「设置 → 菜单文件夹」设置页不再注册,统一从这个入口进入。
|
|
15
|
+
- **功能微调首次有设置页**:六项功能各带一个开关,保存后立即生效,写入本机 profile 的 `cordis.patch.yml`,换机随云端同步带走。
|
|
16
|
+
- **文件夹数据沿用**:仍保存在 `<DSH_HOME>/data/menu-folders.json`,旧配置无需迁移。
|
|
17
|
+
- **不再覆盖官方 `agent-team` 行**:新会话默认开团队协作改由本包自己实现,所以能随时开关。
|
|
15
18
|
|
|
16
|
-
|
|
19
|
+
## 功能微调(标签页 1)
|
|
20
|
+
|
|
21
|
+
| # | 开关 | 官方默认 | 本包默认 | 说明 |
|
|
17
22
|
|---|---|---|---|---|
|
|
18
|
-
| 1 |
|
|
19
|
-
| 2 |
|
|
20
|
-
| 3 |
|
|
23
|
+
| 1 | 隐藏右侧栏展开按钮 | 显示 | 开 | 隐藏会话头部右上角「重新打开右侧栏」按钮;右栏本身、左栏入口、快捷键都不受影响 |
|
|
24
|
+
| 2 | 隐藏「⋯」导出菜单 | 显示 | 关 | 隐藏会话标题栏「⋯」菜单里的导出项 |
|
|
25
|
+
| 3 | 会话列表默认展开 | 每工作区只显示前 5 条 | 开 | 自动点开「展开其余 N 个会话」;手动「收起」的分组保持收起 |
|
|
26
|
+
| 4 | 刷新页面快捷键 | 桌面壳不绑刷新键 | 开 | 桌面端 <kbd>F5</kbd> / 网页端 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd>;刷新前先做安全探针,插件代码刚更新过时只提示、不刷新 |
|
|
27
|
+
| 5 | 退出时不因定时任务确认 | 有已排期定时任务就弹确认 | 开 | 只有定时任务时静默退出(任务不丢,下次打开补触发);确有任务在跑仍确认 |
|
|
28
|
+
| 6 | 新会话默认开启团队协作 | 默认关闭 | 开 | 新建根会话(含普通 fork)首轮模型步之前开启;已有保存选择/恢复的会话不受影响,单会话仍可随时关掉 |
|
|
29
|
+
|
|
30
|
+
> 团队模式会往上下文注入协作提示词和 `team_task_*` 工具,**token 开销更高**;简单任务可在会话里随手关掉。
|
|
21
31
|
|
|
22
|
-
|
|
32
|
+
开关走 Host 的 `settings` 服务写入本行 Config 的 volatile 字段(`settings.update`),所以:
|
|
23
33
|
|
|
24
|
-
|
|
34
|
+
- 保存后立即生效,无需重启;
|
|
35
|
+
- 落在 profile 的 `cordis.patch.yml`(用户覆盖层),重装/升级插件不丢,随云端同步换机;
|
|
36
|
+
- 浏览器端通过 SSE 热更新,另一台页面/窗口也会同步。
|
|
25
37
|
|
|
26
|
-
|
|
27
|
-
- **新行为**:
|
|
28
|
-
- 只有定时任务、没有任务在跑 → **直接退出,不再弹框**;
|
|
29
|
-
- 确有任务在跑 → 仍然确认,文案落到官方的「当前正在运行的任务将会中断」,不再附带「且应用关闭期间,定时任务不会运行」。
|
|
30
|
-
- **代价**:应用关闭期间定时任务不会触发,错过的会在下次启动后补发最近一次(这是 DSH 本来的行为,只是不再每次退出都提示)。介意就把本包整体移除。
|
|
31
|
-
- **不影响**:定时任务本身照常创建/触发;`workspace/session-activity` 里的 `schedule` 族照常上报,所以「归档有定时任务的会话」仍会被拒绝;`dsh web` / headless 没有这条 IPC,补丁自动跳过。
|
|
32
|
-
- **诊断**:插件启动时 `~/.dsh/data/feature-tweaks-diag.log` 会记一行 `quit-inspection-patch-ready`;每次真的拦下定时任务再记一行 `quit-inspection-scheduled-tasks-ignored`。
|
|
38
|
+
高级字段(只建议在 profile patch 里改):`extraSelectors`(上游改了选择器时兜底)、`pollIntervalMs`(SSE 不可用时的兜底轮询间隔)、`debug`(浏览器控制台诊断日志)。
|
|
33
39
|
|
|
34
|
-
|
|
40
|
+
## 菜单文件夹(标签页 2)
|
|
35
41
|
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
42
|
+
- 把左侧顶部菜单里的入口收进自建文件夹;文件夹显示在左侧菜单「更多」的上方,点一下在左侧下拉展开收纳的入口。
|
|
43
|
+
- 已收纳的入口固定从「更多」菜单里移走(打开一次「更多」即完成同步)。
|
|
44
|
+
- 管理页按左侧菜单顺序排列:未收纳的菜单项在上、文件夹在下;可新建/重命名/上移下移/删除文件夹,把入口收纳进指定文件夹或移出。
|
|
45
|
+
- 会话标题栏右上角也有一排文件夹入口,与「更多」按钮同一行、垂直居中对齐。
|
|
46
|
+
- 配置保存在 `<DSH_HOME>/data/menu-folders.json`;浏览器 localStorage 另存一份镜像,页面刚打开时先按上次状态渲染。
|
|
47
|
+
- 旧包 `dsh-menu-folders` 的状态文件(`menu-folders.json`)与更早的 `sidebar-folders.json` 都会被自动沿用。
|
|
40
48
|
|
|
41
49
|
## 安装
|
|
42
50
|
|
|
43
51
|
```powershell
|
|
44
|
-
dsh plugin --profile <profile> add @leiyi-works/dsh-feature-tweaks@0.
|
|
52
|
+
dsh plugin --profile <profile> add @leiyi-works/dsh-feature-tweaks@0.5.0
|
|
45
53
|
```
|
|
46
54
|
|
|
47
|
-
装完后确认 profile 的 `dsh.profile.bundles` 含 `@leiyi-works/dsh-feature-tweaks
|
|
48
|
-
|
|
49
|
-
## 实现机制
|
|
55
|
+
装完后确认 profile 的 `dsh.profile.bundles` 含 `@leiyi-works/dsh-feature-tweaks`,并且**不再**含 `@leiyi-works/dsh-menu-folders`(合并后旧的菜单文件夹包应卸载)。**重启 DSH** 生效。
|
|
50
56
|
|
|
51
|
-
|
|
57
|
+
从 0.4.x + dsh-menu-folders 升级:
|
|
52
58
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
59
|
+
1. 本包升到 0.5.0;
|
|
60
|
+
2. 从 profile 依赖与 `dsh.profile.bundles` 里移除 `@leiyi-works/dsh-menu-folders`;
|
|
61
|
+
3. 重启;文件夹、开关默认值都保持原状,不需要迁移配置。
|
|
56
62
|
|
|
57
|
-
|
|
63
|
+
## 接口(本机回环)
|
|
58
64
|
|
|
59
|
-
|
|
65
|
+
| 路由 | 返回 |
|
|
66
|
+
|---|---|
|
|
67
|
+
| `GET /__dsh-feature-tweaks/config` | 当前生效的六项开关与高级字段快照(`selectors` 是最终生效的选择器列表) |
|
|
68
|
+
| `POST /__dsh-feature-tweaks/feature` | `{ key, value }`:改写本包 Config 的 volatile 字段(经 settings 服务落 profile patch) |
|
|
69
|
+
| `GET /__dsh-feature-tweaks/status` | `{ version, uptimeMs, connectedClients, config }` |
|
|
70
|
+
| `GET /__dsh-feature-tweaks/events` | SSE:`event: config` 推送配置;25 秒心跳顺带当前值,丢事件也能自愈 |
|
|
71
|
+
| `GET /__dsh-feature-tweaks/reload-safe` | `{ ok, revs, changed }`:刷新前安全探针 |
|
|
72
|
+
| `POST /__dsh-feature-tweaks/diag` | Client 半边写一行诊断日志,返回 `{ ok: true }` |
|
|
73
|
+
| `GET/POST /__dsh-feature-tweaks/state` | 菜单文件夹配置 `{ version, folders }` |
|
|
74
|
+
| `GET/POST /__dsh-feature-tweaks/ghosts` | 幽灵会话(磁盘已删、Host 仍在内存)的探测与归档 |
|
|
60
75
|
|
|
61
|
-
|
|
62
|
-
2. 代码类:改 `index.js` / `client.js`,并在 `cordis.patch.yml` 文末「代码侧微调」里补一条说明;
|
|
63
|
-
3. README 的「现有微调」表加一行;
|
|
64
|
-
4. 升版本号 → 发布 → profile 更新依赖 → 重启验证。
|
|
76
|
+
## 实现机制
|
|
65
77
|
|
|
66
|
-
|
|
78
|
+
- `cordis.patch.yml` —— bundle patch:只插入本包 Host 行(不再覆盖 `agent-team` 行)。
|
|
79
|
+
- `index.js` —— Host 行 `feature-tweaks`:功能开关读写(settings 服务)+ SSE/配置/诊断路由 + 刷新安全探针 + 退出确认包装 + 新会话默认团队 + 菜单文件夹状态与幽灵会话路由。
|
|
80
|
+
- `client.js` —— Web 侧半边:左侧「功能微调」入口与双标签页、功能开关页、菜单文件夹全部界面、界面类隐藏规则、会话列表自动展开、刷新快捷键、SSE 订阅 + 兜底轮询。
|
|
81
|
+
- `locale/{zh,en}.json` —— 插件页显示名与介绍。
|
|
67
82
|
|
|
68
|
-
##
|
|
83
|
+
## 撤回
|
|
69
84
|
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
- 若刚装/更新过插件,按 F5 应弹出「请完全退出 DSH 再打开一次」而不是刷新(这是保护,不是故障);重启后再按即正常刷新。
|
|
75
|
-
- 退出确认:先建一个有定时任务的会话(让它处于已排期状态),再点托盘「退出」——应直接退出、不再弹「应用关闭期间,定时任务不会运行」。若有任务正在跑,仍会弹确认,但文案只有「当前正在运行的任务将会中断」。
|
|
76
|
-
- 日志佐证:重启后 `~/.dsh/data/feature-tweaks-diag.log` 里有 `quit-inspection-patch-ready`;每次拦下定任务再退出时多一行 `quit-inspection-scheduled-tasks-ignored`。
|
|
85
|
+
- **整体**:从 profile 的 `dsh.profile.bundles` 移除本包,回到官方默认;
|
|
86
|
+
- **单项**:在设置页把对应开关关掉即可(写回 profile patch);
|
|
87
|
+
- **菜单文件夹**:把文件夹删掉、把收纳项移出,即回到原生左侧菜单;
|
|
88
|
+
- **旧包**:`@leiyi-works/dsh-menu-folders` 已并入本包,不需要也不再更新。
|
|
77
89
|
|
|
78
|
-
##
|
|
90
|
+
## 已知限制
|
|
79
91
|
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
92
|
+
- 右栏隐藏依赖 DSH 自带 `ui-sidebar-right` 的 `data-sidebar-right-expand` 属性;上游大版本若改属性名,用 `extraSelectors` 兜底(控制台会提示),或更新默认选择器。
|
|
93
|
+
- 隐身导出菜单同样依赖上游「⋯」按钮的类名/aria-label,上游改了会失效(默认关闭,不影响日常)。
|
|
94
|
+
- 会话列表展开依赖核心的 overflow 按钮(`data-row-key^="overflow:"` / `class*=sessionOverflowButton`)与每次 +5 条的递增逻辑;上游若改了这两项,改插件常量。
|
|
95
|
+
- 会话列表是「自动点开」而不是改核心状态:工作区会话特别多(>60 条折叠)时可能需要多轮补点。
|
|
96
|
+
- 刷新快捷键的安全探针依赖 Client bundle 重建记录;正常使用(没装/更新插件)不会触发提示。
|
|
97
|
+
- 新会话默认团队只作用于 `startup` 来源的根会话;`resume`/`clear`/`compact` 与子智能体会话不套用。
|
|
85
98
|
|
|
86
99
|
## License
|
|
87
100
|
|