@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 CHANGED
@@ -1,87 +1,100 @@
1
1
  # @leiyi-works/dsh-feature-tweaks · 功能微调
2
2
 
3
- > DeepSeek Harness(DSH)plugin: a bundle patch that collects version-to-version functional/default tweaks (overrides official rows by id, never touches core packages). Currently: new root sessions start with Agent Teams enabled; a configurable "Reload page" shortcut (F5 on desktop), moved here from dsh-sidebar-folders 0.13.4; quitting the desktop app no longer asks just because scheduled tasks are armed.
3
+ > DeepSeek Harness(DSH)插件:**功能微调**与**菜单文件夹**合并后的单包。左侧菜单只留一个「功能微调」入口,页面内分「功能微调 / 菜单文件夹」两个标签页,各自是独立的设置页;功能微调的各项功能从此都能在页面里开关。不改任何核心包。
4
4
 
5
- DSH 每次版本变化都会带来或多或少的官方行为差异、默认值不合意的地方。本包是这些**功能层面微调**的固定落点:按官方行 id 覆盖配置、或补一行,**不改任何核心包**。
5
+ ## 这个版本管什么(0.5.0)
6
6
 
7
- 和界面微调分工:
7
+ 0.5.0 把原来的两个插件合并成一个:
8
8
 
9
- | 包 | 管什么 | 例子 |
10
- |---|---|---|
11
- | [`@leiyi-works/dsh-ui-tweaks`](https://www.npmjs.com/package/@leiyi-works/dsh-ui-tweaks)(界面微调) | 浏览器界面与 DOM 行为 | 隐藏右侧栏展开按钮、会话列表默认展开 |
12
- | **`@leiyi-works/dsh-feature-tweaks`(功能微调,本包)** | Host 侧功能与**默认值** | 新会话默认开智能体团队协作 |
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 | `agent-team` | `defaultEnabled: false` | `defaultEnabled: true` | 新根会话(含普通 fork)在第一次模型步前默认开「智能体团队协作」;已在会话里保存过选择的会话不受影响;单会话仍可在「模型与推理等级」菜单里手动关 |
19
- | 2 | `feature-tweaks.reload` | 桌面壳不绑刷新键(开发构建才有 Reload 菜单) | 桌面端 F5 / 网页端 Ctrl+Shift+R | 整页刷新快捷键,可配置;带「启动后插件已重建就先别刷新」的保护。从 `dsh-sidebar-folders` 0.13.4 迁移过来 |
20
- | 3 | 桌面壳的退出确认(`quit-inspection` 应答) | 有活动定时任务就弹「应用关闭期间,定时任务不会运行」确认框 | 定时任务不计入退出确认 | 退出只在**确实有任务在跑**时确认;定时任务不再触发确认,文案也不再提它。详见下文 |
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
- 团队模式会往上下文注入协作提示词和 `team_task_*` 工具,**token 开销更高**;简单任务随手关掉即可。
32
+ 开关走 Host 的 `settings` 服务写入本行 Config 的 volatile 字段(`settings.update`),所以:
23
33
 
24
- ### 退出不再因定时任务确认
34
+ - 保存后立即生效,无需重启;
35
+ - 落在 profile 的 `cordis.patch.yml`(用户覆盖层),重装/升级插件不丢,随云端同步换机;
36
+ - 浏览器端通过 SSE 热更新,另一台页面/窗口也会同步。
25
37
 
26
- - **改了什么**:桌面端(托盘「退出」、菜单退出、关闭窗口后托盘退出都算)在退出前会问 Host 两件事——有没有任务正在跑、有没有已排期的定时任务。官方只要有任一项就弹原生确认框。本包拦下 Host 的这条应答,把「有定时任务」恒置为否。
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
- ### 刷新页面快捷键(F5)
40
+ ## 菜单文件夹(标签页 2)
35
41
 
36
- - **键位**:桌面端 <kbd>F5</kbd>,网页端 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd>;快捷键服务要求同一个组合只能有一个注册者,所以 F5 只在本包里注册(已从 `dsh-sidebar-folders` 移除)。
37
- - **改键/清除**:设置 → <kbd>Ctrl</kbd>+<kbd>/</kbd>「快捷键」,搜「刷新页面 / Reload page」;桌面端覆盖保存在 `userData/keybindings.json`,网页端在该源站 localStorage 的 `dsh.keybindings.v1`。
38
- - **安全刷新**:刷新前先问 Host `GET /__dsh-feature-tweaks/reload-safe`。若本次启动后有任何 Client bundle 被重建(例如刚 `pnpm install` 了新插件),直接刷新会因桌面壳仍用启动时的 boot manifest 而弹「应用无法启动」;此时只在页面上提示「请完全退出 DSH 再打开一次」,不刷新。
39
- - **兜底**:桌面壳的按键桥接可能晚到,所以另有 document 级 F5 监听;桥接先处理时该监听不会重复触发。
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.3.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`,且排在 `@deepseek-ai/dsh-base` 之后。**重启 DSH** 生效(配置在启动时合成)。
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
- - `cordis.patch.yml` —— bundle patch,在 `dsh-base` 插入官方行之后按 id 覆盖。效果与手改 profile 的 `cordis.patch.yml` 完全一致,但能整体启停、单独删除、换机/重装后随插件恢复。
54
- - `index.js` —— Host 行 `feature-tweaks`:让 bundle 在插件页显示为运行中,提供刷新快捷键的安全探针路由 `GET /__dsh-feature-tweaks/reload-safe`(返回 live Client 模块图的 revs 和启动后被重建的 bundle),并包装 `process.send`、把桌面壳 `quit-inspection` 应答里的 `scheduledTasks` 改写成 false(仅桌面端有这条 IPC;其它 Host 自动跳过)。
55
- - `client.js` —— Web 侧半边:注册「刷新页面」快捷键、F5 兜底监听、安全刷新逻辑;诊断日志写到 `<DSH_HOME>/data/feature-tweaks-diag.log`。
59
+ 1. 本包升到 0.5.0;
60
+ 2. 从 profile 依赖与 `dsh.profile.bundles` 里移除 `@leiyi-works/dsh-menu-folders`;
61
+ 3. 重启;文件夹、开关默认值都保持原状,不需要迁移配置。
56
62
 
57
- **关键坑**:loader 的 patch 会**整段替换**目标行的 `config`(不是深合并)。覆盖时必须把该行原本的其它字段一起重述——例如 `agent-team` 要带上 `maxTasks: 256`,否则会退回 schema 默认值。
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
- 1. 配置类:在 `cordis.patch.yml` 末尾按注释模板追加一段(官方默认 → 本包值 → 理由);
62
- 2. 代码类:改 `index.js` / `client.js`,并在 `cordis.patch.yml` 文末「代码侧微调」里补一条说明;
63
- 3. README 的「现有微调」表加一行;
64
- 4. 升版本号 → 发布 → profile 更新依赖 → 重启验证。
76
+ ## 实现机制
65
77
 
66
- 行 id 与官方包名的对照可以看 `~/.dsh/profiles/<profile>/node_modules/@deepseek-ai/dsh-base/cordis.patch.yml` 的 `insert` 列表。
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
- - 重启后新建一个会话,打开「模型与推理等级」菜单,底部「启用智能体团队协作」应为开;该会话应带 `team_task_*` 工具;
71
- - 已存在的会话(保存过选择)行为不变;
72
- - 手动关掉某一会话的开关后,该会话保持关闭。
73
- - 桌面端按 <kbd>F5</kbd> 应刷新页面;设置 → 快捷键里能看到「刷新页面」并改了生效。
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
- - **整体**:从 profile 的 `dsh.profile.bundles` 移除 `@leiyi-works/dsh-feature-tweaks`,一步回到官方默认;
81
- - **单项(配置类)**:在 profile 的 `cordis.patch.yml`(更晚应用)里把对应行覆盖回去;
82
- - **退出确认**:删掉 `index.js` 里 `apply()` 开头对 `installQuitInspectionTweak(ctx)` 的调用(或改回不包装 `process.send`)后重启;
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