Message Channels · DSH 渠道插件
默认分支 main 现为 DSH 渠道插件产品线。旧独立 macOS App 已归档至 archive/standalone-macos-main-20261104，历史完整保留。
将 iMessage、Telegram、微信 iLink、Discord 消息送入 DeepSeek Harness（DSH） 的原生会话，并回传执行结果。当前版本适配 DSH 0.2.1-rc.2；engines.dsh 接受 >=0.2.1-rc.2 <0.3.0，开发依赖仍固定在经过验证的 RC。
DSH 负责 Agent、模型、工具、权限、执行队列、取消和会话日志；本插件负责消息渠道、固定身份绑定、去重和回复投递。宿主与浏览器端均为原生 Cordis 插件，没有独立平台、服务安装器或执行后端。
安装
需要 DSH 0.2.1-rc.2（engines.dsh 接受 >=0.2.1-rc.2 <0.3.0）。iMessage 通道额外要求 macOS 与本机 Messages；Telegram、微信 iLink、Discord 跨平台。
npm 包：@showin2333/dsh-plugin-channels。安装后以 bundle 形式挂载两条 Cordis 行（dsh-channels 与项目分组），浏览器面板由 dsh.client 自动发现。
原 npm 名称 @showin2333/dsh-channels 已迁至此名称。升级保留设置行 ID、渠道绑定与会话记录；先停止旧包，再切换依赖和模块引用，勿同时加载两个包。详见迁移指南。
当前已发布版本为 1.1.0-dsh.10；索引仅列出此新包名下实际存在的版本。
- 直接安装：DSH → 插件 → 安装，输入
@showin2333/dsh-plugin-channels@1.1.0-dsh.10。
- 市场安装：先启用
@deepseek-ai/dsh-experimental-plugin-market-bundle，在 插件 → 发现 → 添加索引源 填入下方地址，再从卡片安装。
- 本地开发：
pnpm install && npm run build，在 profile 的 dependencies 中以 link: 指向本仓库。
索引地址：https://cdn.jsdelivr.net/gh/ShoWin2333/agent-imessage@main/market/index.json
安装后不会自动连接任何渠道：先按「Desktop 管理面板」配置 workspace、权限预设和凭据引用，再显式启用绑定。升级需要先卸载再安装，DSH 目前没有原地更新动作。
当前闭环
- 四种渠道保留原有适配器与身份过滤：iMessage 的指定号码 DM、Telegram 的指定 Bot/Owner 私聊、微信的指定账号/Owner/上下文、Discord 的 Owner DM 或指定服务器/频道中的明确提及。
- 空闲时文字任务进入 DSH 原生 followup；同一渠道正在执行的轮次内，追加文字通过 steer 在下一步接收；宿主直接发起的轮次不会被渠道接管。渠道游标前进前等待 inbox 落盘。DSH 的
claimed 事件关联单条输入和 turn，turn/end 后显式 flush 再回传结果。
/cancel、/stop 取消本绑定当前与排队的工作；/status 查看绑定会话，/help 查看命令。取消不等待外发完成。- 外部消息 ID 去重保存在 DSH storage domain；不同渠道、账号、Owner、目的地、工作区、权限配置之间不共用会话。
- 重启恢复已完成但未发送的结果；发送中崩溃或发送异常标为
uncertain，不自动重发。未完成的旧输入不自动重跑；恢复 Agent 后清理旧 inbox，防止新输入意外唤醒旧任务。
渠道审批与问答现已接入 DSH 原生处理器链：先让宿主处理，只在宿主没有处理器时转到当前渠道。/approve <凭据> 仅允许本次操作；/deny <凭据> 拒绝；/answer <凭据> <答案> 返回原生结构化问答。单题可用选项数字或 text:自由文本，多题使用包含所有题目 ID 的 answers JSON。计划审批完整展示详情，必须明确选择原选项；不会把自由文本或推荐项当成批准。
临时凭据绑定当前渠道、精确 Agent 实例和已认领的执行轮次，默认两分钟过期。未确认送达时不能批准；取消、断线、执行结束、卸载及重启都会使其失效。过期或重放命令不进入模型。宿主拒绝、取消、其他错误或 never 审批策略不会被渠道覆盖。具体规则见迁移指南。
渠道 Agent 新增 channel_send_media 工具：{ "path": "outputs/report.pdf", "kind": "file" }，kind 可选 image、file、voice。只发送当前绑定收件人，不接受任意聊天目标。每次上传先走宿主原生审批，再通过 Agent 自己的文件系统读取绑定工作区内文件；单文件最多 20 MiB（Discord 仍受 10 MiB 上限约束）。发送前持久化投递凭据；超时或中断标为 uncertain，不自动重发。
图片优先使用渠道原生图片/附件展示；语音优先原生语音消息，不兼容时明确报告文件降级。voice 发送已有音频，不是文字转语音；收取图片/语音并作为任务执行，以及原生定时任务投递，仍不在此版本范围内。
1.1.0-dsh.11 的媒体能力（npm 发布完成前，市场索引仍保留上一个已发布版本）：
| 渠道 | 图片 | 语音 |
|---|
| iMessage | 原生附件展示 | 原生语音；Spectrum 完成编码 |
| Telegram | sendPhoto | sendVoice；支持 MP3/M4A/Ogg Opus |
| Discord | 图片附件展示 | Ogg Opus 原生语音，附真实时长与波形 |
| 微信 iLink | 原生 image_item | 当前未验证原生 bot 语音发送，明确降级音频文件 |
Telegram/Discord 的 voice 请求会在宿主具备 ffmpeg、Agent 子进程与沙箱能力时，通过受限管道转换为单声道 Ogg Opus，并计算真实波形与时长（最长十分钟）。不写临时文件、不启用网络协议、不自动安装依赖；能力缺失会在结果中说明。微信图片协议依据腾讯官方 @tencent-weixin/openclaw-weixin@2.4.10 发布源码核实；共享类型中的语音字段不等于已证实的下行发送能力。网络发送失败不自动改用文件重发。取消已开始的第三方上传是尽力而为，尤其 iMessage SDK 无中途撤回能力。
Agent 只读工具
插件注册一个只读工具 channel_status：返回已配置渠道的启停状态、连接阶段和稳定错误码，不含消息内容、凭据或会话标识。宿主未安装/提供 tools 服务时插件不会加载。
Desktop 管理面板
安装后按 ⌘, → 消息渠道，打开 DSH 设置侧栏中的独立插件设置项。面板提供四渠道、项目路径与宿主目录选择接口、宿主已配置模型与推理强度、凭据引用、身份限制、实际运行状态及显式启停。新增绑定默认停用；保存与启动是两个动作。保存使用宿主配置修订号，冲突或失败保留草稿，取消重新载入宿主已保存值。运行中的渠道也可编辑草稿；保存前须确认仅重新连接当前渠道，原会话历史保留。按左侧 Agent 项目选择消息入口，各渠道独立保存、取消及选择宿主模型；不设置模型覆盖时使用 DSH 默认。原生 Workspace 贡献会将精确属于本插件的会话归入对应项目，后续新会话自动挂接。
面板只保存凭据引用名称；名称存在不表示凭据已配置。默认模型跟随宿主，不创建新账号或密钥。权限预设必须已存在于宿主。跨字段和账号唯一性使用同一纯配置 Zod 校验；原生 Settings schema 保持声明式以兼容宿主二次序列化。外部绕过面板写入的非法配置会被运行入口拒绝，保留现有消费者并显示错误；持久化的非法外部配置须修正后才能正常重启。
插件组合
包声明 dsh.bundle.patch，默认 patch 加载插件但不配置任何绑定，因此不会连接真实渠道。宿主必须提供原生 Agent factory、session persistence、storage domain、credentials、Agent preset、default model 和 permission preset 服务。
以下为 示例配置，不会被本项目自动应用。credentialRef 仅引用宿主已有凭据；不要把 Token 或 Secret 写入 YAML。cwd 必须是现有绝对路径，permissionPreset 必须由宿主预先定义；插件不创建登录或扩大权限。
- id: dsh-channels
name: '@showin2333/dsh-plugin-channels'
config:
bindings:
- id: owner-telegram
cwd: /absolute/existing/workspace
permissionPreset: workspace-write
credentialRef: TELEGRAM_BOT_TOKEN
channel:
id: telegram
kind: telegram
botId: '123456'
ownerUserId: '234567'
其他渠道的 channel 字段：
# iMessage；credentialRef 指向 Photon project secret
channel:
id: imessage
kind: imessage
projectId: existing-photon-project
senderPhoneNumber: '+15551234567'
assignedPhoneNumber: '+15557654321'
# 微信；credentialRef 指向现有 iLink token；weixin 与 channel 同级
channel:
id: weixin
kind: weixin
accountId: existing-bot-account
weixin:
ownerUserId: existing-owner
baseUrl: https://ilinkai.weixin.qq.com/
# Discord；credentialRef 指向现有 bot token
channel:
id: discord
kind: discord
botId: '123456789012345678'
ownerUserId: '234567890123456789'
# 服务器模式同时填写这两项；省略两项为 Owner DM
guildId: '345678901234567890'
channelId: '456789012345678901'
同一个 Bot、微信账号或 Photon project 只能有一个消费者。真实切换前需核对旧消费者和备份。凭据轮换需由宿主更新引用并重新加载绑定。
本地验证
# 使用 pnpm 11.28.5（已核实的 Desktop 自带版本）
pnpm install --frozen-lockfile --ignore-scripts
npm run check
检查包括类型检查、合成消息/模拟渠道测试、构建和打包清单检查。所有 DSH 包固定在 0.2.1-rc.2，避免预发布 peer 范围混入其他 RC。cordis 和 zod 也固定在经过验证的版本。没有真实消息或付费模型测试脚本。
接口依据、恢复语义和已知边界见 迁移指南。English · 安全边界
