dsh-session-mesh · 会话网格

让 DeepSeek Harness（dsh）里所有工作区的普通会话互相发现、互相发消息、互相建会话/改标题/归档的 Host 插件。无任务板、无新增会话事件、不依赖 experimental-agent-team 或 subagent。

English: a DeepSeek Harness (dsh) host plugin that turns every root session in every workspace into a peer: list sessions, message any session as a real agent-message, create/rename/archive/cancel sessions, and wait for session changes. No task board, no new session event types.

• License: MIT
• 要求：DSH >=0.2.1-rc.3 <0.3.0（engines.dsh）；desktop / web-app 这类包含标准 Host 服务的 profile
• 零运行时依赖、无构建步骤、纯 ESM
• 7 个 mesh_* 工具 + 两段模型可见提示（policy / identity）
• 分发方式：GitHub tag / Release tarball（不发布到 npm）

---

1. 安装

# 从 GitHub 按 tag 安装
plugin_manager install_bundle  target = github:kx2398/dsh-session-mesh#v0.2.1

# 或下载 Release 里的 tgz 后本地安装
plugin_manager install_bundle  target = file:C:/.../dsh-session-mesh-0.2.1.tgz

2. 它做什么

工具	能力
mesh_list_sessions	列出所有工作区的会话：sessionId、标题、所属工作区（id/title/path）、cwd、running、archived、agent 可用性、是否 subagent、更新时间。支持工作区/运行态/归档/subagent/ID或标题子串过滤 + 游标分页（nextCursor）
mesh_send_message	给任意会话发一条自包含消息，以真实 agent-message/relay 消息投递（source 带 senderSessionId，不伪装成人类消息）。运行中目标 queue（回合后）或 steer（步边界，默认禁用）；空闲目标被唤醒；冷会话自动恢复。有速率限制与重复抑制
mesh_create_session	新建根会话：可指定工作区（id/路径/标题）、标题、初始 prompt、agent preset；不指定工作区时默认为调用方所在工作区
mesh_rename_session	改任意会话标题（pin 住，不被自动标题覆盖）
mesh_archive_session	归档/取消归档任意会话；运行中的会话默认拒绝并说明有哪些工作，stop_activity: true 时先停止再归档
mesh_cancel_session	停止某个会话当前正在跑的回合（保留待处理 inbox），用于止损
mesh_wait_for_change	等待下一次会话状态/活动/新建/移除事件（1s–1h），返回第一个变化；替代轮询

模型可见文本两段：

• session-mesh:policy（system prompt 段，可用 policy: full|short|off 配置）：协作纪律——peer 消息是另一个 agent 的请求、只回复决策/结果、不要回执、不要乒乓、不共享对话历史、不要给自己发消息。
• session-mesh:identity（required runtime context）：You are session "<title>" (<id>) in workspace "<title>" (<path>)。非根会话不注入；生成失败时退化为最小一行，不阻断 prompt 组装。

3. 实现方式

全部状态复用宿主既有服务，不新增会话事件类型、不落自定义文件：

mesh_* 工具
  ├─ 列会话   sessionController.list() + workspaceRegistry.list()（一次建 session→workspace 索引）
  │            + workspaceRegistry.archivedSessionIds + sessionQuery.readTitleSnapshots()（30s 标题缓存，只取当页）
  ├─ 发消息   sessionController.resolveAgent(target)
  │            → agent.followup(relayUserMessage) / agent.steer(relayUserMessage)
  │            （消息 source = {kind:'agent-message', form:'relay', senderSessionId}；
  │              消息对象按 dsh-llm createUserMessage 的同一形态手工构造并深冻结，避免 import 依赖）
  ├─ 新建     sessionController.create({workspaceId|cwd, agentPreset}) → rename → prompt
  ├─ 改名     sessionController.rename({sessionId, title})
  ├─ 归档     workspaceRegistry.archiveSession(id, {stopActivity}) / unarchiveSession(id)
  ├─ 取消     sessionController.cancel({sessionId})
  └─ 等待     ctx.on('api-session/status|activity|added|removed') 一次性 waiter

• 性能：列表先做不需要标题的过滤 → 排序 → 分页 → 只给当页读标题；带 query 时才读候选集标题。工作区映射一次 O(工作区×会话) 建索引，不再每行遍历。
• 安全：默认 allowSteer: false、maxSendsPerMinute: 30、同目标同内容 60s 内重复抑制；可选 allowedPeers/blockedPeers（精确 sessionId）白/黑名单；发送写 ctx.logger.info 审计。
• 可靠：消息投递失败时错误信息带目标与错误码；resolveAgent 失败不会静默。
• 工作区引用解析：精确 id → 精确路径 → 精确标题 → 唯一子串；多命中报歧义并列出候选。

4. 配置（cordis.patch.yml 的 config）

字段	默认	含义
defaultMode	queue	发消息默认投递模式
maxMessageBytes	65536	含 mesh 信封的单条消息 UTF-8 字节上限
allowCreate	true	允许创建会话
allowArchive	true	允许归档/取消归档
allowCancel	true	允许停止他人回合
allowSteer	false	允许 steer 投递（可能打断人类正在跑的回合）
maxSendsPerMinute	30	每个发送方每分钟发送上限
allowArchivedSend	false	允许向已归档会话发消息
identityContext	true	注入身份 runtime context
policy	short	full / short / off，控制 system prompt 段长度
allowedPeers	[]	非空时仅允许给这些 sessionId 发消息
blockedPeers	[]	禁止给这些 sessionId 发消息

改配置：编辑本目录 cordis.patch.yml → Plugin Manager 里 disable → enable，或重启 DSH。

5. 重载与卸载

• 改代码后重载：先运行 npm test（离线 mock 自检），再在 Plugin Manager 里把 session-mesh 关一次再开。模块热替换会触发 Host 重新组合，进行中的回合可能被中断，重要操作不要和重载放在同一回合。
• 卸载：plugin_manager remove_bundle 目标 dsh-session-mesh。

6. 验证

离线自检（无需 DSH）

git clone https://github.com/kx2398/dsh-session-mesh.git
cd dsh-session-mesh
npm test        # node test/mock-apply.mjs，21 项

覆盖：7 个工具注册、policy/identity 注入（含身份文本渲染）、列表过滤/游标分页、agent-message 投递形态、重复抑制、steer 禁用、自消息拒绝、速率限制、归档目标拒绝、创建（含工作区推断/改名 warning）、改名、归档运行中会话的错误格式化、归档/取消归档、取消自拒绝、wait 成功/超时、policy: off。

在线验证

• mesh_list_sessions 跨多个工作区返回全部会话，标题/运行态/归档态正确；游标分页可用。
• mesh_create_session / mesh_rename_session / mesh_archive_session / 取消归档正常。
• mesh_send_message 向空闲空白会话投递 → 目标被唤醒并跑完回合；目标会话日志中该消息的 source 为 {"kind":"agent-message","form":"relay","senderSessionId":...}。

7. 已知限制

1. agent.followup/steer 是 Host 内部 Agent 接口：绕过 sessionController.prompt 的入站准入（文本消息无影响；图片/附件不走此路径）。若未来宿主改变消息形态，需要同步调整 relayUserMessage。
2. 成功 ≠ 已处理：投递只保证进入目标 inbox；需要结果时让对方向你的 sessionId 回消息，或用 mesh_wait_for_change 观察变化后 mesh_list_sessions 复查。
3. 无 Web UI：只有工具面。可选后续：会话网格面板（列表/跳转/发消息/归档），复用 ui-workspace 的导航。
4. 归档会话不可唤醒：宿主 ArchivedSessionGate 会拒绝其 pre-step；必须先 unarchive。
5. 消息不进入发送方日志：发送记录落在目标会话；发送方只能在回复到达时看到 [mesh] 消息。
6. 没有强制文件隔离：不同工作区的会话可能共享同一文件系统路径；写冲突仍需自行协调。

8. 与生态现有插件的关系

调研结论（基于 npm registry / unpkg 对同类插件的逐包核查）：没有现成插件同时覆盖「全工作区列表 + 任意会话发消息 + 互建会话 + 改标题 + 归档/取消归档 + 无任务板」。最接近的是两个互补半成品：dsh-cross-session-agent-pre（列表+发消息）与 dsh-cross-session-approval（建会话/改名/仅归档），以及已 deprecated 的 dsh-team-rooms。本插件刻意只做薄层：直接依赖宿主 sessionController / workspaceRegistry / sessionQuery。

9. 开发

• 入口：index.js（Host 插件，apply 形态）；装配：cordis.patch.yml 以 insert 方式插入一行 id: session-mesh。
• 测试：test/mock-apply.mjs 用假 Host context 启动插件并跑通全部工具与注入文本，npm test 即可。
• 设计原则：状态只放宿主既有域（Session / Workspace），不新增事件类型；prompt 注入失败必须降级而不是中断回合；对模型暴露的每个限制都给出可行动的错误信息。
• 发布/维护流程见 docs/RELEASING.zh.md。

10. 许可证

MIT。