whybebabo/dsh-recent-sessions

dsh-recent-sessions（最近会话）

把你在所有工作目录里用过的会话，拉平成一块跨目录的列表——外加一个"先记下来，回头它会自己回来找你"的地方。

这是 DSH（DeepSeek Harness） 的客户端插件。本仓库是 huangxp12/dsh-recent-sessions 的 fork（whybebabo/dsh-recent-sessions）：界面按 DSH 原生样式重做，并移除了右下角悬浮胶囊和「在独立窗口打开」。两者注册同一个 recent-sessions 面板 id（main slot key 与 sidebar.panellist 的 id 都是它），不要与原版同时安装。English: README.en.md

为什么做它

DSH 的侧栏按工作目录分组会话：每个目录只显示最近几条、只列你注册过的目录。可当你同时在十几个文件夹里干活时，一阵子没碰的项目就是不在屏幕上；而一个"住在你没想到的那个目录里"的会话，等于丢了。

还有第二个更安静的问题：二十分钟后你才冒出来的那个想法，没有地方可去——要么记住，要么忘掉。

这个插件加了一块不跟会话走的全局面板：一张跨所有工作目录的扁平会话列表；以及一个不用唤醒任何东西就能接住"迟到的想法"的地方。

有什么

• 跨目录一张表：所有会话、最近的在最上面，包括侧栏此刻正藏着的那些（被折叠的工作区、没注册过的目录）。每行右侧是它的目录 chip——点一下就只看这个目录，工具条上出现筛选胶囊，再点取消。
• 「最后一句我在问什么」：每行第二行显示该会话最后一条人类提问（读宿主 turnOutline 会话投影）；鼠标悬停还能看到最后一条助手回复的预览。
• 时间分组 + 两种排序：今天 / 昨天 / 近 7 天 / 更早；可按最近活动或最久没动排序（后者是给清理用的，时间桶会一起倒过来）。置顶的会话单独成组，永远排在时间桶之前。
• 过滤：仅未收尾 / 含空会话 / 含子会话；已归档默认隐藏。视图状态记在本机，刷新后保持。
• 找得回来：搜索框会查宿主的消息内容索引（全文），同时本地按标题/路径即时过滤；内容命中与下方列表共用当前目录/会话过滤条件。行级动作有打开会话、在文件管理器中显示目录、复制路径。
• 迟到的想法：在任意一行写一句话，只存本机、什么都不发送。下次你打开那个会话时，输入框上方会出现一行小条：展开可以把这句话填进草稿（官方插入 API，可撤销）、可以「先不打扰」（想法留着，只是不再烦你）、也可以丢弃。
• 原生外观：侧栏图标、标题层级、输入框、分段控件、状态点和行内动作都沿用 DSH 自己的设计令牌与线条图标，和原生会话界面放在一起不突兀。状态位的显示规则也和侧栏逐条一致：空闲不画点（只留空位）、运行中是转圈、待审批/待回答是琥珀点并把行尾时间换成短词、未读完成是绿点（宿主那份没置位时由插件自己判定，见下条）。
• 跑完未看：会话在你没盯着它的时候跑完，行首亮一个绿点（和侧栏同一个样式），打开它就消失。宿主自带的未读标记只对「没被主视图保留」的会话置位，刚切走的那种经常不亮，所以这一条由插件自己订阅运行状态判定——面板比侧栏更靠得住，但侧栏缺的那颗绿点插件补不了。
• 刻意不吵：没有通知、没有红色告警、不自动归档，"很久没动"只用分组位置表达。

安装

从 npm 安装：

dsh plugin --profile <你的 profile> add @whybebabo/dsh-recent-sessions

本地开发时也可以直接指向仓库目录：

dsh plugin --profile <你的 profile> add /path/to/dsh_recent_locate

实现方式

全部走有文档的扩展点，没有 DOM hack、没有猴子补丁：

东西 · 座位 / 接口 全局面板 · main keyed slot，key = recent-sessions 侧栏入口 · sidebar.panellist（id 必须等于面板 key） 待问小条 · conversation.input.dock（session 作用域） 填入草稿 · InputActions.captureInsertion() + insertText(text, span) 会话列表 · root hooks useSessions / useSessionStatus / useWorkspaces 跑完未看 · ctx.uiSession.sessionStatus 订阅（running 的 true→false + uiSession.current 判定你是不是正在看它） 提问预览 · ctx.sessions.refreshProjections(id) → turnOutline 投影 内容检索 · ctx.sessions.search(query, signal)（命中结果套用当前视图过滤） 显示目录 · ctx.remote.session.canOpenWorkspacePath() / openWorkspacePath({ path, action: "reveal" })

隐私与体积

• 宿主半什么都不做（空 apply）：不注册工具、不注册路由、不追加任何会话事件——对会话数据零写入。
• 想法与视图状态只存在你浏览器的 localStorage（键 dsh-recent-sessions:store:v1）。
• 唯一的写入路径是你自己触发的：把想法填进草稿，以及你随后选择发送的那条消息。
• 没有构建步骤：lib/client.js 是手写的、平台自己的模块格式（window.__ModuleLoader__.load({ id, factory })）。发布包里只有两个小 JS 文件，安装时不执行任何构建。

兼容性

• DSH >= 0.2.0-rc.2（写在 engines.dsh 里）。
• **刻意不声明 @deepseek-ai/dsh-* peer 依赖**：peer 范围不匹配会直接阻止插件激活，所以这里只保留"建议"而非硬门槛。
• 宿主半要求 Node ^22.19.0 || >=24.0.0。
• 面板依赖 useSessions / useSessionStatus / useWorkspaces 三个 root hooks；缺任意一个时会显示一条明确的错误提示，而不是半残渲染。

已知限制

• 提问预览默认只为前 30 行拉取；开启「仅未收尾」时，会额外为需要判定状态的会话补拉投影（并发受限，读持久缓存）。某个会话的投影拉取失败后会进入 5 分钟冷却，冷却结束由下一次渲染重新尝试。
• 界面文案内置中英两套，欢迎补充其它语言。
• 「在文件管理器中显示」依赖宿主报告有桌面能力；没有时按钮不出现，并退化为复制路径。

开发

客户端半由平台模块加载器发现并加载：

window.__ModuleLoader__.load({
  id: "@whybebabo/dsh-recent-sessions",
  factory: (require) => {
    const React = require("react"); // ← 外壳的 PLATFORM_MODULES 基座
    // ...
    return module.exports;          // ← 需要 apply / inject
  },
});

id 必须等于 package.json 的 name：loader 按包名认领 client bundle，写成短名会报 "loaded without registering"，整个 Web 启动失败。

改 `lib/client.js` 后，运行中的浏览器约 1 秒内自动热替换（客户端 HMR 轮询 bundle revision）；改 `lib/index.js` 或改包版本需要重启应用。

运行单元测试（Node 内置 test runner，无额外依赖）：

npm test

## 许可

MIT