前言¶
在 DeepSeek Harness(DSH)桌面端长期使用时,左侧栏往往会同时承担会话切换、插件入口和费用展示。dsh-cost-meter 会把费用卡片渲染在侧栏底部,内容一多,窄侧栏里可读空间就更紧。若还想按需隐藏部分面板入口,或把已归档会话从磁盘上清出去,原生界面未必一步到位。dsh-sidebar-footer-fold 是维护者 eittyneo 发布的客户端插件,在已安装 dsh-cost-meter 的前提下,用少量 UI 增强补齐折叠费用区、编辑侧栏可见性,以及在设置里把归档会话移入 Windows 回收站等能力。本文按官方 README 与仓库元数据说明其定位、安装与用法。
这是什么¶
dsh-sidebar-footer-fold 是一句定位上的「侧栏增强小插件」:它不自带任何费用或额度数据,也不做计费;折叠与展开的对象是 dsh-cost-meter 已在侧栏画出的费用卡片。除此之外,它向侧栏「更多」菜单增加「编辑侧栏…」,并在设置页增加「归档会话清理」分区。源码与说明见 GitHub 仓库,社区目录页为 skillhub.cn/plugins/eittyneo/dsh-sidebar-footer-fold。许可证为 MIT(© 2026 eittyneo)。DSH 生态强调「一切皆插件」;社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
与 dsh-cost-meter 的关系¶
README 明确要求先安装并启用 dsh-cost-meter。本插件已在 dsh-cost-meter 1.9.58 上验证;依赖其侧栏 DOM(费用卡片节点使用 .cm-footer-stack 类)以及宿主插槽 sidebar.footer.action。若 dsh-cost-meter 大版本更新改动了侧栏 DOM,折叠按钮可能失效,README 说明最坏情况不影响 DSH 启动。
核心功能¶
费用面板折叠¶
侧栏底部、头像上方靠左有一行「费用面板 ▾」文字按钮。点一下可将 dsh-cost-meter 的侧栏费用卡片整块收起(按钮文案变为「费用面板 ▸」),再点展开。状态保存在本机浏览器 localStorage,刷新或重启 DSH 后仍保持。侧栏收成约 56px 图标栏时,该行自动隐藏。折叠仅通过给 body 加 class 实现(相对已废弃的本地实验版 0.4.0,不搬移第三方 React 管理的 DOM)。
编辑侧栏¶
在左侧栏面板列表的「更多」菜单中新增「编辑侧栏…」,可勾选显示或隐藏各侧栏面板入口;隐藏状态在本机记忆,可随时恢复。实现依赖宿主插槽 sidebar.panellist.actions 与侧栏面板按钮的 panelRow 类名。
归档会话清理¶
在设置页顶级分区(插槽 settings.section)列出已归档会话:按工作区分组,显示体积与创建时间。支持单个或全部「移入回收站」。移动的是 Windows 回收站(可还原),不是永久删除;只移动会话自身文件:
sessions/<project>/<sessionId>/storages/session_projcache/sessions/<sessionId>.json
不触碰其他会话、共享附件、账本或其他存储。删除后同步归档列表与工作区记账,侧栏会话列表即时刷新。宿主侧仅暴露两个本地 HTTP 接口;删除仅在用户点击时执行。
安装与启用¶
环境要求(见 README 与 package.json):
- DSH 0.2.1-rc.2 ~ 0.3.0(含 0.2.2-rc.1)
- 已安装
dsh-cost-meter - Node >= 20.0.0(插件包
engines字段)
方式一:从 GitHub 安装(推荐)¶
在已配置 DSH 桌面 profile 的机器上执行:
dsh plugin --profile desktop add github:eittyneo/dsh-sidebar-footer-fold
方式二:从 Release 的 tgz 安装¶
- 在 Releases 下载
dsh-sidebar-footer-fold-0.3.4.tgz - 在 DSH 插件管理里安装该 tgz,或执行:
dsh plugin --profile desktop add file:<path-to>/dsh-sidebar-footer-fold-0.3.4.tgz
安装后重启 DSH,或对窗口硬刷新(Ctrl+Shift+R),客户端脚本才会生效。
典型用法¶
- 折叠费用面板:点侧栏底部「费用面板 ▾」;无需额外配置,状态自动记忆。
- 编辑侧栏:左侧栏面板列表 →「更多」→「编辑侧栏…」,按需勾选面板可见性。
- 归档会话清理:打开设置 →「归档会话清理」,按工作区查看归档体积与时间,再选择移入回收站。
当前发行版为 0.3.4;README 称该版本已通过静态检查与运行时冒烟测试(宿主 apply()、路由、客户端模块加载/注册/dispose 均不抛异常)。
适用场景与注意¶
适合谁:已在 DSH 桌面端使用 dsh-cost-meter、希望侧栏底部费用区可折叠,并需要本机管理侧栏面板显隐或清理归档会话目录的开发者。
权限与审阅:插件以当前 DSH 进程权限运行;归档清理会移动本地会话目录与部分 storages 文件到回收站。安装前建议阅读仓库源码与 MIT 许可证,确认行为符合本机备份与安全策略。
兼容性摘要:
| 依赖 | 说明 |
|---|---|
| DSH | >=0.2.1-rc.2 <0.3.0 |
| dsh-cost-meter | 已在 1.9.58 验证;需 .cm-footer-stack |
| 宿主插槽 | sidebar.footer.action、sidebar.panellist.actions、settings.section |
卸载:执行下列命令后重启 DSH;已移入回收站的会话不会自动还原。
dsh plugin --profile desktop remove dsh-sidebar-footer-fold
结尾¶
dsh-sidebar-footer-fold 在 dsh-cost-meter 之上补了三块侧栏与设置能力:费用卡片折叠、面板入口编辑、归档会话进回收站,改动面集中在客户端与少量本地接口。若你的 DSH 版本落在 README 声明区间内且已启用费用计量插件,可按上文命令安装并在重启后使用。