dsh-sidebar-size
本插件是使用于DeepSeek Harness的右侧边栏尺寸持久化记忆插件。会在用户拖动右侧边栏更改尺寸时记录尺寸偏好并持久化记忆。
一、功能介绍
- 按活动页签类型分别记忆：拖动右侧边栏改变宽度时，插件记录当时活动页签的类型（如引导页、文件页、文档页），
下次打开同类内容时自动恢复。记忆与具体文件、具体会话无关，全局共用。
- 没有记录时沿上级内容页继承：区分内容模式下依次查找「本类型记录 → 上级内容页记录 → … → 引导页记录」，
整条继承链都没有记录时使用 DSH 默认右侧边栏尺寸。
继承只影响显示：不会为没有继承上级内容页的尺寸创建记录，只记录经用户拖拽过的内容页尺寸。
- 可切换为统一宽度：关闭“按显示内容区分尺寸”后，所有内容共用同一份宽度；该功能开启或关闭情况下的数据分别记录、互不覆盖。
- 状态可见：设置页显示插件是否正常运行、当前活动页签、当前侧边栏尺寸及其来源
（本类型记录 / 继承自某个上级 / DSH 默认）。
- 运行日志可导出：设置页可一键生成一段可直接复制的运行日志，便于反馈问题。
- 数据迁移：导出当前数据、导入（先预览再确认）。
二、兼容性
实测兼容
自 0.1.0 起：
| 环境 | 结果 |
|---|
| DSH 桌面端 v0.2.0-rc.2（本体） | 已实测通过 |
DSH 桌面端 v0.2.0-rc.2 + dsh-better-sidebar v0.24.1 | 已实测通过 |
理论兼容
自 0.1.0 起：
- 与实测兼容同一版本线（v0.2.0-rc.x）的其它 DSH本体 或 本体+插件 组合，以及 DSH 的 Web 形态；
本插件不修改宿主文件、不干预其它插件、只读写自己的数据，因此上述情形理论上可用；
但这些组合未逐一实测，如遇问题请附上设置页导出的运行日志。
三、使用方法
安装
用 DSH 的插件安装入口添加本插件（官方 CLI 的子命令形式为
plugin --profile desktop add <包名或路径>），然后重启桌面端。
安装成功并重启后，设置里会出现「侧边栏尺寸」分组。
方式一：用发行包（无需构建，推荐）
每次发版都会生成 dsh-sidebar-size-<版本>.tgz（例如 dsh-sidebar-size-0.1.1.tgz），
从本仓库的 Releases 页面下载对应的 .tgz 文件，然后把上面的 <包名或路径> 换成该文件的本地路径即可。
发行包里已经包含构建好的 lib/，不需要额外安装依赖或执行构建。
方式二：用源码
克隆本仓库后，先安装依赖并构建，再以仓库目录作为路径安装：
pnpm install
pnpm build
plugin --profile desktop add <本仓库目录>
本仓库的 lib/（构建产物）不进入版本历史，所以必须先执行构建；
构建需要 Node 24 与 pnpm 11（见 package.json 的 packageManager），两者用 Corepack 或官方安装包均可获得。
设置项
| 设置 | 说明 |
|---|
| 总开关 | 关闭后不再记录、记忆或调整宽度，右侧边栏宽度恢复DSH默认值，设置入口仍可重新开启 |
| 按显示内容区分尺寸 | 开：每个页签类型分别记录右侧边栏尺寸；关：所有内容共用同一尺寸记录。开启或关闭该设置项时记录的数据互不覆盖、相互独立；本插件初始默认开启该功能，第一次关闭时没有统一记录值，侧边栏回到 DSH 默认尺寸 |
| 已保存的宽度 | 下拉选择已记录的页标签类型，查看或修改记录数值。 |
| 重置侧边栏尺寸数据 | 二次确认后清除本插件保存的全部宽度数据，并把当前侧边栏恢复为默认尺寸 |
另有「数据迁移」：导出当前数据，以及“预览 → 确认”的导入。
更新与卸载
- 更新：换成新版本后重新安装并重启桌面端；已保存的宽度数据不受影响。
- 卸载：在插件管理里移除本插件并重启桌面端。卸载不会自动删除宽度数据；
如需一并清除，请在卸载前使用「重置」，或删除浏览器存储键
dsh-sidebar-size.widths.v1。
版本变更记录见 CHANGELOG.md。
四、说明与限制
- 未实测的情形：浮窗（浮动面板）、拖动过程中切换内容或改动开关、分栏焦点切换，
以及「理论兼容」里列出的组合——这些没有实测证据，不能保证行为完全符合预期。
- 稳定性：DeepSeek Harness版本更新时，本插件的功能可能失效。
- 异常结束进程：强制结束进程（而不是正常退出）可能丢失最近一次尺寸提交。
五、引用声明
- 许可：本插件以 MIT 许可证发布，全文见 LICENSE。
- 无隶属声明：本插件由第三方开发，与 DeepSeek 官方没有隶属、赞助或背书关系；
DeepSeek Harness 及其名称、产品与商标归其权利人所有。
- 共存插件：
dsh-better-sidebar 是第三方插件。本插件仅在其共存环境下做过实测，
两者之间没有隶属、赞助或依赖关系。
