导航历史 AhaCrazy/dsh-nav-history

dsh-nav-history

DSH（DeepSeek Harness）Web GUI 的全局后退 / 前进插件：像浏览器一样，记住你去过的每一个「页面」——包括会话（含 Agent Teams 的成员会话 / 子智能体会话）和各种插件开启的整页面板（插件市场、任务、自定义插件页……），一键回到上一个位置。

DSH 本身没有 URL 路由，也没有浏览历史：切换会话或整页面板只是替换当前视图，旧位置直接丢弃。本插件维护自己的访问栈来补上这一块。

dsh-nav-history 导航条示意：底部显示前后多个页面记录，右侧为历史位置计数

示例中底栏一次显示 4 个页面记录（可在 1–7 之间配置），右侧 45/45 为当前历史栈位置；点击任意条目可直接跳转。

功能

- 全局后退 / 前进：覆盖两类「页面」：
- 会话：主会话、成员会话（origin: 'subagent' 的子会话）、任意历史会话；
- 整页面板：插件注册到 main + sidebar.panellist 的页面（插件市场、任务页等），以及从面板跳回会话、会话再进面板的任意交错。
- 常驻底栏：挂在 shell.bottom 根座位，跨面板常驻、不随面板切换消失，也不占用会话头部。
- 前后文可见：底栏一次性显示当前页面及其前后的历史位置（默认 3 个，可在 1–7 之间配置），点击任意条目可直接跳转；当前页面高亮。
- 浏览器式快捷键：Alt+← / Alt+→（macOS 为 ⌘[ / ⌘]），已注册进 DSH 的快捷键系统，可在 设置 → 通用 → 快捷键 中查看和改键；另支持鼠标侧键（后退键 3 / 前进键 4）。
- 历史持久化：按浏览器存 localStorage（键 dsh.nav-history.v1，上限 100 条，7 天过期），刷新页面后历史仍在。
- 纯客户端：Host 半为空实现，不注册工具、不写提示词、不碰会话数据；只读取公开的布局 / 会话状态并调用公开的导航 API。

安装

从 GitHub 安装（DSH 桌面版 profile desktop）：

dsh plugin --profile desktop add github:AhaCrazy/dsh-nav-history

本地开发时可以用 link: 方式挂载当前目录：

dsh plugin --profile desktop add ./dsh-nav-history

或手动在 ~/.dsh/profiles/desktop/package.json 中：

1. dependencies 增加 "dsh-nav-history": "link:C:/Users/happyelements/Documents/dsh-plugins/dsh-nav-history"；
2. dsh.profile.bundles 追加 "dsh-nav-history"；
3. 在 profile 目录执行 pnpm install；
4. 重启 DSH 桌面端（Host 需要重新组合插件行），刷新 Web 页面。

使用

页面底部出现一条细导航条：

[←] [→] │ [上一页] [当前页] [下一页] 3/7

- 左键点击箭头、按快捷键、或用鼠标侧键即可后退 / 前进；
- 点击中间的页面条目可直接跳到该历史位置；
- 右侧 3/7 是历史栈位置（进入过的页面总数）；
- 标题为当前会话标题或面板名称；面板页面的标题取侧栏面板注册的 label。

配置

设置 → 插件 → dsh-nav-history → 导航栏：

- 最多显示条目数：1–7（硬限制，越界值会被夹紧）；默认 3。
- 每个页面的最大宽度：64–320 px（滑块，按 8 px 步进；越界值会被夹紧，默认 160 px）。标题超出部分省略显示。
- 设为 1 时只显示当前页面；大于 1 时显示当前页面前后的页面。
- 配置即时生效，并按浏览器保存在 localStorage（键 dsh.nav-history.settings.v1）。

快捷键

- 默认：Windows Alt+← / Alt+→；macOS ⌘[ / ⌘]；
- Web 与 Linux 默认不绑定（ArrowLeft/ArrowRight 在那些平台属于保留键），可在 设置 → 通用 → 快捷键 中手动分配；
- 若要改键：设置 → 通用 → 快捷键 → 查看，搜索「后退 / 前进」。

边界与说明

- 只跟踪主视图的切换：右侧栏、侧边对话、设置弹窗等不进入历史（它们不改变主页面）。
- 返回面板时先恢复面板下的会话再选中面板（顺序由 DSH 公开 API 决定）。
- 面板或会话已被删除 / 归档时，该条历史在恢复失败后自动丢弃。
- 无历史或到栈顶 / 栈底时按钮置灰。
- 未跟踪会话内的 view 页签（对话 / 轨迹）切换，也不跟踪滚动位置。

更新记录

- 0.3.0：代码按职责拆分为 src/ 下的多个 ES 模块（常量、文案、样式、工具、存储、历史控制器、快捷键、视图、装配），新增零依赖的 scripts/build.mjs 把模块拼装为浏览器所需的单文件 client.js；测试拆成 history / apply / build 三组，并加入 GitHub Actions 校验。行为不变。
- 0.2.3：新增「每个页面的最大宽度」配置项（64–320 px 滑块，默认 160 px），控制底栏中每条页面记录的最大显示宽度。
- 0.2.2：快捷键标题统一加前缀 Nav History:（如 Nav History: 后退），便于在「设置 → 通用 → 快捷键」中查找。
- 0.2.1：修复「后退到中间位置后再打开新页面，前进分支（d/e）没有被截断」的问题——恢复动作现在同步定案，若落点与记录条目略有差异只就地重写该条目，绝不会把光标挪到栈尾；因此后退后打开新页面会正确截断旧的前进分支。另加只读诊断句柄 window.__dshNavHistory.dump()。
- 0.2.0：底栏支持显示前后多个历史条目（1–7 可配置、点击跳转）；插件详情页增加「导航栏」配置卡；修复快捷键未出现在「设置 → 通用 → 快捷键」的问题（默认键位不再使用 Web 保留键导致注册失败）。
- 0.1.0：首个版本：全局历史栈、底栏、快捷键、鼠标侧键、持久化。

开发

npm run build # 从 src/ 重新生成 client.js
npm test # 校验 client.js 是最新的 + 运行三组测试

代码结构：

src/
constants.js 版本、键名、上下限 locales.js 中英文案 styles.js 底栏 / 配置卡 CSS utils.js entryKey、位置读取、标题解析、偏好夹紧 storage.js localStorage 读写 history.js 与 UI 无关的历史栈控制器（可单测） shortcuts.js 快捷键注册、鼠标侧键 view.js 底栏与配置卡的 React 组件工厂 apply.js 组装模块并注册进 DSH 上下文 scripts/build.mjs 零依赖打包：拼装为 window.__ModuleLoader__ 形式的 client.js

client.js 是生成产物（不要手改）；DSH 客户端加载器只接受单个普通脚本，所以构建脚本把 src/ 下的 ES 模块按依赖顺序内联进 loader factory，再交给 createClientModule(React)。