SDK 与 CLI
@azothos/cli
azoth 命令:通过网关中继 AI 编码工具的调用,在提交中指明这些调用,上报用量,向路由器请求模型,以及在 CI 中运行回归测试套件。
npm install -g @azothos/cli
azoth --help
# or without installing
npx @azothos/cli --help软件包为 @azothos/cli,需要 Node.js 18 或更高版本。不存在 @azoth/cli,npx azoth 也不是 Azoth:该 npm 名称属于他人。
配置
设置 AZOTH_API_KEY(自托管部署还需设置 AZOTH_BASE_URL),或将它们以 apiKey 和 baseUrl 写入 ~/.azoth/config.json。环境变量优先。
azoth proxy
- 在您机器上运行的中继,适用于任何接受 OpenAI 基础 URL 的工具:将其指向
http://127.0.0.1:8787/v1,可使用任意 API 密钥。 - 每次调用都会使用您的工作区密钥发送到工作区的网关,并在那里接受治理和封存;工具自身的密钥从不会被转发。
- 中继只保留每个回答附带的引用(其签名回执,或流式回答的追踪 ID),保存在
~/.azoth/receipts.jsonl中,保留 7 天。它只响应本机。
azoth proxy # relay on http://127.0.0.1:8787/v1
export OPENAI_BASE_URL=http://127.0.0.1:8787/v1 # or the tool's own setting; any API keyazoth hook install
- 为当前仓库添加一个 git
commit-msg钩子:对于中继自上次提交以来看到的每次调用,每个提交都会添加一个Azoth-Receipt:尾注,最多保留最近的 5 个。 - 当 Azoth 读取该仓库时,这样的提交会显示为关联到已封存的调用:它指明网关已封存的一次调用,绝不证明代码来自该调用。
- 该钩子从不阻止提交,不会为空消息或合并提交添加任何内容,也从不覆盖不是由它写入的钩子——使用 husky 或 commitlint 时,请将
azoth hook run "$1" || true添加到您自己的钩子中。azoth hook uninstall可将其移除。
azoth hook install
git commit -m "Fix the retry on 429"
# → Azoth-Receipt: eyJhbGciOiJFZERTQSIs… (one trailer per relayed call, the latest 5)其他命令
azoth ingest [file]从文件、stdin 或命令行参数上报用量事件
azoth route向路由器请求模型(
--mode cost|quality|balanced)azoth budget打印每个预算及其使用情况;
--exit-on-exceeded 可用作 CI 门禁azoth test run <suite.json>通过网关运行回归测试套件;有用例失败时以 1 退出
在 CI 中
# .github/workflows/ai-regression.yml
- run: npx --yes @azothos/cli test run suite.json
env:
AZOTH_API_KEY: ${{ secrets.AZOTH_API_KEY }}