Session Bridge · 会话桥接
中文 | English · 桌面端与安装包 · 全部插件
为 DeepSeek Harness 显示与复制完整会话 ID，提供跨会话查询、读取和投递，以及临时工作区。
- 包名：
@missher/dsh-session-bridge；版本：0.1.3（发行候选，尚未发布或安装）。
- 会话顶部单行显示完整会话 ID：窄窗口在 ID 区域内横向滚动，方向键与 Home/End 可用，点击即复制完整 ID；详情浮层由插件注入
shell.overlay，长路径正常换行。
- 左侧三点菜单同样可复制完整 ID、工作目录或
/bridge 引用；归档记录带二次确认的删除入口。
- 独立、可卸载的 Cordis Bundle；不需要另装兼容插件。不是 DeepSeek 官方产品。
- 许可证 · 上游署名 · 兼容记录
安装固定版本
0.1.3 是已冻结源码的发行候选：尚未发布、尚未安装，远端也还没有可用的 v0.1.3 资产地址。等维护者发布后，从 Releases 页面 下载 missher-dsh-session-bridge-0.1.3.tgz 与 SHA256SUMS，并以页面上的实际标签为准。不要将 GitHub 的自动源码压缩包当作插件 tarball。
下载后可在包含两个文件的目录校验：macOS 用 shasum -a 256 -c SHA256SUMS，Linux 用 sha256sum -c SHA256SUMS。运行包已包含 lib，无需本地构建，也没有安装脚本。
**Desktop：**打开“插件 → 添加插件”，选择本地 .tgz 或填写下面固定地址。确认版本及组件 session-bridge 已启用；按 Host 提示重新加载，必要时完全退出后重开。Desktop 的 desktop profile 由应用管理，使用应用内安装入口。
发布地址以 Release 页面上的标签为准，格式为
https://github.com/Missher12/Missher-DSH-Session-Bridge/releases/download/<tag>/missher-dsh-session-bridge-0.1.3.tgz。
在资产出现之前，请先用本地 tarball 的绝对路径安装。
**已有 DSH CLI 的 Web 用户：**在自己的 Web profile 安装；以下命令不修改 Desktop profile。
dsh plugin --profile web add /absolute/path/to/missher-dsh-session-bridge-0.1.3.tgz
发布后把本地路径换成上面的固定地址即可。首次测试使用独立 DSH_HOME / DSH_AGENTS_HOME。不要同时启用旧 dsh-session-bridge、开发别名 session-bridge-dev 和当前 scoped 包；它们会重复注册 session_list 等工具。升级前保留旧包与配置，等当前任务结束再重新加载。
使用
会话 ID 与菜单
会话顶部会显示当前会话的完整 ID，始终单行、不省略、不删 session- 前缀。窗口变窄时，ID 文字在自己的区域内横向滚动：拖触控板或按住 Home/End 也能用键盘跳到首尾，而复制图标和下拉按钮不会跟着滚走。点击 ID 即复制完整 ID，详情浮层给出完整 ID、工作目录和 /bridge <session-id> 引用；浮层挂在插件的 shell.overlay 单元格上，因此不会被标题栏裁切，长工作目录正常换行，按 Escape 关闭并把焦点交回控制按钮。放大窗口后控件会恢复自然宽度。
宽窗口下的顶部控件（Missher 社区发行版 DSH 0.2.1-alpha.2，合成会话与隔离目录；真实 IAB 浏览器点击，非原生 Electron）：
宽窗口下的顶部会话 ID 控件，单行显示完整 ID
窗口收窄到 600px、侧栏展开时，ID 在自身区域内横向滚动，复制图标与下拉按钮始终留在原处：
600px 窄窗口下 ID 区域横向滚动，按钮仍可达
左侧会话的三点菜单同样可复制完整 ID、工作目录或 /bridge <session-id> 引用，包括归档行。操作读取被点击的会话，不切换当前会话；目录未加载或复制失败会给出提示。归档记录另外提供带二次确认的“删除会话…”入口。
「不在工作区」与 scratch
新会话选择器末尾提供“✨ 不在工作区（临时目录）…”。选择后复用配置根目录下的 dsh-scratch 工作区，默认标题为“不在工作区”；macOS 的默认规范路径是 /private/tmp/dsh-scratch。它仍是正式注册的工作区，只是名字叫“不在工作区”，并不是真正无工作区的会话——宿主的 blank 会话输入流程需要工作区。
只打开选择器不会创建目录或会话。重复选择复用规范路径及真实工作区 ID，保留用户重命名；不合并其他同名项目。固定路径若是符号链接、非当前用户所有，或可被组/其他用户写入，创建请求会失败。
选择器末尾的“不在工作区”入口：
新会话选择器末尾的“不在工作区（临时目录）”入口
模型工具 session_scratch 和 /scratch 则为每次调用建立独立的一次性目录；这与界面复用 dsh-scratch 的行为不同。临时目录可能被操作系统清理，不适合作为重要文件的唯一保存位置。
工具与命令
| 模型工具 | 作用 |
|---|
session_list | 列出会话 ID、标题、目录和运行状态；默认排除子代理会话。 |
session_read | 读取目标最近的用户/助手文本，不含思维链和工具结果；只读，不唤醒目标。 |
session_send | 向目标投递真实 user-role 消息；steer 在步骤边界送达、空闲时开始回合，turn 排队为独立回合。 |
session_scratch | session 模式在独立临时目录创建会话；directory 模式不创建会话，但默认仍注册工作区，可用 registerScratchWorkspace: false 关闭。 |
目标接受精确 ID、忽略大小写的精确标题或唯一 ID 前缀；歧义会拒绝，不猜测。
| 人类命令 | 作用 |
|---|
/sessions [过滤词] | 列出会话 ID 与标题。 |
/bridge <ID或标题> <消息> | 给指定会话投递消息；含空格标题按可唯一解析的最长前缀识别。 |
/scratch [标签] | 新建临时目录会话。 |
/scratch-clean | 预览可清理的一次性临时项目。 |
/scratch-clean yes | 真正注销符合条件的项目并删除其目录。 |
清理按规范化 scratchRoot 范围、目录名以 dsh- 开头、没有非空白会话筛选已注册工作区，始终排除固定 dsh-scratch。它不检查插件创建标记，也不使用当前 scratchPrefix：其他符合条件的 dsh-* 工作区也可能入选，自定义非 dsh- 前缀则不会入选。目录内自行保存的文件也会删除；先看预览，保留所需文件。
Host 与平台边界
没有宿主版本号硬限制：判定按能力，不按版本号。开发 SDK 的 rc.2 pin 只是开发链接，不是兼容范围门禁。
2026-10-14 在 Linux x64 / Node 22.22.1 上实测两套 Missher 社区发行版（都是为该桌面产品改过的构建，不是未经改动的官方版）：
| DSH 0.2.0-rc.2 / Cordis 4.0.4 | DSH 0.2.1-alpha.2 / Cordis 4.0.5-alpha.1（desktop 0.2.1-alpha.2.20261014.1） |
|---|
| 真实 Cordis Loader、客户端 boot graph、HTTP | 通过 | 通过 |
| Bridge 激活数 / 失败启用组件 | 1 / 0 | 1 / 0 |
| 实际 UI：1280 与 600px（侧栏展开） | 通过 | 通过 |
| 单行完整 ID、完整复制、Home/End、详情浮层与 Escape、放大后恢复自然宽度 | 通过 | 通过 |
| console error / 模型请求 / 外部 fetch | 0 / 0 / 0 | 0 / 0 / 0 |
| 能力 | 缺少对应扩展时 | 带对应公共扩展时 |
|---|
| ID 显示与复制、跨会话工具、scratch、选择器末尾入口 | 插件提供 | 插件提供 |
| 将“不在工作区”组排在侧栏其他工作区之后 | 保留普通排序 | 使用 uiWorkspace.registerTrailingWorkspace；不改持久排序 |
| 永久删除归档聊天记录 | 隐藏该入口；请求返回 POST 501，且不读取私有存储 | 归档行“删除会话…”二次确认；仅删聊天记录，工作区文件保留 |
| 工作区标题栏的专用归档图标 | 属于 Host，不由本插件包提供 | 同左 |
归档记录的二次确认（Missher 社区发行版 DSH 0.2.0-rc.2，仅合成记录）：
归档会话的删除二次确认，说明工作区文件保留
以上四张截图均来自真实 IAB 浏览器点击，使用合成会话与隔离目录，不是原生 Electron。前三张（宽窗、600px 窄窗、scratch 入口）取自最终候选的运行字节，截图时诊断 manifest 为 0.1.3-local.7，最终客户端 bundle SHA256 为 04aee89f50915de92811b209bfe15f56b8568b231a7ac2f1da860dfd2fdfdcda。归档确认图取自较早的诊断构建，只有归档删除相关的四个源文件哈希至今未变，因此沿用它证明确认／取消／删除、工作区文件保留与重启后删除持久；该图不代表整个 bundle 与最终候选相同，无需重拍。配图只证明这两套 Missher 社区发行版上的实际表现，不证明其他版本或平台。
删除能力依赖可选的 sessionController.deleteArchivedSession：缺失时插件不补私有删除路径，也不读取 Host 私有日志。运行中、被其他写入者占用或存在派生子会话时的保护由 Host 执行。
验证层次见 COMPATIBILITY.json。本版在 Linux 隔离构建，59 条离线测试全通过（0 失败 0 跳过，worker 1）；其中 12 条 chip/浮层测试是 React + JSDOM 的受控几何行为检查，不等于像素或浏览器布局证据。check-host-contracts 通过的是共享 Host source SDK 声明，安装包内没有 .d.ts。样式所有权与 peer reload/self reload/unload 在真实安装的 alpha.2 模块系统 + Cordis Loader 上通过；历史上“无主 style 被 claim”的负对照在新版不再复现（owner 为 null），旧故障复现说法不适用于本版。归档删除的确认/取消/删除为 rc.2 真实点击、仅合成记录，工作区文件与其他会话保留、重启后删除仍持久。原生 Electron 点击、真实模型调用、其他官方版本与其他平台未验收。
配置
所有字段可选。Bundle 已声明正式实例，不要再插入第二个插件行。需要覆盖时，在目标 profile patch 中按既有 ID 更新配置：
- id: session-bridge
config:
scratchRoot: /tmp
scratchPrefix: dsh-session-
| 字段 | 默认值 | 含义 |
|---|
scratchRoot | POSIX /tmp；Windows 系统临时目录 | 临时目录的父目录。 |
scratchPrefix | dsh-session- | 一次性目录前缀。 |
registerScratchWorkspace | true | 将工具创建的临时目录注册为工作区，包含 session 与 directory 模式。 |
maxListedSessions | 40 | 单次列举上限。 |
maxTranscriptTurns | 20 | 最近转写回合上限。 |
maxMessageChars | 8000 | 单条跨会话消息字符上限。 |
wakeColdSessions | true | 允许唤醒冷会话投递；使用 Host 会话创建/恢复流程。 |
announceSessionId | true | 系统提示中声明自身 ID 和跨会话工具。 |
停用、卸载与数据
在 Desktop 或 Web 的插件管理里关闭该 Bundle，按提示重新加载；重新打开开关即可启用。停用移除本插件的工具、命令、样式与界面入口，侧栏排序恢复 Host 默认行为。
卸载使用同一插件管理入口。Web CLI 用户也可以：
dsh plugin --profile web remove @missher/dsh-session-bridge
停用/卸载不会删除现有聊天记录、已投递消息、工作区或临时目录里的文件，也不会撤销已经开始的目标会话任务。Host 中独立保存的配置覆盖项可在确认不再需要后手动移除。回退时通过同一安装入口装回保留的旧 tarball；无需替换整个会话库。
隐私与权限
本插件没有独立遥测或外部上传服务；界面请求使用 Host 自身受鉴权的 HTTP 接口。它能通过 Host 读取会话目录和用户/助手文本，并向其他会话发送真实消息。目标模型处理收到的内容时，仍遵循目标会话的供应商、权限与费用设置。只向有权接收内容的会话投递，先确认目标。
跨会话信封标注来源及“同伴请求”，但没有额外人工审批队列或权限隔离层。它不提供聊天备份、账户间同步或跨 Host 通信。反馈问题时提供版本、步骤及脱敏错误，不提交会话库、API Key 或 Cookie。
独立源码开发
本仓库是唯一维护入口。使用 Node >=22.19 和 packageManager 指定的 pnpm 11.1.3，并准备已构建的 rc.2 Harness SDK：
node scripts/link-harness.mjs /absolute/path/to/built-harness
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm run build
node --test --test-concurrency=1 "tests/*.test.mjs"
pnpm pack --pack-destination ./dist
node scripts/check-package-boundary.mjs ./dist/missher-dsh-session-bridge-0.1.3.tgz
SDK 链接只用于开发，不提交或进入 tarball。安装包包含预构建运行文件、对应源码、许可证及用户说明；开发脚本和历史本机回执留在 Git 仓库。Node 半边仅使用结构化 ctx 服务，不运行时导入任何 @deepseek-ai/dsh-*。客户端保留三个 Host 静态请求：react、react/jsx-runtime、@deepseek-ai/dsh-client-ui-primitives；没有新增运行时依赖。
build 包含严格客户端类型检查和客户端模块加载自检；watch 仅转译，不能代替验收。源码 checkout 不等于已安装 app.asar，修改代码后必须核对目标应用实际加载的包；桌面禁用 HMR 或元数据缓存可能要求重启。
