@ cydm/ pie (韩语)
@cydm/pie 是一个最小的,强大的,嵌入式的代理套房,供游戏开发者使用.
它给你一个终端第一代理体验 出盒子, 同时保持模块化 足够嵌入其他运行时间和产品。 派被设计为团队想要一个小的地表面积,强烈的默认,持续的会话,工具的使用,以及从CLI使用到更深的整合的干净路径.
派是开发的 细胞梦。 。 。 .
为什么派
- 最小界面, 低规格
- 终端中强大的编码代理工作流程
- 在可再使用的基础上建造的可嵌入式建筑
@pie/*软件包 - 持续会话、斜线命令和技能加载
- 工作以及每天的CLI和定制代理产品的构件
安装
npm install -g @cydm/pie
派需要Node.js 20.19或更新. Npm 的锁文件工作流程验证了释放构建( Namenpm ci因此依赖性分辨率是可以复制的.
快速启动
为您想要使用的提供者设置 API 密钥 :
export KIMI_API_KEY="your-kimi-api-key"
# or
export BIGMODEL_API_KEY="your-bigmodel-api-key"
也可以在 :
~/.pie/settings.json~/.pie/models.json~/.pie/config.json与遗产兼容的缺省数
最小值 ~/.pie/models.json数字 :
{
"profiles": {
"cy-gpt": {
"api": "openai-completions",
"baseUrl": "https://token.magicshell.ai/v1",
"apiKey": "YOUR_API_KEY",
"models": [
{
"id": "gpt-5.4",
"name": "GPT 5.4",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 128000,
"maxTokens": 16384,
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
}
}
]
}
},
"defaults": {
"provider": "cy-gpt",
"modelId": "gpt-5.4"
}
}
需要配置字段 :
apibaseUrlapiKey或者说apiKeyEnvmodels
需要的模型字段 :
idinputcost(单位:千美元)input, (中文(简体) ),output, (中文(简体) ),cacheRead, (中文(简体) ),cacheWrite; 可选cacheWriteLong(中文(简体) )contextWindowmaxTokens
明确验证文件 :
pie models validate
pie models validate --path /abs/path/to/models.json
pie models validate --probe web_search
生成启动模板 :
pie models init
pie models init --stdout
对于编辑器自动完成和验证,您也可以指向可选 "$schema" 区域 models.json 在您的安装中 @cydm/pie/models.schema.json 文档.
cost 可能额外携带 cacheWriteLong ——1h-TTL缓存的每百万吨速率在报告TTL分解(Anthropic-type routes)的供应商上写出. 它是可选的;不继续工作的遗产配置。 当它不存在时,长文按Anthropic 2x输入估计值定价,并标出计算成本 cacheWriteLongEstimated 因此,它不是作为确切的提供者法案提出的.
设置
~/.pie/settings.json (或 ./.pie/settings.json 项目范围)持有CLI默认值. 相关的快速缓存密钥 :
{
// Explicit Anthropic prompt-cache TTL: "none" | "short" | "long".
// Absent keeps the provider default (Anthropic: short/5m).
"promptCacheRetention": "short"
}
优先权是 每个请求选项 > CLI 设置 > 提供者默认。此设置仅在 Anthropic 即时缓存路径上转发;它从未强制 OpenAI 兼容 store 或另一个提供者的缓存模式。 派不从观察到的命中率自动切换 TTL —— 选择 long 明确当1h的写价值值值.
远程模型目录
派可以添加集中管理的模型而无需替换本地配置文件或默认. 添加目录到 ~/.pie/models.json 并保留环境变量中的虚拟密钥:
{
"remoteCatalogs": [
{
"id": "token-manager",
"url": "https://token.magicshell.ai/v1/client-catalogs/pie.json",
"apiKeyEnv": "TOKEN_MANAGER_API_KEY"
}
]
}
远程目录使用三秒超时,拒绝重定向,并倒回最后一个有效的缓存响应. 本地的相片 总是会赢 远程目录永远不会修改 defaults。 。 。 .
每个模型覆盖
使用顶级 modelOverrides 以补丁任何已装入模型的描述字段(在本地声明或由远程目录提供)而无需重新声明整个配置。 键是 "provider/modelId"数字 :
{
"modelOverrides": {
"cydream/gpt-5.6-terra": {
"contextWindow": 256000,
"maxTokens": 16384,
"compat": { "streamRequiresDone": false }
}
}
}
可覆盖字段 : name, (中文(简体) ), displayName, (中文(简体) ), reasoning, (中文(简体) ), input, (中文(简体) ), cost, (中文(简体) ), contextWindow, (中文(简体) ), maxTokens, (中文(简体) ), headers, (中文(简体) ), compat, (中文(简体) ), cacheCapability, (中文(简体) ), webSearch, (中文(简体) ), fileCapabilities. 嵌入式物体深度; 阵列替换。 标识和路由域(id, (中文(简体) ), provider, (中文(简体) ), api, (中文(简体) ), baseUrl, (中文(简体) ), apiKeyEnv, (中文(简体) ), filePlatform, (中文(简体) ), attachmentPlatform不能被推翻。 在配置文件与远程目录合并后应用覆盖; 当目录刷新时重新应用; 匹配未加载模型的密钥会被忽略 .
在交互式模式下启动派 :
pie
或者通过一个初始的提示:
pie chat "Summarize this repository"
在一发模式下使用 Pie :
pie "List the files in the current directory"
pie chat "Write a quick Python script for merge sort"
核心思想
派不只是聊天的CLI。 它是一个紧凑的代理套件,在可再使用的运行时间上方有一个终端UI.
- CLI故意小而快的学习
- 代理可以使用文件、 shell 命令、 会话和技能
- 架构是模块化的,因此同一基础可以被嵌入到其他应用程序和环境中
如果你想要一个感觉轻而易举但能力仍然很强的代理,这就是派的设计目标.
结构位置
@cydm/pie 是repo架构中的CLI产品层.
@pie/agent-core提供运行时间语义和代理循环@pie/agent-framework提供共享的应用基础设施,例如课程、技能和扩展协议@pie/shared-headless-capabilities提供所有主机使用的共享无头能力products/cli添加终端绑定, CLI 工作流程, 以及 shell 执行等特定主机的能力
国家信息倡议应消耗共同能力和框架合同;不应在当地重新界定共享运行时间或扩展语义.
互动经验
运行 :
pie
# or
pie chat
主要密钥绑定 :
Enter提交信件Shift+Enter插入新行\+ 键Enter在终端中插入新行而无需修改输入支持Ctrl+C清除编辑器; 按500ms以内两次退出Ctrl+D当编辑器为空时退出; 向前删除其它内容Ctrl+V编号 :Alt+V编号 :Cmd+V在主聊天编辑器拥有焦点时从剪贴板上粘贴一幅图像(先是终端剪贴板,OS帮助器倒置). 计划完善,扩展输入/编辑/海关用户界面,可见上下文,取名者保留了自己的粘贴键.Ctrl+O扩展或崩溃工具输出Ctrl+X切换 YOLO 模式Alt+O是终端发送 Alt 的可选别名Ctrl+R设置或切换 IM 转发( T)Alt+I是终端发送 Alt 的可选别名/打开斜线命令菜单
OS剪贴板图像在每所读取的私人临时目录(0700目录并专门保留POSIX上的0600文件)中被上演,包括子进程输出,在上演后或失败时被移除. Windows使用用户的临时目录并继承OS访问控制. 终端 OSC 5522 帧和 CSI 5522 支持响应是递增设定的,大小限定的,在识别时从不被冲出作为键盘输入:默认的相切相切期限为1s,有10s的绝对帧期限. 失败的帧通过终止器丢弃尾巴,或者直到1s的闲取. 一个模棱两可的孤独 Escape 保留了它正常的键盘超时,除非剪贴板请求活动;即使如此,它最终也会作为 Escape 交付. 在闲置回收后,任意后期裸载荷字节与新打字无法区分.
直接 shell 模式 :
!!git status
!!npm test
前缀为命令 !! 直接运行在外壳中而不经过代理.
斜线命令
派使用分级斜线命令菜单. 当前的内置命令包括:
| 命令 | 说明 |
|---|---|
pie doctor [--json] | 诊断本地配置、模型设置、可写路径、浏览器自动化和团结桥提示 |
pie models init | 创建启动器 ~/.pie/models.json |
pie models validate | 校验 ~/.pie/models.json |
pie permissions | 解释工具和 shell 安全默认值( E)--json 返回结构化安全模型) |
pie capabilities [--json] | 报告命令表面、旗帜、退出代码以及代理产品的输出计划 |
pie sessions list/read/rename/rewind/fork | 检查和管理存储的会话非互动( 每个支持) --json 财务报告和审定财务报表 --help(中文(简体) ) |
pie extensions list/enable/disable | 非互动地检查和切换扩展 |
/sessions/compact | 总结历史并建立一个紧凑的检查站 |
/sessions/new | 启动新会话 |
/sessions/resume | 恢复会话( 默认为当前方向会话; 按 g 在选择器中显示已装入的全部最近列表) |
/sessions/tree | 导航会话树 |
/sessions/info | 显示会话信息 |
/sessions/fork | 早先消息中的叉子 |
/settings | 打开设置菜单 |
/settings/model | 选择一个模型 |
/settings/theme | 更改主题 |
/settings/thinking | 设置推理深度 |
/settings/yolo | 切换限制较少的文件系统模式 |
/settings/hotkeys | 显示键盘快捷键 |
/settings/quit | 退出馅饼 |
/skills/list | 列出现有技能 |
/skills/use | 使用技能 |
/skills/reload | 从磁盘上重新装入技能 |
/settings/extensions | 列出扩展名并切换启用/失效 |
/tools/subagent | 给任务注入子剂 |
/tools/init | 创建或更新项目 AGENTS.md |
/settings/debugs/cache-test | 用专用的2-请求探测器运行提供者缓存诊断 |
/settings/debugs/context | 附加上下文摘要到 ~/.pie/logs/pie-cli.log |
/settings/debugs/package | 将软件包摘要添加到 ~/.pie/logs/pie-cli.log |
Pie也可以在运行时装入扩展提供的命令.
会议
派会一直坚持下去 这样你就可以回到以前的工作了.
- 会话存储于
~/.pie/sessions/ - 您可以从命令菜单切换会话
- 您可以叉开一个会话, 切换到以前的工作线
- 您可以压缩长会话以保持上下文焦点
这样一来 派对进行中的编码任务有用,而不仅仅是一次性的提示.
排定会话提示
内置 cron 延续预定的、绑定在原会话和工作目录上的提示 :
/tools/cron add {"prompt":"Continue the investigation above.","schedule":{"every":3600}}
/tools/cron list
/tools/cron pause <job-id>
/tools/cron resume <job-id>
/tools/cron remove <job-id>
在同一配置空间中保持至少一个克龙启用的互动派打开. 最初的会议不需要继续开放:由临时工作人员恢复未主办的会议,而主办会议则接受一般的后续行动。 无任务意味着没有页脚或启动通知;无关/随行窗口保持安静. 五地卡通时间表的使用 世界协调时模型要求的修改需要明确确认.
协调是合作性的,不是会场锁:不要在未参加的国家劳工联合会中开设工人会议。 崩溃可以要求离线锁/出站审查,而不是自动回放. 见 cron 设计、恢复和狗粮。 。 。 .
技能 广度
派支持基于Markdown的技能和内置扩展.
- 用CLI建造的技巧船
- 用户技能可以生活在
~/.agents/skills(交叉工具标准)或~/.pie/skills - 项目-地方技能可以生活在
.agents/skills(从项目根下到cwd,镜像 AGENTS.md 发现)或.pie/skills - 名称相撞( 后胜出) 上覆顺序: 内置 <
~/.agents<~/.pie< 祖先.agents(远至相近) <./.pie - 扩展可以注册额外的命令和工作流程
这是Pie可以嵌入的部分:CLI只是更广泛的代理工具包上的一个界面.
扩展源、 优先级和切换
扩展由四个来源在递增优先级中发现(后由源以稳定的扩展身份来阴影前一个来源):
builtin与CLI一起装运(ask-user, (中文(简体) ),todo, (中文(简体) ),plan-mode, (中文(简体) ),subagent, (中文(简体) ),init, (中文(简体) ),changelog,附件处理器)global—— 说~/.pie/extensions/project—— 说./.pie/extensions/configured——重复--extension-path <dir>旗帜
每个扩展都是默认启用的 。 切换是存储在设置中的稀有覆盖,并通过扩展身份适用于所有来源:
- 交互式: 选择 扩展 内
/settings,或使用/settings/extensions,打开用户默认切换菜单./settings/extensions --project编辑工程覆盖;/settings/extensions/list|enable|disable ...仍可供命令驱动使用. - 脚本和第三方 UI :
pie extensions list [--json], (中文(简体) ),pie extensions enable|disable <name> [--project|--user] - 进程旗:
--no-builtin-extensions(skip内置)和--no-extensions(查找所有已发现的来源;);--extension-path仍然装入)
在 ~/.pie/settings.json (或 ./.pie/settings.json 项目范围,每个身份胜出:
{
"extensions": {
"plan-mode": { "enabled": false }
}
}
完整合同(身份规则、计划、主机整合) docs/extensions-enablement.md。 。 。 .
浏览器工具
内置 chrome-devtools-axi 技能使用 chrome-devtools-axi CLI 来驱动一个真实的 Chrome 浏览器来覆盖 Chrome DevTools 协议 。 其运行时间依附船与 CLI; 不运行 npm install 在技能目录中.
解析技能资源并运行浏览器命令 :
node <resolvedPath for chrome-devtools-axi/chrome-devtools-axi-cli.js> open https://example.com
node <resolvedPath for chrome-devtools-axi/chrome-devtools-axi-cli.js> snapshot
node <resolvedPath for chrome-devtools-axi/chrome-devtools-axi-cli.js> screenshot /tmp/page.png
node <resolvedPath for chrome-devtools-axi/chrome-devtools-axi-cli.js> console
node <resolvedPath for chrome-devtools-axi/chrome-devtools-axi-cli.js> network
CLI 发射或附加到真实的 Chrome/ Edge 浏览器中; 参见 --help 用于连接模式(头模式、自动连接、自定义配置、远程浏览器 URL)和 CHROME_DEVTOOLS_AXI_SESSION 用于同时举行的单独会议.
运行 pie doctor 以检查chrome-devtools-axi和Chrome浏览器是否可以发现.
终端 UI 自动化
内置 tui-use 技能驱动交互终端程序 - RePLs, pdb/gdb调试会话,以及全屏TUI app - 通过 Pie 的被包的 PTY 运行时间. 运行 node <skill-baseDir>/tui-use-cli.js --help;不需要首先使用依赖下载或全球CLI。 Windows使用本土的"PowerShell"和"ConPTY". 国家生活 ~/.pie/tui-use,或专用 PIE_TUI_USE_STATE_DIR。总是以 --session <id>,确认终止方式为 wait --exit,然后只清理会话和守护进程。 使用 shell 用于非交互命令的工具.
桌面控制( 计算机使用)
内置 computer-use-axi 技能通过本土的可访问性帮助控制macOS,Windows和Linux上的真实桌面应用. 桌面控制是最后的手段 - 喜欢随时完成任务的API, CLI, 或网络工具. 启动技能的CLI通过 shell 工具 (node <skill-baseDir>/computer-use-axi-cli.js <command>); 观察命令读取UI状态,同时 act 合成真实输入. 这些是CLI操作,不是单独的模型可见扩展工具分级,所以正常的 shell确认政策适用.
读取 builtin/skills/computer-use-axi/SKILL.md 页:1 roots,边框观察,检查动作和浏览器工作流程. 在macOS上,运行CLI's permissions setup 接下来 permissions recheck 在允许访问和屏幕录入后; 交互式启动 Pie 并不能代替设置流 .
平台注释:
- 马科斯 (14+):已签名的辅助应用程序安装到
~/.pie/computer-use/pie-computer-use.app开始使用。 赠款 无障碍 财务报告和审定财务报表 屏幕记录 改为pie-computer-use.app在系统设置 → 隐私和安全;交互式会话引导您通过提示。 帮助者更新后再发放补助金(重新签署将取消旧补助金). - 窗口: 帮助器安装到
~/.pie/helpers/computer-use/windows-bridge.exe并需要一个交互式桌面会话. - 链接: 帮助器安装到
~/.pie/helpers/computer-use/linux-bridge并需要AT-SPI2总线(运行中的桌面会话;不支持无头服务器).
配置 : ~/.pie/extensions/computer-use.json (用户)或 .pie/computer-use.json (项目)与 browser_use, (中文(简体) ), headless, (中文(简体) ), cursor_overlay, (中文(简体) ), managed_browser; 内存覆盖 PIE_COMPUTER_USE_BROWSER_USE 编号 : PIE_COMPUTER_USE_HEADLESS 编号 : PIE_COMPUTER_USE_CURSOR_OVERLAY 编号 : PIE_COMPUTER_USE_MANAGED_BROWSER运行 pie doctor 用于帮助安装状态.
网络研究
Pie曝出一款默认模式可见网络工具: web_research用于公共网络研究、最新信息、在线文档和互联网启发。 过 query 用于研究, url 获取已知的页面/ PDF,或 query 与 mode: "search" 用于低级搜索结果。 工作空间搜索仍然分开:使用 grep_text, (中文(简体) ), find_files,以及 list_dir 用于本地仓库内容.
web_search 财务报告和审定财务报表 web_fetch 仍然是低等内部原始物,用于探针、诊断和测试;它们不是单独的默认模型可见工具. web_search 不刮 Duck Duck 或返回到 bash 与 curl 或 Python HTTP 脚本。 如果配置的提供者/模型无法进行本地网页搜索,Pie会返回一个清晰的无法获取的结果,其中包含提供者/配置的细节. 在CLI中, web_research 可使用chrome-devtools-axi在有Chrome浏览器可用时用于浏览器的源; Unity报告这些页面为 requires_browser。 。 。 .
web_research pie的状态目录中记录了路由健康和耐久性,所以以后的运行可以更偏好提供商,具有更好的源质,更少的超时,更低的速率限制压力. pie doctor --json 报告记录的保健提供者,以及 verify:web 编写网页测量标准,包括p50/p95耐用度、故障类别和引用质量文物.
权限
互动派从YOLO模式起:文件系统沙盒目录限制被禁用,高风险外壳命令被自动批准. 使用 /settings/yolo off 需要工作空间范围文件工具和确认的可信工作流程; ~/.pie 允许在此模式下列出 Pie 配置/会话支持 。 无头打印/json-events主机保留其非YOLO成分. 壳牌命令返回结构化超时/truncation/error细节. Cononic 可执行工具的名称 shell· ; bash 仍然是历史重放/移交和政策标识,而不是第二个可执行的别名。 在窗口上 shell:auto 使用PowerShell,呼叫者可以明确要求 bash, (中文(简体) ), powershell,或 cmd 方言学. 高风险 shell 命令需要在 YOLO 模式外进行确认; 确认对话框还提供时间框 Yolo (5 min) 选项,在不启用全 YOLO 模式的情况下,压制进一步高风险提示5分钟。 明显地转动 /settings/yolo off 取消持续的YOLO和任何活期临时补助金;状况单独报告剩余的补助金. pie permissions 打印当前政策衍生的安全摘要.
互动计划模式( E)/tools/plan),工作空间编辑工具没有. 计划模式 shell 守护系统接受简单的读取命令和只读的管道,例如 rg 'TODO' . | head -20;它会阻断重定向,命令替换,以及可写入子命令. 使用 plan_scratch 在专门用于本届会议的目录中写入、读取或列出临时文本草稿。 贝壳重定向到 /tmp 仍然以 Plan 模式被屏蔽 。 当计划完成后,代理商会提交命令步骤 plan_submit 您选择立即执行( 进度跟踪通过 [DONE:n] 在答复中标出标记,继续规划,或在预填编辑器中细化计划;在预填编辑器下将计划写成纯文本 Plan:编号 :计划: 标题仍然被检测为倒置。 在更改工作空间文件之前离开计划模式 .
密码情报
CLI 以前的类型脚本服务 code_intel 工具已退役。 Unity目前暴露出一个只读 JS/TS 诊断,定义,参考,符号,和悬浮的轻量级提供者;不要从旧文档推断出一个CLI TypeScript工人或Unity Node侧车.
诊断
使用 :
pie doctor
pie doctor --json
医生检查节点/npm,模型配置,API密钥可用性,可写作的Pie数据路径,chrome-devtools-axi和Chrome浏览器准备,Unity Bridge提示,以及运行时日志位置. 显示用户的错误要简洁; 详细的调试到 ~/.pie/logs/pie-cli.log 和会话追踪文物.
输出模式
对于非交互用法, Pie 支持结构化输出选项 :
pie "summarize this file" --raw-output
pie "summarize this file" --json-output
pie "continue previous task" --session-id my-session
从另一个目录恢复会话
会话记录他们创建的目录 。 当你恢复一个
属于另一个项目的会话(按 --session-id 或
交互式 /resume picker),派在该项目中重启自己
在装入任何 cwd 敏感内容( AGENTS. md 发现,
项目技能,项目记忆)——复会行为完全类似
一个崭新的项目 单行横幅显示开关
OSC 7出逃序列讲述支持新窗格所属的终端.
- 您发射的外壳保留了自己的 cwd( Unix 外壳不能是 ) 由儿童过程驱动);印刷的横幅是真理的来源.
--no-cd跳过重启(已标出/ CI 使用).session.resume.chdir: false内~/.pie/settings.json关闭它 永远.- 如果已录入的目录已不存在, Pie 将发出警告并恢复到 当前目录而不是失败.
可读输出( 代理和主机)
每项管理命令sessions, (中文(简体) ), doctor, (中文(简体) ), models, (中文(简体) ), extensions, (中文(简体) ), permissions, (中文(简体) ), capabilities发出一个紧凑的 JSON 信封 --json数字 :
{"v":1,"ok":true,"kind":"sessions.list","data":[...],"meta":{"count":10,"total":42,"nextCursor":"..."},"help":["..."]}
va. 恒定输出-示玛生成标记;kind识别命令.meta背负平面图( a)nextCursor)和总量;help[]列出今后具体的步骤,只要这些步骤存在,并且绝不重复大型有效载荷.- 错误结构在 stdout 上 :
{"v":1,"ok":false,"kind":"...","error":{"code":"session_not_found","message":"...","hint":"..."}}。 。 。 . - 退出代码 :
0成功吗,1经营失败,2使用错误。 未知的旗帜响亮失败; 每个子命令支持--help。 。 。 . sessions list --json默认为当前项目( e)--all列出每个项目。 行为最小( E)id, (中文(简体) ),name, (中文(简体) ),updatedAt, (中文(简体) ),count与--fields财务报告和审定财务报表--full选入;sessions read默认情况下将内容切换为相同的选入 .- JSONL 协议模式 (
--json-events)识别条目entryId仅(遗产)checkpointId化名已去),并设定大工具结果并默认转换摘要;通过--event-detail full用于较大但仍有界限的有效载荷(包括4 000个字符串盖、深度/物品/钥匙限制)。 受影响的工具结果字符串携带truncated编号 :fullLength;其他有界限的结构只能使用truncated。 。 。 .
运行 pie capabilities --json 在程序上发现完整的指挥面、旗帜和退出码合同.
终端笔记
对于最佳多行编辑体验,使用具有良好修改键支持的终端,例如:
发展
npm ci
npm run verify:quality
npm run verify:release
npm run verify:browser
npm run verify:terminal:matrix
使用 npm run verify:agent 您需要真正的日常代理大门.
使用 npm run verify:agent:nightly 在释放候选人之前,这些候选人声称是真正的供应商.
默认链中的统一检查是离线测试和静态包/捆绑
只检查。 真实编辑器、 重新装入、 播放模式和玩家验证使用
手动核对表 products/pie-unity/TESTING.md,而不是自动统一门.
设定 PIE_REAL_BROWSER=1 当你想要的时候 verify:browser 打开真实的浏览器会话,而不是只检查铬-devtools-axi CLI合同.
设定 PIE_REAL_WEB=1 当你想要的时候 verify:web 以获取或浏览器阅读的引用来运行真正的提供者网络研究烟雾.
出版
发布 @cydm/pie 从单发根.
首先设定 npm 符号 :
npm config set //registry.npmjs.org/:_authToken <YOUR_TOKEN>
然后出版:
npm run verify:release
npm publish --workspace products/cli --access public
如果在 npm 上已存在软件包版本, 则碰 products/cli/package.json 先说.
许可证
麻省理工学院
实验反应简介
单位 models.json,设置配置文件 api 改为 "openai-responses", (中文(简体) ), baseUrl 改为
其 API 根( 例如) https://api.openai.com/v1),以及 apiKeyEnv 给您的
认证环境变量 。 供应模式标识和限制 models 作为
常规。 可选简介/模型 transport 实值 "sse" (违约), "websocket"
(严格),或 "auto" (WS带有保守的前提交SSE倒置).
型号运输超越了剖面运输. API 选择是明确的.
配置文件可声明 endpoints: { "<api>": "https://..." } 和每个模型
可能选择 api (否则它继承了配置 API). 支持的密钥为
openai-completions, (中文(简体) ), openai-responses,以及 anthropic-messages; 端点 URL
遵循与 HTTP( S) 相同的绝对验证 baseUrl。解析的 API 用途
endpoints[api] 当存在时,否则 baseUrl明确不同的模式
API 密码 需求 它的端点条目; 明确的相同 API 选择可以使用
baseUrl。远程目录还需要每个端点共享
认证目录来源 . modelOverrides 无法改变这些路线.
例如,Bigmodel's Chat Confinitions and Response roots 不同的根源. 这是一个 配置示例, 而非特殊的提供者逻辑; 在内部使用不同的模型 ID 配置文件( 用您支持的模型取代 Chat 模式 ID ):
{
"profiles": {
"bigmodel": {
"api": "openai-completions",
"baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4",
"endpoints": {
"openai-responses": "https://open.bigmodel.cn/api/v1"
},
"apiKeyEnv": "BIGMODEL_API_KEY",
"transport": "sse",
"models": [
{
"id": "glm-5.2", "api": "openai-completions", "input": ["text"],
"contextWindow": 128000, "maxTokens": 4096,
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
},
{
"id": "glm-5.3", "api": "openai-responses", "input": ["text"],
"contextWindow": 128000, "maxTokens": 4096,
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
}
]
}
}
}
上述限制/价格是说明性的,不是提供元数据。 保持大模型和 Kimi 对已测试端点/账户的SSE的回复:响应支持确实如此 并不意味着 WS 会话可用 。 目前的基准显示继续上传节省, 未连贯一致地改进延迟; SSE 仍然默认, WS/ Continent- in.
派默认为 store: false可选 compat 字段为 store, (中文(简体) ),
supportsStore, (中文(简体) ), supportsReasoningEffort, (中文(简体) ), supportsEncryptedReasoning,以及
responsesContinuation。设置后者为真,以启用经核实的同源连接
WS三角洲请求. SSE仍为全文. 地方历史仍然具有权威性;
倒带,紧凑,重置和模型/证书更改丢弃或重新评价锚.
提交后的连接损失不自动重放.
文本/图像和函数工具得到支持;音频/视频输入明显失败. 连接再利用、三角洲续作和快速切入是不同的事实. 见 运输验证和选入基准。 。 。 .