dsh-plugin-atlas

August 23, 2026 · View on GitHub

npm version License: MIT

为 dsh 的 Web UI 补上三件事：对话区左缘的轮次刻度尺、输入框里的 ↑/↓ 历史翻找，以及设置页里的会话归档管理。

对话刻度尺

每轮对话对应刻度尺上的一个刻度，间距固定，超出可视高度后出现自带的细滚动条。整条历史的刻度由宿主端直接索引，长会话的切换与浏览不受加载拖累。

指针进入刻度尺时，最近的刻度伸长加深，邻近刻度随之递减伸缩；点击刻度跳转到对应消息，目标在尚未加载的历史里就先加载再滚动定位并短暂高亮；停留处显示该轮的输入与回复预览，Alt+↑/↓ 在轮次间逐条移动。配色跟随宿主主题。

对话刻度尺

输入历史

在输入框按 ↑，最近发送的消息直接填入，连按向更早翻找，↓ 返回，走回起点时恢复翻找前的草稿——和终端里翻历史命令一个手感。光标停在文本开头或末尾才触发翻找，光标在正文中时箭头照常移动，不打扰编辑。

归档管理

设置页的一级分区：已归档会话按工作区分组，支持搜索与批量取消归档，还原后侧边栏实时恢复、无需重启。标题与轮次数取自会话日志本体。

归档管理

自动归档默认关闭，可配置「不活跃超过 N 天」与「每个工作区保留最近 M 条」，每日核查一次，执行前可试运行预览清单。

安装

dsh plugin --profile web add dsh-plugin-atlas

也可以在 Web UI 的 设置 → 插件 里按包名安装（经 dsh-plugin-install），或直接从 GitHub 装：

dsh plugin --profile web add github:qinyre/dsh-plugin-atlas

开发时 add file:/path/to/dsh-plugin-atlas 可装本地检出，包内 prepare 脚本会自动构建。卸载把 add 换成 remove 即可。

安全与边界

写操作要求同源 POST，规则数值有范围校验，自动归档只调用 dsh 公开的 archiveSession。取消归档经由注册表预留的状态写入路径完成——若未来 dsh 的改动使其失效，插件会明确报错而不是损坏数据，届时更新 dsh 与本插件即可。插件不删除任何会话或文件。

在 DSH Desktop 中

DSH Desktop 内嵌同一 Web UI，插件装上即在桌面内生效。

开发

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

端到端 smoke 默认关闭，要求同级目录存在 deepseek-harness 源码检出且 Node ≥ 22.19：

DSH_ATLAS_PLUGIN_SMOKE=1 pnpm test

它会建临时 DSH_HOME、把本插件装入 web profile、启动 dsh web，并逐一探测各路由。

许可

MIT