# @cydm/pie 中文文档 规范地址：https://npmcn.com/package/%40cydm/pie/ 版本：4\.2\.0 npm 元数据更新时间：2026-11-10T04:28:21.081Z 中文译文更新时间：2026-11-11T07:07:19.147Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cydm/pie 原文对照：https://npmcn.com/package/%40cydm/pie/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：24.9 MB，116 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=20\.19\.0 - 运行依赖：15 个 - 首次发布：2026-03-25T11:57:11.308Z - 最新版本发布：2026-11-10T04:28:20.873Z - 近 30 天下载量：6135（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：102（近 12 个月 102 个） ## 中文简介 Pie AI 代理 CLI ## 安装 ```sh npm install @cydm/pie ``` 也可以使用：`pnpm add @cydm/pie`、`yarn add @cydm/pie`、`bun add @cydm/pie` ## README # @ cydm/ pie (韩语) `@cydm/pie` 是一个最小的,强大的,嵌入式的代理套房,供游戏开发者使用. 它给你一个终端第一代理体验 出盒子, 同时保持模块化 足够嵌入其他运行时间和产品。 派被设计为团队想要一个小的地表面积,强烈的默认,持续的会话,工具的使用,以及从CLI使用到更深的整合的干净路径. 派是开发的 [细胞梦](https://cydream.tech/)。 。 。 . ## 为什么派 - 最小界面, 低规格 - 终端中强大的编码代理工作流程 - 在可再使用的基础上建造的可嵌入式建筑 `@pie/*` 软件包 - 持续会话、斜线命令和技能加载 - 工作以及每天的CLI和定制代理产品的构件 ## 安装 ```bash npm install -g @cydm/pie ``` 派需要Node.js 20.19或更新. Npm 的锁文件工作流程验证了释放构建( Name`npm ci`因此依赖性分辨率是可以复制的. ## 快速启动 为您想要使用的提供者设置 API 密钥 : ```bash 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`数字 : ```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` 明确验证文件 : ```bash pie models validate pie models validate --path /abs/path/to/models.json pie models validate --probe web_search ``` 生成启动模板 : ```bash 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默认值. 相关的快速缓存密钥 : ```jsonc { // 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` 并保留环境变量中的虚拟密钥: ```json { "remoteCatalogs": [ { "id": "token-manager", "url": "https://token.magicshell.ai/v1/client-catalogs/pie.json", "apiKeyEnv": "TOKEN_MANAGER_API_KEY" } ] } ``` 远程目录使用三秒超时,拒绝重定向,并倒回最后一个有效的缓存响应. 本地的相片 总是会赢 远程目录永远不会修改 `defaults`。 。 。 . ### 每个模型覆盖 使用顶级 `modelOverrides` 以补丁任何已装入模型的描述字段(在本地声明或由远程目录提供)而无需重新声明整个配置。 键是 `"provider/modelId"`数字 : ```json { "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`不能被推翻。 在配置文件与远程目录合并后应用覆盖; 当目录刷新时重新应用; 匹配未加载模型的密钥会被忽略 . 在交互式模式下启动派 : ```bash pie ``` 或者通过一个初始的提示: ```bash pie chat "Summarize this repository" ``` 在一发模式下使用 Pie : ```bash 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 执行等特定主机的能力 国家信息倡议应消耗共同能力和框架合同;不应在当地重新界定共享运行时间或扩展语义. ## 互动经验 运行 : ```bash 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 模式 : ```text !!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` 延续预定的、绑定在原会话和工作目录上的提示 : ```text /tools/cron add {"prompt":"Continue the investigation above.","schedule":{"every":3600}} /tools/cron list /tools/cron pause /tools/cron resume /tools/cron remove ``` 在同一配置空间中保持至少一个克龙启用的互动派打开. 最初的会议不需要继续开放:由临时工作人员恢复未主办的会议,而主办会议则接受一般的后续行动。 无任务意味着没有页脚或启动通知;无关/随行窗口保持安静. 五地卡通时间表的使用 **世界协调时**模型要求的修改需要明确确认. 协调是合作性的,不是会场锁:不要在未参加的国家劳工联合会中开设工人会议。 崩溃可以要求离线锁/出站审查,而不是自动回放. 见 [cron 设计、恢复和狗粮](https://npmcn.com/package/docs/cron.md)。 。 。 . ## 技能 广度 派支持基于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 ` 旗帜 每个扩展都是默认启用的 。 切换是存储在设置中的稀有覆盖,并通过扩展身份适用于所有来源: - 交互式: 选择 **扩展** 内 `/settings`,或使用 `/settings/extensions`,打开用户默认切换菜单. `/settings/extensions --project` 编辑工程覆盖; `/settings/extensions/list|enable|disable ...` 仍可供命令驱动使用. - 脚本和第三方 UI : `pie extensions list [--json]`, (中文(简体) ), `pie extensions enable|disable [--project|--user]` - 进程旗: `--no-builtin-extensions` (skip内置)和 `--no-extensions` (查找所有已发现的来源;); `--extension-path` 仍然装入) 在 `~/.pie/settings.json` (或 `./.pie/settings.json` 项目范围,每个身份胜出: ```jsonc { "extensions": { "plan-mode": { "enabled": false } } } ``` 完整合同(身份规则、计划、主机整合) [`docs/extensions-enablement.md`](https://npmcn.com/package/docs/extensions-enablement.md)。 。 。 . ## 浏览器工具 内置 `chrome-devtools-axi` 技能使用 chrome-devtools-axi CLI 来驱动一个真实的 Chrome 浏览器来覆盖 Chrome DevTools 协议 。 其运行时间依附船与 CLI; 不运行 `npm install` 在技能目录中. 解析技能资源并运行浏览器命令 : ```bash node open https://example.com node snapshot node screenshot /tmp/page.png node console node 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 /tui-use-cli.js --help`;不需要首先使用依赖下载或全球CLI。 Windows使用本土的"PowerShell"和"ConPTY". 国家生活 `~/.pie/tui-use`,或专用 `PIE_TUI_USE_STATE_DIR`。总是以 `--session `,确认终止方式为 `wait --exit`,然后只清理会话和守护进程。 使用 `shell` 用于非交互命令的工具. ## 桌面控制( 计算机使用) 内置 `computer-use-axi` 技能通过本土的可访问性帮助控制macOS,Windows和Linux上的真实桌面应用. 桌面控制是最后的手段 - 喜欢随时完成任务的API, CLI, 或网络工具. 启动技能的CLI通过 `shell` 工具 (`node /computer-use-axi-cli.js `); 观察命令读取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侧车. ## 诊断 使用 : ```bash pie doctor pie doctor --json ``` 医生检查节点/npm,模型配置,API密钥可用性,可写作的Pie数据路径,chrome-devtools-axi和Chrome浏览器准备,Unity Bridge提示,以及运行时日志位置. 显示用户的错误要简洁; 详细的调试到 `~/.pie/logs/pie-cli.log` 和会话追踪文物. ## 输出模式 对于非交互用法, Pie 支持结构化输出选项 : ```bash 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`数字 : ```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` 在程序上发现完整的指挥面、旗帜和退出码合同. ## 终端笔记 对于最佳多行编辑体验,使用具有良好修改键支持的终端,例如: - [小猫](https://sw.kovidgoyal.net/kitty/) - [任期2](https://iterm2.com/) - [幽灵](https://ghostty.org/) ## 发展 ```bash 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 符号 : ```bash npm config set //registry.npmjs.org/:_authToken ``` 然后出版: ```bash 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: { "": "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 ): ```json { "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仍为全文. 地方历史仍然具有权威性; 倒带,紧凑,重置和模型/证书更改丢弃或重新评价锚. 提交后的连接损失不自动重放. 文本/图像和函数工具得到支持;音频/视频输入明显失败. 连接再利用、三角洲续作和快速切入是不同的事实. 见 [运输验证和选入基准](https://npmcn.com/package/docs/maintenance/responses-transport.md)。 。 。 . ## 常见问题 ### @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 和提交记录判断。