itchenshi/dsh-gui-last-session

dsh-gui-last-session

重启 DeepSeek Harness（DSH）之后，自动回到你上一次 待着的那个会话 —— 不用再一层层翻历史。

它做什么

• 页面半边记录你正在看的会话，重启后自动把它重新打开。
• 引擎启动时那个空白会话永远不会被记录（两道防线），所以不会续接一个空对话。
• 续接会等目标在会话列表里出现（每 150ms 轮询、约 30 秒），这样对未知 id 的 open() 不会失败。
• 记住的会话已被删除时安静放弃，把引擎自己的启动行为留在原地。
• 记录时不会写入子代理（subagent）会话。

安装

• 用 DSH Ready GUI（推荐）：插件随 GUI 内置，安装后在设置窗口 →「第三方插件」里勾选/取消即可。 它是带页面半边的插件，装完按提示刷新页面。

• 其它 DSH 宿主（dsh web / CLI）—— 任选一条：

  # 推荐：直接从 GitHub 装
  dsh plugin --profile web add github:itchenshi/dsh-gui-last-session
  
  # 备选：从本仓库 Release 的 tarball 装
  dsh plugin --profile web add https://github.com/itchenshi/dsh-gui-last-session/releases/download/v0.1.9/dsh-gui-last-session-0.1.9.tgz
  

  两条命令装到的都是这个仓库的完整内容（含 cordis.patch.yml），装完不需要额外配置。

本包还不在 npm 上（registry.npmjs.org 查无此包），只能用上面两种方式装。

使用

装好、重启引擎、刷新页面后什么都不用做：页面加载时会尝试回到存下的那个会话，之后你每次切换会话都会 更新指针。

从 DSH Ready GUI 迁移过来时，GUI 会把自己记的指针交给插件（插件已有指针时不覆盖）， 所以原来的「上一个会话」不会丢。

配置

cordis.patch.yml 里 id: gui-last-session 这一行的 config，全部可选：

想在不改包的前提下覆盖某个 profile 的配置，就在该 profile 自己的 cordis.patch.yml 里加一条 id 相同的行（它会整体替换 config，所以每个键都要写全）。

兼容性

• 清单声明 DSH >= 0.1.5-rc.2，并把 0.1.5-rc.2 与 0.2.0-rc.2 标为 compatible。
• Node >= 20。
• 插件本身不做版本号门禁，依赖的是公开服务契约（ctx.sessions）；契约变了引擎会大声报错，而不是 悄悄关掉功能。
• 本仓库的测试不启动引擎；与真实引擎的端到端行为没有在这里自动化。

常见问题

重启后没回到原会话？ 看应用日志：记录成功会打 [gui-last-session] pointer -> session-...，启动时 会打 [gui-last-session] active (pointer: <DSH_HOME>/last-session.json)。恢复路径的诊断也写进同一份 日志（[gui-last-session] reopen: no usable pointer、reopen: FAILED — ...、reopen: giving up ...）， 所以「没有指针 / 目标一直没出现 / 这个引擎没有打开会话的接口」是可以区分开的。

它存了什么、存在哪？ 只有一个 session id 和时间戳，写在 <DSH_HOME>/last-session.json，原子写入 （唯一临时名 + rename），崩溃不会留下半个文件。除此之外不留状态。

为什么记下的不是我刚看的那个会话？ 空白（未使用）会话永不记录；插件取的是引擎主视图正在显示的 那个（retainedBy.mainView），否则是最近提问过的那个。子代理会话会被跳过。

别人能读到这个指针吗？ 宿主只开 GET/POST/PUT /gui-last-session 与一条只写日志的 POST /gui-last-session/report，两者都走引擎自己的信任围栏（Host 白名单 + 浏览器会话 cookie），拿不到 围栏时失败即关闭 —— 不带 cookie 的裸 curl 得到 401。插件没有任何对外网络请求。

开发

node --check lib/index.js
npm test        # manifest-contract.cjs + test.mjs + handoff.cjs

node tests/test.mjs 就是本地行为测试（不联网、不需要引擎），它按引擎的 __ModuleLoader__ 契约加载 页面 bundle；tests/served-bundle-check.cjs 需要跑着的 profile，不在 npm test 里。

许可

MIT