爱意满满的作品展示区。
shiye515

把 Claude Code、Copilot 装进元宝: yuanbao-acp 让 AI 智能体触手可及

  •  
  •   shiye515 ·
    shiye515 · 2h 55m ago · 73 views

    一行命令,将你最喜欢的 AI 编程智能体接入腾讯元宝,支持群聊、多实例、文件收发,开箱即用。


    痛点:好工具太多,入口太散

    作为一个开发者,你可能同时在使用多个 AI 智能体:

    • Claude Code 用来做代码审查和重构
    • GitHub Copilot 用来做实时补全
    • Gemini CLI 用来做技术调研
    • Codex 用来做复杂任务规划

    每个智能体一个入口,每次切换都要打开不同的终端、输入不同的命令——工具越多,效率越低

    开发者被各种 AI 工具分散注意力,每个工具一个入口

    而如果你想在微信里用这些智能体?微信机器人的生态早就收紧了,群聊更是遥不可及的梦。

    解决方案:yuanbao-acp

    今天介绍一个我刚开源的项目——yuanbao-acp,它能把你喜欢的任意 ACP 兼容智能体桥接到腾讯元宝,让智能体在元宝里直接为你工作。

    npx -y yuanbao-acp@latest --agent copilot \
      --yuanbao-app-id YOUR_APP_ID \
      --yuanbao-app-secret YOUR_APP_SECRET
    

    就这一行命令,Copilot 就出现在元宝里了。你在元宝发消息,它在背后干活,结果直接回传给你。

    元宝消息经过桥接层到达智能体,结果回传

    为什么是元宝?

    很多人第一反应是"为什么不桥接到微信"。确实,微信的用户基数更大,但元宝有几个微信做不到的优势:

    特性 微信 元宝
    机器人加入群聊 ❌ 几乎不可能 ✅ 原生支持
    多机器人并行 ❌ 受限严格 ✅ 随意添加
    深度 AI 集成 ❌ 封闭生态 ✅ 开放 API

    简单说:微信适合触达用户,元宝适合承载智能体

    ![微信机器人无法进群聊,元宝原生支持群聊和多机器人]( https://raw.githubusercontent.com/shiye515/yuanbao-acp/main/resources/03-yuanbao-acp-微信 vs 元宝.png)

    核心能力一览

    🧠 内置 11 个智能体预设

    不用记复杂的命令行,内置了最常用的智能体预设:

    • copilot — GitHub Copilot CLI
    • claude — Anthropic Claude Code
    • gemini — Google Gemini CLI
    • qwen — 通义千问
    • codex — OpenAI Codex
    • opencode / openclaw / kiro / hermes / kimi / pi

    一条命令启动:

    npx -y yuanbao-acp@latest --agent claude
    

    💬 群聊 & 私聊双模式

    不只是私聊,智能体可以加入群聊。你的团队可以在群里 @元宝机器人,让它直接调用后端的 Claude Code 或 Copilot 做代码评审——多人协作,一人配置,全员受益。

    📁 文件收发,原生支持

    用户发送 PDF 、图片、ZIP 等文件,yuanbao-acp 会自动下载保存到本地,智能体通过文件路径直接读取。发文件给智能体,就像发给本地终端一样自然。

    🔄 多部分消息缓冲

    元宝不支持单条消息里同时发图片和文字?没关系。用 /acp-prompt-start 进入缓冲模式,随意发送文本、图片、文件,最后 /acp-prompt-done 一键合并发送。

    👤 多实例并行

    一台机器、多个元宝账号、多个项目——--instance 参数让每个实例完全隔离:

    一台机器同时驱动多个智能体,每个项目独立运行

    # 终端 1:项目 A 用 Copilot
    npx -y yuanbao-acp@latest --instance projA --agent copilot
    
    # 终端 2:项目 B 用 Claude
    npx -y yuanbao-acp@latest --instance projB --agent claude
    

    ⏰ 本地注入,自动化利器

    通过 inject 命令从 cron 任务或脚本向元宝机器人发消息,实现每日 AI 资讯推送、定时代码检查等自动化场景:

    npx yuanbao-acp inject --text "今日 AI 资讯"
    

    🎛️ 运行时配置

    不用重启,直接在元宝里通过 /acp-config 命令调整智能体的模型、模式、推理强度等参数。还支持自定义命令别名,把 /acp-cancel 改成 /取消,让非技术同事也能用。

    快速上手

    前置条件

    • Node.js 20+
    • 已安装元宝 App
    • 从元宝开放平台获取 App ID 和 App Secret

    三步启动

    # 1. 一键启动(以 Copilot 为例)
    npx -y yuanbao-acp@latest --agent copilot \
      --yuanbao-app-id YOUR_APP_ID \
      --yuanbao-app-secret YOUR_APP_SECRET
    
    # 2. 后台运行
    npx -y yuanbao-acp@latest --agent claude --daemon
    
    # 3. 自定义智能体
    npx -y yuanbao-acp@latest --agent "npx my-agent --acp" \
      --yuanbao-app-id YOUR_APP_ID \
      --yuanbao-app-secret YOUR_APP_SECRET
    

    就这么简单。不需要搭建服务器,不需要配置数据库,不需要写一行代码。

    隐私与安全

    yuanbao-acp 在设计上充分考虑了隐私:

    • 遥测可选:通过环境变量 YUANBAO_ACP_TELEMETRY=0 一键关闭
    • 数据最小化:遥测仅收集事件类型和哈希化的用户 ID ,不收集消息内容、文件名、令牌等任何敏感信息
    • 本地存储:所有配置和状态数据保存在本地 ~/.yuanbao-acp/ 目录下

    适用场景

    • 开发者个人效率:在元宝里直接用 Claude Code 做代码审查,不用切终端
    • 团队智能协作:智能体加入项目群,成员随时 @ 它做技术讨论
    • 自动化工作流:结合 cron + inject 实现定时 AI 日报、代码巡检
    • 多智能体编排:一个元宝账号驱动多个智能体,各司其职

    写在最后

    yuanbao-acp 的核心理念很简单:让智能体去用户所在的地方,而不是让用户去智能体所在的地方

    不是用户去找智能体,而是智能体主动出现在用户身边

    ACP 协议正在成为 AI 智能体的标准接口( Agent Client Protocol ),越来越多的工具开始支持它。yuanbao-acp 是这个生态中的一座桥梁——把强大的智能体能力,带到元宝这个触手可及的入口。

    项目已开源,MIT 协议,欢迎 Star 、Fork 和提 PR:

    👉 https://github.com/shiye515/yuanbao-acp


    如果你觉得这个项目有用,不妨分享给同样在用元宝的朋友。一个人的智能体是效率,一群人的智能体是生产力。

    No Comments Yet
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1051 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 54ms · UTC 18:07 · PVG 02:07 · LAX 11:07 · JFK 14:07
    ♥ Do have faith in what you're doing.