dsh-ikuai-mcp

配置：改爱快 IP / 加账号密码

取值优先级：环境变量 > DSH 凭据中心 > 默认值。默认值：

键	默认值	说明
IKUAI_URL	https://192.168.1.1	爱快 web 管理地址；只写 192.168.1.1 会自动补 https://
IKUAI_USERNAME	admin	web 登录用户名
IKUAI_PASSWORD	空	必须配，否则工具直接报「未配置 IKUAI_PASSWORD」

改 IP

先用浏览器确认管理地址能打开：默认 192.168.1.1；改过 LAN 网段就用改后的地址；端口不是 80/443 要带上， 例如 http://192.168.1.1:81。然后任选一种：

A. 让 agent 调工具写进凭据中心（不用重启）

ikuai_set_credentials  { "url": "192.168.1.1", "username": "admin", "password": "你的web登录密码" }

会先归一化地址 → 再用这组参数试连一次 → 成功才写入。连不上就不落盘（确需强存加 "allowUnverified": true）。 写入后 5 秒内生效。

B. 在 GUI 里填（推荐，密码不进对话记录）

设置 → 凭据中心 → 新增 IKUAI_URL（值如 192.168.1.1），同样方式加 IKUAI_USERNAME、IKUAI_PASSWORD。

C. 环境变量

给启动 DSH 的进程设 IKUAI_URL=http://192.168.1.1，需重启。注意环境变量优先于凭据中心， 设了之后在凭据中心改同名值不生效。

加账号密码

密码就是你登录爱快 web 管理页的那个密码。

• 推荐：设置 → 凭据中心 → 加 IKUAI_PASSWORD（明文只存 ~/.dsh/.credentials.yaml，权限 0600，不进对话记录）
• 或者调 ikuai_set_credentials { "password": "..." } —— 该参数是明文，会留在会话记录里，能用 GUI 就用 GUI

验证

ikuai_credentials_status   →  四项生效值与来源（env / 凭据中心 / 默认值）
ikuai_ping                 →  ✅ 登录成功：192.168.1.1（用户 admin）
mcp__ikuai__ikuai_status   →  CPU / 内存 / 在线终端数

ikuai_ping 结果对照：

返回	含义
✅ 登录成功：…	通了
❌ 登录失败：code=1005 账号或密码错误	用户名/密码不对
❌ 连接失败：connect ECONNREFUSED …	地址或端口不对
❌ …响应不是 JSON（地址可能不是爱快 web 管理端口）	这个端口不是爱快管理页

什么时候要重启

改的是	重启？
凭据中心里的 IKUAI_*	不用（每次调用重读，5s 缓存）
server/*.mjs 代码	重挂 MCP 子进程：能力面板把 mcp-server:ikuai 关掉再打开，或 kill server/ikuai-mcp-server.mjs（配了 reconnect 会自动拉起）
lib/index.mjs 或 cordis.patch.yml	重启 dsh web

---