跳到主内容

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

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则