tmux 会话面板joao-paulo-santos/dsh-wo-tmux

dsh-wo-tmux

一个 DeepSeek Harness (DSH)
插件：将你的 tmux 工作流接入 Workspace Overview 标签页。该
插件能识别当前工作区的 tmux 会话是处于活动状态、被 tmux-fridge 冻结，
还是静置于冷存储中，一键即可打开一个附加到该会话的新终端：
需要时先解冻或恢复。

对于按项目使用命名 tmux 会话、并在思考中途挂起工作的人来说，
这填补了浏览器 harness 与控制台之间的空白：不再需要 tmux ls，
不再需要记住哪些项目被冻结了。

你将获得

- 会话标题栏中的胶囊标签：显示工作区的 tmux 会话及其
状态；点击会打开一个附加到它的终端（根据状态执行附加、解冻
或恢复）。对于没有会话的工作区隐藏，或
通过 Granular Settings 中的开关隐藏。
- Workspace Overview 中的 Tmux 子标签页，分为两个窗格：
- Session（默认）：
- 状态卡片：会话名称、状态标签、解析方式
（显式链接或名称约定）、已附加的客户端和窗口；
- 按状态区分的操作：打开控制台、快照到冷存储、冻结
（需确认；冻结会终止活动会话）、恢复、
清理快照（同样需确认）；
- 链接：将工作区固定到任意会话名称（按活动、冻结、
冷存储分组）、取消链接，或创建新会话（预填
工作区基名，自动链接，在终端中打开）。
- All sessions：本机已知的所有会话，按
存储分组：活动会话（打开控制台、冻结、快照）、冻结
会话（解冻）和冷存储快照（恢复、清理）。
从此窗格冻结任意活动会话，即可在不离开
harness 的情况下停放项目。
- 该标签页在打开时轮询：执行操作后（解冻会移交给
终端并在 tmux 稳定前返回），状态标签会自行
跟上，无需切换页面。
- 工作区到会话的链接在
~/.dsh/settings/wo-tmux.json 中重启后依然保留，因此冲突的基名（两个项目
都叫 api）仍能保持明确无歧义。

如何将工作区解析到会话

首个匹配者胜出：

1. 来自链接存储的显式链接；
2. 与工作区基名同名的 tmux 会话，依次在
活动服务器、冻结列表、冷存储中查找；
3. 无匹配（标签页会邀请你创建或链接）。

如何与 tmux 通信

宿主端仅使用参数数组调用 tmux 和 tmux-fridge CLI
（不做 shell 插值）。Open 会直接运行 fridge 命令：
tmux-fridge 会自行检测并启动用于附加的终端然后退出，
因此包装它只会闪现一个在交接发生瞬间就消失的窗口。只有 create 需要我们提供终端（普通的
tmux new-session 无法启动终端）：$TERMINAL 选择模拟器；
没有它时，插件会探测 kitty、alacritty、wezterm、gnome-terminal、
x-terminal-emulator、xterm，并且在找不到任何终端时分离会话。TMUX_FRIDGE_BIN 环境变量会覆盖 fridge 二进制文件的位置。存储格式从不直接读取：CLI 就是契约，因此 tmux-fridge 可以自由更改其布局。

如何安装

需要一个 DeepSeek Harness 检出和一个 profile，这里为 web。tmux
和 tmux-fridge 必须在 PATH 上。将依赖项和此插件克隆到一个 plugins 文件夹中：

mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-workspace-overview.git
git clone https://github.com/joao-paulo-santos/dsh-wo-tmux.git

from the harness checkout
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-workspace-overview
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-wo-tmux

verify the profile still composes
pnpm dsh --profile web --dump-config

重启 harness；Tmux 标签页会出现在 Workspace Overview 中，并且对于工作区拥有会话的会话，会出现胶囊标记。

依赖项

- dsh-workspace-overview 承载子标签页和胶囊标记（必需；没有它，客户端部分将保持不活跃）
- PATH 上的 tmux 二进制文件（会话列出和创建）
- PATH 上的 tmux-fridge 二进制文件（冻结/冷存储以及附加操作）；没有它，标签页仍会显示实时状态以及一条清晰的“不在 PATH 上”提示
- 一个终端模拟器：$TERMINAL 或探测到的其中之一；如果没有任何终端，打开和创建会尽可能回退到分离会话

依赖此插件的插件

（无）

限制

- 该插件从不在浏览器中嵌入终端；它会启动一个真实的
终端窗口。这正是其意义所在。
- 每次点击一个终端窗口。对同一会话附加两次是
正常的 tmux 行为，由你自己决定。
- 名称检测覆盖每个工作区一个会话；多对多设置
（一个项目多个会话）不在范围内，不过链接会
选择你关心的那一个。