@missher/dsh-session-bridge

使用

会话 ID 与菜单

会话标题栏完整显示包含 session- 前缀的 ID，保持一行、原字号、不省略；单击复制完整值。右侧展开按钮提供 ID、工作目录及 /bridge 引用的复制入口。侧栏会话的三点菜单也提供这三项，包括归档行；读取被点击会话，不切换当前会话。目录未加载或复制失败会给出提示。

当会话栏窄于完整 ID 和固定按钮的总宽时，存在布局空间限制；本功能不通过缩写 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	给指定会话投递消息；含空格标题按可唯一解析的最长前缀识别。
/scratch [标签]	新建临时目录会话。
/scratch-clean	预览可清理的一次性临时项目。
/scratch-clean yes	真正注销符合条件的项目并删除其目录。

清理按规范化 scratchRoot 范围、目录名以 dsh- 开头、没有非空白会话筛选已注册工作区，始终排除固定 dsh-scratch。它不检查插件创建标记，也不使用当前 scratchPrefix：其他符合条件的 dsh-* 工作区也可能入选，自定义非 dsh- 前缀则不会入选。目录内自行保存的文件也会删除；先看预览，保留所需文件。

配置

所有字段可选。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 和跨会话工具。