qiushi-dev/dsh-session-nexus

dsh-session-nexus

非官方社区插件，用于 DeepSeek Harness。未经 DeepSeek 审查或背书。
非官方社区插件，未经 DeepSeek 审查或背书。

一次安装，获得完整的会话工具套件——社区会话 RFC 的工作配套实现。

一次安装获得完整的会话工具套件：生命周期控制 + 跨会话消息。

安装 / 安装

dsh plugin --profile web add dsh-session-nexus   # 或 github/tarball 规格

命令 / 命令

| 命令 | 功能 |
|---|---|
| /resume  | 按 id 显式挂载冷会话（不发消息；从日志解析 preset） |
| /unarchive  | best-effort 取消归档（注册表缓存限制见下） |
| /rm-session  --yes | 降级两步删除（默认关闭，lifecycle.allowDelete: true 开启） |
| /send-to   | wakeup 投递：成为目标的下一个 turn；冷会话自动 resume |
| /notify   | quiet 投递：目标下一步的模型上下文，不唤醒 |
| /address [地址] | 输出会话的规范地址（URI + mention）供复制；无参数=当前会话 |

模型工具（mailbox.enableTool: true 默认开启）：session_send_message（向其他会话投递消息）、session_overview（一次调用获取任意会话的标题/时间线/最近消息摘要——让“这个会话干了什么”这类问题一步得到答案，不再需要模型翻磁盘日志）。

地址格式（按推荐顺序）：composer @ 选择器产生的 @标题 mention、dsh-session: URI、session id、"含空格的标题"（直引号或「」）、裸标题（贪心匹配，仅活会话）。

当 mailbox.enableTool: true（默认）时，模型会获得一个 session_send_message 工具——编排会话可以驱动其他会话。

呈现 / 呈现

Wakeup 邮件显示为干净的聊天气泡（只有消息，类似 Codex）；发送者归属和不可信内容提示位于同一 turn 所声明的单独折叠上下文行（mailbox.presentation: 'context' 则将所有内容保留在一个折叠行中）。Quiet 邮件始终是带可见单行摘要的上下文行。

安全 / 安全

- 发送者归属包含实时会话标题：会话「标题」(id)。
- 每次投递都附带不可信内容提示；拒绝自我投递；大小上限（maxMessageChars，16384）。
- 循环断路器：按发送者→目标的滑动窗口（默认 10 条消息 / 300 秒）。

配置

- id: session-nexus
name: dsh-session-nexus
config:
lifecycle:
allowDelete: false
mailbox:
enableTool: true
allowColdWakeup: true
maxMessageChars: 16384
presentation: bubble      # bubble | context
rateLimitCount: 10
rateLimitWindowSeconds: 300

已知限制（需上游支持）/ 已知限制（需上游支持）

- /unarchive 会写入持久状态并推送 UI 帧，但工作区注册表的私有内存缓存无法从外部失效——之后的工作区写入可能会将其回滚，直到重启。干净的修复方案是归档设计说明中预留的上游 unarchiveSession()。
- /rm-session 仅移除 JSONL 会话目录；派生索引/缓存/记账会延迟对账。正确的删除需要在上游持久化接缝上提供 delete 操作。
- 从插件向冷会话进行 quiet 投递是不可能的——持久的 queued → delivered 邮箱事件属于 RFC 所提议的上游接缝。
- 没有会话行的“复制地址”菜单项：侧边栏行菜单没有插件槽位。/address 和编辑器提及选择器是插件层面的替代方案。

这些缺口正是 RFC 的论点：插件在公共接缝上验证了 UX；这些接缝应归属于上游。

许可证

MIT

Web UI 增强（客户端插件）

- 会话头部 ID 芯片：每个会话标题栏右侧显示该会话的 session id，点击即复制（悬停提示说明用途）。
- /address 专属结果卡片：不再是折叠截断的文本行——地址逐条整行展示，点击任意一条直接复制。

RFC 提案（proposed Agent Note 三件套）

本插件是两份社区 RFC 的伴生实现，提案原文见 rfc/（官方 .agents/notes/proposed/feature 格式，中英双语 + i18n sidecar）：会话生命周期控制 · 会话邮箱。讨论串：deepseek-harness#3640。