@cydm/pie

中文文档
4.2.0发布于 2026/11/10MITES Module近 30 天下载 6135

Pie AI 代理 CLI

中文使用文档
文档目录29 节
  1. 为什么派
  2. 安装
  3. 快速启动
  4. 设置
  5. 远程模型目录
  6. 每个模型覆盖
  7. 核心思想
  8. 结构位置
  9. 互动经验
  10. 斜线命令
  11. 会议
  12. 排定会话提示
  13. 技能 广度
  14. 扩展源、 优先级和切换
  15. 浏览器工具
  16. 终端 UI 自动化
  17. 桌面控制( 计算机使用)
  18. 网络研究
  19. 权限
  20. 密码情报
  21. 诊断
  22. 输出模式
  23. 从另一个目录恢复会话
  24. 可读输出( 代理和主机)
  25. 终端笔记
  26. 发展
  27. 出版
  28. 许可证
  29. 实验反应简介

@ 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"
  }
}

需要配置字段 :

  • api
  • baseUrl
  • apiKey 或者说 apiKeyEnv
  • models

需要的模型字段 :

  • id
  • input
  • cost (单位:千美元)input, (中文(简体) ), output, (中文(简体) ), cacheRead, (中文(简体) ), cacheWrite; 可选 cacheWriteLong(中文(简体) )
  • contextWindow
  • maxTokens

明确验证文件 :

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只是更广泛的代理工具包上的一个界面.

扩展源、 优先级和切换

扩展由四个来源在递增优先级中发现(后由源以稳定的扩展身份来阴影前一个来源):

  1. builtin 与CLI一起装运(ask-user, (中文(简体) ), todo, (中文(简体) ), plan-mode, (中文(简体) ), subagent, (中文(简体) ), init, (中文(简体) ), changelog,附件处理器)
  2. global —— 说 ~/.pie/extensions/
  3. project —— 说 ./.pie/extensions/
  4. 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":["..."]}
  • v a. 恒定输出-示玛生成标记; 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仍为全文. 地方历史仍然具有权威性; 倒带,紧凑,重置和模型/证书更改丢弃或重新评价锚. 提交后的连接损失不自动重放.

文本/图像和函数工具得到支持;音频/视频输入明显失败. 连接再利用、三角洲续作和快速切入是不同的事实. 见 运输验证和选入基准。 。 。 .

版本与发布记录

@cydm/pie 共发布 102 个版本,首次发布于 2026/03/25;过去 12 个月发布了 102 个版本。

版本发布日期距今
4.2.0latest2026/11/101 天前
4.1.02026/11/082 天前
4.0.02026/11/082 天前
3.0.02026/11/055 天前
2.8.12026/11/047 天前
2.8.02026/11/019 天前

关于 @cydm/pie 的常见问题

@cydm/pie 是什么?

Pie AI 代理 CLI

如何安装 @cydm/pie?

在项目目录运行 npm install @cydm/pie,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pie,可以用 npx pie 直接运行。

@cydm/pie 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/cydm__pie 是否存在。

@cydm/pie 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cydm/pie 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cydm/pie 可以商用吗?

@cydm/pie 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cydm/pie 的下载量有多少?

根据 npm 官方下载统计,@cydm/pie 在 2026/10/11 – 2026/11/09 这 30 天内被下载 6,135 次,日均约 205 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cydm/pie 还在维护吗?

最新版本 4.2.0 发布于 2026/11/10(1 天前);至今共发布 102 个版本,其中过去 12 个月发布了 102 个;首次发布于 2026/03/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。