dsh-session-nexus

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-session-nexus

> **Unofficial community plugin** for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). Not reviewed or endorsed by DeepSeek.
> 非官方社区插件，未经 DeepSeek 审查或背书。

One install, the whole session toolkit — working companion to the community [session RFCs](https://github.com/deepseek-ai/deepseek-harness/discussions/3640).

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

## Install / 安装

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

## Commands / 命令

| 命令 | 功能 |
|---|---|
| `/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 @ 选择器产生的 `@[标题](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

```yaml
- 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/](rfc/)（官方 `.agents/notes/proposed/feature` 格式，中英双语 + i18n sidecar）：[会话生命周期控制](rfc/2026-08-20-session-lifecycle-controls.md) · [会话邮箱](rfc/2026-08-20-session-mailbox.md)。讨论串：[deepseek-harness#3640](https://github.com/deepseek-ai/deepseek-harness/discussions/3640)。