dsh-settings-plus
zthhero/dsh-settings-plus
在设置中新增「设置增强」分区:发送快捷键、退出时切换的默认工作区、把会话移动到其它工作区、永久删除会话、Windows 窗口位置/大小记忆,以及隐藏设置里的 DeepSeek 提供方卡片。
安装
dsh plugin --profile web add github:zthhero/dsh-settings-plusREADME
设置增强(dsh-settings-plus)
给 DeepSeek Harness 补上一些原生设置里没有的能力:发送快捷键、默认工作区切换、永久删除会话、窗口位置/大小记忆,以及隐藏模型设置里的 DeepSeek 提供方卡片。
插件以 profile bundle 安装。安装后,设置左侧会新增一个独立的 设置增强 分区,页面标题旁显示当前版本。
Settings Enhanced for DeepSeek Harness — send shortcut, deferred default-workspace switch, permanent session deletion, window position/size memory on Windows, and a DeepSeek provider-card switch.
版本变更见 CHANGELOG.md。
功能
1. 发送快捷键
在 设置 → 设置增强 中选择发送消息的按键:
Enter发送,Shift+Enter换行(默认);Ctrl/Cmd+Enter发送,Enter换行。
选择控件复刻 DSH 原生的选择按钮、右侧 chevron、菜单内选中打勾,不使用浏览器原生 <select>。
2. 默认工作区目录
选择一个目录作为默认工作区:
- 选择后会弹出确认框;
- 真正的目录切换和会话迁移在退出应用时执行;
- 下次启动时 Host 会把结果写回设置:成功显示新目录并清掉待重启提示,失败显示原因;
- 旧默认工作区里没迁移完的会话会在下次退出时继续尝试。
DSH 没有“修改工作区路径”的接口,因此这个功能需要在退出时改写工作区注册表、迁移会话日志与投影缓存。
3. 移动会话到工作区
会话行的「…」菜单里新增 移动到工作区,子菜单会列出当前会话所在工作区之外的其它工作区:
- 选择目标工作区后,只移动选中的这个会话,其它会话不动;
- 退出 DSH 时执行迁移,重启后会话出现在目标工作区;
- 每个会话可以单独指定目标,不会简单地全部移动到默认工作区;
- Host 会先备份,然后迁移会话日志、header 中的
cwd、projection cache 和 workspace 记录。
4. 永久删除会话
会话行的「…」菜单里新增「删除会话」:
- 先归档,再从磁盘删除会话日志与投影缓存;
- 选中的会话也能删:删完自动跳到它后面那个会话;如果它已经是最后一个,就在同一工作区新建一个会话;
- 归档和删除在同一组菜单页脚中,紧跟在原生「归档」后面。
5. 窗口位置和大小(Windows Desktop)
在 Windows 桌面端记住主窗口的位置、大小和最大化状态,默认开启:
- 启动时在 shell 显示窗口之前同步恢复,第一帧就是上次的大小,不会先出现默认大小再跳变;
- 运行期间常驻 watcher,移动、缩放、最大化/还原后立即写回(约 300ms 内落盘);
- 关闭到托盘或正常退出时,由 watcher 负责最后一次写入;退出钩子不再启动 PowerShell,所以退出不会拖住单实例锁——退出后立刻双击图标也能正常打开;
- 保存的位置不在任何显示器上时,会居中到主显示器;
- 可在设置里用「记住窗口位置和大小」开关关闭;关闭后不记录、不恢复。
普通 dsh web 浏览器、macOS 和 Linux 会自动跳过这个功能。
6. 隐藏模型设置中的 DeepSeek 选项
在 设置 → 模型 中隐藏显示名为 DeepSeek 的提供方卡片,保留 DeepSeek账号:
- 默认关闭;
- 打开「隐藏设置中的 DeepSeek 选项」后卡片立即隐藏;
- 隐藏通过预先不可见 + 同步扫描实现,切换模型页时不会先闪出 DeepSeek 再消失;
- 只影响 UI 可见性,不会删除提供方,也不影响模型调用。
7. 设置分区与版本
所有插件设置集中在 设置 → 设置增强,页面顶部标明「以下设置由 dsh-settings-plus 插件提供」,并显示当前插件版本。
实现要点
- Bundle 安装:
package.json声明dsh.bundle.patch,包内cordis.patch.yml插入dsh-settings-plus行;profile 通过dsh.profile.bundles选中它。客户端通过dsh.client提供 Web UI。 - Host 半侧(
lib/index.js、switch.js、profile-state.js、window-state.js):- 声明设置 schema;
- 处理会话删除请求;
- 在退出时处理移动会话请求和默认工作区切换;
- 管理窗口记忆和跨进程状态。
- Client 半侧(
lib/client.js):- 注册
settings.section设置分区; - 注册会话右键菜单的子菜单(移动、删除);
- 通过
configForms读写插件设置; - 在模型设置页做 DeepSeek 卡片的可见性处理。
- 注册
- 唯一状态文件:
<profile>/.dsh-settings-plus/state.json。里面包含默认工作区切换记账、rememberWindow、hideDeepSeekModel和上次窗口window。Host 与 PowerShell watcher 通过state.json.lock目录串行化写入。 - 移动会话:Client 通过子菜单把
{sessionId, targetPath}加入 config 的moveRequests;Host 退出钩子调用moveSessionToWorkspace迁移存储并更新 workspace 记录,成功的请求从队列清除,失败的请求保留到下次退出重试。 - 窗口记忆:profile 插件没有 Electron BrowserWindow API,因此通过包内 PowerShell 脚本调用 Win32 窗口 API。Host 启动时同步恢复(代价是一次 PowerShell 冷启动,约 1.5 秒),之后由 watcher 持续保存;Windows 专用。退出时不再同步调用 PowerShell:桌面 shell 会一直等到 Host 退出才
app.quit(),而单实例锁要到 Electron 主进程退出才释放,退出钩子里的spawnSync会让这段时间变成 1.5 秒以上,期间双击图标启动的新实例会静默退出。placement 由 watcher 负责落盘,window.log里能看到saved/final save、exit hook ...ms记录。 - DeepSeek 隐藏:原生模型设置把 provider 渲染成带
rowName的li;账号卡片额外带accountStatus。插件先用样式把 provider 卡片设为不可见,MutationObserver 同步扫描后只显示非目标卡片,从而保留DeepSeek账号并消除闪烁。 - 无网络请求:插件不向外部发送数据;状态只保存在本地 profile。
安装
从 GitHub 安装
在 DSH 的 Add plugin 向导中填写:
https://github.com/ZTHHero/dsh-settings-plus
点击 Install,安装完成后重启 DSH 或刷新页面:设置左侧会出现 设置增强。插件按 profile 安装,切换 profile 后需要在该 profile 里重新安装。
使用
- 设置 → 设置增强:发送快捷键、默认工作区、窗口记忆开关、DeepSeek 隐藏开关。
- 默认值:
- 发送快捷键:
Enter发送; - 记住窗口位置和大小:开启;
- 隐藏设置中的 DeepSeek 选项:关闭。
- 发送快捷键:
- 窗口记忆开关:关闭后立即停止记录/恢复;重新打开时先记录当前窗口,再继续跟踪。
- DeepSeek 隐藏开关:默认关闭;打开后
DeepSeek卡片隐藏,DeepSeek账号始终保留。 - 默认工作区:选择目录后需退出应用再启动,切换和会话迁移才会执行。
- 状态文件:
<profile>/.dsh-settings-plus/state.json;删除它可以清除窗口记忆和默认工作区记账。
卸载
- 打开 DSH 的 插件 → 已安装;
- 找到 设置增强 / dsh-settings-plus,选择 卸载 / 移除;
- 重启 DSH。
卸载后:
- 插件不再出现在设置里;
- 窗口记忆 watcher 会随应用退出停止;
- 如需彻底清除本地数据,删除
<profile>/.dsh-settings-plus/目录。