dsh-session-nexus

dsh-session-nexus

Unofficial community plugin for DeepSeek Harness. Not reviewed or endorsed by DeepSeek. 非官方社区插件，未经 DeepSeek 审查或背书。

One install, the whole session toolkit — working companion to the community session RFCs.

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

Install / 安装

dsh plugin --profile web add dsh-session-nexus   # or a github/tarball spec

Commands / 命令

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

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

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

With mailbox.enableTool: true (default) models get a session_send_message tool — an orchestrator session can drive other sessions.

Presentation / 呈现

Wakeup mail shows as a clean chat bubble (just the message, Codex-like); sender attribution and the untrusted-content notice ride a separate collapsed context row the same turn claims (mailbox.presentation: 'context' keeps everything in one collapsed row instead). Quiet mail is always a context row with a visible one-line summary.

Safety / 安全

• Sender attribution includes the live session title: 会话「标题」(id).
• Untrusted-content notice on every delivery; self-delivery refused; size cap (maxMessageChars, 16384).
• Loop breaker: per sender→target sliding window (default 10 messages / 300 s).

Config

- 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

Known limitations (upstream territory) / 已知限制（需上游支持）

• /unarchive writes durable state and pushes the UI frame, but the workspace registry's private in-memory cache cannot be invalidated from outside — a later workspace write may roll it back until restart. The clean fix is the upstream unarchiveSession() the archive design note reserved.
• /rm-session removes the JSONL session directory only; derived indexes/caches/accounting reconcile lazily. Correct deletion needs a delete operation on the upstream persistence seam.
• Quiet delivery to a cold session is impossible from a plugin — durable queued → delivered mailbox events belong to the upstream seam the RFC proposes.
• No session-row "copy address" menu item: the sidebar row menu has no plugin slot. /address and the composer mention picker are the plugin-level substitutes.

These gaps are the RFCs' argument: the plugin proves the UX on public seams; the seams belong upstream.

License

MIT

Web UI 增强（客户端插件）

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

RFC 提案（proposed Agent Note 三件套）

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