智卡管家

智卡管家（Aitok Hub） 是专为桌面用户和开发者量身定制的本地 AI 网关客户端。

它可以在你的电脑本地一键启动高性能代理服务（默认运行在 http://127.0.0.1:8309），作为你常用 AI 工具与智卡云端大模型算力之间的高速公路。

为什么需要智卡管家？

在日常使用各种 AI 编程助手或对话软件时，很多用户常常受到网络抖动、接口连接超时、或每个工具都要繁琐配置代理和密钥的困扰。

智卡管家为此提供了优雅的本地化解决方案：

连接加速与网络优化：管家内置多节点智能路由，深度优化网络链路，彻底告别直连 API 经常遭遇的 TLS 握手慢、响应断流与连接重置。
本地免密钥中转，统一管理：你只需在智卡管家上登录一次智卡账号，本地所有的开发工具或客户端只需把接口地址指向管家的本地端口，无需在几十个软件里反复复制粘贴真实密钥。
离线用量缓存与请求保护：管家采用高性能 Rust 引擎编写，资源占用极低（内存通常不足 30MB）。即使网络出现短暂抖动，内置的缓存与队列机制也能保障任务顺利完成，并自动在后台平滑同步。

客户端下载与支持平台

你可以前往智卡官网下载页面获取适合你操作系统的安装包：

macOS 客户端：
- 提供 Apple Silicon（M1/M2/M3/M4 系列芯片）及 Intel 架构 DMG 安装包，拖拽即可安装。
Windows 客户端：
- 支持 Windows 10 及以上（64 位），提供极简的一键安装程序。
Linux 桌面端 (AppImage)：
- 提供 Linux AppImage (x86_64) 与 Linux AppImage (ARM64)，下载后添加可执行权限即可直接运行，无任何动态库依赖烦恼。
Linux 命令行端 (CLI Binary)：
- 提供纯终端独立的单可执行文件：Linux CLI Binary (x86_64) 与 Linux CLI Binary (ARM64)。
- 专为无图形界面的远程开发机、云服务器 (VPS) 或 Docker 容器打造。

快速使用指南

1. 桌面端 (GUI) 操作

启动 智卡管家 桌面应用。
点击应用界面中的 “登录” 按钮，系统将自动唤起浏览器进行一键安全授权。
授权成功后，客户端界面将显示当前连接的智卡账户与可用算力状态。
点击 “启动代理” 开关，此时本地网关即在 http://127.0.0.1:8309 监听就绪。

2. 命令行 (CLI) 操作

赋予二进制文件执行权限，并通过内置的子命令进行管理：

chmod +x aitok-hub-cli

# 1. 登录智卡账号（支持交互式提示输入账号与密码）
./aitok-hub-cli sign-in

# 2. 同步平台模型与算力配置
./aitok-hub-cli load

# 3. 运行代理服务：
# 方式 A：前台直接启动运行（开发调试推荐）
./aitok-hub-cli serve

# 方式 B：注册为后台系统服务常驻运行（推荐日常使用）
./aitok-hub-cli install    # 注册系统服务（支持 macOS LaunchAgent / Linux systemd / Windows）
./aitok-hub-cli start      # 启动后台服务
./aitok-hub-cli status     # 查询运行状态、运行时间与请求计数
./aitok-hub-cli stop       # 停止后台服务
./aitok-hub-cli restart    # 重启后台服务

常用工具一键接入（内置自动化配置）

为了彻底免去用户手动翻找软件设置、手填长链接与拼接配置文件的繁琐流程，智卡管家已将常用主流工具（如 Cursor、Windsurf、Chatbox、Continue 等）的接入流程全自动化集成：

进入配置面板：在智卡管家桌面客户端的 “AI 密钥 / 智能体” 列表中，找到你需要连接的工具或智能体。
打开一键配置：点击该工具卡片旁边的 “配置”（或“快速配置”）按钮。
使用集成脚本一键完成：
- 弹窗会自动生成适配你当前操作系统（macOS / Linux / Windows）的专用配置脚本；
- 脚本已自动填入你的本地代理网关端点（http://127.0.0.1:8309）与认证参数；
- 直接点击弹窗中的 “一键执行” 按钮（或复制脚本在终端中粘贴执行），即可瞬间完成目标软件的环境配置。
即刻使用：脚本执行完成后，直接打开你的 AI 工具即可立即畅享极致流畅的开发与问答体验，全程无需手动复制粘贴任何密钥。