GitHub Hot Board

GitHub Hot Board · リポジトリアーカイブ

HUIdada1/AgentHub

①Trae/WorkBuddy/Zcode/Qoder/AutoClaw/Cline/商汤小浣熊/CatPaw等主流agent号池管家:统一签到、快捷切号、余额日历。② Skill技能库:本地扫描、智能去重、分类管理 Agent 技能,支持 WebDAV 远程同步,换机一键迁移。③ 用量记录同步:自动抓取 Trae/WorkBuddy/Qoder/Zcode/Codex/反重力等工具的 token 消耗与成本,加密存储、多端同步、结合计费规则自动算账,生成趋势图表与费用账单。④记忆中枢:可MCP链接进行记忆存储,配置模型可以进行蒸馏,多agent同步一套记忆,多设备同步记忆。 (説明はリポジトリ自身のドキュメント由来です。)

JavaScript

データ時点 October 29HUIdada1

最高順位

#136

見過ごされた宝石 · 活発なのに無名

100

累計スター

22

フォーク数

1

直近 30 日のランクイン日数

ライセンス: NOASSERTION最終 push: October 29未解決 Issue(PR 含む): 22026-10-25 から収集。不明 = 未収集

プロジェクト文書

AgentHub Logo

AgentHub —— Agent 中控台

简体中文 · English

把「技能、用量、额度、记忆、提示词、转发」六件事收进一个 Windows 桌面应用。

AgentHub 是本地运行的中控台(Electron + Vue 3 + TypeScript),自身不带模型,只把你散在各家 AI 编程工具里的东西管起来:Skill 重复安装、这个月 token 花在哪儿、订阅额度能不能给别的客户端用、Agent 记不住项目、每次开新会话都要重写同一段提示词、手里有额度却接不进自己的 IDE。这六件事对应下面六个板块。

提供 Windows 桌面版(六个板块全功能,见 Windows 版下载与安装)。原 Docker 版随「反代网关」模块停止维护已一并下线;其 API 转发能力已由新的本地网关板块以「主进程内嵌、与号池只读对接」的形态接替。

板块 一句话 适合谁
用量统计 汇总 21 个数据源的 token 用量与费用,按天 / 项目 / 模型看趋势 想知道这个月到底烧了多少的人
记忆中枢 本地 Markdown 记忆库 + MCP 服务,让 Agent 记住项目和偏好 不想每次开新会话都重新交代背景的人
提示词库 把一句话扩写成规范提示词,好用的存起来复用,另有 60 条精选目录 反复重写同一段提示词、或不知道该怎么把需求说清楚的人
号池管家 把各渠道的账号收进一个号池,集中看余额、管签到、跨设备同步 手里有多渠道订阅额度(Trae / WorkBuddy / 小浣熊 / 魔搭 / ZCode / Qoder / Cline 等 21 个渠道)、想知道余额还剩多少的人
本地网关 把号池里的账号包装成一个本地 OpenAI / Anthropic 兼容端点,改一行 base_url 就能用 想让自己的 IDE、脚本或自建服务用上号池额度的人
技能仓库 各工具的 Skill 收进一个中央库,一处维护、一键挂回 同时用 Codex / Claude Code / ZCode / Cursor 等多个工具的人

上表顺序即左栏默认导航顺序(用量统计 → 记忆中枢 → 提示词库 → 号池管家 → 本地网关 → 技能仓库), 可在「设置 · 通用」里拖拽调整;调整后本文件的板块序号不再对应导航位置,以左栏实际顺序为准。


社区和支持

  • QQ 群:110336924(QQ 里搜群号即可加入)——使用答疑与问题反馈都在这里
  • 赞赏:项目完全免费、开源,如果它帮你省下了 Token,欢迎扫码请作者喝瓶快乐水
  • 商务合作:赞助、README 产品露出、定制开发(ERP、可视化大屏、微信小程序等),加群联系作者

完整说明见 SPONSOR.md。


目录


Windows 版下载与安装

安装版

  1. 打开 Releases 页面
  2. 下载 AgentHub-Setup-x.y.z.exe
  3. 双击安装。安装过程中可以改安装目录,装完会在桌面和开始菜单创建「AgentHub」快捷方式
  4. 启动后程序常驻系统托盘,关窗口不会退出;托盘图标双击可唤回窗口,右键菜单里能暂停同步、看今日用量

系统要求

  • Windows 10 / 11(x64)
  • 不需要预装 Node、浏览器等任何依赖,运行时已打包在内
  • 部分能读到数据的工具需要本机登录过对应客户端(如用量统计要读 Codex、Trae 的本地库)

数据、更新与备份

  • 配置与多数数据存在 %APPDATA%\AgentHub,卸载程序不会删除它
  • 例外:三个「用户资产」放在用户目录下,方便你直接备份或丢进 Git——技能仓库 ~/.agent_skills(可用环境变量 AGENT_SKILLS_HOME 改)、记忆库 ~/AgentHub/memory、提示词库 ~/AgentHub/prompts
  • 自动更新:默认每小时检查一次 GitHub Releases,检测到新版本会在侧栏设置齿轮和「设置 · 通用」的更新按钮上冒红点;自动检查可在「设置 · 通用」关闭
  • 左下角「设置」= 全局项(通用 / WebDAV 同步 / 同步时间 / 数据与备份);每个板块右上角还有一个「配置」按钮,管的是这个板块自己的设置

板块一:用量统计

它解决什么问题

用量散在各家工具自己的本地库里,没人告诉你这个月一共花了多少。用量统计直接读本机客户端的数据文件,把 21 个数据源归一到同一套口径,做汇总、趋势、费用和跨设备对比。

支持的数据源(21 个)

ZCode、商汤小浣熊、Xiaomi MiMo、Codex、DeepSeek Harness、WorkBuddy、WorkBuddy AI、Reasonix、CodeBuddy、Qoder、Qoder CN、Antigravity、Antigravity IDE、Antigravity 老数据恢复、Trae、Trae CN、TRAE SOLO、TRAE SOLO CN、OpenSquilla、Grok、AutoClaw。

在「配置 · 用量统计」里可以逐个开关、指定自定义数据目录——没装过的源自动跳过,不会报错。

页面构成

页面 作用
总览 核心指标卡 + 全年热力图 + 用量趋势(当天可按小时看)+ 各电脑用量构成
用量明细 按来源/模型/项目筛选,逐条记录,可分页、可导出 CSV
费用 按模型价格折算费用;需要先在「计费规则」里配好价格
计费规则 模型价格表、远程价格源、模型别名归并(变体模型名按目标价格计费)
同步日志 每次同步的时间、窗口、条数、结果,出问题先看这里

同步节奏

  • 本机统计:每 30 分钟自动入库一次(固定,不设开关)
  • 跨设备同步:在「设置 · 同步时间」里配置,支持「每小时」或「每天定时」两种自动节奏,也可以随时手动触发
  • 没有配置 WebDAV 也能正常用:会自动进入本地模式,只统计本机数据

板块二:记忆中枢

它解决什么问题

Agent 每次开新会话都不记得你的项目背景、技术决策和踩过的坑。记忆中枢在本地维护一个 Markdown 记忆库,把会话里值得长期保留的事实沉淀下来,再通过 MCP 服务给各个 Agent 读写——你的记忆始终是本地一堆可读、可 diff 的 md 文件。

默认仓库在 ~/AgentHub/memory:projects/<项目>/l1/<agent>/<日期>.md 存原始事实,projects/<项目>/l2/... 存蒸馏出的项目汇总、决策与知识。

页面构成

页面 作用
仪表盘 记忆总量、增长趋势、各项目与 Agent 的分布
记忆浏览 列表 / 热力图 / 待确认 / 回收站四个视图;三类待人工裁决的条目在「待确认」里处理
项目归档 按项目看汇总与归类溯源,项目可重命名、合并到其他项目
深层画像 从长期记录里蒸馏出的偏好与人格画像
Agent 接入 一键给各 Agent 注入 MCP 与指令块,并做三级校验
检索与索引 全文检索(中文 bigram 分词 + 同义词扩展),索引状态与自愈
自动化 九个后台任务的开关、节奏、立即执行与运行历史
导入与去重 从各工具的历史会话导入记忆,重复内容合并
WebDAV同步 记忆库跨设备同步

怎么用

  1. 接入 Agent:进入「Agent 接入」,找到你要用的 Agent(内置 ZCode、Codex CLI、WorkBuddy、WorkBuddy AI、Claude Code、DeepSeek Harness、Trae Solo、Cursor、通用 ~/.agents),点一键注入。它会做两件事:往 Agent 配置里加一条 MCP 启动项,往它的指令文件(AGENTS.md / CLAUDE.md 等)写一段受控块——都在写前自动备份,卸载时只删自己的部分。 WorkBuddy 与 WorkBuddy AI 是两个独立产品(~/.workbuddy / ~/.workbuddy-ai),各自一张卡片、各自一份配置,别混着看
  2. 验证:卡片上的三级校验会依次确认「配置条目在不在 → 桥能不能真的拉起并列出工具 → 这个 Agent 有没有真的调用过」。只有第三级出现心跳,才说明它确实在用
  3. 导入历史:进入「导入与去重」,把已有会话历史导进来做底料(支持 Codex、ZCode、WorkBuddy / WorkBuddy AI、Qoder、Trae 系、Antigravity 等来源的会话库),导入前可以先跑干跑预览
  4. 开自动化:进入「自动化」按需打开任务。九个任务分两类:
    • 本地算法类:项目归类建议、索引自愈扫描(不耗 token)
    • 需要模型类:抽取结构化信息、生成摘要、自动打标签、失效判定、L2 蒸馏、去重合并、人格/偏好画像
  5. 给记忆任务配模型:在记忆中枢的配置页选择模型来源——填自己的 OpenAI 兼容 API(Key 存本机、界面只显掩码),并配置失败时的降级链

待确认收件箱

自动化跑完后,有三类结论不会直接生效,而是排队等你确认:事实失效判定(新事实是否覆盖旧事实)、项目归类建议、去重合并建议。它们收在「记忆浏览 → 待确认」里,逐条采用或驳回;每条都带推荐建议,也可以按推荐一键全部确认。


板块三:提示词库

它解决什么问题

同一段提示词,你在每个新会话里都要重写一遍;想说「帮我写个周报」,又不知道该怎么补才够清楚。提示词库把这件事拆成三步:让模型替你扩写(优化提示词)、好用的存起来复用(个人库)、直接拿现成的(线上目录)。

页面构成

页面 作用
优化提示词 上框原文、下框结果;6 套内置风格 + 「补充要求」+ 角度引导;边生成边显示
优化历史 最近 50 次优化的原文 / 结果 / 耗时 / 用量,可一键回填重跑
个人提示词库 分类树、标签、收藏、版本历史、回收站、导入导出、全文搜索
线上提示词库 内置 60 条精选 + 10 套模板,可检查更新,也可导入自己的数据集
WebDAV 同步 提示词库跨设备同步,冲突可逐条裁决

6 套内置优化风格

风格 什么时候用
通用增强 默认。补上下文、明约束、结构化,保持语言一致
多角度补全 原话很短、信息量不足时用(如「帮我写个周报」)。先按 9 个角度扫描缺口,再用合理假设补齐,最后按规范骨架输出
更简洁 只做减法:删冗余、去重复、压缩表达,不新增要求
更结构化 强制分层:目标 / 输入 / 约束 / 输出格式 / 验收标准
补全约束 重点补边界条件、禁止项与可判定的验收标准
面向编码任务 目标场景预设为编码助手:补技术上下文与可验收的完成条件

「多角度补全」的两个关键设计:

  • 不编事实:人名、机构、数字、日期、金额、型号一律留成 {{变量}},不替用户瞎猜
  • 假设看得见:模型替你做的假设(最多 3 条)单独列在结果下方,每条都写「若不成立会变成什么样」;选中正文里的对应文字点「→ 变量」,就能把它变成可填写的变量

三个值得一试的细节

  1. 补充要求:想加一句「面向不懂技术的老板」,写在原文框下面的「补充要求」里就行,不用改原文。改原文会污染这条提示词的「血缘」,而且想再来一版不同要求的还得改回去
  2. 流式输出:边生成边显示,旁边带已用时。上游不支持流式会自动回退成一次性返回(只慢那一次,之后记住这个供应商);读流中途卡住超过 20 秒会自动中断,不会无限转圈
  3. 假设可接管:多角度补全给出的假设逐条列出,把「模型替你猜的」变成「你填一次就固化」

线上提示词库

  • 内置 60 条(写作 / 编程 / 分析 / 办公 / 图像 / 角色 / 学习 / 生活 8 个分类)+ 10 套模板。模板给的是方法论:什么时候用、怎么做、容易踩的坑,不只是丢一段文本给你
  • 断网可用:目录内置在安装包里,首启就有内容;联网后可「检查更新」增量拉取新版,只下变更的分片
  • 收录不覆盖你的改动:收入个人库后来源记为「线上」,目录以后更新时卡片会显示「有更新」,但不会自动覆盖你改过的内容
  • 可导入自己的数据集:支持 {items:[...]} / {prompts:[...]} / 裸数组三种格式。导入的条目只存在你本机,版权与合规由你负责

数据放在哪

内容 位置 参与同步
提示词库(一条一个 .md) ~/AgentHub/prompts 是(WebDAV)
优化历史(最近 50 次) %APPDATA%\AgentHub\prompts\history.json 否,本机留痕
优化风格(含自定义) %APPDATA%\AgentHub\prompts\styles.json 否,本机偏好
线上目录缓存 %APPDATA%\AgentHub\prompts\catalog 否,应用资产

怎么用

  1. 打开「优化提示词」,把想改的那句话粘进去。信息很少就选「多角度补全」,已经比较完整就选「通用增强」
  2. 有额外要求写在「补充要求」里,不用动原文;不知道还缺什么,就点下面的角度 chip(受众 / 场景 / 格式 / 边界 / 示例 / 验收)
  3. 跑完看结果,不满意点「重新优化」或直接在下框手改;改过之后再点「重新优化」会先问一次,不会默默覆盖你的修改
  4. 满意的点「保存到我的库」,正文里的 {{变量}} 会被自动识别成变量
  5. 想直接拿现成的,去「线上提示词库」按分类翻,或者用左栏「按变量找」——从「我手上有什么材料」反查模板
  6. 多台电脑:先在「设置 · WebDAV 同步」填好服务器,再到「WebDAV 同步」页跑一次

板块四:号池管家

原「反代网关」模块已停止维护,改造为「号池管家」:保留号池账号、余额、签到与跨设备同步;其 API 转发能力已由新的板块五:本地网关接替(主进程内嵌、与号池只读对接)。维护策略调整说明见本节末尾。

它解决什么问题

订阅额度散在十几个客户端里:这个号还剩多少、哪天到期、今天签到没有、换台电脑还得重新登一遍。号池管家把这些账号收进一个本地号池,集中看余额、管签到、跨设备同步,凭据经 DPAPI 加密落盘。

页面构成

页面 作用
总览 各渠道余额聚合、账号可用性、即将到期提醒、最近动态
号池 按渠道管理账号:状态、余额、套餐到期、策略、添加账号、一键签到、切到 IDE
积分日历 把所有渠道所有账号的积分包拉平,按到期升序统一呈现;默认只列有余额的包
号池同步 多台电脑共享号池:账号与凭据打包经 WebDAV 同步,可选只同步某一个渠道
日志 号池操作日志:按时间 / 等级 / 类型筛选,可导出 Excel

支持的渠道

渠道 对应订阅 登录形态 签到
Trae SOLO CN Trae SOLO 国内版 官方授权页 + 本机回环回调 每日签到
WorkBuddy CN WorkBuddy 国内版 官方登录页 + 本机轮询 每日签到
WorkBuddy AI WorkBuddy 国际版 官方登录页 + 本机轮询 一次性加油包
商汤小浣熊 商汤小浣熊 应用内授权窗截获(不经过系统浏览器) 每日签到
ModelScope(魔搭) 魔搭免费推理额度(魔粒) OAuth 授权页(应用自动注册)+ 粘贴 ms- 令牌兜底(无需安装客户端) 每日任务(登录 / 绑云;点赞不再自动代点)
LobsterAI(有道) 网易有道龙虾 官方登录页 + 本机回环回调(无需安装客户端) 每日签到 100 积分
ZCode(智谱) Z.ai GLM 编码套餐 Z.ai 授权页 + 本机轮询 领取奖励
CatPaw(美团) CatPaw 桌面端会话额度 从本机 CatPaw 客户端登录态导入(实时读取,无需重新登录) 无签到活动
Qoder CN Qoder 国内版 官方登录页设备码轮询(无需本机客户端)/ 从本机软件导入 每日领 Credits
Qoder International Qoder 国际版 同上 每日领 Credits
AutoClaw 国内版 智谱 AutoGLM 加速站 手机验证码登录 / 从本机 AutoClaw 客户端导入 每日签到领积分
AutoClaw 国际版 AutoGLM 国际站 OAuth 授权登录(含风控验证)/ 从本机导入 每日签到领积分
Cline Free Cline 免费额度池 WorkOS 设备授权(浏览器确认,无需安装客户端)/ 从本机 Cline 客户端导入 / 粘贴凭据 无签到活动
Cline Pass ClinePass 订阅池 同上(同一份 Cline 登录态可在两个渠道各导入一次) 无签到活动
Accio 阿里 Accio 国际版 OAuth 授权页 + 本机回环回调(无需安装客户端) 未核实
Accio 国内版 阿里 Accio 国内站 同上(两区账号与额度互不相通) 未核实
CodeArts(华为云) 华为云 AI 代码助手 华为云授权页登录(临时凭据自动续期) 每日登录领福利
Loomy(讯飞) 讯飞 Loomy 手机验证码登录(登录态不在可读文件里,故无本机导入) 每日首次登录刷赠送积分
KukuAI(百度文库) 库库 AI(GenFlowPro)免费额度 粘贴登录态 Cookie(需含 BDUSS / STOKEN / PTOKEN,上游没有续期接口) 每日任务领积分
MonkeyCode 国内版 长亭 MonkeyCode 在线托管版 粘贴 session cookie(30 天有效、上游没有续期接口;镜像 id 可自动发现) 无签到活动
MonkeyCode 国际版 MonkeyCode 国际站 同上(两站账号与额度互不相通,各自成渠道) 无签到活动

各渠道的号池、签到、策略完全独立,互不影响:在号池页顶部切换渠道,下方整块区域只显示当前渠道的账号。

Qoder 渠道说明:每日 Credits 按钮每天可领 100(10:00 UTC+8 刷新,领取后 30 天有效,重复点击按「今日已领」处理)。领取接口要求客户端自带的风控身份,故需要本机安装对应客户端。

怎么用

往号池里加账号

进入「号池管家 · 号池」,先在顶部选中渠道,再点添加账号。每个渠道都支持四种添加方式,挑一种就行:

  1. OAuth 登录(最推荐)——跳转官方授权页登录,登录完成后自动入池,全程不用手工填任何 token:
    • Trae SOLO CN:授权后会回调本机回环地址;万一浏览器停在回调页没自动跳回,把地址栏内容整段粘到输入框兜底
    • WorkBuddy 两个版本:登录完本机自动轮询结果,无需任何粘贴
    • 商汤小浣熊:授权窗在 AgentHub 应用内弹出,授权码由应用直接截获;被拦截时可粘贴 office-raccoon://auth/callback?code=… 兜底
    • ZCode:跳 Z.ai 授权页,登录后自动入池;随后后台会用几十秒初始化套餐
    • Qoder 两个版本:跳官方登录页(qoder.cn / qoder.com)完成登录,本机每秒轮询直接取回设备凭据对,无需本机安装客户端、也不用粘贴回调
    • LobsterAI(有道龙虾):跳官方登录页(lobsterai.youdao.com)登录,回调本机回环地址自动入池,无需安装客户端
    • Cline 双渠道:跳 WorkOS 设备授权页(已带用户码,点一次确认即可)完成登录,本机自动轮询入池,无需安装客户端、不占用本地回调端口
    • 每次登录对应一个账号,想加几个号就重复几次
  2. 从本机软件导入 —— 直接扫描本机已登录客户端的凭据,零请求入池,最省事(Qoder 走的也是这条)
  3. 从 JSON / ZIP 文件 —— 批量导入别人给你的账号文件
  4. 粘贴 JSON —— 手动粘贴单条或一组凭据

账号加进来后,号池列表里能看到它的余额、套餐到期时间和状态(online / cooling / exhausted / relogin / disabled)。想主动养护账号,点该渠道的一键签到(或领加油包,Qoder 是「领 Credits」);也可以打开定时自动签到,每天到点自动跑全渠道。

看余额与到期

「总览」页按渠道列出余额、可用账号数与最早到期时间;「积分日历」把逐包明细按到期升序铺开,快过期的排在最前。额度刷新周期与「即将到期」预警阈值都在「配置 · 号池管家」里改,保存即生效。

切到本机 IDE(可选)

号池里每个账号都有一个「切到 IDE」按钮:把该账号写成本机客户端的当前登录态,适合「号池里的号想直接在本机客户端里用」。

  • 支持 WorkBuddy 双区、商汤小浣熊、ZCode。Trae 不支持——它的登录态是绑定设备密钥的加密信封,构造不出合法文件,程序会直接说明原因,不会硬写
  • 点击后会弹确认框,确认即自动:关闭客户端 → 备份原登录态 → 写入 → 重新打开客户端
  • 写入前后有多道校验(防并发回写、写后回读校验失败自动回滚);ZCode 采用合并式写回,不会动你的远程连接地址;小浣熊会保留账号专属设备指纹,避免跨号串号导致旧号被吊销

合规边界:只做账号管理

号池的定位是「管理你自己的账号」,不做「替账号制造行为」的事。落到开关上:

  • 登录 / 导入后不自动签到(默认关):加账号只把账号存进号池,不在服务商侧产生任何记录;要自动签到请在「配置 · 号池管家」里显式打开。号池页的手动「签到」照常可用。
  • 额度轮询可单独关闭(默认开,周期下限 15 分钟):额度查询是主动出站请求,可在「配置 · 号池管家」里关掉,只留手动刷新。
  • 不做资格规避:跨账号借用设备指纹以绕过「一设备一周一次」这类领取限制的能力不提供;号池里的「指纹修复」只把撞车的账号各自恢复为它自己的稳定指纹,不涉及跨账号借用。

多台电脑共享号池

「号池同步」页把账号与凭据打包(用统一 WebDAV 密码 AES-256-GCM 加密)传到 WebDAV,另一台电脑拉下来即可共用同一批号。可以选择同步全部渠道,也可以只同步某一个渠道;进度按阶段展示,中途可看细节。

与原「反代网关」的差异

已下线(代码归档、不再维护):旧的反代网关进程与其外置插件形态、Docker 版与远程实例、自定义提供商、CC Switch 生态接入、网络代理(出口池)、规则热加载。

保留:号池账号管理、余额查询、积分签到、号池同步、操作日志、IDE 切号。

接替:API 转发(OpenAI / Anthropic 两条协议面)、API Keys、模型目录、网关请求统计,由新的板块五:本地网关以「主进程内嵌、与号池只读对接」的形态重新实现——不再有独立网关进程,也不再有 Docker 形态。

维护策略调整说明

关于「反代网关」模块维护策略调整的说明

经评估,本项目「反代网关」模块将转入停止维护状态,后期修改为「号池管家」模块。

维护范围:不再进行该模块的功能开发与代码更新,不再跟进各渠道上游的协议调整与风控策略变化,亦不再受理相关新增 issue 与 PR。

调整原因:本项目为个人自用工具,不具备长期投入协议适配与风控对抗的持续维护能力;受上游策略更新频率影响,反代通道的稳定性与可用周期已不具备可控性,继续投入适配工作的实际价值有限。

仓库现状:仓库保持现有可用状态,已合入的修复内容不作回退。

风险提示:敬请使用者自行评估使用风险。受上游策略影响,该功能存在随时不可用的可能;因使用非官方客户端而产生的账号风控、限制或封禁等后果,由使用者自行承担。


板块五:本地网关

它解决什么问题

号池里已经躺着一堆渠道账号,但你的 IDE、脚本或自建服务要调用模型时,还是得逐个去翻渠道的登录态、拼各自的请求格式。本地网关把号池已配置的账号包装成一个本地 OpenAI / Anthropic 兼容端点:把 base_url 指到 http://127.0.0.1:9527/v1,其余照旧。

它不新建账号体系——账号的唯一事实源仍然是「号池管家」,本地网关只读复用。

页面构成

页面 作用
总览 运行状态、今日请求 / tokens / 成功率 / 平均延迟、渠道在线一览、实时请求流、快速上手三步
服务与密钥 生成 / 吊销 / 改名 API Key;按调用方命名,可圈定可访问渠道、并发与每分钟上限、到期时间
模型目录 合并各渠道模型,支持别名与覆盖(把上游真实模型名映射成你想对外暴露的名字)、自定义模型;可控制是否在 /v1/models 中暴露
用量统计 今日 / 近 7 天 / 近 30 天 / 自定义区间的 KPI、趋势、渠道与状态分布、模型排行与明细,并按保留期清理
路由与渠道 策略(智能 / 固定 / 轮询 / 评分)、故障转移与冷却退避、渠道启停、单渠道连通性测试
自定义提供商 自建上游供应商(地址 / Key / 模型清单 / 额外头与体),从上游拉取模型并做「新增 / 已存在 / 下架」三态合并
生态接入 把 Claude Code / Codex CLI / Claude Desktop 一键指向本网关;区分「路由(库里的接管开关)」与「链路(客户端实际指向)」
网络代理 出网出口池(直连 / 固定 / 轮询)与出口连通性测试;同页另有「出站伪装」栏
请求日志 按时间倒序,按渠道 / 状态筛选,可导出 JSONL 或 CSV;「敏」列标出被脱敏改写的请求
接入与文档 本地监听地址、curl 示例、IDE 配置一键复制

右上角「配置」打开配置页,分五个二级 tab:监听与安全 / 性能与限流 / 模块联动 / 扩展点 / 出站伪装。其中「出站伪装」与「网络代理」页的同一栏读写同一份配置,改哪边都一样。

对外端点

方法 路径 说明
GET /health 探活,不需要鉴权(只回运行态与端口)
GET /v1/models OpenAI 风格模型目录
POST /v1/chat/completions OpenAI 对话补全,支持流式(SSE)
POST /v1/messages Anthropic Messages,支持流式;入向字段翻译 + 出向 SSE 帧映射
GET /v1/anthropic/models 兼容占位(Anthropic 无此端点,返回空目录)

鉴权支持 Authorization: Bearer <key> 与 Anthropic 的 x-api-key 两种头。

几个关键设计

  • 凭据不出进程:上游凭据只从号池 vault 内取,不写进网关配置文件、不进日志
  • 号池停用即熔断:选号前先过号池的在线判定,号池侧停用的账号在网关侧一并不可用
  • API Key 不明文落库:库里只存 HMAC-SHA256(raw + 内部密钥) 与展示前缀,完整 Key 只在创建响应里出现一次
  • 端口冲突自愈:9527 被占时自动往后探 9528 ~ 9530,界面显示的是实际生效端口
  • 默认不自启、默认只听回环:装了不等于对外开端口;autostart 默认关,bind 默认 127.0.0.1
  • 出站伪装与清洗(每个渠道一份策略):上游对请求体是逐字精确匹配审核的(不是语义审核),且各家官方客户端都有固定的请求形态。配置页的「出站伪装」给每个上游渠道一份独立策略,另有全局默认供未配置渠道继承:
    • 出站模式:伪装(按策略改写出站请求)或 全透传(头与 body 原样发出)。自定义供应商渠道默认透传——对端不是官方 agent 后端,没有可伪装的风控指纹
    • 模拟档案:内置 Claude Code / Codex CLI / Cursor / Gemini CLI 等官方客户端的请求形态(UA 与形态头),也可自建档案。只伪装请求形态,不代理、不启动任何 agent 软件
    • 请求头覆盖 / 移除:按渠道增删改出站头(换 UA、去掉客户端自报字段等),不碰鉴权头
    • 关键词清洗与文案替换:按消息角色(system / user / assistant / tool)圈定作用域,逐字或正则替换;内置指纹脱敏(表头键值、cc_* 计费字段名、official CLI for Claude 这类模板句、裸错误码 11128)是其中一组内置规则,默认开
    • 只改发给上游的副本:客户端看到的响应不变;命中的请求在请求日志的「敏」列打标,悬停可看命中了哪几条规则
    • 可试跑:填一段样例文本点「试跑」,直接看清洗前后的差异与命中明细,全程不打上游
  • 出站链路零回归:号池自身的请求不带出站上下文,策略只作用于网关转发出去的请求;把渠道切回透传或清空策略即为原行为
  • 停用板块即停服务:模块开关关掉会立刻 close 掉监听并释放连接,不留后台监听

数据放在哪

内容 位置 参与同步
API Key(HMAC + 前缀) %APPDATA%\AgentHub\proxy\stats.db 的 localgw_keys 表 否(与号池同库、同备份)
请求流水 同库 localgw_logs 表,按 logRetentionDays 定期清理 否
网关配置 %APPDATA%\AgentHub\config.json 的 localgw 段 否

怎么用

  1. 先去「号池管家」把至少一个渠道账号加进号池(网关的账号来自这里,没有账号时总览会显示三步引导)
  2. 回「本地网关 → 总览」点「启动」,状态徽标变成「运行中 · 9527」
  3. 到「服务与密钥」创建第一个 API Key——页面只显示这一次,请立即复制保存
  4. 到「接入与文档」抄 curl 示例或 IDE 配置,把 base_url 指到 http://127.0.0.1:9527/v1,Key 填上一步的 sk-lgw-...
  5. 想看哪个渠道慢,去「请求日志」按渠道筛,或看总览里的 P95 延迟

板块六:技能仓库

它解决什么问题

同一个 Skill 你在 Codex、Claude Code、ZCode、Cursor 里各装了一份,改一处忘三处。技能仓库把所有工具的 Skill 目录收进一个中央仓库,再挂载回各工具:以后只在中央库维护,一处更新,处处生效。

页面构成

页面 作用
仪表盘 中央库与各工具连接状态总览:收了多少技能、挂载是否健康、有没有孤儿目录
中央技能库 技能列表与详情,逐条查看/收纳/挂载,挂载失效时可一键修复
去重与冲突 同一技能在不同工具里内容不一致时列出差异,人工裁决保留哪份;工具目录里的链接指向别处时,决定链接该指向谁
同步中心 扫描预览 → 确认执行 → 查看报告,一次把「收什么、挂什么、有什么要裁决」讲清楚
WebDAV 同步 中央仓库跨设备同步(服务器地址在「设置 · WebDAV 同步」里配)

怎么用

  1. 打开「技能仓库 · 仪表盘」,确认工具列表里检测到了你的工具(ZCode / Codex / Claude Code / Antigravity / 通用 ~/.agents 为内置,其他工具会按本机目录自动建议添加)
  2. 进入「同步中心」,先点扫描看看这次会收哪些技能、往哪些工具挂——预览不写任何文件,看清楚再执行
  3. 点执行。技能会以软链接(junction)的方式从中央仓库挂回各工具,几乎不占额外空间
  4. 日常在某处新增/修改了技能,回「同步中心」再跑一次即可;出现冲突会进入「去重与冲突」页面等你裁决
  5. 多台电脑:在「设置 · WebDAV 同步」填好服务器,然后在「WebDAV 同步」页跑一次,中央仓库就同步过去了

常见问题

Q:为什么 Trae 不能「切到 IDE」? Trae 的本地登录态是 ByteCrypto 加密信封,绑定了设备密钥,无法在外部构造出合法文件。程序会诚实提示而不是写坏你的登录态。

Q:小浣熊多账号要注意什么? 多账号入池请统一在 AgentHub 的「OAuth 登录」里做。不要在电脑端小浣熊软件里点「退出登录」——商汤服务端会因此吊销旧号凭证,导致号池里的旧账号失效。

Q:号池用 WebDAV 同步到第二台电脑后,小浣熊账号显示「需重登」怎么办? 不用重新登录,先让它自己缓过来:小浣熊的刷新令牌是一次性轮换的(第一台每刷一次,同步过去的那份就会作废),v1.68.1 起刷新被服务端拒绝时会自动到其他设备把最新凭据取回来重试,第一台下次刷新也会立刻回传,所以保持两台都开着、网络与 WebDAV 正常,等一轮额度刷新(默认 30 分钟)即可。同一账号请只在 AgentHub 里登录一次:不要在第二台电脑上用 OAuth 或客户端再登录同一个号——那会产生第二个会话(服务端按会话互踢),连第一台也会一起掉。真掉登录时账号气泡会说明原因(服务端拒绝 / 并发抢刷 / 疑似在别处重新登录)。

Q:点「切到 IDE」会不会打断我正在用的客户端? 会:程序需要先关闭对应客户端,写入登录态后再自动打开(这也是为什么每次都会先弹一个确认框)。如果你此刻正在那个客户端里干活,先存盘再点。

Q:我的凭据安全吗? 账号 token 经 Windows DPAPI 加密后落盘,且只在主进程中流转,不暴露给界面层。所有请求只发往你所用服务的官方接口,以及你自己配置的 WebDAV 服务器,中途不经过任何第三方服务器。

Q:没配置 WebDAV 是不是很多功能不能用? 不是。用量统计会自动进入本地模式;技能仓库、号池管家、记忆中枢、提示词库的单机功能全部可用,WebDAV 只是「多台电脑共享」用的。

Q:自动签到什么时候跑? 默认关闭。开启后每天到设定时间(默认 09:00,可改)自动给全部渠道跑一遍签到/领加油包,结果按渠道分别记录,切渠道看得到各自的历史。

Q:优化提示词时一直转圈怎么办? 先看「设置 · 模型与网关」里有没有可用模型(没配会直接提示并给跳转入口),再看「高级」里的超时设置。流式读取时如果上游超过 20 秒不吐新内容会自动中断并说明原因,不会无限转下去。反代环境如果反复失败,可以在「配置 · 优化偏好」里关掉「流式输出」,省掉那次失败往返。

Q:线上提示词库里的条目能直接商用吗? 内置的 60 条与 10 套模板是自建内容,许可写在详情页的「来源与许可」里。你自己导入的数据集(别人的开源提示词库等)版权与合规由你负责——程序只做本地加载,不打包、不分发。


开发与自测

# 环境:Node >= 18
npm install

npm run dev          # 桌面端开发(Electron + Vite HMR)
npm run dev:web      # 纯浏览器预览 UI(mock 数据,不启动 Electron)
npm run build        # 类型检查 + 前端构建
npm run electron:build   # 打包安装版到 release/

回归自测总闸(纯 Node,不联网、不碰真实数据;scripts/ 下全部 test-*.cjs + tools/ 的 cockpit 兼容契约自测,任一失败即以非零码退出):

npm test

Qoder 渠道专项自测(离线,默认不联网、不消耗额度;凭据与签名器相关断言需要本机装有 Qoder 客户端):

ELECTRON_RUN_AS_NODE=1 node_modules/electron/dist/electron.exe tools/proxy-qoder-adapter-selftest.cjs      # 适配器纯函数 + SSE 信封解包
ELECTRON_RUN_AS_NODE=1 node_modules/electron/dist/electron.exe tools/proxy-qoder-integration-selftest.cjs  # 每日领取(stub)+ 记忆中枢适配器
ELECTRON_RUN_AS_NODE=1 node_modules/electron/dist/electron.exe tools/proxy-qoder-selftest.cjs              # 凭据解密 + wasm 签名器

Cline 双渠道专项自测(离线 + 本地假上游,不联网、不消耗额度):

ELECTRON_RUN_AS_NODE=1 node_modules/electron/dist/electron.exe tools/proxy-cline-selftest.cjs   # 协议断言 + 假上游端到端

技能仓库自测(纯 Node,只在临时目录里造现场,不碰真实 home / 不联网):

node scripts/test-skills-diff-link.cjs    # 链接指向异常:现场识别 + relink / adopt 两个动词 + 裁决后不复发

记忆中枢验证入口:

npm run verify:memory                                             # 静态校验:IPC 管道 / 配置分档 / 术语 / 导航 / 结构
node tools/memory-runtime-path-selftest.cjs                       # 桥的 runtime 定位:各平台目录布局 + 大小写 + 离线报错

提示词库自测(纯 Node,不联网、不写真实数据:目录测试会用临时目录替掉 dataDir):

node tools/prompts-smoke.cjs    # 内置风格 / {extra} 渲染 / <ASSUMPTIONS> 剥离 / 三格式 SSE 解码 / 本地假上游端到端(含回退与取消) / 线上目录 / IPC 通道一致性

代码结构:

electron/            主进程
  backend/
    adapter-*.cjs    各用量数据源适配器
    proxy/           号池管家(存储 / 渠道适配 / 号池 / 签到 / 号池同步 / IDE 切换)
    memory/          记忆中枢(存储 / 索引 / 检索 / 接入 / 自动化 / 导入)
    prompts/         提示词库(存储 / 风格 / 优化 / 历史 / 同步 / 线上目录)
    localgw/         本地网关(HTTP 服务 / 鉴权 / 渠道路由 / 模型目录 / 请求流水 / 转发委托)
  main.cjs           应用入口(窗口 / 托盘 / 更新 / 各板块接线)
resources/catalog/   线上提示词库的内置目录(随安装包分发,8 个分类分片 + 索引)
src/                 渲染层(Vue 3)
  views/             六大板块的页面
  components/        公共组件(侧栏 / 页签 / 配置中心)

各渠道的接入细节来自对官方客户端的逆向分析,代码独立实现。


使用声明

请在使用本项目前完整阅读本节。下载、安装、启动或以任何方式使用本项目,即视为你已阅读、理解并全部接受以下条款。

一、仅供学习与交流

本项目是一个用于学习 本地凭据管理、多上游账号与额度聚合、HTTP 反向代理与 SSE 流式透传、OpenAI / Anthropic 协议适配、跨工具技能目录管理与 Electron 桌面端打包等技术主题的实践项目,仅供个人学习与研究使用,不是任何公司的官方产品。

本项目与下列公司及其产品均无任何关联,未获得其授权、认可、赞助或背书:

腾讯及 WorkBuddy / CodeBuddy、字节跳动及 Trae / TRAE SOLO、商汤科技及小浣熊、智谱及 ZCode / AutoClaw / AutoGLM、美团及 CatPaw、阿里巴巴及 Qoder / ModelScope(魔搭)/ Accio、华为云及 CodeArts、科大讯飞及 Loomy、网易有道及 LobsterAI、小米及 MiMo、DeepSeek 及 DeepSeek Harness、OpenAI 及 Codex、Google 及 Antigravity、Cline,以及其他文中提及的服务提供方。

文中出现的所有产品名、商标、服务名、协议名均归其各自所有者,仅用于标识与说明用途,不构成任何形式的关联或授权。

二、关于第三方账号与平台规则

本项目(号池管家)会在你自己的机器上复用你自己账号的登录态,用于余额查询、签到与号池管理等本地操作。它不破解、不绕过任何付费或权限校验,读取到的额度始终来自你自己账号本就拥有的配额。

「本地网关」(板块五)在此之上增加一层本机回环的 API 转发:它把你自己账号的额度以 OpenAI / Anthropic 兼容协议暴露在 127.0.0.1 上,默认不自启、默认只听回环地址,凭据不出本机进程。旧「反代网关」的独立进程与 Docker 形态已停止维护并移除,其能力由本地网关接替;本地网关同样不再跟进上游协议与风控策略变化,可用性不承诺。

但需要明确的是,这种「以非官方客户端形态复用登录态」的做法,可能不符合上游服务的用户协议或使用条款;是否使用、以及由此产生的一切后果(包括但不限于账号被限流、被风控、被降权、被冻结或封禁,订阅被终止,积分/额度被清零),均由使用者自行承担,作者不承担任何责任。

作者未逐家取回并核对各平台的条款原文,本项目中关于「是否符合平台规则」的表述均为基于行为形态的推断,不构成法律意见;请在使用前自行阅读并遵守你所用服务的条款。

三、禁止用途

禁止将本项目用于:

  • 任何商业用途、二次分发牟利、以本项目为载体售卖账号或额度
  • 批量账号运营、账号买卖、代刷代领、养号
  • 绕过上游计费、配额、风控或权限限制
  • 攻击、爬取、扫描或干扰任何服务的正常运行
  • 其他违反当地法律法规或上游服务条款的活动

上述禁止事项同时写入 LICENSE 第二部分的「附加使用条款」,构成本项目授权与使用约定的一部分,不是仅作呼吁。

如需在生产环境或商业场景中调用相关模型服务,请使用官方渠道与官方 API。

四、凭证与数据风险

本项目需要读写本机已登录客户端的账号凭据(accessToken / refreshToken 等)与本地数据文件:

  • 凭据在本机经 Windows DPAPI 加密后落盘;号池同步生成的加密包与本机备份包含可还原的凭据,请自行妥善保管。号池页「导出选中账号」仅导出元数据(不含 token),不要误当成凭据文件
  • 切勿将导出的凭据文件提交到公开仓库、上传到网盘、发送到聊天群或分享给他人
  • 若将服务绑定到 0.0.0.0(供局域网访问),同网段设备均可访问,请自行评估风险并设置 Key 的日配额与限速
  • 「切到 IDE」会关闭并重新写入本机客户端登录态,操作前请自行保存工作内容
  • 因凭证泄露、设备被他人使用、配置不当或误操作造成的任何损失,由使用者自行承担,作者不承担任何责任
  • 卸载程序不会删除 %APPDATA%\AgentHub,如需彻底清除请自行删除该目录

五、无担保与权利通知

本项目按「现状」(AS IS)提供,作者不对其可用性、稳定性、安全性、合法性、准确性或对特定用途的适用性作任何明示或默示的承诺与保证。

  • 上游接口、鉴权方式、协议字段随时可能变更,本项目可能随时失效且不再维护,作者无更新、修复或答疑的义务
  • 使用本项目造成的任何直接或间接损失(包括但不限于账号损失、额度损失、数据丢失、业务中断、第三方索赔、监管处罚),作者一概不承担任何责任
  • 本项目中的接口形态、协议字段等信息来自对各官方客户端公开网络通信的观察与整理,仅用于学习研究;相关商标与服务的权利归其各自所有者
  • 若权利方认为本项目存在不当之处,请联系作者,将及时调整或删除

完整条款见 LICENSE。 若你不同意本节任何一条,请立即停止使用并删除本项目及其相关数据。

作者

沐晖(GitHub: @HUIdada1)

License

本项目采用 MIT License + 附加使用条款 的复合授权,不是纯粹的 MIT 项目:

部分 内容
第一部分 · MIT License 授予软件层面的使用、复制、修改、合并、发布、分发、再许可与销售权利
第二部分 · 附加使用条款 对本项目的使用场景作进一步限制:禁止商业用途、禁止二次分发牟利、禁止批量账号运营、禁止绕过上游计费与配额、禁止攻击与干扰、禁止违法用途

两部分不可分割,共同构成本项目完整的授权与使用约定;仅接受其中一部分者,不得以任何形式使用、复制、修改或分发本项目。附加条款与上文使用声明第三节「禁止用途」一致,如表述有出入以 LICENSE 为准。

商业场景使用须事先联系作者另行取得书面授权。完整条款(含 MIT 全文)见 LICENSE。

Copyright (c) 2026 沐晖 (HUIdada1)


声明(完整版)

本节是使用本项目的完整声明,与上文《使用声明》一致;如有出入,以 LICENSE 为准。

仅供学习与交流

本项目是一个用于学习 本地凭据管理、多上游账号与额度聚合、HTTP 反向代理与 SSE 流式透传、OpenAI / Anthropic 协议适配、跨工具技能目录管理与 Electron 桌面端打包 等技术主题的实践项目,仅供个人学习与研究使用。它不是官方产品,与下列公司及其产品均无任何关联,未获得其授权、认可或赞助:

腾讯及 WorkBuddy / CodeBuddy,字节跳动及 Trae / TRAE SOLO,商汤科技及小浣熊,智谱及 ZCode / AutoClaw / AutoGLM,美团及 CatPaw,阿里巴巴及 Qoder / ModelScope(魔搭)/ Accio,华为云及 CodeArts,科大讯飞及 Loomy,网易有道及 LobsterAI,小米及 MiMo,DeepSeek 及 DeepSeek Harness,OpenAI 及 Codex,Google 及 Antigravity,Cline,以及其他在文档、代码或界面中提及的服务提供方。

文中出现的所有产品名、商标、服务名、协议名均归其各自所有者,仅用于标识与说明用途。

关于反向代理行为

本项目实现的是本地反向代理:「号池管家」在你自己的机器上复用你自己账号的登录态,用于余额查询、签到与账号管理;「本地网关」在此基础上把这份额度以 OpenAI / Anthropic 兼容协议暴露在 127.0.0.1 上(默认不自启、默认只听回环、凭据不出本机进程),把请求转发到官方上游网关。

它不破解、不绕过任何付费或权限校验,使用的额度始终来自你自己账号本就拥有的配额。但需要明确的是,这种「以非官方客户端形态复用登录态」的转发方式,可能不符合上游服务的用户协议或使用条款;是否使用、由此产生的一切后果(包括但不限于账号被限流、被风控、被降权、被冻结或封禁,订阅被终止,积分/额度被清零),均由使用者自行承担,作者不承担任何责任。

禁止用途

禁止将本项目用于任何商业用途、二次分发牟利、以本项目为载体售卖账号或额度、批量账号运营、代刷代领、养号、绕过上游计费或配额限制、攻击或干扰任何服务的正常运行,以及其他违反当地法律法规或上游服务条款的活动。

如需在生产环境或商业场景中调用相关模型服务,请使用官方渠道与官方 API。

无担保与权利通知

本项目按「现状」(AS IS)提供,作者不对其可用性、稳定性、安全性或对特定用途的适用性作任何承诺。上游接口随时可能变更,本项目可能随时失效而不再维护。

本项目中的接口形态、协议字段等信息来自对各官方客户端公开网络通信的观察与整理,仅用于学习与研究;相关商标与服务的权利归其各自所有者。若权利方认为本项目存在不当之处,请联系作者,将及时调整或删除。

完整条款见 LICENSE。 若你不同意本节任何一条,请立即停止使用并删除本项目及其相关数据。

現在のランクイン

  • 136

    見過ごされた宝石 · 活発なのに無名

    100 スター · 22 fork · 総スター数(昇順)

    過小評価 →

直近30日の推移

スター累計の推移

ランキング推移

README にバッジを貼ろう · HUIdada1/AgentHub[![README にバッジを貼ろう](https://git.vaiox.xyz/api/badge/HUIdada1/AgentHub.svg)](https://git.vaiox.xyz/ja/repo/HUIdada1/AgentHub)

Badge · 任何仓库都可以挂 —— 未上榜的仓库显示灰章,上完榜会自动点亮。

<a href="https://git.vaiox.xyz/ja/repo/HUIdada1/AgentHub"><img src="https://git.vaiox.xyz/api/badge/HUIdada1/AgentHub.svg" alt="README にバッジを貼ろう" height="20"></a>

← ランキングへ戻る

GitHub Hot Boardタイムマシン発見联系我们 · Contact