DeepSeek Harness 左侧菜单显示/隐藏开关

前言¶

DeepSeek Harness（DSH）桌面版左侧栏默认列出所有「全局面板」项，随着插件增多会越来越长。想要精简界面、只保留当前需要的功能，没有现成入口。DSH 目前没有公开的「隐藏某个侧栏菜单项」的 API，只能通过数据层过滤来实现。

这是什么¶

这是一个 DSH 客户端插件：winjazw/dsh-sidebar-menu。它给 DSH 左侧栏底部增加一个滑块图标，打开后列出所有全局面板，逐项勾选即可显示/隐藏，选择保存在本地，重启后依然生效。

核心功能¶

逐项开关¶

面板每一行对应左侧菜单的一项，点一下即可隐藏或恢复，左侧菜单实时更新。

批量操作¶

全部隐藏：清空整列菜单（只保留「新会话」与工作区），一键把侧栏收至最简。
恢复：撤销上一步，最多连撤 20 步；「全部隐藏」点错了可以一步退回原来的选择。
全部显示：一键恢复所有项。

持久化与无障碍¶

选择存储在浏览器的 localStorage 中，关闭应用后重新打开，设置依然存在。
使用 Esc 关闭面板；每行使用 role="switch" + aria-checked；入口按钮带 aria-label。

状态判断¶

当没有可隐藏项时，「全部隐藏」按钮变灰；没有隐藏项时，「全部显示」变灰；撤销栈为空时「恢复」变灰。

安装¶

这是一个 DSH 本地 bundle（@local/… 是官方模板沿用的本地包命名，不发布到 npm）。

方式一：把目录交给 DSH（推荐）¶

git clone https://github.com/Winjazw/dsh-sidebar-menu.git

然后在 DSH 会话里让它把这个目录装成 bundle，等价于调用插件管理工具：

{ "action": "install_bundle", "target": "/绝对路径/dsh-sidebar-menu" }

装完会热加载，侧栏底部出现滑块图标；没出现就 ⌘R 重载一次。

方式二：手动放进 profile¶

# 1) 放进 profile 的 node_modules
ln -s "$PWD" ~/.dsh/profiles/<你的profile>/node_modules/@local/sidebar-menu

# 2) 在该 profile 的 package.json 里登记：
#    "dependencies": { "@local/sidebar-menu": "link:/绝对路径/dsh-sidebar-menu" }
#    "dsh": { "profile": { "bundles": [ … , "@local/sidebar-menu" ] } }

手动改完重启 DSH。

使用¶

左侧栏最底部（「Jev 统计」与头像之间）多了个滑块图标，点它。
弹出「左侧菜单设置」，逐项开关。
需要批量处理就用底部四个按钮。
完成 或 Esc 关闭。此时左侧菜单已是最新状态。

侧栏折叠成窄图标栏时入口仍在，面板依旧居中弹出。

工作原理¶

DSH 目前没有「隐藏某个侧栏菜单项」的公开 API：sidebar.panellist 只接受 id / order / label，layout 服务也只有 selectPanel / toggleSidebar / openRightbar / closeRightbar。本插件走数据层过滤，一共三处：

环节	做法
菜单来源	包住 `ctx.slots.entriesOfSlot('sidebar.panellist')`，只对这一个 key 过滤掉被隐藏的 id，其余原样透传；`ctx.effect` 在卸载时还原原实现
触发重算	侧栏靠 `subscribe('sidebar.panellist')` 重算清单。插件每次改动注册一个 `order: 1e9` 的哨兵条目来触发刷新，哨兵本身永远被过滤，不会出现在菜单里
入口与面板	入口注册在 `sidebar.footer.action`，面板注册在 `shell.overlay`（该层本身 click-through，面板根节点自己开 `pointer-events:auto`）
样式	注入一个 `<style data-plugin-css>`，颜色/圆角/焦点环全部取 `--dsw-alias-`、`--dsw-radius-` 等主题 token，跟随明暗主题

Host 侧（index.js）是空的：所有逻辑都在渲染进程，不改宿主任何文件。

兼容性¶

能保证：不兼容时被 DSH 安全拒绝，而不是装成一个半坏的插件。

不能保证：所有 DSH 版本都能用——它依赖上表那三处内部面，而这些会随版本演化。

依赖	缺失/变更时
`engines.dsh` + DSH 的 compatibility preflight	不满足就 `disabling profile plugin …`，插件不加载并打印原因
`sidebar.footer.action` / `shell.overlay`	缺哪个跳过哪个（`contribute()` 内 try/catch），其余照旧
`entriesOfSlot` 可被包住	包不住 → 面板显示「当前版本不支持」，不隐藏、不报错、不影响侧栏

声明：engines.dsh: ">=0.2.0-rc.2"（不封上限，新版本仍会尝试加载，靠能力探测降级）
实测：0.2.1-rc.2（macOS 桌面版）
0.1.x：会被拒绝加载（不是坏掉）。需要的话先做隔离环境实测，再把下限放宽

升级 DSH 后复查三步：底部图标还在吗 → 面板能列出项吗（列出 = entriesOfSlot 还能用）→ 关一项菜单真的少了吗。

若被拒绝加载，可在 profile 目录的 compatibility.json 里给这个包登记显式豁免（informed grant）——这属于用户决策，插件不代劳。

已知限制¶

只影响「全局面板」那一列菜单；不影响工作区里的会话列表与底部状态条。
「恢复」是撤销上一步，不是「恢复默认」；撤销历史在内存里，重开应用后清空（持久化的只有当前清单）。
若 DSH 换了左侧菜单的数据来源，最坏表现是「面板能打开、但隐藏不生效」——侧栏本身不会坏。

目录结构¶

dsh-sidebar-menu/
├─ package.json        # bundle 清单：dsh.bundle.patch / dsh.client / engines
├─ cordis.patch.yml    # 插入一行插件 entry
├─ index.js            # Host 半边（有意为空）
├─ client.js           # 全部功能：过滤 + 哨兵 + 底部按钮 + 面板 + 样式
├─ locale/{zh,en}.json # 插件页里的标题与说明
├─ icon.svg
├─ docs/               # README 截图
└─ LICENSE (MIT)

开发与自检¶

node --check index.js
node --check client.js
node -e "JSON.parse(require('fs').readFileSync('package.json','utf8'))"

改完热重载：DSH 里 ⌘R。想直接看持久化真相：

strings ~/Library/Application\ Support/@deepseek-ai/dsh-desktop/Local\ Storage/leveldb/*.log \
  | grep -A1 'dsh-sidebar-menu.hidden.v1'

适用场景与注意¶

适合经常需要精简左侧栏、只保留当前使用面板的开发者。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。

小结¶

这个插件通过数据层过滤实现了左侧菜单项的显示/隐藏控制，支持逐项开关与批量操作，选择持久化存储，并适配主题与无障碍。适合希望在 DSH 中快速调整左侧栏布局的用户。

目录页：https://www.skillhub.cn/plugins/Winjazw/dsh-sidebar-menu
GitHub：https://github.com/Winjazw/dsh-sidebar-menu