@cartanova/克格丽德-克利
联合国 • 妇女 한국어
用一行运行 Qgrid 服务器 。 一个LLM代理将OpenAI/Anthropic订阅信用披露为HTTP API+仪表板.
安装
npm i -g @cartanova/qgrid-cli
安装还自动同步 qgrid 技能 :
- 全局安装 :
~/.codex/skills/qgrid, (中文(简体) ),~/.claude/skills/qgrid - 项目安装 :
.agents/skills/qgrid, (中文(简体) ),.claude/skills/qgrid
工程安装会创建并联,当并联失败时会倒回复制.
正在准备 PostgreSQL
Qgrid需要PostgreSQL来存储OAuth令牌并请求日志.
如果您已经有一个可到达的 PostgreSQL,请与 --db 或 QGRID_DB_* 环境变量.
如果本地没有,你可以和多克一起旋转:
docker run --name qgrid-postgres \
-e POSTGRES_USER=postgres \
-e POSTGRES_PASSWORD=postgres \
-e POSTGRES_DB=qgrid \
-p 5432:5432 \
-d postgres:18
使用量
# Run with a DB URL
qgrid --db postgres://user:password@host:port/dbname
# Specify a port
qgrid --db postgres://... -p 3000
# Configure the DB with environment variables (flags can be omitted)
export QGRID_DB_HOST=dev.example.com
export QGRID_DB_PORT=5432
export QGRID_DB_USER=postgres
export QGRID_DB_PASSWORD=postgres
export QGRID_DB_NAME=qgrid
qgrid
CLI翻译公众 QGRID_DB_* 设置到索纳穆的内部
SONAMU_DB_* 变量。 包装的 CLI 默认为 NODE_ENV=production· ;
设定 NODE_ENV=staging 只当它被故意作为遥控器运行
非生产服务。 此配置选择从未创建或重命名为
数据库 QGRID_DB_NAME。包装的 CLI 拒绝 development
财务报告和审定财务报表 test,需要源发展布局.
一旦服务器打开,打开仪表盘 http://localhost:44900 —通过OAuth登录注册符.
与 -p, --port 设置,在端口连接.
服务器端口仅由默认确定 44900 或者说 --port编辑 PORT 环境变量不读取为 CLI 服务器端口输入.
如果选中的端口已经在使用中,则CLI会以出错退出,而不是杀死已存在的进程或倒回另一个端口.
停止使用 Ctrl+C.
选项
qgrid [options]
--db <url> PostgreSQL connection URL
-p, --port <port> Server port (default: 44900)
--skip-update Skip the automatic update check
-V, --version Print version
-h, --help Help
在启动时,CLI会检查npm上的最新版本和每当安装版本不同时的自更新,包括补丁发布. 更新器安装它刚刚解决的准确的已公布版本,并从更新的二进制中重新启动.
环境变量
没有 --db 旗下, DB 连接信息读取自 :
| 变量 | 默认 |
|---|---|
QGRID_DB_HOST | localhost |
QGRID_DB_PORT | 5432 |
QGRID_DB_USER | postgres |
QGRID_DB_PASSWORD | postgres |
QGRID_DB_NAME | qgrid |
SLACK_BOT_TOKEN | - (未设置禁用符号过期通知) |
SLACK_CHANNEL_ID | —— 说 |
SLACK_EXPIRY_REMINDER_INTERVAL_MINUTES | -(未设置禁用会话 - 重复) |
SLACK_USER_MAP | —— (中文(简体) )tokenName:SlackUserId (对) |
服务器行为变量 :
| 变量 | 说明 | 默认 |
|---|---|---|
NODE_ENV | 索纳穆运行时间简介. 设定 staging 用于远程非生产部署 | production |
先决条件
- 节点.js 22
- 邮递SQL
- 多克( 如果在本地运行 PostgreSQL 作为容器)
- 克劳德代码 (用于Anthropic模型)
如何运作
CLI将基于Sonamu的服务器作为内置的捆绑船. 发射时:
- 校验 DB 连接
- 启动服务器( API + 仪表板网络 UI)
- 从 DB 装入注册符 。 以后通过 PostgreSQL UNSTEN/NOTIFY 实时向运行中的服务器传播符号添加/更改
- OpenAI 令牌: 调用
https://chatgpt.com/backend-api/codex/responses直接通过HTTPS并解码SSE. 托肯级并行许可使用平滑加权路由;50个项目排队最多等待60秒. 完整历史被不透明地重放sessionKey- 产生的快切亲和,和AbortSignal取消已队列或活动的工作 - 炭相符号:每个请求产生一个新鲜的、孤立的 claude 过程(
stream-json(b) 将有关费用列入/列入) 托肯被选为使用最少的先行. OAuth 令牌自动刷新 - 超过其配额阈值(默认为 80%) 的被排除于路由( 使用- 检查失败无法打开)
Qgrid应用本身并不依赖于多克克克,但PostgreSQL是需要的. 如果不在当地运行PostgreSQL,在多克运行是最简单的设置.
OpenAI 登录使用直接的 PKCE OAuth, 配额检查使用私人 wham/usage 直接用 Codex CLI 身份头来结尾. 这些 ChatGPT 后端接口没有记录,可能不经通知而更改. 模拟测试不能确定现场提供者的兼容性.
SDK 整合
服务器运行后,请使用 @cartanova/qgrid-ai-sdk数字 :
import { generateText } from "ai";
import { qgrid } from "@cartanova/qgrid-ai-sdk";
const { text } = await generateText({
model: qgrid("openai/gpt-6-luna"),
prompt: "What's the weather in Seoul?",
});
见 @cartanova/qgrid-ai-sdk 读取 详细情况.