dsh-im 使用指南
把九种 IM 渠道和公网 AI Office 接入 DeepSeek Harness,支持多机器人独立工作区与凭据。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-im
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add @xmanrui/dsh-im
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
/help不需要参数,也不会创建会话;它会返回当前机器人支持的完整命令列表。/status不需要参数,也不会向模型发送消息或改变会话绑定;它用于确认当前机器人能够连接 DeepSeek Harness。/new只解除当前聊天在 dsh-im 中保存的会话绑定,不会删除、清空或归档旧 Session。下一条普通消息会在当前工作区创建并绑定一个新 Session。任务正在运行或等待问题、审批时,应先完成交互或使用/stop,再使用/new。/models不需要参数,也不会创建会话。它为 Harness 当前配置的全部可用模型分配序号,同时显示可稳定复制的Provider/模型ID;某个 Provider 查询失败时,其他 Provider 的结果仍会显示。/model不带参数时只查看当前会话模型;带参数时接受/models列出的序号或完整模型 ID,例如/model 2。完整 ID 必须精确匹配。聊天尚无会话时,有效的切换命令会创建并绑定一个空白会话,但不会触发模型回复。切换只影响当前会话;Harness 还会尝试把它保存为以后新会话的默认模型,已有其他会话不受影响。
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
这个插件和其它 DSH IM 插件是什么关系?
dsh-im 是一个合并包,统一接管九种 IM 渠道的设置页;安装时会自动移除此前的独立包 @xmanrui/dsh-feishu、@xmanrui/dsh-weixin、@xmanrui/dsh-dingtalk,原有扫码绑定和凭据保持不变。
一个 IM 渠道能加几个机器人?
同一渠道支持接入任意多机器人,每个机器人独立保存凭据、连接状态、工作区和聊天-会话映射,在设置页中的每张机器人卡片上互不影响地操作。
/model、/steer、/stop 这些命令有什么区别?
/model 用于查看或切换当前会话使用的模型;/steer 把补充指令追加到正在运行的任务中;/stop 立即停止当前聊天发起的运行任务但保留排队消息,三者都不会影响其他聊天。
图片支持什么格式、大小有上限吗?
九种渠道都支持 JPEG、PNG、WebP,以及以图片文件方式发送的 GIF;单张上限 5 MB,单条消息内图片总大小上限 20 MB,单条消息最多 20 张。
AI Office 是什么?现在能用吗?
AI Office 是让本机 Harness 主动连接公网 Office 的反向桥接,目前在设置页明确标注为「实验功能」,遵循 office-harness.v1 协议,需要先在公网 Office 拿到 Base URL 和 Device Token。
为什么从外网/局域网访问不到管理页面?
IM 管理 RPC 默认仅接受回环浏览器(loopback),防止扫码、凭据提交等敏感操作被外网调用;在可信局域网内可在 profile 的 cordis.patch.yml 中显式设置 rpcAuthority: trusted-host。
如何完全卸载?
运行 dsh plugin --profile web remove @xmanrui/dsh-im,或用 npx -y github:xmanrui/dsh-im uninstall,再重启 dsh web,插件注册和设置项会被一并清除。
机器人的命令谁都可以执行吗?
是的。任何已被平台可见范围接受、能给机器人发消息的用户都能执行这些命令,包括 /session 这种会接续指定会话的命令,开放机器人前请评估可见用户是否可信。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 未声明
- Node: >=22.19
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则