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）。
- 会话内消息定位：
Alt+↑ / Alt+↓ 激活右侧原生回合导航条（TurnNavigator）里相邻的标记，与用鼠标点击小杠走同一条原生路径——未加载的历史回合会自动按需加载并精确对齐；焦点在输入框内也生效，且不会让输入框失去焦点（该组合键在输入框中不再触发编辑器的段落移动）。
- 历史持久化：按浏览器存 localStorage（键
dsh.nav-history.v1，上限 100 条，7 天过期），刷新页面后历史仍在。
- 纯客户端：Host 半为空实现，不注册工具、不写提示词、不碰会话数据；只读取公开的布局 / 会话状态并调用公开的导航 API。
安装
从 npm 安装（推荐，大陆网络可直接使用镜像）：
dsh plugin --profile desktop add dsh-nav-history
从 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 中：
dependencies 增加 "dsh-nav-history": "link:C:/Users/happyelements/Documents/dsh-plugins/dsh-nav-history"；dsh.profile.bundles 追加 "dsh-nav-history"；- 在 profile 目录执行
pnpm install；
- 重启 DSH 桌面端（Host 需要重新组合插件行），刷新 Web 页面。
使用
页面底部出现一条细导航条：
[←] [→] │ [上一页] [当前页] [下一页] 3/7
- 左键点击箭头、按快捷键、或用鼠标侧键即可后退 / 前进；
- 点击中间的页面条目可直接跳到该历史位置；
- 在会话中按
Alt+↑ / Alt+↓ 可跳到上一条 / 下一条用户消息（等价于点击右侧原生导航条的相邻小杠）；
- 右侧
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 ⌘[ / ⌘]；
- 消息定位：Windows / macOS
Alt+↑ / Alt+↓（macOS 即 Option+↑/↓）；
- Web 与 Linux 默认不绑定（方向键在那些平台属于保留键），可在 设置 → 通用 → 快捷键 中手动分配；
- 焦点在输入框时同样生效，且不会使输入框失去焦点；代价是该组合键在输入框中不再执行编辑器的段落移动（如仍想保留段落移动，可在设置中把消息定位改到别的键）。
- 若要改键：设置 → 通用 → 快捷键 → 查看，搜索「后退 / 前进 / 上一条用户消息」。
边界与说明
- 只跟踪主视图的切换：右侧栏、侧边对话、设置弹窗等不进入历史（它们不改变主页面）。
- 返回面板时先恢复面板下的会话再选中面板（顺序由 DSH 公开 API 决定）。
- 面板或会话已被删除 / 归档时，该条历史在恢复失败后自动丢弃。
- 无历史或到栈顶 / 栈底时按钮置灰。
- 未跟踪会话内的 view 页签（对话 / 轨迹）切换，也不跟踪滚动位置。
更新记录
- 0.4.2：修复两处问题。一是导航条在切换到有固定侧栏的界面后（例如 Bot 模式的左侧列表、右侧面板）会被侧栏压住一部分，现在导航条会实时测量主内容区的位置并自动让开，侧栏出现、收起、切换模式或拖动宽度时都保持对齐，量不到位置或窗口过窄时保持原样。二是侧边栏打开、原生消息定位栏被隐藏时，
Alt+↑ 走到对话最顶部会卡住，现在能正常触发「加载更早」。
- 0.4.1：消息定位改为复用右侧原生 TurnNavigator——快捷键激活相邻的 mark，与鼠标点击小杠同一条原生路径（未加载回合会按需加载、精确对齐、更新阅读位置），不再用
scrollTop 近似，并移除自定义高亮；同时支持焦点位于输入框时触发，且不改变焦点（该组合键在输入框中不再执行编辑器的段落移动）。
- 0.4.0：新增「上一条 / 下一条用户消息」定位（
Alt+↑ / Alt+↓）：直接滚动到对话中相邻的 user turn 并短暂高亮，输入框内让位给编辑器；测试新增 conversation 组。
- 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 无关的历史栈控制器（可单测）
conversation.js 会话内「上一条 / 下一条用户消息」定位（激活原生 TurnNavigator 相邻 mark）
shortcuts.js 快捷键注册、鼠标侧键
view.js 底栏与配置卡的 React 组件工厂
apply.js 组装模块并注册进 DSH 上下文
scripts/build.mjs 零依赖打包：拼装为 window.__ModuleLoader__ 形式的 client.js
client.js 是生成产物（不要手改）；DSH 客户端加载器只接受单个普通脚本，所以构建脚本把 src/ 下的 ES 模块按依赖顺序内联进 loader factory，再交给 createClientModule(React)。
