配置

安装并重新加载 DSH 后，在 Web UI 的 设置 → 如流 中填写机器人 ID 和凭证，使用方式和填写 API Key 类似。页面里的四项密钥是密码输入框，只显示“已配置”，不会回显原文；保存时留空表示保留已有密钥。

设置页提供以下字段：机器人 Agent ID、AppKey、AppSecret、回调校验 Token、消息加密 AES Key，以及接口地址、回调路径、工作目录和消息类型。页面还会根据当前 DSH 地址生成可复制的回调 URL。

如果当前 DSH 是已经运行的旧版本，安装新版本后需要让插件重新加载一次；本地 link 开发环境还需要加载仓库里的 settings companion。正常从新版本安装时，客户端设置页面随插件一起加载。

首次安装或无法使用图形设置页时，也可以把配置模板合并到 ${DSH_HOME:-$HOME/.dsh}/profiles/web/cordis.patch.yml，但个人凭证不要提交到 GitHub。

找到下面这段，把尖括号里的内容替换成你自己的值：

- id: dsh-ruliu
  config:
    enabled: true
    appKey: ''
    appSecret: ''
    agentId: 123456                 # 这里填机器人 Agent ID，只填数字
    checkToken: ''
    encodingAESKey: ''
    apiHost: 'https://api.im.baidu.com'
    webhookPath: '/dsh-ruliu/webhook'
    cwd: '/path/to/your/workspace'
    msgType: 'text'

必须填写的值一共有五项：

配置项	填什么	从哪里获取
`appKey`	如流应用 AppKey	如流开放平台的应用详情页
`appSecret`	如流应用 AppSecret	同一个应用详情页；插件会自动计算接口所需的 md5，不要手动加密
`agentId`	机器人 Agent ID	如流开放平台的机器人/应用详情页，必须是数字
`checkToken`	回调校验 Token	如流开放平台「接收消息服务器」配置页；自己生成并填入两边也可以
`encodingAESKey`	消息加密 AES Key	如流开放平台「接收消息服务器」配置页；通常是 22 位字符串

agentId 是机器人 ID；appKey 和 appSecret 是应用凭证；checkToken 和 encodingAESKey 是 webhook 校验与消息解密用的 key。它们不是本项目生成的值，也不要把真实值提交到 GitHub。

字段	必需	说明
`apiHost`	可选	默认 `https://api.im.baidu.com`；百度内网机器通常使用 `http://apiin.im.baidu.com`
`webhookPath`	可选	默认 `/dsh-ruliu/webhook`，要和如流后台填的一致
`cwd`	可选	新建 DSH 会话的工作目录，改成 DSH 实际运行的目录
`msgType`	可选	出站消息类型，`text`（默认）或 `md`

机器地址也要填：在如流后台「接收消息服务器」里，把回调 URL 填成下面的形式，把 `` 换成运行 DSH 的机器 IP：

http://:8080/dsh-ruliu/webhook

例如 DSH 机器内网 IP 是 10.10.20.35，就填：

http://10.10.20.35:8080/dsh-ruliu/webhook

这里的机器 IP 必须是如流服务器能访问到的地址，不能填 127.0.0.1 或 localhost。如果 DSH 不是监听 8080 端口，还要把 URL 中的端口改成实际端口。

如流会先发一次 echostr 校验（插件按 md5(rn + timestamp + checkToken) 验签并原样回显），通过后才开始推消息。

dsh-ruliu

설치

문서

配置