dsh-session-telecom

DeepSeek Harness 会话通信插件。复制会话 ID、只读已有会话内容、向在线或已保存的会话发送消息，并查看 token 用量、计费 token 和缓存命中率。

本包从原本地会话通信插件独立改名，包名、客户端模块、菜单项、RPC 通道和模型工具均使用新名称。它与 npm 上的 dsh-session-toolkit 是不同项目，不依赖或升级该包。

安装

通过 DSH 插件管理安装 npm 包 dsh-session-telecom。桌面端在插件管理页面使用包名；CLI/Web 用户可运行：

dsh plugin --profile web add [email protected]

也可安装 GitHub Release 中经过相同验证的 .tgz：

dsh plugin --profile web add https://github.com/ltmroberthk915/dsh-session-telecom/releases/download/v1.1.0/dsh-session-telecom-1.1.0.tgz

安装后重启宿主。桌面与 Web 的 profile 独立，需要分别安装。

如果所在网络无法访问 GitHub Release 附件，可使用相同版本标签的源码归档；该标签已包含构建后的客户端：

dsh plugin --profile web add https://codeload.github.com/ltmroberthk915/dsh-session-telecom/tar.gz/refs/tags/v1.1.0

上述安装方式都不依赖开发者电脑上的源码目录。

迁移时先备份 DSH 配置和会话。移除旧插件的依赖和 bundle 项，再安装新包；旧的配置文件可以保留在备份中。不要直接覆盖、清空用户目录或会话数据。

如果之前安装 [email protected] 后出现 Cannot read properties of undefined (reading 'prepare')，仅禁用它不一定恢复：已被安装的第二份 @deepseek-ai/dsh-tools 仍可能遮蔽宿主内核。应通过包管理器重建正确的依赖树，确认 profile 不再有这份多余的核心包，然后重启。

使用

会话菜单中可复制会话 ID；会话发送面板支持选择目标、查看用量并发送消息。

模型工具名为 session_telecom：

1.1.0 增加 read/peek 和 expectReply。接管默认先取已有内容，再按需提问；普通通知无需请求回信。

{"action":"list","limit":20}

接管工作时先读取源会话，自己整理待办；只有已有内容不足时才请求对方澄清：

{"action":"read","sessionId":"源会话完整 ID","last":5,"mode":"summary"}

peek 是 read 的别名。summary 返回最后一条助手消息的文本和最近用户指令摘要；tail 返回最近事件摘要；raw 返回完整 JSONL 尾部行。默认 last=5，范围 1..50，正文默认最多 32KB（宿主配置 maxReadBytes 可调整，最低 256 字节）。超长输出标记 truncated；raw 只保留放得下的完整尾部行，若最后一行本身超限，正文为空并标记截断。正在运行的会话可能尚未写完回答，可结合 lastSeq 和活动时间判断。

读取复用宿主 sessionQuery 或 sessionPersistence 的只读接口，由宿主处理存储定位、格式校验和多帧 zstd 解压；不唤醒会话、不调用模型、不接管写锁。不支持读取的宿主返回 session/read-unavailable，不会自行扫描磁盘、猜根目录或手工解压。session/not-found 仍按下述停止查找规则处理。

list 补充 cwd 和可见活动时间，支持按标题、ID、工作区路径过滤。在线会话补充最后用户/助手消息时间和助手回答前 100 字；冷会话未读内容保持未知（时间为 0，摘要为空），需要时对明确的 ID 调用 read。列表不会为了摘要批量解压冷档案。

{"action":"send","targetSessionId":"目标会话 ID","text":"请继续这项工作","mode":"queue"}

明确需要答复时设置 expectReply：

{"action":"send","targetSessionId":"目标会话 ID","text":"还有哪些验收工作未完成？","expectReply":true}

宿主验证发送方身份后附上可直接复制的 send targetSessionId=... 回信指引；无法确认发送方时拒绝这次需回信的请求。发送结果保留已有的 messageId、requestId（宿主提供时）和 persisted。成功表示通道已接受，不能据此判断已消费或已答复；对方的最终回答不会自动转发。收到明确问题时按授权范围回投实质答案，纯“确认收到”无需回投。请求方在下一次需要结果时 read 目标会话取回答，避免忙轮询和重复唤醒。

queue 排到目标下一回合；steer 插到目标下一步。已保存的离线会话由宿主恢复。发送会唤醒目标并可能产生模型费用，应只在用户授权的通信范围内使用。投递失败返回结构化错误，不自动重复发送。

本插件只访问当前 DSH 宿主可见的 DSH 会话，不提供 zcode 等外部平台会话的查找、读取或接管。带 query 的查询没有匹配，或读取/投递返回 session/not-found 时，工具描述和返回文本要求模型停止这次查找并向用户报告：不得重复查询、改词扩大搜索、扫描日志或磁盘，也不得自行启动、委派或询问 agent 继续寻找。用户补充或更正 ID、提供外部会话内容或另行完成导入后，可以继续处理该目标；当前对话仍可继续。这是插件文本中的使用规则，不会强制中止会话或封锁工具。

用量显示来自宿主已有投影，不将估算 token 当成货币价格。缺少数据时明确显示未知。

依赖与生命周期

• 无运行时 dependencies、optionalDependencies 或捆绑依赖；不会安装第二份 DSH 内核或 React。
• 宿主库只声明为 optional peer，使用 DSH 自身的模块解析。包安装不执行脚本、不改宿主代码。
• 工具服务就绪后才加载宿主的工具定义接口。接口缺失或注册失败只停用模型工具并记录原因；RPC 与界面保持独立。
• 卸载会取消尚未完成的工具加载，并注销已注册的工具和路由。
• 不注入“每轮必须检查收件箱”的全局要求，普通对话无需调用本插件。

上述设计防止本包再次引入同类依赖冲突；其他插件或未来宿主的不兼容改动仍需单独验证。

开发与验证

npm ci
npm run build:client
npm test
npm run check:package
npm pack

构建只使用锁定的开发依赖 esbuild，没有个人目录或本地源码路径依赖。客户端从宿主获得 React。发布检查会拒绝新增的自动安装依赖、非 optional 的 peer、旧包名和内联 React。

test 覆盖通信、只读交接、UTF-8 输出限额、回信指引、参数与输出契约、菜单、用量展示及加载/卸载竞态。找不到真实内核的可选对照测试会明确跳过，不能据此宣称宿主集成通过。复杂的消息状态机、自动转发、磁盘索引和宿主 CLI/环境变量改动留待确有需求时另做，本轮保持无新增依赖和后台任务。

完整宿主测试使用 scripts/host-smoke.cjs。先在隔离目录安装发布 .tgz，profile bundles 配置为 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app、dsh-session-telecom；设置 DSH_TEST_RUNTIME（宿主 dsh 目录）、DSH_TEST_PROFILE 和 DSH_TEST_HOME。使用宿主的 Node/Electron 运行，Electron 需设置 ELECTRON_RUN_AS_NODE=1 并传入 --expose-internals。测试会确认调度器属于同一个内核实例，并让两个新会话分别完成工具调用和回复。模型响应由测试适配器提供，不访问模型 API，也不向真实会话发消息。

许可

MIT