前言¶
用 DeepSeek Harness(dsh)做智能体或日常对话时,侧栏会话会越积越多,而默认流程里「删掉某一行」往往要绕到归档视图或别处操作。另一方面,字号和分区配色分散在主题里时,想只改侧栏背景或代码区字号,不一定有集中入口。
社区插件 dsh-plugin-session-delete-and-appearance(仓库 Ai-design-001/-DSH_mod-)把两件事做成纯前端能力:在侧栏直接触发会话归档(界面上表现为删除),并在 设置 → 外观定制 里调节正文/代码/终端字号与分区颜色。实现上不依赖运行时包、不发网络请求,Host 侧 index.js 的 apply() 为空。
这是什么¶
| 项目 | 说明 |
|---|---|
| npm 包名 | dsh-plugin-session-delete-and-appearance |
| 版本(资料) | 0.1.0 |
| 维护者 | Ai-design-001 |
| 许可证 | MIT |
| 目录页 | skillhub.cn 插件页 |
| 源码 | GitHub |
插件挂在 dsh 的 Cordis 槽位上,Client 逻辑在 client.js:删除入口、外观设置页。社区目录站点与 DeepSeek / 幻方无官方从属关系;安装前建议自行查看仓库源码与许可证。
会话删除¶
插件提供两个入口,对应不同会话行形态:
| 入口 | 位置 | 说明 |
|---|---|---|
| 行内图标 | 会话行右侧(悬停时出现) | 常规会话行 |
| 悬停卡片里的「删除会话」 | 会话行悬停卡片底部 | 对空白的「新会话」行同样生效;行内图标不渲染这种行 |
操作后列表会立即收起对应行,无需手动刷新页面。
需要弄清的是平台语义:dsh 会话接口没有硬删除。插件调用宿主提供的 archiveSession,再把侧栏切回「隐藏已归档」视图,因此界面上像删掉了,数据仍在归档里,可通过「显示已归档」恢复。若要在磁盘上彻底清理记录,需自行在文件系统处理,插件不承担这一步。
外观定制¶
在 设置 → 外观定制 中分两组:
字体大小
- 正文:10–22px
- 代码:10–16px
- 终端:10–20px
步进调节,到边界时按钮自动禁用。
分区颜色
可单独设置:侧边栏背景、主背景、层级背景(一级 / 二级)、品牌强调色、边框(一级 / 二级)。每项可「恢复默认」,或整组「全部恢复默认」。颜色同时写入浅色与深色主题,改动即时生效,无需重启 dsh。
持久化仅一项:localStorage 键 dsh.session-delete-and-appearance.colors.v1,存颜色 JSON(例如 {"sidebar":"#1f2430"})。卸载后该键可能仍保留;重装会再次应用,若不想保留可先「全部恢复默认」再卸载。
颜色通过主题 token(--dsw-*)覆盖;宿主若改名 token,旧覆盖会失效并退回默认配色,不应导致崩溃。
安装与启用¶
把命令中的 desktop 换成你的 profile 名(桌面端常见 desktop,Web 端常见 web)。安装后重启 dsh,或在插件页重载该插件。
方式一 · 插件市场(收录后)
在 dsh 插件 → 发现 中搜索「会话删除」或包名并安装。
方式二 · npm
dsh plugin --profile desktop add dsh-plugin-session-delete-and-appearance
方式三 · GitHub
dsh plugin --profile desktop add github:Ai-design-001/-DSH_mod-
方式四 · 本地目录(开发调试)
dsh plugin --profile desktop add link:D:\path\to\dsh-plugin-session-delete-and-appearance
将 link: 后的路径改为你本机 clone 或解压后的插件目录。
卸载示例:
dsh plugin --profile desktop remove dsh-plugin-session-delete-and-appearance
典型用法¶
- 重启后把鼠标移到侧栏任意会话行:右侧出现垃圾桶图标;悬停卡片底部可见「删除会话」。
- 打开 设置 → 外观定制:按档位调字号,为各分区选色。
- 需要还原时:单项点「恢复默认」,或整组点「全部恢复默认」。
空白「新会话」行若看不到行内图标,用悬停卡片底部的「删除会话」。触屏设备侧栏无 hover 时,实际可用入口主要是行内图标。
兼容性与宿主席位¶
README 记载的开发验证环境:dsh Desktop 0.2.2-rc.1 / Windows 11 / 内置 Chromium。插件声明需要 dsh 0.2.x 档能力。
依赖的槽位与服务(版本过旧时对应 UI 可能不出现,一般不报错):
| 类型 | 名称 |
|---|---|
| 槽位 | sidebar.workspaces.session.row.action |
| 槽位 | sidebar.session.row.hover |
| 槽位 | settings.section |
| 服务 | uiWorkspace.archiveSession、theme.overrideTokens、theme.setFontSize、locale.register |
package.json 中 Client 注入包括 @deepseek-ai/dsh-client-ui-theme、@deepseek-ai/dsh-client-ui-workspace、@deepseek-ai/dsh-client-ui-conversation。
权限与隐私¶
- 无 Host 业务逻辑,行为均在浏览器端。
- 不发起网络请求,不读文件,不碰凭据,不执行命令。
- 删除会话与你在界面上点归档等价,走宿主
archiveSession。
插件以当前 dsh 进程权限运行;安装前应阅读 client.js 与 cordis.patch.yml,确认符合你的环境策略。
结尾¶
dsh-plugin-session-delete-and-appearance 适合希望在侧栏快速「删掉」会话行(实为归档)、并在一处调节字号与分区配色的 dsh 用户。功能边界清楚:可恢复归档、可本地存颜色,不做硬删除与远程同步。