dsh-plugin-atlas

dsh-plugin-atlas

为 dsh 提供两项能力：会话归档的管理（浏览、还原、可配置的自动归档），以及对话区左侧一条用于轮次导航的刻度尺。两项功能相互独立，可单独使用。

对话刻度尺

对话区左缘常驻一条纵向刻度尺，每轮对话（一条用户消息）对应一个刻度。刻度间距固定，不随会话长度变化：刻度较少时整列垂直居中，新增刻度自中部向两端延伸；超出可视高度后，刻度尺出现自带的细滚动条（支持滚轮与滑块拖动），不干预对话本身的滚动。

鼠标进入刻度尺区域时，距指针最近的刻度伸长并加深，邻近刻度按距离递减伸缩，形成随指针连续移动的局部放大效果（Focus+Context 鱼眼交互）；指针离开后全部复位。点击刻度跳转至对应消息——目标位于尚未加载的历史分页时，将先行加载再滚动定位并短暂高亮；指针停留处显示该轮的用户输入与模型输出预览；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

开发时可安装本地源码检出，包内 prepare 脚本会自动构建 lib/：

dsh plugin --profile web add file:/path/to/dsh-plugin-atlas

卸载：

dsh plugin --profile web remove dsh-plugin-atlas

安全与边界

写操作（取消归档、保存规则、执行自动归档）均要求同源 POST；规则数值设有范围校验；自动归档仅调用 dsh 公开的 archiveSession 接口，不读写私有状态。取消归档依赖注册表内部的状态写入函数——该路径在核心契约中已预留、尚未公开 RPC 化；若未来 dsh 的改动使其失效，插件将明确报错而非损坏数据，届时更新 dsh 与本插件即可。插件不删除任何会话或文件。

在 DSH Desktop 中

桌面客户端 DSH Desktop 内嵌同一 Web UI，本插件安装后即在桌面内生效，行为与独立 dsh 下完全一致；DSH_HOME 由桌面壳层统一管理。

开发

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，并对状态、列表、预览、取消归档、规则读写与 CSRF 防护逐一探测。

许可

MIT