在使用 DeepSeek Harness 进行开发或交互时,调整右侧边栏宽度以查看隐藏的上下文或工具是常见操作。若频繁切换不同类型的内容页签(如引导页、文件页、文档页),手动调整宽度会消耗额外精力。dsh-sidebar-size 插件旨在解决这一问题,它通过记忆和恢复侧边栏尺寸,减少重复操作。
核心功能¶
该插件主要提供以下能力:
- 按页签类型分别记忆:插件记录当前活动页签的类型,并在下次打开同类内容时恢复对应的右侧边栏宽度。记忆与具体文件或会话无关,是全局共享的。
- 继承机制:当特定类型没有记录时,插件会沿继承链查找上级内容页的记录,直到找到有效记录或回退到 DSH 默认尺寸。需注意,继承仅影响显示,不会为未经过用户拖拽的内容页创建记录。
- 统一宽度模式:可关闭“按显示内容区分尺寸”开关,使所有内容共用同一份宽度记录。
- 状态与日志:在设置页中,用户可以查看插件运行状态、当前活动页签、侧边栏尺寸及其来源(本类型记录/继承自上级/DSH 默认)。此外,支持一键导出运行日志以便排查问题。
- 数据迁移:支持数据的导出与导入(预览后确认),便于在不同环境间迁移配置。
安装与启用¶
安装需通过 DSH 的插件安装入口,使用官方 CLI 的子命令形式。安装成功并重启桌面端后,设置页会出现「侧边栏尺寸」分组。
方式一:使用发行包(推荐)
从本仓库的 Releases 页面下载对应版本的 .tgz 文件(例如 dsh-sidebar-size-0.1.1.tgz),将安装命令中的 <包名或路径> 替换为该文件的本地路径即可。
plugin --profile desktop add <本地文件路径.tgz>
方式二:使用源码
克隆本仓库后,需先安装依赖并构建,再以仓库目录作为路径安装。构建需要 Node 24 与 pnpm 11(版本号见 package.json)。
pnpm install
pnpm build
plugin --profile desktop add <本仓库目录>
配置与使用¶
安装完成后,在 DSH 设置页找到「侧边栏尺寸」分组进行配置:
- 总开关:控制插件是否生效。关闭后不再记录、记忆或调整宽度,侧边栏宽度恢复为 DSH 默认值,但设置入口仍可重新开启。
- 按显示内容区分尺寸:默认开启。开启时,每个页签类型分别记录右侧边栏尺寸;关闭时,所有内容共用同一尺寸记录。切换此设置时,新旧数据互不覆盖。
- 已保存的宽度:下拉选择已记录的页签类型,可查看或修改该类型的记录数值。
- 重置侧边栏尺寸数据:二次确认后清除插件保存的全部宽度数据,并将当前侧边栏恢复为默认尺寸。
此外,设置页还提供数据迁移功能,支持导出当前数据和导入(需预览确认)。
兼容性与注意事项¶
- 实测兼容:基于 DSH 桌面端 v0.2.0-rc.2(本体)及
dsh-better-sidebarv0.24.1 的实测组合通过。 - 理论兼容:与同一版本线(v0.2.0-rc.x)的其它 DSH 本体或本体+插件组合,以及 DSH Web 形态理论上兼容。插件不修改宿主文件,仅读写自身数据。
- 未实测情形:浮窗(浮动面板)、拖动过程中切换内容或改动开关、分栏焦点切换,以及上述理论兼容列表中的组合未逐一实测,不能保证行为完全符合预期。
- 稳定性与维护:DeepSeek Harness 本体版本更新时,本插件功能可能失效。异常结束进程(强制关闭而非正常退出)可能丢失最近一次尺寸提交的数据。
- 依赖声明:本插件由第三方开发,与 DeepSeek 官方无隶属、赞助或背书关系,以 MIT 许可证发布。