GenieLocker

GenieLocker

GenieLocker 按分钟为 AI Agent 提供一个私有的、兼容 OpenAI 的 Qwen2.5-7B 端点。储物柜会在付费时长开始前经过质量门控，并在到期时自动销毁。

当前商业边界

• 一款商业常驻 SKU：l16-resident
• 预付费额度：已上线
• 按储物柜直接进行的 x402 结算：已关闭／失败时默认拒绝
• 公开状态计数器中的一个已完成储物柜是运营方的金丝雀实例，不是客户实例

请以实时 API 为准，而非复制的文档：

curl -s https://genie.locker/api/status
curl -s 'https://genie.locker/api/quote?envelope=l16&placement=resident&minutes=10'

Agent 集成

• MCP 服务：io.github.nhantour/genie-locker
• 完整购买与安全流程：https://genie.locker/agent.md
• OpenAPI 3.1：https://genie.locker/openapi.json
• 机器可读的网站索引：https://genie.locker/llms.txt
• 查看脚本后安装 Agent 技能：

curl -sL https://genie.locker/skill.sh | sh

第一步可以是分配免费试用额度。仅阅读此代码库或安装技能不会创建钱包或购买。

MCP 连接器

公开的 MCP 连接器刻意设为只读。它提供五种工具，用于查询服务状态、商业库存、实时报价、配方搜索和额度定价。它无法创建账户、预留 GPU、购买额度、创建储物柜，也无法向推理模型发送数据。

从源代码运行：

npm install
npm start

或者，在公开镜像可用后：

docker run --rm -i ghcr.io/nhantour/genie-locker-mcp:0.2.0

客户端配置：

{
  "mcpServers": {
    "genie-locker": {
      "command": "docker",
  "args": ["run", "--rm", "-i", "ghcr.io/nhantour/genie-locker-mcp:0.2.0"]
    }
  }
}

此代码库中的连接器源代码采用 MIT 许可，详见 LICENSE。私有经纪服务的实现不包含在此代码库或许可中。

Genie Guard SDK

此软件包还包含一个与框架无关、进程内的支出边界，适用于异步 JavaScript/TypeScript 工具：

npm install https://github.com/nhantour/genie-locker/releases/download/guard-v0.2.0/nhantour-genie-locker-mcp-0.2.0.tgz

它也以 @nhantour/[email protected] 的形式发布在 GitHub Packages 上，供已通过 npm.pkg.github.com 身份验证的客户端使用。

import { createSpendGuard } from '@nhantour/genie-locker-mcp/guard';
const guard = createSpendGuard({ limitUsd: 100, perCallLimitUsd: 5 });
const safeSearch = guard.wrap(paidSearch, { estimateCostUsd: () => 0.02 });

预留额度会在工具启动前计入，因此并发调用无法同时通过同一笔剩余预算的检查。失败的调用会释放预留额度；成功的调用则会记录估算成本，或记录适配器返回的 actualCostUsd。支持按日、UTC 月度和全时段计算的额度窗口。

这是本地 SDK 防护措施，不是托管钱包、支付处理器、持久化账本、多重签名审批系统，也不能替代服务提供商侧的支出限制。其状态会随进程重置。只要包装的工具可能转移真实资金，就应在钱包或支付提供商处设置最终硬性边界。

对应的 Python wheel 和源代码归档发布在 guard-v0.2.0 GitHub 版本中。

对应的无依赖 Python 软件包位于 python/。

安全问题请通过代码库的私密安全公告表单提交。

最简流程

# 1. Create a trial account and save the returned gk_... key securely.
curl -s -X POST https://genie.locker/api/credits/trial

# 2. Request a ten-minute locker with a stable idempotency key.
curl -s -X POST https://genie.locker/api/lockers \
  -H 'authorization: Bearer gk_REDACTED' \
  -H 'idempotency-key: your-stable-order-id' \
  -H 'content-type: application/json' \
  -d '{"envelope":"l16","placement":"resident","minutes":10}'

订单采用异步处理。使用相同的 API 密钥轮询返回的 status_url，直到状态变为 live；只有到这时，付费时长才开始。

版权所有 © Intelix Systems LLC。本代码库仅用于说明公开服务；它不授予私有经纪服务实现的使用许可。