把「技能、用量、额度、记忆、提示词、转发」六件事收进一个 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。
- 打开 Releases 页面
- 下载
AgentHub-Setup-x.y.z.exe - 双击安装。安装过程中可以改安装目录,装完会在桌面和开始菜单创建「AgentHub」快捷方式
- 启动后程序常驻系统托盘,关窗口不会退出;托盘图标双击可唤回窗口,右键菜单里能暂停同步、看今日用量
- Windows 10 / 11(x64)
- 不需要预装 Node、浏览器等任何依赖,运行时已打包在内
- 部分能读到数据的工具需要本机登录过对应客户端(如用量统计要读 Codex、Trae 的本地库)
- 配置与多数数据存在
%APPDATA%\AgentHub,卸载程序不会删除它 - 例外:三个「用户资产」放在用户目录下,方便你直接备份或丢进 Git——技能仓库
~/.agent_skills(可用环境变量AGENT_SKILLS_HOME改)、记忆库~/AgentHub/memory、提示词库~/AgentHub/prompts - 自动更新:默认每小时检查一次 GitHub Releases,检测到新版本会在侧栏设置齿轮和「设置 · 通用」的更新按钮上冒红点;自动检查可在「设置 · 通用」关闭
- 左下角「设置」= 全局项(通用 / WebDAV 同步 / 同步时间 / 数据与备份);每个板块右上角还有一个「配置」按钮,管的是这个板块自己的设置
用量散在各家工具自己的本地库里,没人告诉你这个月一共花了多少。用量统计直接读本机客户端的数据文件,把 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同步 | 记忆库跨设备同步 |
- 接入 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),各自一张卡片、各自一份配置,别混着看 - 验证:卡片上的三级校验会依次确认「配置条目在不在 → 桥能不能真的拉起并列出工具 → 这个 Agent 有没有真的调用过」。只有第三级出现心跳,才说明它确实在用
- 导入历史:进入「导入与去重」,把已有会话历史导进来做底料(支持 Codex、ZCode、WorkBuddy / WorkBuddy AI、Qoder、Trae 系、Antigravity 等来源的会话库),导入前可以先跑干跑预览
- 开自动化:进入「自动化」按需打开任务。九个任务分两类:
- 本地算法类:项目归类建议、索引自愈扫描(不耗 token)
- 需要模型类:抽取结构化信息、生成摘要、自动打标签、失效判定、L2 蒸馏、去重合并、人格/偏好画像
- 给记忆任务配模型:在记忆中枢的配置页选择模型来源——填自己的 OpenAI 兼容 API(Key 存本机、界面只显掩码),并配置失败时的降级链
自动化跑完后,有三类结论不会直接生效,而是排队等你确认:事实失效判定(新事实是否覆盖旧事实)、项目归类建议、去重合并建议。它们收在「记忆浏览 → 待确认」里,逐条采用或驳回;每条都带推荐建议,也可以按推荐一键全部确认。
同一段提示词,你在每个新会话里都要重写一遍;想说「帮我写个周报」,又不知道该怎么补才够清楚。提示词库把这件事拆成三步:让模型替你扩写(优化提示词)、好用的存起来复用(个人库)、直接拿现成的(线上目录)。
| 页面 | 作用 |
|---|---|
| 优化提示词 | 上框原文、下框结果;6 套内置风格 + 「补充要求」+ 角度引导;边生成边显示 |
| 优化历史 | 最近 50 次优化的原文 / 结果 / 耗时 / 用量,可一键回填重跑 |
| 个人提示词库 | 分类树、标签、收藏、版本历史、回收站、导入导出、全文搜索 |
| 线上提示词库 | 内置 60 条精选 + 10 套模板,可检查更新,也可导入自己的数据集 |
| WebDAV 同步 | 提示词库跨设备同步,冲突可逐条裁决 |
| 风格 | 什么时候用 |
|---|---|
| 通用增强 | 默认。补上下文、明约束、结构化,保持语言一致 |
| 多角度补全 | 原话很短、信息量不足时用(如「帮我写个周报」)。先按 9 个角度扫描缺口,再用合理假设补齐,最后按规范骨架输出 |
| 更简洁 | 只做减法:删冗余、去重复、压缩表达,不新增要求 |
| 更结构化 | 强制分层:目标 / 输入 / 约束 / 输出格式 / 验收标准 |
| 补全约束 | 重点补边界条件、禁止项与可判定的验收标准 |
| 面向编码任务 | 目标场景预设为编码助手:补技术上下文与可验收的完成条件 |
「多角度补全」的两个关键设计:
- 不编事实:人名、机构、数字、日期、金额、型号一律留成
{{变量}},不替用户瞎猜 - 假设看得见:模型替你做的假设(最多 3 条)单独列在结果下方,每条都写「若不成立会变成什么样」;选中正文里的对应文字点「→ 变量」,就能把它变成可填写的变量
- 补充要求:想加一句「面向不懂技术的老板」,写在原文框下面的「补充要求」里就行,不用改原文。改原文会污染这条提示词的「血缘」,而且想再来一版不同要求的还得改回去
- 流式输出:边生成边显示,旁边带已用时。上游不支持流式会自动回退成一次性返回(只慢那一次,之后记住这个供应商);读流中途卡住超过 20 秒会自动中断,不会无限转圈
- 假设可接管:多角度补全给出的假设逐条列出,把「模型替你猜的」变成「你填一次就固化」
- 内置 60 条(写作 / 编程 / 分析 / 办公 / 图像 / 角色 / 学习 / 生活 8 个分类)+ 10 套模板。模板给的是方法论:什么时候用、怎么做、容易踩的坑,不只是丢一段文本给你
- 断网可用:目录内置在安装包里,首启就有内容;联网后可「检查更新」增量拉取新版,只下变更的分片
- 收录不覆盖你的改动:收入个人库后来源记为「线上」,目录以后更新时卡片会显示「有更新」,但不会自动覆盖你改过的内容
- 可导入自己的数据集:支持
{items:[...]}/{prompts:[...]}/ 裸数组三种格式。导入的条目只存在你本机,版权与合规由你负责
| 内容 | 位置 | 参与同步 |
|---|---|---|
提示词库(一条一个 .md) |
~/AgentHub/prompts |
是(WebDAV) |
| 优化历史(最近 50 次) | %APPDATA%\AgentHub\prompts\history.json |
否,本机留痕 |
| 优化风格(含自定义) | %APPDATA%\AgentHub\prompts\styles.json |
否,本机偏好 |
| 线上目录缓存 | %APPDATA%\AgentHub\prompts\catalog |
否,应用资产 |
- 打开「优化提示词」,把想改的那句话粘进去。信息很少就选「多角度补全」,已经比较完整就选「通用增强」
- 有额外要求写在「补充要求」里,不用动原文;不知道还缺什么,就点下面的角度 chip(受众 / 场景 / 格式 / 边界 / 示例 / 验收)
- 跑完看结果,不满意点「重新优化」或直接在下框手改;改过之后再点「重新优化」会先问一次,不会默默覆盖你的修改
- 满意的点「保存到我的库」,正文里的
{{变量}}会被自动识别成变量 - 想直接拿现成的,去「线上提示词库」按分类翻,或者用左栏「按变量找」——从「我手上有什么材料」反查模板
- 多台电脑:先在「设置 · 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 天有效,重复点击按「今日已领」处理)。领取接口要求客户端自带的风控身份,故需要本机安装对应客户端。
进入「号池管家 · 号池」,先在顶部选中渠道,再点添加账号。每个渠道都支持四种添加方式,挑一种就行:
- 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 设备授权页(已带用户码,点一次确认即可)完成登录,本机自动轮询入池,无需安装客户端、不占用本地回调端口
- 每次登录对应一个账号,想加几个号就重复几次
- 从本机软件导入 —— 直接扫描本机已登录客户端的凭据,零请求入池,最省事(Qoder 走的也是这条)
- 从 JSON / ZIP 文件 —— 批量导入别人给你的账号文件
- 粘贴 JSON —— 手动粘贴单条或一组凭据
账号加进来后,号池列表里能看到它的余额、套餐到期时间和状态(online / cooling / exhausted / relogin / disabled)。想主动养护账号,点该渠道的一键签到(或领加油包,Qoder 是「领 Credits」);也可以打开定时自动签到,每天到点自动跑全渠道。
「总览」页按渠道列出余额、可用账号数与最早到期时间;「积分日历」把逐包明细按到期升序铺开,快过期的排在最前。额度刷新周期与「即将到期」预警阈值都在「配置 · 号池管家」里改,保存即生效。
号池里每个账号都有一个「切到 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 段 |
否 |
- 先去「号池管家」把至少一个渠道账号加进号池(网关的账号来自这里,没有账号时总览会显示三步引导)
- 回「本地网关 → 总览」点「启动」,状态徽标变成「运行中 · 9527」
- 到「服务与密钥」创建第一个 API Key——页面只显示这一次,请立即复制保存
- 到「接入与文档」抄 curl 示例或 IDE 配置,把
base_url指到http://127.0.0.1:9527/v1,Key 填上一步的sk-lgw-... - 想看哪个渠道慢,去「请求日志」按渠道筛,或看总览里的 P95 延迟
同一个 Skill 你在 Codex、Claude Code、ZCode、Cursor 里各装了一份,改一处忘三处。技能仓库把所有工具的 Skill 目录收进一个中央仓库,再挂载回各工具:以后只在中央库维护,一处更新,处处生效。
| 页面 | 作用 |
|---|---|
| 仪表盘 | 中央库与各工具连接状态总览:收了多少技能、挂载是否健康、有没有孤儿目录 |
| 中央技能库 | 技能列表与详情,逐条查看/收纳/挂载,挂载失效时可一键修复 |
| 去重与冲突 | 同一技能在不同工具里内容不一致时列出差异,人工裁决保留哪份;工具目录里的链接指向别处时,决定链接该指向谁 |
| 同步中心 | 扫描预览 → 确认执行 → 查看报告,一次把「收什么、挂什么、有什么要裁决」讲清楚 |
| WebDAV 同步 | 中央仓库跨设备同步(服务器地址在「设置 · WebDAV 同步」里配) |
- 打开「技能仓库 · 仪表盘」,确认工具列表里检测到了你的工具(ZCode / Codex / Claude Code / Antigravity / 通用
~/.agents为内置,其他工具会按本机目录自动建议添加) - 进入「同步中心」,先点扫描看看这次会收哪些技能、往哪些工具挂——预览不写任何文件,看清楚再执行
- 点执行。技能会以软链接(junction)的方式从中央仓库挂回各工具,几乎不占额外空间
- 日常在某处新增/修改了技能,回「同步中心」再跑一次即可;出现冲突会进入「去重与冲突」页面等你裁决
- 多台电脑:在「设置 · 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 testQoder 渠道专项自测(离线,默认不联网、不消耗额度;凭据与签名器相关断言需要本机装有 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)
本项目采用 MIT License + 附加使用条款 的复合授权,不是纯粹的 MIT 项目:
| 部分 | 内容 |
|---|---|
| 第一部分 · MIT License | 授予软件层面的使用、复制、修改、合并、发布、分发、再许可与销售权利 |
| 第二部分 · 附加使用条款 | 对本项目的使用场景作进一步限制:禁止商业用途、禁止二次分发牟利、禁止批量账号运营、禁止绕过上游计费与配额、禁止攻击与干扰、禁止违法用途 |
两部分不可分割,共同构成本项目完整的授权与使用约定;仅接受其中一部分者,不得以任何形式使用、复制、修改或分发本项目。附加条款与上文使用声明第三节「禁止用途」一致,如表述有出入以 LICENSE 为准。
商业场景使用须事先联系作者另行取得书面授权。完整条款(含 MIT 全文)见 LICENSE。
Copyright (c) 2026 沐晖 (HUIdada1)
本项目是一个用于学习 本地凭据管理、多上游账号与额度聚合、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。 若你不同意本节任何一条,请立即停止使用并删除本项目及其相关数据。
