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 是第三方插件。本插件仅在其共存环境下做过实测， 两者之间没有隶属、赞助或依赖关系。