HAPI Connector for TRSS-Yunzai

把 Claude Code / Codex / Gemini / OpenCode 会话搬进聊天窗口。

这是什么

hapi_connector-plugin 是云崽 / TRSS-Yunzai 版的 HAPI 遥控器。它连接 HAPI 后端，通过 QQ/微信等聊天窗口远程查看、切换、创建和管理 AI 编码会话，并接收 SSE 实时通知。

适合这些场景：

• 离开电脑后继续推进 Claude Code / Codex 任务
• 在手机上审批工具权限请求
• 多个项目、多种代理并行运行时按聊天窗口隔离通知
• 从聊天窗口查看远端目录、搜索文件、下载/上传小文件

预览

• 示例中连接的是 Claude Code
• 支持 Markdown 图片回复

安装插件

第一次使用请先看详细教程：HAPI 安装与锅巴配置教程。

1. 克隆仓库

请在 TRSS-Yunzai 根目录执行：

git clone https://github.com/AIGC-Yunzai/hapi_connector-plugin.git ./plugins/hapi_connector-plugin

Note

如果你的网络环境较差，无法连接到 Github，可以使用 GitHub Proxy 提供的文件代理加速下载服务：

git clone https://ghfast.top/https://github.com/AIGC-Yunzai/hapi_connector-plugin.git ./plugins/hapi_connector-plugin

如果已经下载过本插件，需要修改代理加速下载服务地址，在插件根目录使用：

git remote set-url origin https://ghfast.top/https://github.com/AIGC-Yunzai/hapi_connector-plugin.git

2. 安装依赖

请在 TRSS-Yunzai 根目录执行：

pnpm install --filter=hapi_connector-plugin

插件配置

Warning

非常不建议手动修改配置文件。本插件已兼容 Guoba-plugin，请优先使用锅巴插件对配置项进行修改。

锅巴里至少填写：

hapi_endpoint: "http://127.0.0.1:3006"
access_token: "your-token"

改完连接配置后重启云崽，让 SSE 监听和运行时缓存完整生效。

必备指令

所有 HAPI 指令同时支持 /hapi 和 #hapi：

#hapi help
#hapi帮助

Important

所有 #hapi 指令仅对云崽主人权限生效，普通用户无法使用任何 HAPI 指令

常用命令

会话查看

#hapi list                 查看当前窗口可见 session
#hapi list all             查看全部 session
#hapi sw <序号|ID前缀>      切换当前 session
#hapi s                    查看当前 session 状态
#hapi msg [条数]           查看最近消息
#hapi diff                 以 Markdown 图片查看当前工作区未暂存变更

消息发送

#hapi to <序号> <内容>      发送到指定 session
> 内容                      快捷发送到当前 session
>{N} 内容                   快捷发送到第 N 个 session
> 上传附件3张 [内容]         等待 3 个附件后发送到当前 session
> {3} 上传附件5份 [内容]     等待 5 个附件后发送到第 3 个 session

Tip

快捷发送、#hapi to 支持同一条消息附带图片/视频/文件等附件，插件会先上传附件到 HAPI，再把附件引用随消息发送。> 上传附件3张 会进入等待模式，按提示继续发送附件即可。

Session 管理

#hapi machines                                  查看在线机器
#hapi create <machineId> <目录> <agent> [...]    创建 session
#hapi abort [序号|ID前缀]                        中断 session
#hapi archive                                   归档当前 session
#hapi resume [序号|ID前缀]                       恢复 inactive session
#hapi rename <新标题>                            重命名当前 session
#hapi delete [序号|ID前缀]                       删除 session
#hapi trim <数量>                               删除倒数 N 个已关闭会话
#hapi clean [路径前缀]                          删除已关闭会话（交互选择）

Tip

#hapi create 不带完整参数时会进入分步向导模式 （新手推荐）

create 的完整格式：

#hapi create <machineId> <目录> <claude|codex|gemini|opencode> [simple|worktree] [模型] [推理强度] [权限模式] [yolo]
示例：
#hapi create my-pc E:/myrepo/project codex simple yolo high
#hapi create my-pc E:/myrepo/project claude simple opus high bypassPermissions

权限审批

#hapi pending             查看待审批
#hapi a                   批准全部普通请求
#hapi approve             批准全部普通请求
#hapi allow <序号>        批准单个普通请求
#hapi as <序号>           本会话允许单个普通请求
#hapi answer <序号> <答案> 回答 question 请求
#hapi deny [序号]         拒绝全部或单个请求
戳一戳机器人              批准全部普通请求

Tip

#hapi answer 只用于回答 HAPI agent 发起的 question 请求，不会把内容当作普通聊天消息发送。普通对话请使用 #hapi to <序号> <内容> 或快捷发送。

文件操作

#hapi files [路径]        浏览远端目录
#hapi files -l [路径]     浏览目录并显示大小
#hapi find <关键词>       搜索远端文件
#hapi read <路径>         读取远端小文本文件
#hapi download <路径>     下载远端文件到聊天
#hapi upload [附件]       上传聊天附件到当前 session
#hapi upload cancel       删除当前 session 已上传 blob

模式与通知

#hapi perm [模式]         查看/切换权限模式
#hapi model [模式]        查看/切换模型
#hapi effort [值]         查看/切换推理强度
#hapi plan                切换 Plan 模式
#hapi output [级别]       查看/切换 SSE 推送级别
#hapi bind                设置当前聊天为默认通知窗口
#hapi bind status         查看路由
#hapi bind reset          清除当前窗口绑定
#hapi bind clean          清除默认通知窗口
#hapi routes              查看 session 推送路由

插件维护

#hapi更新

TODO

• 若适配器不支持发送文件，图片仍会优先以图片消息发送，普通文件会回退到 segment.file。

致谢

• astrbot_plugin_hapi_connector：参考了该插件的命令设计和 Hapi 配置帮助说明
• siliconflow-plugin：借鉴了该插件的 Markdown 渲染实现

---

🎨 让AI自己打工！✨

📚 查看插件主页 | 💬 加入交流群1 💬 加入交流群2 | ⭐ 给个Star