@leiyi-works/dsh-feature-tweaks 0.4.0 → 0.6.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 +60 -104
- package/client.js +2288 -206
- package/cordis.patch.yml +28 -56
- package/icon.svg +15 -7
- package/index.js +495 -152
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,149 +1,105 @@
|
|
|
1
1
|
# @leiyi-works/dsh-feature-tweaks · 功能微调
|
|
2
2
|
|
|
3
|
-
> DeepSeek Harness(DSH
|
|
3
|
+
> DeepSeek Harness(DSH)插件:**功能微调**与**菜单文件夹**合并后的单包。左侧菜单只留一个「功能微调」入口,点开后在**右侧原生边栏**打开(不遮挡会话,和 AI视频 / 临时目录 / 自动重启一致),面板内分「功能微调 / 菜单文件夹」两个标签页,各自是独立的设置页;功能微调的各项功能从此都能在页面里开关。右侧边栏不可用时退回全页面板。不改任何核心包。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## 这个版本管什么(0.6.0)
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|---|---|---|
|
|
9
|
-
| 功能微调 | Host 侧功能与**默认值** | 新会话默认开智能体团队协作、刷新快捷键、退出确认 |
|
|
10
|
-
| 界面微调 | 浏览器界面与 DOM 行为(0.4.0 起并入本包) | 隐藏右栏展开按钮、会话列表默认展开 |
|
|
7
|
+
0.5.0 把原来的两个插件合并成一个;0.6.0 把入口的打开方式改成右侧边栏面板:
|
|
11
8
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
9
|
+
| 原来 | 现在 |
|
|
10
|
+
|---|---|
|
|
11
|
+
| `@leiyi-works/dsh-feature-tweaks` 0.4.x(功能微调) | 本包的「功能微调」标签页 |
|
|
12
|
+
| `@leiyi-works/dsh-menu-folders` 0.16.0(菜单文件夹) | 本包的「菜单文件夹」标签页 |
|
|
15
13
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
| 4 | 会话右上角「右侧栏展开」按钮 | 显示 | 隐藏 | `hideRightSidebarToggle`(默认 `true`) |
|
|
22
|
-
| 5 | 左侧会话列表 | 每个工作区只显示前 5 条,其余折叠成「展开其余 N 个会话」 | 默认展开全部会话(尊重手动「收起」) | `expandWorkspaceSessions`(默认 `true`) |
|
|
23
|
-
| 6 | 会话标题栏「⋯」导出菜单 | 显示 | 显示(可选隐藏) | `hideSessionLogExportMenu`(默认 `false`) |
|
|
14
|
+
- **入口只放在左侧菜单**:原来的「设置 → 菜单文件夹」设置页不再注册,统一从这个入口进入。
|
|
15
|
+
- **在右侧边栏打开(0.6.0)**:点左侧「功能微调」会先回到当前会话,再在右侧原生边栏打开面板,会话保持可见;再次点入口会聚焦该标签页。右侧边栏不可用(例如某些精简宿主)时自动退回原来的全页面板。
|
|
16
|
+
- **功能微调首次有设置页**:六项功能各带一个开关,保存后立即生效,写入本机 profile 的 `cordis.patch.yml`,换机随云端同步带走。
|
|
17
|
+
- **文件夹数据沿用**:仍保存在 `<DSH_HOME>/data/menu-folders.json`,旧配置无需迁移。
|
|
18
|
+
- **不再覆盖官方 `agent-team` 行**:新会话默认开团队协作改由本包自己实现,所以能随时开关。
|
|
24
19
|
|
|
25
|
-
|
|
20
|
+
## 功能微调(标签页 1)
|
|
26
21
|
|
|
27
|
-
|
|
22
|
+
| # | 开关 | 官方默认 | 本包默认 | 说明 |
|
|
23
|
+
|---|---|---|---|---|
|
|
24
|
+
| 1 | 隐藏右侧栏展开按钮 | 显示 | 开 | 隐藏会话头部右上角「重新打开右侧栏」按钮;右栏本身、左栏入口、快捷键都不受影响 |
|
|
25
|
+
| 2 | 隐藏「⋯」导出菜单 | 显示 | 关 | 隐藏会话标题栏「⋯」菜单里的导出项 |
|
|
26
|
+
| 3 | 会话列表默认展开 | 每工作区只显示前 5 条 | 开 | 自动点开「展开其余 N 个会话」;手动「收起」的分组保持收起 |
|
|
27
|
+
| 4 | 刷新页面快捷键 | 桌面壳不绑刷新键 | 开 | 桌面端 <kbd>F5</kbd> / 网页端 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd>;刷新前先做安全探针,插件代码刚更新过时只提示、不刷新 |
|
|
28
|
+
| 5 | 退出时不因定时任务确认 | 有已排期定时任务就弹确认 | 开 | 只有定时任务时静默退出(任务不丢,下次打开补触发);确有任务在跑仍确认 |
|
|
29
|
+
| 6 | 新会话默认开启团队协作 | 默认关闭 | 开 | 新建根会话(含普通 fork)首轮模型步之前开启;已有保存选择/恢复的会话不受影响,单会话仍可随时关掉 |
|
|
28
30
|
|
|
29
|
-
|
|
30
|
-
- 本包在 `cordis.patch.yml` 里把该行覆盖为 `defaultEnabled: true`(同时重述 `maxTasks: 256`):新根会话(含普通 fork)在第一次模型步之前就默认开启;已保存过选择的会话不受影响,单会话仍可随时关掉。
|
|
31
|
+
> 团队模式会往上下文注入协作提示词和 `team_task_*` 工具,**token 开销更高**;简单任务可在会话里随手关掉。
|
|
31
32
|
|
|
32
|
-
|
|
33
|
+
开关走 Host 的 `settings` 服务写入本行 Config 的 volatile 字段(`settings.update`),所以:
|
|
33
34
|
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
- 兜底:桌面壳的按键桥接可能晚到,所以另有 document 级 F5 监听;桥接先处理时该监听不会重复触发。
|
|
35
|
+
- 保存后立即生效,无需重启;
|
|
36
|
+
- 落在 profile 的 `cordis.patch.yml`(用户覆盖层),重装/升级插件不丢,随云端同步换机;
|
|
37
|
+
- 浏览器端通过 SSE 热更新,另一台页面/窗口也会同步。
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
高级字段(只建议在 profile patch 里改):`extraSelectors`(上游改了选择器时兜底)、`pollIntervalMs`(SSE 不可用时的兜底轮询间隔)、`debug`(浏览器控制台诊断日志)。
|
|
40
40
|
|
|
41
|
-
|
|
42
|
-
- **新行为**:只有定时任务、没有任务在跑 → 直接退出,不再弹框;确有任务在跑 → 仍然确认,文案落到官方的「当前正在运行的任务将会中断」,不再附带「且应用关闭期间,定时任务不会运行」。
|
|
43
|
-
- **不影响**:定时任务本身照常创建/触发;`workspace/session-activity` 里的 `schedule` 族照常上报,所以「归档有定时任务的会话」仍会被拒绝;`dsh web` / headless 没有这条 IPC,补丁自动跳过。
|
|
44
|
-
- **诊断**:插件启动时 `<DSH_HOME>/data/feature-tweaks-diag.log` 会记一行 `quit-inspection-patch-ready`;每次真的拦下定时任务再记一行 `quit-inspection-scheduled-tasks-ignored`。
|
|
41
|
+
## 菜单文件夹(标签页 2)
|
|
45
42
|
|
|
46
|
-
|
|
43
|
+
- 把左侧顶部菜单里的入口收进自建文件夹;文件夹显示在左侧菜单「更多」的上方,点一下在左侧下拉展开收纳的入口。
|
|
44
|
+
- 已收纳的入口固定从「更多」菜单里移走(打开一次「更多」即完成同步)。
|
|
45
|
+
- 管理页按左侧菜单顺序排列:未收纳的菜单项在上、文件夹在下;可新建/重命名/上移下移/删除文件夹,把入口收纳进指定文件夹或移出。
|
|
46
|
+
- 会话标题栏右上角也有一排文件夹入口,与「更多」按钮同一行、垂直居中对齐。
|
|
47
|
+
- 配置保存在 `<DSH_HOME>/data/menu-folders.json`;浏览器 localStorage 另存一份镜像,页面刚打开时先按上次状态渲染。
|
|
48
|
+
- 旧包 `dsh-menu-folders` 的状态文件(`menu-folders.json`)与更早的 `sidebar-folders.json` 都会被自动沿用。
|
|
47
49
|
|
|
48
|
-
|
|
49
|
-
- **右栏功能本身不受影响**:左栏各类入口、右栏面板自身的折叠/全屏/关闭、快捷键 `sidebar.right.toggle` 都照常可用;隐藏的只是右侧栏收起时出现在会话头部右上角的「重新打开」按钮。
|
|
50
|
-
- 生效时机:先注入规则避免按钮闪一下,宿主配置通过 SSE 推送后按最终值校正。
|
|
51
|
-
- 上游若改了属性名:按钮会保持可见,控制台给出一次提示;在 `extraSelectors` 里追加新选择器即可,不必改插件代码。
|
|
50
|
+
## 安装
|
|
52
51
|
|
|
53
|
-
|
|
52
|
+
```powershell
|
|
53
|
+
dsh plugin --profile <profile> add @leiyi-works/dsh-feature-tweaks@0.6.0
|
|
54
|
+
```
|
|
54
55
|
|
|
55
|
-
|
|
56
|
-
- 做法:`MutationObserver`(节流 600ms)在列表渲染后自动点开该按钮,每轮最多补点 12 次(每轮 +5 条),直到该分组全部展开。
|
|
57
|
-
- **尊重手动收起**:只认 `event.isTrusted === true` 的点击——你手动点「收起」的分组按 workspace key 记住,本次页面会话内不再自动展开;再点「展开其余」即解除。插件自己的模拟点击是 `isTrusted === false`,不会误判。
|
|
58
|
-
- 刷新页面后回到默认全展开。
|
|
56
|
+
装完后确认 profile 的 `dsh.profile.bundles` 含 `@leiyi-works/dsh-feature-tweaks`,并且**不再**含 `@leiyi-works/dsh-menu-folders`(合并后旧的菜单文件夹包应卸载)。**重启 DSH** 生效。
|
|
59
57
|
|
|
60
|
-
|
|
58
|
+
从 0.5.0 升级:本包升到 0.6.0、重启即可,开关和文件夹配置都不用迁移(左侧入口点开后改为右侧边栏面板)。
|
|
61
59
|
|
|
62
|
-
|
|
63
|
-
|---|---|---|---|
|
|
64
|
-
| `hideRightSidebarToggle` | boolean | `true` | 隐藏右上角右栏开关;`false` 恢复原按钮 |
|
|
65
|
-
| `hideSessionLogExportMenu` | boolean | `false` | `true` 隐藏会话标题栏「⋯」导出菜单 |
|
|
66
|
-
| `expandWorkspaceSessions` | boolean | `true` | 左侧会话列表默认展开全部会话;`false` 恢复 DSH 原生折叠 |
|
|
67
|
-
| `extraSelectors` | string[] | `[]` | 追加隐藏的 CSS 选择器(上游改属性名时兜底) |
|
|
68
|
-
| `pollIntervalMs` | number | `30000` | SSE 不可用时的浏览器兜底轮询间隔(毫秒,最小 2000) |
|
|
69
|
-
| `debug` | boolean | `false` | 浏览器控制台输出诊断日志 |
|
|
60
|
+
从 0.4.x + dsh-menu-folders 升级:
|
|
70
61
|
|
|
71
|
-
|
|
72
|
-
|
|
62
|
+
1. 本包升到 0.6.0;
|
|
63
|
+
2. 从 profile 依赖与 `dsh.profile.bundles` 里移除 `@leiyi-works/dsh-menu-folders`;
|
|
64
|
+
3. 重启;文件夹、开关默认值都保持原状,不需要迁移配置。
|
|
73
65
|
|
|
74
66
|
## 接口(本机回环)
|
|
75
67
|
|
|
76
68
|
| 路由 | 返回 |
|
|
77
69
|
|---|---|
|
|
78
|
-
| `GET /__dsh-feature-tweaks/config` |
|
|
70
|
+
| `GET /__dsh-feature-tweaks/config` | 当前生效的六项开关与高级字段快照(`selectors` 是最终生效的选择器列表) |
|
|
71
|
+
| `POST /__dsh-feature-tweaks/feature` | `{ key, value }`:改写本包 Config 的 volatile 字段(经 settings 服务落 profile patch) |
|
|
79
72
|
| `GET /__dsh-feature-tweaks/status` | `{ version, uptimeMs, connectedClients, config }` |
|
|
80
73
|
| `GET /__dsh-feature-tweaks/events` | SSE:`event: config` 推送配置;25 秒心跳顺带当前值,丢事件也能自愈 |
|
|
81
74
|
| `GET /__dsh-feature-tweaks/reload-safe` | `{ ok, revs, changed }`:刷新前安全探针 |
|
|
82
75
|
| `POST /__dsh-feature-tweaks/diag` | Client 半边写一行诊断日志,返回 `{ ok: true }` |
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
## 安装
|
|
87
|
-
|
|
88
|
-
```powershell
|
|
89
|
-
dsh plugin --profile <profile> add @leiyi-works/dsh-feature-tweaks@0.4.0
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
装完后确认 profile 的 `dsh.profile.bundles` 含 `@leiyi-works/dsh-feature-tweaks`,且排在 `@deepseek-ai/dsh-base` 之后。**重启 DSH** 生效(配置在启动时合成)。
|
|
93
|
-
|
|
94
|
-
## 从 0.3.x + dsh-ui-tweaks 迁移(0.4.0)
|
|
95
|
-
|
|
96
|
-
1. 从 profile 的依赖与 `dsh.profile.bundles` 里移除 `@leiyi-works/dsh-ui-tweaks`(或 `dsh plugin remove`),把 `@leiyi-works/dsh-feature-tweaks` 升到 0.4.0;
|
|
97
|
-
2. 不需要迁移任何配置:界面微调的 Config 字段名与原 `dsh-ui-tweaks` 完全一致,`agent-team` 覆盖不变;
|
|
98
|
-
3. 旧界面微调的路由 `/ui-tweaks/*` 不再提供,新路由统一在 `/__dsh-feature-tweaks/*`;
|
|
99
|
-
4. `dsh-ui-tweaks` 在 npm 上仍可安装,但不再更新。
|
|
76
|
+
| `GET/POST /__dsh-feature-tweaks/state` | 菜单文件夹配置 `{ version, folders }` |
|
|
77
|
+
| `GET/POST /__dsh-feature-tweaks/ghosts` | 幽灵会话(磁盘已删、Host 仍在内存)的探测与归档 |
|
|
100
78
|
|
|
101
79
|
## 实现机制
|
|
102
80
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
- `
|
|
106
|
-
- `index.js` —— Host 行 `feature-tweaks`:界面侧提供配置/状态/SSE 路由;功能侧提供刷新安全探针、诊断路由,并包装 `process.send` 改写桌面壳 `quit-inspection` 应答里的 `scheduledTasks`。
|
|
107
|
-
- `client.js` —— Web 侧半边:隐藏 CSS、会话列表自动展开、SSE 订阅 + 兜底轮询 + 失效诊断、刷新快捷键(含 F5 DOM 兜底)。
|
|
81
|
+
- `cordis.patch.yml` —— bundle patch:只插入本包 Host 行(不再覆盖 `agent-team` 行)。
|
|
82
|
+
- `index.js` —— Host 行 `feature-tweaks`:功能开关读写(settings 服务)+ SSE/配置/诊断路由 + 刷新安全探针 + 退出确认包装 + 新会话默认团队 + 菜单文件夹状态与幽灵会话路由。
|
|
83
|
+
- `client.js` —— Web 侧半边:左侧「功能微调」入口(点开在右侧原生边栏打开,带全页面板兜底)、双标签页、功能开关页、菜单文件夹全部界面、界面类隐藏规则、会话列表自动展开、刷新快捷键、SSE 订阅 + 兜底轮询。
|
|
108
84
|
- `locale/{zh,en}.json` —— 插件页显示名与介绍。
|
|
109
85
|
|
|
110
|
-
**关键坑**:loader 的 patch 会**整段替换**目标行的 `config`(不是深合并)。覆盖时必须把该行原本的其它字段一起重述——例如 `agent-team` 要带上 `maxTasks: 256`,否则会退回 schema 默认值。
|
|
111
|
-
|
|
112
|
-
## 新增一项微调(维护者)
|
|
113
|
-
|
|
114
|
-
1. 配置类:在 `cordis.patch.yml` 末尾按注释模板追加一段(官方默认 → 本包值 → 理由);
|
|
115
|
-
2. 代码类:改 `index.js` / `client.js`,并在 `cordis.patch.yml` 文末「代码侧微调」里补一条说明;
|
|
116
|
-
3. README 的「现有微调」表加一行;
|
|
117
|
-
4. 升版本号 → 发布 → profile 更新依赖 → 重启验证。
|
|
118
|
-
|
|
119
|
-
行 id 与官方包名的对照可以看 `~/.dsh/profiles/<profile>/node_modules/@deepseek-ai/dsh-base/cordis.patch.yml` 的 `insert` 列表。
|
|
120
|
-
|
|
121
|
-
## 验证
|
|
122
|
-
|
|
123
|
-
- 重启后新建一个会话,打开「模型与推理等级」菜单,底部「启用智能体团队协作」应为开;该会话应带 `team_task_*` 工具;
|
|
124
|
-
- 已存在的会话(保存过选择)行为不变;手动关掉某一会话的开关后,该会话保持关闭。
|
|
125
|
-
- 打开会话:右上角右栏展开按钮应不可见;右栏仍可通过左侧入口/快捷键打开。
|
|
126
|
-
- 左侧会话列表中每个工作区应直接显示全部会话;手动点「收起」后该分组保持收起,刷新页面后回到全展开。
|
|
127
|
-
- 桌面端按 <kbd>F5</kbd> 应刷新页面;设置 → 快捷键里能看到「刷新页面」并改了生效。刚装/更新过插件时按 F5 应提示「请完全退出 DSH 再打开一次」(这是保护,不是故障)。
|
|
128
|
-
- 退出确认:先建一个有定时任务的会话(让它处于已排期状态),再点托盘「退出」——应直接退出、不再弹「应用关闭期间,定时任务不会运行」。若有任务正在跑,仍会弹确认,但文案只有「当前正在运行的任务将会中断」。
|
|
129
|
-
- 日志佐证:`<DSH_HOME>/data/feature-tweaks-diag.log` 里有 `quit-inspection-patch-ready`、`reload-shortcut-ready`。
|
|
130
|
-
|
|
131
86
|
## 撤回
|
|
132
87
|
|
|
133
|
-
- **整体**:从 profile 的 `dsh.profile.bundles`
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
- **退出确认**:删掉 `index.js` 里对 `installQuitInspectionTweak(ctx)` 的调用后重启;
|
|
138
|
-
- **单会话团队**:直接在「模型与推理等级」菜单里关(仅本会话生效)。
|
|
88
|
+
- **整体**:从 profile 的 `dsh.profile.bundles` 移除本包,回到官方默认;
|
|
89
|
+
- **单项**:在设置页把对应开关关掉即可(写回 profile patch);
|
|
90
|
+
- **菜单文件夹**:把文件夹删掉、把收纳项移出,即回到原生左侧菜单;
|
|
91
|
+
- **旧包**:`@leiyi-works/dsh-menu-folders` 已并入本包,不需要也不再更新。
|
|
139
92
|
|
|
140
93
|
## 已知限制
|
|
141
94
|
|
|
142
95
|
- 右栏隐藏依赖 DSH 自带 `ui-sidebar-right` 的 `data-sidebar-right-expand` 属性;上游大版本若改属性名,用 `extraSelectors` 兜底(控制台会提示),或更新默认选择器。
|
|
96
|
+
- 隐身导出菜单同样依赖上游「⋯」按钮的类名/aria-label,上游改了会失效(默认关闭,不影响日常)。
|
|
143
97
|
- 会话列表展开依赖核心的 overflow 按钮(`data-row-key^="overflow:"` / `class*=sessionOverflowButton`)与每次 +5 条的递增逻辑;上游若改了这两项,改插件常量。
|
|
144
98
|
- 会话列表是「自动点开」而不是改核心状态:工作区会话特别多(>60 条折叠)时可能需要多轮补点。
|
|
145
|
-
-
|
|
146
|
-
-
|
|
99
|
+
- 刷新快捷键的安全探针依赖 Client bundle 重建记录;正常使用(没装/更新插件)不会触发提示。
|
|
100
|
+
- 新会话默认团队只作用于 `startup` 来源的根会话;`resume`/`clear`/`compact` 与子智能体会话不套用。
|
|
101
|
+
- 右侧边栏面板依赖宿主提供 `sidebarRightTabs` / `sidebarRight` 两个客户端服务;没有它们的精简宿主会自动退回全页面板(功能不变,只是占满主区域)。
|
|
102
|
+
- 面板变窄时(右侧边栏)文件夹管理页的操作按钮会换行,属窄栏适配,不是布局错误。
|
|
147
103
|
|
|
148
104
|
## License
|
|
149
105
|
|