DSH-IM — Connecting DeepSeek Harness
DSH-IM phone logo
[!NOTE]
DSH-IM 已获得 DeepSeek Harness 官方认可，并获得价值 人民币 1,000 元的 Token 额度奖励。感谢官方对本项目的肯定与支持！
简介
通过扫码、App Manifest 或已有机器人凭据把 IM 机器人接入 DeepSeek Harness，并让本机 Harness 主动连接公网 AI Office。一个插件、一个设置入口，统一管理内置 IM 渠道和 AI Office Connector。每个 IM 渠道都支持接入多个机器人，各机器人的连接状态、工作区、模型和会话绑定彼此独立；iMessage 是本机 Messages.app 身份接入的例外，详见iMessage 渠道说明。
Connect IM bots to DeepSeek Harness by scanning a QR code, using an App Manifest, or entering existing bot credentials, and let the local Harness connect outward to a public AI Office. One plugin and one settings entry manage the built-in IM channels and the AI Office Connector.
本 Fork 的改动（拟人化）
本包发布为 @johnnren/dsh-im-humanize（基于上游 4.21.2）：
dsh plugin --profile web add @johnnren/dsh-im-humanize
本仓库是从 xmanrui/dsh-im fork 出来的"拟人化"分支，在保留上游全部功能的基础上，新增面向角色扮演沉浸体验的设置。全局项在「设置 → IM机器人 → 通用设置」的拟人化设置面板中配置；全部拟人化设置还支持在每个渠道的机器人卡片里按机器人逐项覆盖。
速览：与上游的全部差异
| 改动 | 默认 | 说明 |
|---|
流式回复 streaming | 开 | 关闭后一次性发送完整回复，不逐字推送 |
分步消息 message_break | 关 | 注册 no-op 工具，模型主动调用拆长回复为多条消息 |
新消息行为 onNewMessage | interrupt | interrupt / queue / steer 三档；上游仅 queue |
状态表情回应 statusReaction | 开 | 关闭后六渠道停发处理中/成功/失败表情 |
回复引用 replyQuote | 开 | 关闭后 Telegram/Discord/WhatsApp 回复不带引用头 |
过程进度提示 progressStatus | 开 | 关闭后不发"正在处理…/正在使用工具…/正在整理结果…"占位与中间进度气泡，回复直达；流式文本仍逐字显示 |
发送延迟 sendDelay | 关 | 阅读延迟 + 分段间隔两阶段，含活跃响应 |
输入状态指示 typingIndicator | burst | off / continuous / burst 三档 |
| QQ 桥接 messageBreak 修复 | — | 修复上游 messageBreakHandler 作用域缺陷 |
| QQ 输入状态会话重写 | — | 桥内自管理 55s/50s 替代失效的 SDK 中间件 |
| 延迟窗口双回复修复 | — | 被取代回合静默取消，无双回复 |
| 主动回合自动投递 | — | proactive 唤醒、定时任务、后台子代理完成通知等「agent 主动发起」回合的可见回复，自动投递到当前 Session 绑定的私聊（原文无前缀，不依赖双向同步开关） |
send_im 投递工具 imSendTool | 开 | 注册模型工具，仅用于显式投递到「非绑定」的指定目标（botId+targetId）；主动回合的绑定私聊已自动投递，无需调用 |
上游同步说明：本分支为长期维护的 fork，会持续合并 xmanrui/dsh-im 上游更新；上游修复与功能在合并时保持完全兼容。分步消息（message_break）、流式开关（streaming）、发送延迟与输入状态指示依赖本 fork 对 Harness 回复追踪（HarnessReplyTracker）与渠道桥接的扩展，在上游仓库中不可用。
-
流式回复（streaming，默认开启）：关闭后不再逐字推送模型输出，而是等回合结束后一次性发送完整回复，更接近真人回复节奏。可与 message_break 同时开启。
-
分步消息（message_break，默认关闭）：插件会注册一个名为 message_break 的 no-op 工具（不执行任何操作，仅作为回复中的断点标记）。模型在长回复中主动调用它来"换气"时，插件会把断点之前的文本作为一条独立消息发送，随后继续发送后续分段，整段回答因此变成多条消息，读起来更像真人逐条输入。三个分隔点（思考/工具进度与最终回答之间、长回答的段落之间、前后文切换处）最自然；单回合最多拆分 20 段，纯空白分段会被跳过。
-
新消息行为（onNewMessage，默认 interrupt）：模型生成过程中用户又发来新消息时的处理方式：
- 打断重发（interrupt）：取消当前回合并立即用新消息重新提问；
- 排队等待（queue）：等当前回合结束后再处理新消息（上游默认行为）；
- 注入纠偏（steer）：不中断生成，把新消息文本注入为当前回合的纠偏指令，模型在回答末尾顺势回应。
当回合正在等待用户交互（提问/审批等待、验证码等）时，一律按排队处理，保证交互流程不被新消息打乱。
-
状态表情回应（statusReaction，默认开启）：机器人在用户消息上用表情标记任务状态（处理中/成功/失败，例如 Telegram 的 👀 → 👍/👎）。关闭后不再发送任何表情，回复照常送达。支持 Telegram、Discord、WhatsApp、Slack、飞书、钉钉。
-
回复引用（replyQuote，默认开启）：机器人回复时引用你的消息（回复顶部的引用样式）。关闭后回复以普通消息发出。仅影响 Telegram、Discord、WhatsApp 的引用样式；话题路由（Telegram 话题、Discord Thread、Slack 线程、飞书话题回复）与会话归组不受影响。
-
过程进度提示（progressStatus，默认开启）：处理任务时显示中间状态气泡（如"正在处理…""正在使用工具…""正在整理结果…"）。关闭后不再发送占位气泡与中间进度文案，回复直达；流式文本仍正常逐字显示。与 message_break 同时开启时，关闭此项会连带跳过占位流（分段直接逐条发送，消除占位气泡与分段消息的内容重复）。支持所有聊天渠道；QQ/微信本就无中间进度，AI Office 任务进度不受影响（属产品核心 UX）。
发送延迟（两阶段模型）
发送延迟把"真人感"拆成两个阶段，对应真人在 IM 里的两个真实间隙：
-
阅读延迟（readDelay，阶段①）：机器人收到消息后先静默一段时间才开始处理，模拟"过了一段时间才读到消息"。静默期没有任何输入状态或已读提示。时长为 minMs–maxMs 区间随机值，另有两个可选加项：
- 按消息长度阅读项（charsPerSecond）：用户消息越长，"读"得越久（按字符数除以阅读速度累加）；
- 活跃响应（activityBoost）：刚聊完天时"秒回"，闲置越久延迟越接近完整区间——上一回合结束后 0–
fastWindowMs（默认 1 分钟）内直接用 fastReplyMs（默认约 1 秒）；minWindowMs（默认 2 分钟）前线性回升到阅读延迟下限；超过 fullWindowMs（默认 5 分钟）回到完整随机区间。首条消息不加速。
总延迟受 maxTotalMs 封顶；无输入状态接口的渠道（钉钉、企业微信、飞书、Slack 等）阅读延迟封顶 5 秒。钉钉的分段间隔额外强制 ≥3 秒（webhook 频控）。
-
分段间隔（segmentGap，阶段②的一部分）：分步消息或流式分段的两条消息之间"正在打下一条"的停顿，同样为 minMs–maxMs 随机，可按分段长度加项。
取代（supersede）语义：阅读延迟期间用户又发来新消息（interrupt 模式）或执行 /stop 时，旧回合静默取消——不生成、不发送、无"处理失败"提示、无双回复，新消息立即接管。排队（queue）模式下多条消息依次处理，延迟会累积（每条都"被读一遍"）。
发送延迟默认关闭（enabled=false），此时除上述取代修复外行为与上游完全一致。设置面板提供全参数面：阅读延迟 min/max、阅读速度（字/秒）、单回合封顶、活跃响应（快速回复 + 秒回/恢复下限/完全恢复三个时间窗）、分段间隔与分段打字速度，折叠区内的断续节奏高级参数（亮/灭四档毫秒），以及探索预设（轻拟人 / 慢性子 / 沉浸角色扮演 / 即刻应答，一键填充全部字段）。配置文件（~/.dsh/integrations/dsh-im/humanize.json）支持同样的全部参数。每个机器人可在其渠道卡片的「拟人化」折叠面板中逐项覆盖全部设置（流式回复、分步消息、状态表情回应、回复引用、新消息行为、输入状态指示、断续节奏、发送延迟）：每项可选择「跟随全局」或自定义值，保存只写被自定义的项，未自定义的项继续跟随全局默认变化。
输入状态指示（typingIndicator）
进入处理阶段后"正在输入"的显示方式，三档：
- 关闭（off）：完全不显示输入状态；
- 持续（continuous）：处理期间持续显示；
- 断续（burst，默认）：像真人一样时断时续——显示几秒、熄灭一两秒、再显示，避免长时间挂机的机器人感。断续节奏（typingBurst 的 on/off 区间）可在配置文件中调整。
渠道能力差异：Telegram / Discord / WhatsApp（composing）支持全部三档；微信在阅读延迟结束后拉取输入票据并保活；QQ 仅私聊支持（群聊无此 API），且改用桥内自管理的输入状态会话（55 秒显示 / 50 秒续期）替代上游依赖的、已失效的 SDK 中间件；钉钉、企业微信、飞书、Slack 无输入状态接口，自动忽略此项。交互等待（提问/审批）期间输入状态暂停显示，回合结束（含 /stop、出错）后必定熄灭。
修复的缺陷（上游 bug）
以下问题在上游 xmanrui/dsh-im v4.13.0 中存在，本 fork 已修复：
- QQ 桥接
messageBreakHandler 作用域缺陷：上游中任何成功回合只要启用 message_break 就会触发 ReferenceError 并误报"任务未完成"（也是 4 个基线测试失败的根因）。本 fork 修复了作用域，message_break 在 QQ 渠道正常工作。
Fixes a QQ bridge messageBreakHandler scoping bug in upstream: any successful turn with message_break enabled threw a ReferenceError and misreported a task failure (also the root cause behind 4 baseline test failures).
- 延迟窗口内被取代回合的双回复：阅读延迟计时期间用户又发来新消息（interrupt）或执行
/stop 时，旧回合会被静默取消——不生成、不发送、无"处理失败"提示、无双回复，新消息立即接管。被取代的批量输入保留待 /send 重试。上游的 queue 模式无此问题；本修复覆盖 interrupt 模式。
Fixes double replies for turns superseded during the delay window: a new message (interrupt) or /stop while the read delay is ticking silently cancels the old turn — no generation, no send, no failure notice, no double reply; superseded batch inputs are retained for /send retry. Upstream's queue mode was unaffected; this fix covers interrupt mode.
配置迁移
readDelay.idleBoost → readDelay.activityBoost（语义反转）：早期版本的"闲置加成"（闲置越久延迟 ×N）已被语义反转并替换为"活跃响应"（刚聊完天"秒回"）。已存的 idleBoost 键在读取时被忽略并回落新默认值——如果你之前调过闲置加成，请在设置面板重配活跃响应。
readDelay.idleBoost → readDelay.activityBoost (semantic inversion): the early "idle boost" (the longer the idle, the slower the reply) is semantically inverted and replaced by "activity boost" (fast replies right after a quick exchange). A stored idleBoost key is ignored on load and falls back to the new defaults; if you had tuned the idle boost, re-configure the activity boost in the settings panel.
界面
IM 机器人页面
上下文增强页面 访问模式页面
当前内置渠道
| 渠道 | 接入方式 | 消息与回复 |
|---|
| 飞书 | 扫码创建机器人，或使用 App ID + App Secret 手动绑定 | 长连接接收消息；通过飞书流式卡片显示思考、工具进度和回答 |
| 微信 | 使用微信扫码绑定机器人 | 腾讯 iLink 长轮询收发消息；等待 Harness 回答时显示“正在输入”，最终回复按 1,800 字符分段发送 |
| 钉钉 | 扫码创建机器人，或使用 Client ID + Client Secret 手动绑定 | 钉钉 Stream 长连接；通过 AI Card 流式显示回答 |
| 企业微信 | 使用企业微信 App 扫码创建智能机器人，或使用 Bot ID + Secret 手动绑定 | 官方 WebSocket 长连接；原生显示“正在思考中”、工具执行进度和流式回答 |
| 企业微信应用 | 在企业微信管理后台创建自建应用，填写企业 ID、AgentId、Secret、Token、EncodingAESKey（可选代理地址） | HTTP 回调接收；私聊支持流式回复（微信端不支持时自动改为分段文本），支持图片输入与结果文件回传；成员的微信关注该企业的微信插件后可在微信中直接使用 |
| QQ | 使用手机 QQ 扫码创建机器人，或使用 AppID + AppSecret 手动绑定 | WebSocket 长连接；私聊显示“正在输入”并以单条 Markdown 回复，群聊被 @ 后只发送最终答案 |
| Slack | 使用预置 App Manifest 创建应用，再填写 Bot Token（xoxb-）和 App Token（xapp-） | Socket Mode 长连接；私聊直接回复，频道被 @ 后响应，优先使用官方流式消息 API |
| Telegram | 使用 @BotFather 生成的 Bot Token | Bot API 长轮询；默认私聊直接响应、群聊被提及或回复时响应，也可为每个机器人独立启用私聊白名单安全模式；私聊通过 Rich Message Draft 流式预览并持久化最终富消息，群聊和 Topic 原位完成占位消息，平台不支持时回退为普通文字 |
| Discord | 使用 Developer Portal 生成的 Bot Token | Gateway v10 长连接；私信直接回复；服务器文字/公告频道首次 @ 后创建原生 Thread，后续在线程中无需重复 @，并通过编辑消息流式显示回答 |
| WhatsApp | 使用手机 WhatsApp 扫码关联设备 | WhatsApp Web 长连接；默认仅响应账号自聊，也可切换到指定联系人或开放响应模式；显示已读和“正在输入”，通过每秒编辑同一条消息显示工具进度和逐步生成的回答，长回复自动分段，编辑失败时回退为完整文字回复 |
| iMessage | 在 macOS Messages.app 中登录 iMessage，并按渠道说明授予本机权限 | 使用 macOS 原生 Messages.app 收发文本私聊；不依赖 BlueBubbles；每个 macOS 用户账户使用一个本机 iMessage 身份 |
企业微信自建应用的回调基址、代理地址和企业可信 IP 配置，见企业微信自建应用接入说明。
其他 IM 平台可继续按同一渠道适配器结构接入。
飞书群聊默认接收其他机器人明确 @ 当前机器人的消息，无需额外开关；未 @、仅 @ 其他成员或全体、机器人自身发送的消息和机器人私聊消息仍会忽略，即使群聊响应方式设为“全部”。消息仍受群聊白名单与命令权限约束。飞书应用需要租户权限 im:message.group_at_msg.include_bot:readonly（“获取群组中其他机器人和用户@当前机器人的消息”）；扫码新建应用会默认申请，已有或手动绑定的应用可点击“补全权限”或私聊执行 /repair，扫码并完成飞书要求的发布审批后生效。详见飞书接收消息权限说明。
支持图片输入的内置渠道均支持把 JPEG、PNG、WebP 图片，以及以图片文件方式发送的 GIF，连同可选文字说明发送给 Harness；单张图片上限为 5 MB，单条消息中的图片总大小上限为 20 MB。iMessage 首版仅支持文本私聊，不包含在图片能力中。飞书下载用户消息中的图片或文件需要租户权限 im:message:readonly，确认页将其显示为“获取单聊、群组消息”；飞书目前没有为该下载接口提供仅限图片的更窄权限。扫码新建的应用会默认申请；已有或手动绑定的应用可私聊机器人执行 /repair，或在「IM机器人」设置页点击“补全权限”，扫码增量补全该权限、上传机器人图片或文件所需的 im:resource、原生命令面板所需的 application:app_slash_command:read / write，以及卡片回调。
超时后的结果补发
已接入的 IM 渠道共用超时任务跟踪：收到“等待模型回复超时”后，插件会继续检查原任务，完成后向原聊天或线程补发最终文字；插件重启或连接恢复后也会继续检查。/stop 只停止当前聊天提交的对应回合，切换会话后不再向该聊天补发旧会话的结果。无需新增设置，正常回复流程保持原样。
补发仍受渠道发送权限和配额限制。明确发送失败最多尝试三次；发送结果不确定时保留记录并停止自动重试，避免重复消息。此机制恢复文字结果和终态通知，不重放问题、审批或文件工具调用。详见延迟交付说明。
结果文件与图片回传
支持文件回传的内置渠道均可把 Harness 可读取的文件作为渠道原生附件回传。已有文件和当前任务新生成的文件都可以直接发送；该能力对所有已连接机器人默认可用，无需开关或机器人白名单，原有文字、图片、流式回复、命令和会话行为保持不变。iMessage 首版不支持文件或附件回传。
模型调用文件回传工具后，插件把指定文件交给当前渠道的原生接口。图片会优先以原生图片消息呈现；渠道不支持或明确拒绝图片发送时自动回退为文件附件，发送结果不确定时不会补发文件造成重复消息。插件不额外设置文件来源、创建时间、工作区边界、扩展名、内容、数量、大小或有效期规则；文件只需真实存在且可读取。渠道平台仍可能依据自身权限、配额、文件能力或账号等级拒绝发送，插件会按平台返回结果提示。
GIF 动图按各渠道原生能力呈现，存在差异：Telegram 把 .gif 走原生动画消息（sendAnimation），客户端内联循环播放；微信（iLink）协议只提供图片消息、没有独立的表情/动图消息类型，GIF 经图片消息只显示静态首帧，无法内联动图（这是协议层限制，非插件可修）；其余渠道以各自图片消息对 GIF 的原生表现为准。文件名需带 .gif 扩展名才会走图片/动画路径，无扩展名的 GIF 会被当作普通文件发送。
| 渠道 | 平台要求 |
|---|
| 微信 | 当前绑定协议和会话需支持原生文件消息，实际可发送范围以微信接口返回为准。 |
| 飞书 | 飞书文件上传接口要求文件非空且不超过平台 30 MB；应用需有租户权限 im:resource（“读取与上传图片或文件资源”）。内置扫码流程新建应用时默认申请该权限；已有或手动绑定的应用可通过“补全权限”或私聊 /repair 增量补全并完成飞书要求的审批。飞书开发者后台当前没有单独的 im:resource:upload 权限。 |
| 钉钉 | 应用需开通 qyapi_base，机器人需具备文件消息能力；实际格式和大小以当前 OAPI 与机器人能力返回为准。 |
| 企业微信 | 应用需具备素材上传和文件消息能力，实际可发送范围以企业微信接口返回为准。 |
| QQ | 机器人需具备文件消息能力，并受 QQ 当日文件上传配额约束；额度耗尽时会明确提示稍后重试。 |
| Slack | Bot Token 需有 files:read、files:write 和 reactions:write；实际文件大小上限由 Workspace 当前策略决定。已有 App 新增或变更 Scope 后，必须重新授权/安装 App 并重新连接机器人。 |
| Telegram | 机器人必须能在当前聊天发送文档，实际可发送范围以 Bot API 返回为准。 |
| Discord | Developer Portal 的 Bot 设置中需启用 Message Content Intent；机器人需有 Send Messages、Create Public Threads、Send Messages in Threads 和 Read Message History 权限；发送结果文件还需 Attach Files。实际附件额度由当前账号与服务器能力决定。 |
| WhatsApp | 当前绑定会话需支持 Document Message，实际可发送范围以 WhatsApp/Baileys 返回为准。 |
AI Office Connector
查看 AI Office Connector 说明
安装
推荐从 npm 安装已发布的稳定版本：
dsh plugin --profile web add -w @xmanrui/dsh-im
重启 dsh web、刷新浏览器，然后打开「设置 → IM机器人」。IM机器人使用 order: 21，尽量排在一级设置菜单的「Agent 预设」之后；插件页面不再保留旧入口。从旧版升级不会改变已有机器人、凭据、工作区、Agent Preset 或会话绑定。
本机 dsh web 和 DSH Desktop 默认直接复用当前 Host 的内部服务：旧版 Harness 使用 apiProxy，新版 Harness 自动使用 Typert Gateway、Session Controller 和 Workspace Controller，不需要配置 Harness 地址，也不绕行本机 HTTP 端口。Desktop 的兼容模式、扩展窗口和增强模式均无需开启“允许在浏览器中打开”或局域网访问。渠道配置中显式设置的 harnessBaseUrl 仅保留给旧版远程 HTTP/WebSocket Harness；内部调用失败不会自动改连其他 Host。
如需试用尚未发布到 npm 的最新代码，可以改用 GitHub 源安装器：
npx -y github:xmanrui/dsh-im install
GitHub 源安装会直接拉取并构建 Git 依赖；pnpm 10 及以上版本可能要求先在 profile 的 pnpm-workspace.yaml 中允许该依赖执行构建脚本。普通用户建议优先使用 npm 稳定版。
安装后，在对应渠道页面按照内置引导完成扫码或凭据配置。所有 Secret 和 Token 只提交给本机 Harness Host，并写入受保护的凭据存储；状态接口和机器人列表不会回传这些凭据。
如果本机必须通过正向代理访问飞书，请在启动 dsh web 前把 HTTPS_PROXY 设置为包含协议的 HTTP 代理 URL（例如 http://proxy:8080；也支持小写 https_proxy，并兼容使用 HTTP_PROXY 作为回退），修改后重启 Host。飞书注册和凭据验证会复用 SDK 的代理感知 HTTP 客户端，消息长连接会显式通过这个代理建立 WebSocket；长连接目前不读取 ALL_PROXY 或 NO_PROXY。
如果本机无法直连 Telegram Bot API，请使用 Node.js 22.21 或更高版本，并在启动 dsh web 前启用 Node 的环境变量代理支持：
NODE_USE_ENV_PROXY=1 \
HTTPS_PROXY=http://proxy:8080 \
HTTP_PROXY=http://proxy:8080 \
NO_PROXY=localhost,127.0.0.1 \
dsh web
代理地址按本机网络环境填写；修改代理后需要重启 Host。绑定 Telegram Bot Token 时，如果页面提示无法访问 Bot API，请优先检查代理地址、Node.js 版本和 NO_PROXY 配置。
| 默认行为 | 说明 |
|---|
| 机器人别名 | 点击机器人名称旁的铅笔设置别名，保存后立即显示，无需重启或重连。原名称始终保留，可点击“恢复原名称”或清空别名后保存；仅影响本机设置页中的显示名称。 |
| 机器人工作区 | 每个机器人独立保存工作区。新机器人默认使用 Host 当时的工作目录；之后可在机器人卡片中修改。 |
| 模型 | 每个 IM 渠道的每个机器人都可在工作区下方独立选择模型；未选择时跟随 Host 默认。切换只影响之后新建的会话；当前聊天先发送 /new，再发送普通消息才会使用新选择。 |
| 思考强度 | 在模型下方显式选择该模型支持的思考强度，或跟随模型默认。档位、说明和默认值来自 DSH；切换模型后恢复新模型默认强度。每个机器人独立保存，只影响之后新建的会话。 |
| Agent Preset | 每个机器人可在设置页卡片中选择 Agent Preset。未选择时跟随 Host 的 agent-presets.default；渠道级 config.agentPreset 只作为该渠道之后新接入机器人的默认值。切换不会修改或清空已有会话；若当前聊天已有会话，需先发送 /new，再发送一条普通消息，才会按新选择创建会话。 |
| 上下文增强 | 从机器人卡片打开设置，分别决定群聊、私聊是否增强；两个开关默认均关闭，旧机器人升级后也不会自动开启。 |
| 会话渠道标识 | 本机 Host 的 IM 渠道与 AI Office 会话自动标记来源。Web 会话列表和搜索结果将「微信 ·」等前缀显示为渠道 Logo；保留 DSH 原有的自动标题生成与更新。已有会话在下次加载时补上。 |
渠道前缀在 DSH 生成标题后追加，完整保留原始标题与自动／手动来源，不会将自动标题锁定为手动命名，也不会额外调用模型。重复生成、刷新或重启不会叠加前缀；真实的手动命名仍遵循 DSH 原有的锁定规则。此功能由当前 Host 的会话事件驱动，显式连接远程 harnessBaseUrl 时需在目标 Host 上安装该插件。
Logo 由 dsh-im 的浏览器适配显示，无需修改 DSH。适配保留原始文字节点和点击、菜单、拖拽操作；复制、读屏及其他界面仍保留文字渠道名。DSH 页面结构不匹配、浏览器不支持或图标加载失败时，自动保留文字前缀；插件卸载后恢复原始显示。
主动投递
支持主动投递的 IM 渠道可以使用稳定的 botId + targetId 主动发送文字消息。机器人设置页支持从已聊会话选择或手工填写目标、保存前测试当前路由，以及复制调用参数；HTTP POST、同 Host 插件和 Connection RPC 共用同一目标配置与投递核心。
已保存的私聊目标还可以开启默认关闭的「会话双向同步」。开启后，DSH Web／CLI 在该私聊当前 Session 中发送的用户文字和最终助手文字会同步回私聊；IM 侧原有提问与 /steer 不会重复。开关自动跟随 /session、/new 和工作区切换后的当前 Session。首版仅支持当前 Host 的私聊文字；群聊、Topic、Thread 与显式远程 harnessBaseUrl 不支持。
设置步骤、各渠道字段、完整调用示例、管理端点、错误码与排错说明请查看《主动投递使用指南》（English）。
上下文增强
查看上下文增强说明
访问模式
查看访问模式说明
检查与安装更新
查看检查与安装更新说明
机器人命令
| 命令 | 作用 |
|---|
/help | 显示机器人支持的命令和用法。 |
/menu、/m | 飞书、钉钉和企业微信打开交互菜单。钉钉的会话、工作区、预设和模型按两列排列，选择后立即生效，并在原卡片更新结果。企微下拉选择后点击应用；菜单仅通过 /m 或 /menu 手动打开，进入单聊时不自动展示，按钮执行后仅反馈结果，不自动补发菜单。菜单还提供新会话、停止、压缩、状态与帮助等按钮。 |
QQ /menu、/m | 打开按钮与数字菜单：会话选择、工作区、模式／预设、模型、新会话、会话列表、停止、压缩、补充指令、归档显示切换、状态和帮助。列表支持分页；按钮不可用时回复数字选择。菜单按聊天和操作者隔离，15 分钟或重启后失效；普通消息退出数字选择，审批、提问和批量输入保留原有优先级。 |
/new | 解除当前聊天的会话绑定，让下一条普通消息开启全新 Harness 会话。 |
/status | 检查当前机器人与 DeepSeek Harness 的连接状态。 |
/version | 查看当前运行的 dsh-im 插件版本。 |
/models | 按序号列出当前配置的全部可用模型。 |
/model | 查看当前聊天绑定会话正在使用的模型和推理等级。 |
/model <序号或 Provider/模型ID> [推理等级ID] | 切换当前会话模型，并可同时指定目标模型支持的推理等级。 |
/reasoninglist、/reasonings | 等价命令；列出当前模型支持的推理等级。 |
/reasoning | 查看当前会话的模型和推理等级。 |
/reasoning <序号或等级ID> | 切换当前模型的推理等级。 |
/reasoning --default | 恢复当前模型的默认推理等级。 |
/presetlist、/presets | 两个等价命令；按序号列出 Host 当前可用的 Agent Preset，并标记 Host 默认项和当前机器人的选择。 |
/preset | 查看当前机器人的新会话 Agent Preset 设置。 |
/preset <序号或 Preset ID> | 设置当前机器人的 Agent Preset；纯数字 ID 使用 /preset id:<ID>。 |
/preset --default | 清除当前机器人的显式选择，让后续新 Session 跟随 Host 默认。 |
/stop | 立即停止当前聊天正在运行的任务，并保留尚未开始的排队消息。 |
/steer <补充指令> | 把补充指令立即加入当前聊天正在运行的任务。 |
/batch | 在私聊中开启批量输入，最多收集 10 条纯文字消息。 |
/send | 将已收集的消息按原顺序作为一次输入提交。 |
/cancel | 取消批量输入并丢弃已收集的消息。 |
/repair |
命令说明
钉钉菜单使用插件内置的共享卡片模板，无需逐个机器人创建或配置模板。卡片打开后可操作 30 分钟；超时或 Host 重启后重新发送 /m。模板源文件保存在 assets/dingtalk-menu-template.json，供维护者导入卡片平台更新。
查看命令说明
其它功能
- 图片识别：支持图片输入的内置渠道都可以把 JPEG、PNG、WebP，以及以图片文件方式发送的 GIF 交给 Harness；图片可以附带文字说明。单张图片上限为 5 MB，单条消息中的图片总大小上限为 20 MB。iMessage 首版仅支持文本私聊。
- 在机器人卡片切换工作区：设置页中的每张机器人卡片都会显示当前 Harness 工作区。可以直接填写已有目录的绝对路径，也可以打开目录选择器。切换只清除该机器人的旧聊天映射，不会删除、清空或归档旧 Session；已经开始的回复可以继续完成，后续消息使用新工作区。
- 在机器人卡片选择模型与思考强度：每个 IM 渠道的每张机器人卡片都在工作区下方提供模型与思考强度入口，采用 DSH 风格的分组列表、档位说明和选中标记。先选择 Host 当前可用模型，再选择其支持的强度，或跟随模型默认；未选模型时整体跟随 Host 默认。设置按机器人独立保存，只用于之后新建的 Session；已有 Session 和正在生成的回复不受影响。
- 在机器人卡片选择 Agent Preset：设置页中的每张机器人卡片都可以选择 Host 已有的 Agent Preset，或跟随 Host 默认。切换只作用于该机器人，并且只影响之后新建的会话；已有会话和正在生成的回复不受影响。
- 检查连接并发送测试消息：机器人在线时，点击卡片上的「检查连接」会检查平台连接，并向该机器人最近记录的私聊发送一条“DeepSeek Harness 连接测试成功”消息；WhatsApp 会发送到账号自聊。测试消息不会创建 Harness Session，也不会调用模型。机器人必须至少收到过一条私聊才能记住测试目标，否则页面会提示尚无可用的测试会话。
- 重试连接和移除接入：机器人离线时，卡片上的操作会变为「重试连接」；不再使用时可以点击「移除接入」。这些操作都只作用于所选机器人，不影响其他机器人或渠道。
- 多机器人独立管理：同一渠道可以接入多个机器人。每个机器人分别保存凭据、连接状态、工作区、模型、Agent Preset 和聊天会话映射，卡片上的工作区、模型、Preset、连接检查、重试和移除操作互不影响。
- 流式回复和进度提示：插件会按各平台能力显示正在思考、工具执行和逐步生成的回答；不支持原生流式接口的平台会通过编辑消息、卡片更新或最终消息完成回复。
微信扫码、连接或移除失败时，可展开页面中的「诊断详情」并点击「复制诊断信息」。反馈时附上操作步骤、Desktop/Web 运行方式和实际 DSH 版本；使用 WX-CONN-… 参考号查找同一次故障的 [dsh-weixin] Host 日志。诊断会区分网络、凭据、文件、Harness 和微信业务拒绝，不包含登录令牌或二维码内容。账号已移除但本机清理未完成时，页面会保留清理警告；若未取得 Host 参考号，请同时检查 DSH 管理连接和启动日志。
微信启动配置校验失败时，诊断还会提供 file、field、issue，定位 config.json 或 workspaces.json 中第一个未通过校验的位置。字段中的序号从 0 开始，按文件条目顺序计数，例如 workspaces[0].value 表示第一条工作区配置的值，不包含真实账号标识。默认目录为 DSH_HOME/integrations/dsh-weixin（未设置 DSH_HOME 时为 ~/.dsh/integrations/dsh-weixin），自定义路径以插件配置为准。修复后需要重启 DSH；页面「重新读取」仅查询状态，不会重新加载配置文件。
设计
- Harness 一级设置菜单中只注册一个「IM机器人」设置页，其中包含内置 IM 渠道和一个 AI Office Connector；
- 内置渠道及 Office Connector 的 Host、客户端与运行时源码都在本仓库维护，不依赖外部独立插件；
- 设置页跟随 DeepSeek Harness 的语言选择，在中文和 English 之间即时切换；机器人发出的聊天消息、命令帮助和 Telegram 命令菜单同样跟随该界面语言并即时切换，中文始终为兜底，未收录的文案原样输出；
- 左侧使用 Logo 切换微信、飞书、钉钉、企业微信、企业微信应用、QQ、Slack、Telegram、Discord、WhatsApp、iMessage 和 AI Office，不使用启用/停用开关；
- 各 IM 渠道保持独立的 RPC、凭据、连接监督和会话映射；Office Connector 另行维护设备凭据、Job 租约、审批等待与并发上限；
- 浏览器只获得二维码、Manifest、脱敏状态，以及用户为当前 Telegram 或 WhatsApp 机器人主动保存的访问模式和白名单标识；手动输入的 Secret 或 Token 仅单向提交给本机 Host，任何 RPC 响应都不会返回 App Secret、
bot_token、钉钉 client_secret、企业微信 Secret、QQ app_secret、Slack Bot/App Token、Telegram/Discord Bot Token、WhatsApp 关联设备密钥、AI Office Device Token，或从平台消息中观察到的其他原始用户标识。
本地开发
Web profile 已验证兼容原版 DSH 0.1.2-alpha.4、0.1.2-alpha.5、0.1.2-rc.1、0.1.3-alpha.1 和 0.1.5-alpha.1。这些版本共用 dsh-im 的管理 RPC 适配，通过 Connection 的公开 /api Fetch 注册接口工作，无需修改或重新编译 DSH。升级插件后重启 Host 并刷新设置页，使 Host 和客户端使用同一版插件。
npm install
npm run check
node bin/dsh-im.mjs install --source .
npm run check 运行单元测试、构建 Host/Client 产物，并验证发布包不包含凭据或独立渠道设置页注册。
IM 管理接口默认沿用 Harness 的浏览器认证和 Host／Origin 信任检查。只要 Harness 已允许并认证当前局域网访问，便可直接查看和配置 IM 机器人，无需额外修改 dsh-im 配置。
通过自定义域名访问时，如果 IM 设置页出现 transport failure for /api/dsh-im/...: HTTP 403，请在原 DSH 启动命令中添加浏览器访问的域名，并重启 DSH：
dsh web --trusted-host dsh.example.com
将 dsh.example.com 替换为实际访问域名，不带 http://、https:// 或路径。只写域名允许该域名的任意端口；如需限制到指定访问端口，使用 --trusted-host dsh.example.com:8443。多个域名可重复传入 --trusted-host。这个参数属于 DSH；dsh-im 的 rpcAuthority: trusted-host 本身不会把域名加入 DSH 信任列表。本机通过 localhost 或 127.0.0.1 访问通常不需要额外配置。
使用反向代理时，代理传给 DSH 的 Host 应保留浏览器访问的域名及端口；浏览器携带的 Origin 解析出的 host（含非默认端口）必须与该 Host 一致，仅将两者分别加入信任列表仍会返回 403。--trusted-host 只配置访问校验，浏览器仍需通过有效启动链接完成认证。
如需将 IM 管理额外限制为仅本机访问，可在当前 Web profile 的 cordis.patch.yml 中设置：
- id: xmanrui-dsh-im
config:
rpcAuthority: loopback
rpcAuthority 默认为 trusted-host；显式设置 loopback 会额外要求回环 Host 和 Origin。更新与入站 TTL 管理始终仅允许回环访问。
局域网管理的 HTTP 集成测试可在构建插件后运行 node scripts/verify-lan-management.mjs /path/to/built/deepseek-harness。脚本启动原版 DSH CLI，使用独立临时 profile 和空机器人配置，检查默认访问、登录认证、Host／Origin 检查以及显式 loopback 策略，结束后停止服务并清理临时目录。测试通过回环 TCP 发送局域网 Host／Origin，不替代跨设备浏览器验收；原版 0.1.5-alpha.1 CLI 本身拒绝 --host 0.0.0.0，跨设备测试需使用支持局域网访问的 Harness 环境。
聊天消息语言
无需配置。 机器人发出的聊天消息、命令帮助和 Telegram 命令菜单跟随 DeepSeek Harness 的界面语言。在 设置 → 通用 → 语言 中把 DSH 切换为 English，机器人即以英文回复；切换即时生效，无需重启 Host，也无需重连机器人。
语言按以下顺序取第一个有效值：
- 插件自身的
language 配置（或环境变量 DSH_IM_LANGUAGE）。这是下文的运维级固定值；一旦设置，就不再跟随 DSH 的界面语言。
- DSH「语言」设置项中的显式选择，从 Host 用户设置文档读取。这就是「DSH 设为 English」的含义，对所有渠道生效。
- 设置页实际渲染所用的界面语言。当界面语言来自浏览器语言列表时 DSH 不会存储任何偏好，因此 dsh-im 会把生效语言回传 Host 并保存在
~/.dsh/integrations/dsh-im/interface-language.json，这样 Host 重启后、尚无浏览器连接时机器人仍以该语言回复。
中文始终是兜底语言，任何未收录到英文词典的文案都会原样以中文输出，因此该功能不会改变现有中文用户的行为。
聊天消息从下一条起即切换语言。Telegram 命令菜单会立即重新下发，但 Telegram 客户端会缓存 / 菜单，因此即使 Telegram 侧已保存新语言，你自己的客户端仍可能在一段时间内显示切换前的语言；重开客户端即可刷新，getMyCommands 始终反映实际存储的内容。
输入框旁的蓝色 Menu 按钮不受机器人控制，也不会跟随该设置：dsh-im 将其设为 MenuButtonCommands，而 Bot API 中该类型没有文本字段，因此按钮文案由 Telegram 按阅读者客户端自身的语言渲染。只有 MenuButtonWebApp 带有文本字段，但它需要一个 Web App URL。
端到端验证可运行 node scripts/verify-interface-language.mjs /path/to/deepseek-harness：脚本使用原版 DSH CLI 与独立临时 home，通过真实 /api 通道逐层校验语言解析顺序，并验证重启后与运维固定 language 时的行为。设置 DSH_IM_TELEGRAM_TOKEN 可额外接入真实机器人，断言 Telegram 侧实际存储的命令菜单，检查结束后会恢复其原有菜单。
如需固定一种语言、不随阅读者的界面语言变化，可在插件配置中设置 language（也接受 en-US、english），或设置环境变量 DSH_IM_LANGUAGE=en：
- id: xmanrui-dsh-im
config:
language: en
联系方式
欢迎加入企业微信群，或通过邮箱、微信、小红书或 WhatsApp 联系我。
贡献者 ✨
感谢每一位帮助 dsh-im 成长的贡献者！本项目采用 All Contributors 规范，认可代码、文档、测试、问题反馈、想法和其他形式的贡献。
以下名单以 GitHub Contributors 中的用户账号为基础，排除 GitHub 标记为 Bot 的账号，并按用户名排序；贡献类型依据 Git 提交记录标注，点击 emoji 可查看对应记录。
贡献类型说明：💻 代码 · 📖 文档 · ⚠️ 测试 · 🚇 基础设施 · 🌍 翻译 · 🤔 想法与规划。
名单和贡献类型统一维护在 .all-contributorsrc 中。若有遗漏，欢迎通过 Issue 或 PR 补充，非代码贡献同样欢迎。
维护者可运行 npx --yes --package=all-contributors-cli@6.26.1 all-contributors add <username> <type[,type...]> 添加贡献者及贡献类型；手动修改配置后，运行 npx --yes --package=all-contributors-cli@6.26.1 all-contributors generate 同步更新中英文 README。也可在仓库安装 All Contributors Bot 后，通过 Issue 或 PR 评论中的 @all-contributors please add @username for code, doc, test 更新名单。
