接管 DSH 的左侧栏:拖拽排序、改名、换成 24 个内置图标之一、隐藏,以及把多个面板合并成一行(点开是成员菜单)。改动即时生效、重启后保留;可以一键导入已有的 dsh-panellist 配置。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-railkeeper
# Release 预构建包
dsh plugin --profile web add "https://github.com/lcy362/dsh-railkeeper/releases/latest/download/dsh-railkeeper.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:lcy362/dsh-railkeeper
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 简体中文
接管 DeepSeek Harness 的左侧栏:排序、改名、换图标、隐藏、分组。改动即时生效,重启后保留。
它是已停止维护的 dsh-panellist 的替代品,按当前 DSH 客户端接口(0.2.2)重写,并且一键导入已有的 dsh-panellist 配置。
能做什么
| 能力 | 说明 |
|---|---|
| 排序 | 拖动手柄,或用 ↑ / ↓ 按钮(键盘可达)。 |
| 改名 | 直接输入新名字;清空即恢复插件自己的名称。 |
| 换图标 | 24 个内置线条图标;选「原始图标」恢复插件自带图标。 |
| 隐藏 | 隐藏的面板照常工作、照常可选,只是左侧栏不再画它那一行。 |
| 分组 | 把两个以上面板合成一行;点这一行会在旁边弹出成员菜单,而不是把你带走。 |
| 导入 / 导出 | 整份配置导出为 JSON,可备份、可换机器。 |
| 迁移 | 读取 $DSH_HOME/panellist.json 并转换成本插件结构。 |
| 存储 | 单文件 $DSH_HOME/railkeeper.json,按 profile 分节,权限 0600。 |
配置是本插件唯一自己持有的状态。它不会去改 profile 的 cordis.patch.yml;配置文件损坏时会先复制成 .corrupt-<时间戳> 留档,而不是直接丢掉。
安装
dsh plugin --profile desktop add dsh-railkeeper
本地目录安装:设置 → 插件 → 添加插件。
装完打开 设置 → 面板列表。
重要:不要同时运行两个左栏管理插件
Railkeeper 改写的是侧栏读取的 sidebar.panellist 注册表。任何做同样事情的插件都会和它打架——两边会互相覆盖,形成来回对写。
最容易踩到的场景:刚停用 dsh-panellist 但没有重新加载页面,它的浏览器半区还在内存里跑,还在改同一批条目。Railkeeper 会检测到这一点,暂停改写顺序与名称,并给出提示让你重新加载页面(或重启应用)。「隐藏」标记仍然生效,不会丢东西。
重新加载一次页面,railkeeper 就会独占左栏。
兼容性
- DSH
>=0.2.0-rc.2 <0.3.0-0,实测0.2.2-rc.3。 - Node
^22.19.0 || >=24.0.0(仅构建与测试需要)。
Railkeeper 刻意不依赖任何 Harness 客户端包(React 除外):图标、控件、样式、设置页全部自带。这样 DSH 某次发布改掉内部导出名,也不会把本插件打成空白。
它确实用到一个内核接缝:改写注册表条目上的 options 不会通知订阅者,所以本插件会注册一个临时条目并立刻释放,推动侧栏重新读一遍注册表。这个技巧哪天失效,结果也只是「左栏不再跟随配置」,面板照常加载,不会崩。插件会把每轮实测结果上报到 GET /railkeeper/api/client-status,让这件事可查而不是玄学。
HTTP 接口
全部挂在 /railkeeper/api 下,只允许回环访问,并额外校验 Host;写请求还要求同源(完全没有 Origin 的情况放行,那是桌面版的 IPC 桥)。
| 方法 | 路径 | 用途 |
|---|---|---|
GET |
/health |
存储与 profile 状态。 |
GET |
/config |
当前 profile 的配置。 |
PUT |
/config |
保存 { config };非法输入回 400 并说明原因。 |
POST |
/config/reset |
恢复空配置。 |
GET |
/legacy |
转换已有的 dsh-panellist 配置。 |
GET/POST |
/client-status |
浏览器半区最近的上报(内存里保留最近 50 条)。 |
配置结构
{
"schemaVersion": 1,
"profiles": {
"desktop": {
"sequence": [
{ "type": "panel", "id": "plugins" },
{ "type": "group", "id": "g_1", "label": "统计", "icon": "chart",
"members": ["dsh-context", "personal-kit-usage"] }
],
"panels": {
"schedules": { "hidden": true },
"personal-kit-models": { "label": "模型开关", "icon": "bolt" }
}
}
}
}
sequence 只描述顺序与分组关系;panels 存单个面板的覆盖项。当前没注册的面板行会保留,所以插件卸了再装回来,那一行会回到原来的位置;设置页把它们列在「已配置但当前未安装」下面。
开发
node scripts/build-client.mjs # 由 src/client/ 构建 lib/client.js
node --test "test/*.test.mjs" # 51 项:配置、计划、宿主存储、路由、迁移
src/client/* 是普通 ES 模块。构建会把它们内联成 DSH 要求的单一浏览器产物(window.__ModuleLoader__.load({ id, factory })),因为运行时 require() 只能解析平台 seed。
改完 src/client/* 后重新构建,客户端 HMR 会热生效,不用重启应用;改 src/host/* 需要重启。改动客户端代码时顺手递增 src/client/index.js 里的 CLIENT_VERSION——它会上报到 /client-status,用来确认现在跑的是哪一代。
自检
页面加载后不久,本插件会跑一次隐形自检(它打开的菜单不绘制、不抢焦点),专门覆盖两条会“静默失效”的路径:
selectProbe—— 直接调layout.selectPanel(成员)并把activePanelId读回来,然后还原原来的选中项。clickProbe—— 渲染分组弹出菜单,在第一个菜单项上派发一次真实的MouseEvent,记录处理函数有没有执行、选中项最后落在哪。
两个结果、注册表现状、以及真实 DOM 的测量值都在 GET /railkeeper/api/client-status 里。外壳的槽位或布局行为一旦变化,这里会直接暴露,而不是表现为“点了没反应”。
验证到什么程度
test/ 覆盖配置模型、渲染计划、弹出菜单的摆放计算、宿主存储、回环路由,以及 dsh-panellist 迁移。
DOM 相关的路径没有单元测试:改写轨道行、隐藏、分组弹出菜单都需要真实浏览器。它们是在真实应用里、每轮重建后读真实 DOM 验证的——行数、实际画出的行数、每行标签、隐藏标记数、分组行标记数都会上报到 /client-status,并与计划逐项对照。本插件注入的每一条样式选择器都被限定在轨道 nav([data-rk-rail])或它自己的 .rk-* 类名下,因此不可能改到别的页面。
许可
MIT
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7797
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5191
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1007
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。