AI-Tkoens English

Skills

AI-Token

AI-Token 是 AI-Tkoens 官方用户级 Skill 插件,支持 Claude Code、Codex 和 OpenClaw(龙虾)。通过自然语言指令在 AI 编码助手内查询模型、管理令牌、查看分组和余额,并直接提问 AI-Tkoens 的使用问题。

为什么使用 Skills

在日常 AI 开发中,开发者经常需要在编辑器和 AI-Tkoens 管理面板之间反复切换:查看可用模型、创建 API 令牌、检查余额、调整分组配额……这些操作打断了编码流程。

AI-Token-skills 解决的问题:

  • 零切换:在 Claude Code、Codex、OpenClaw(龙虾)等 AI 编码助手中直接输入自然语言指令,无需打开浏览器或管理后台
  • 内置问答:可直接提问 AI-Tkoens 的部署、配置、分组、模型调用格式等使用问题,快速获得帮助
  • 安全优先:密钥永不明文显示,令牌复制与注入均通过安全通道完成(sk- 开头的密钥绝不会出现在终端或日志中)
  • 即装即用:一行 npx 命令完成安装,自动检测运行时环境(Bun / Node.js / Deno)
  • 多编辑器兼容:支持所有实现 Skills 协议的 AI 编辑器和编码助手

支持的 AI 编辑器

AI-Token-skills 可在以下 AI 编码工具中使用:

AI 编辑器 / 编码助手类型备注
Claude Code终端 AI 编程助手Anthropic 官方 CLI
OpenClaw自托管 AI 助手平台支持 Skills,可在对话中直接调用 /AI-Token 指令
CursorAI 原生代码编辑器基于 VS Code
WindsurfAI 代码编辑器Codeium 出品
ClineVS Code AI 扩展开源 AI 编码代理
Codex CLI终端 AI 编程助手OpenAI 官方 CLI

任何支持 Skills 协议的 AI 工具都可以使用 AI-Token-skills。

功能与指令一览

以下是 AI-Token-skills 提供的全部指令。这些指令通过 AI-Tkoens REST API 执行,支持查询和管理 AI-Tkoens 实例中的各类资源。

查询类指令

指令说明用途
/AI-Token models列出可用 AI 模型查看当前 AI-Tkoens 实例中配置的所有模型(OpenAI、Claude、Gemini 等)
/AI-Token groups列出用户分组查看账户所属的分组及其配额、倍率设置
/AI-Token balance查看账户余额实时查询当前用户的账户余额和用量

令牌管理指令

指令说明用途
/AI-Token tokens列出 API 令牌查看所有已创建的令牌(密钥以掩码形式显示,如 sk-reHR**********OspA
/AI-Token create-token <name> [--group=xxx]创建新 API 令牌为不同应用或项目创建独立的 API 密钥
/AI-Token switch-group <token_id> <group>切换令牌分组更改令牌所属的分组以调整模型访问权限和倍率
/AI-Token copy-token <token_id>复制密钥到剪贴板安全地将真实密钥复制到系统剪贴板(密钥不会显示在终端中)
/AI-Token apply-token <token_id> <file>注入密钥到配置文件将令牌密钥安全写入项目配置文件(如 .env),使用占位符替换机制

帮助指令

指令说明用途
/AI-Token help <question>提问关于 AI-Tkoens 的问题获取 AI-Tkoens 部署、配置、API 调用格式等帮助信息

安装与配置

安装 AI-Token-skills

使用 npx 一键安装:

npx skills add https://github.com/QuantumNous/skills --skill AI-Token

该命令会从 GitHub 仓库拉取最新的 Skill 定义并安装到你的编辑器环境。

设置环境变量

AI-Token-skills 需要三个环境变量来连接你的 AI-Tkoens 实例。推荐在终端配置文件中设置:

# ~/.bashrc 或 ~/.zshrc
export AI-Token_BASE_URL=https://<your-AI-Token-domain>
export AI-Token_ACCESS_TOKEN=your-access-token
export AI-Token_USER_ID=1
变量说明示例
AI-Token_BASE_URLAI-Tkoens 服务地址https://api.example.com
AI-Token_ACCESS_TOKEN管理员或用户的访问令牌从「个人设置 → 账户管理 → 安全设置 → 系统访问令牌」获取
AI-Token_USER_ID用户 ID1(管理员默认为 1)

也可以在项目根目录创建 .env 文件。请确保 .env 已加入 .gitignore,防止密钥泄露。

开始使用

安装完成后,在支持 Skills 的 AI 编辑器中直接输入 /AI-Token 指令即可。例如:

  • 输入 /AI-Token models 查看可用模型列表
  • 输入 /AI-Token balance 查看当前余额
  • 输入 /AI-Token create-token my-app 创建一个名为 my-app 的新令牌
  • 输入 /AI-Token help 如何配置模型分组和令牌? 直接提问 AI-Tkoens 的使用问题
  • 在 OpenClaw(龙虾)中同样可以直接调用 /AI-Token models/AI-Token balance 等指令

运行环境要求

AI-Token-skills 需要以下任一 JavaScript 运行时(Skill 启动时自动检测):

运行时版本要求推荐程度
Bun最新版推荐(最快)
Node.js>= 18广泛支持
Deno最新版可选

安全机制

AI-Token-skills 内置多层安全防护,保护你的 API 密钥安全:

  • 令牌列表仅显示掩码密钥(如 sk-reHR**********OspA),真实密钥不会出现在终端输出中
  • copy-token 仅将密钥复制到系统剪贴板,不会在任何输出中显示
  • apply-token 使用占位符替换机制注入密钥,不直接暴露密钥内容
  • 所有 sk- 开头的密钥值在整个执行流程中都被严格保护

了解更多

AI-Token-skills 正在持续迭代中,指令和功能可能随版本更新。请以仓库 README 为准获取最新信息和变更日志:

输入关键词搜索全部中文文档