# @computesdk/pi-loops 中文文档 规范地址：https://npmcn.com/package/%40computesdk/pi-loops/ 版本：1\.0\.13 npm 元数据更新时间：2026-11-04T03:58:40.121Z 中文译文更新时间：2026-11-10T15:16:09.607Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40computesdk/pi-loops 原文对照：https://npmcn.com/package/%40computesdk/pi-loops/?lang=original 项目主页：https://github.com/computesdk/pi-extensions/tree/main/packages/pi-loops#readme 源码仓库：https://github.com/computesdk/pi-extensions ## 关键信息（来自 npm 元数据） - 包体积（解压后）：301 kB，22 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.18\.0 - 运行依赖：0 个 - peer 依赖：typebox \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \* - 首次发布：2026-10-30T15:08:48.607Z - 最新版本发布：2026-11-04T03:58:39.966Z - 近 30 天下载量：3321（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：16（近 12 个月 16 个） ## 中文简介 山地攀爬环绕为 Pi 单位: 1 `loop` 工具,风格代理,在git worktrees的forked尝试会话, 法官保存最好的. ## 安装 ```sh npm install @computesdk/pi-loops ``` 也可以使用：`pnpm add @computesdk/pi-loops`、`yarn add @computesdk/pi-loops`、`bun add @computesdk/pi-loops` ## README # @ computesdk/ pi- loops 由皮氏自有单位所建的用于编码代理的希尔-攀接回路. 你的Pi课是家长 一个工具, `loop`,运行一回合:三次尝试将您的会话叉入他们自己的 git 工作树上,每次由风格代理驱动(**保险**, (中文(简体) ), **粗体**, (中文(简体) ), **疯狂**)),法官保存最优秀. 再来一次 `from` 从胜利者那里爬来. ``` > /loop make search() in search.mjs faster; check is node test.mjs; bench is node bench.mjs and prints ms loop-20261029T141200 r1 · judging safe done 14 tools · 61k tok — Replaced the DP table with two rolling rows bold done 22 tools · 98k tok — Early-exit Levenshtein with a k-best bound wild done 19 tools · 84k tok — Bit-parallel Myers distance Round 1 — kept R1-bold attempt style result judge ------- ----------- -------- ------------------------------------------------ CURRENT best so far 422.6 ms 422.6 ms re-measured R1-safe safe 188.0 ms 188 ms (2.25× better) · same algorithm, less allocation R1-bold bold 11.5 ms 11.5 ms (36.75× better) · bounded search, identical output R1-wild wild vetoed vetoed: memoises distances across calls R1-bold is best at 11.5 ms vs 422.6 ms now (36.75×); tests pass. 1 attempt(s) failed tests or were vetoed. Best so far: R1-bold (3f2a9c1, branch loops/loop-20261029T141200/r1-bold) at 11.5 ms search.mjs | 48 ++++++++++++++++++++++++++++-------------------- Apply (tracked files only): git checkout 3f2a9c1 -- search.mjs Next round: loop({ from: "loop-20261029T141200" }) ``` ## 安装 ```sh pi install npm:@computesdk/pi-loops # or: pi -e /path/to/pi-extensions/packages/pi-loops/extensions/loop.ts ``` 节点 22.18(TypeScript扩展被剥去,没有编译)和至少一个承诺的git repo. 尝试使用您 TUI 上的任何模式( 在设置中每个角色覆盖) . ## 供应商 摩尔夫和粒子飞船作为自己的包件,所以你可以安装任何一种,没有这个: | 提供者 | 软件包 | 密钥 | 模型 | | --- | --- | --- | --- | | 第AI条 | `pi-particle` | `PARTICLE_API_KEY` (单位:千美元)`pai-…`(中文(简体) ) | `particle-1`, (中文(简体) ), `deepseek-ai/deepseek-v41-flash-1017`, (中文(简体) ), `glm-5.3-flash` | | 墨菲语 | `@computesdk/pi-morph` | `MORPH_API_KEY` | `morph-kimik3`, (中文(简体) ), `morph-kimik3-fast`, (中文(简体) ), `morph-glm53-744b`, (中文(简体) ), `morph-glm53flash`, (中文(简体) ), `morph-dsv41flash`, (中文(简体) ), `morph-dsv41flash-1017`, (中文(简体) ), `morph-dsv4flash` | 他们住在这间公寓里 `packages/pi-morph` 财务报告和审定财务报表 `packages/pi-particle`; 安装它们 `pi install npm:@computesdk/pi-morph` (或 `pi install npm:pi-particle`) (中文(简体) ). 循环本身是模型-不可知论的——它运行在你的TUI上. ## 一个工具 ```ts loop({ goal, // what to improve check?, // command that must pass (tests) bench?, // command that prints the metric → bench mode metric?, // { key: "ms", unit: "ms", better: "lower" } protect?, // literal repo-relative files/directories; restored exactly before judging build?, shots?, // visual mode: build writes screenshot files, a judge panel scores them rounds? = 1, // rounds to run in this call from?, // run id (or "last") to continue from its last judged round rules?, // rules every attempt must follow; the judge vetoes breaches }) ``` `/loop ` 是快捷键:当这些字段时,模型会通过句子并调用工具。 扩展注册命令本身(来自 `prompts/loop.md`因此,它就在那里与 `pi -e packages/pi-loops/extensions/loop.ts` 不仅之后 `pi install`。 。 。 . **`/loop init` 曾经,那么 `/loop ` 写简报.** `/loop init` 您的 Pi 会话已读取 package.json 和配置文件( 仅读取工具, 无 bash) 并调用 `loop_init` 与项目的力学—— `serve` (启动应用程序于 `$PORT`, (中文(简体) ), `check`, (中文(简体) ), `bench` + 键 `metric`, (中文(简体) ), `protect` ——在对话框(保存 / 更改 / 讨论)中显示,并写到 `.pi/loops.json`。第一个 `/loop ` 在回购中,没有他们首先这样做。 每个 `/loop ` 然后只写简报 尝试得到.. `goal` (什么好看起来像,), `rules`, (中文(简体) ), `directions` (安全/粗体/野生目标特定角度), `routes` 来截取视觉目标,并调用该工具,该工具在“批准/更改./讨论”中显示简报。 未经你批准,不得运行(无头跑; `confirm: false` 跳过对话框 。 与原"环行记"相同的分出:项目分出一次,每跑一句; 4; `check` 编号 : `bench` 编号 : `build` 编号 : `shots` 编号 : `protect` 在工具上是覆盖. **座椅模式** (单位:千美元)`bench` 设置 : 工作树是一种新鲜的检查结果, 所以每次尝试都会按照 repo 的 docs 说的方式设置项目, 进行修改, 然后运行 `check` 财务报告和审定财务报表 `bench` 自己来 接下来 **法官** - 一个特工 `read`编号 :`bash`,不编辑 —— 重新测量每个候选人居住的地方(在第1轮中,在前面的获胜者工作树上,在自己的工作树上,每一次尝试), `bench` `repeat` 最好的样本数, `protect`ed文件首先放回,阅读每个diff和否决规则中断和作弊(特殊情况输入,截取通话,跳出工作,弱化检查). 它返回数字; `pickWinner` 使用检查门、否决权和 `minGain`循环本身对安装或运行项目一无所知. `protect` 条目是尝试工作树内的文字路径,而不是 globs 或 Git 路径谱。 Directories被恢复到基线树上,包括被删除的文件以及被添加的有轨,无轨和被忽略的文件被删除. 基线中缺失的路径仍然缺失;不存在配置的测试目录是无害的。 工作树之外的道路,它的根, `.git`,通过对称父母的路径被拒绝. **视觉模式** (无) `bench`: 每次尝试运行 `build` 和必须离开 `shots` 工作树中的文件(PNG/JPEG); a **法官** 面板(中间分数为3分),前两名对阵Current的正面对决,两种顺序;一名候选人以明确多数胜出,得分不低于Current's. 科伦特的镜头也是一样 `build` 在您的退票( 第1轮) 或之前的胜利者的工作树。 退出中未承诺的编辑是两种模式基准的一部分:工作树承诺的一叉(`git stash create`,你的退票是未触及的),所以尝试和当前从同一状态开始. 截图来自 `lib/shot.ts`: 无头 Chrome 驱动过 Chrome DevTools 协议, 没有依赖性( CDP 过节点内置) `WebSocket`) (中文(简体) ). 默认是 **全页**,而不是900px折叠——法官评分的截图应该看它的全部——用 `--viewport` 折叠和 `--selector '#card'` 一个元素。 任何铬/铬工程,包括: `chrome-headless-shell`无头的二进制 `--screenshot` 旗子是怎样的 `npx playwright install chromium-headless-shell` 装入 `~/.cache/ms-playwright`· ; `LOOPS_CHROME` 超过发现。 循环寻找一个 **在此之前** 回合开始,当没有回合时,一次以安装提示而不是三个失败 `build failed` 线条。 404s或拒绝连接的路由是一个错误,从来不是浏览器错误页面的照片. 床单是 `montage` (ImageMagick)安装时. **选择权是你的.** 每一轮评分后,你都会得到轮回牌:当跑步有 `shots` (两个模式)一个并列 **工作表** 数量和企图数量`.pi/loops//r.png`,在终端中还显示有图像支持的内线),以及一个采取器——保持法官的取取取,取而代之的再取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取`/loop-open R1-bold`, (中文(简体) ), `/loop-open judge`) (中文(简体) ). 结果以 **爬上来**:每发一行相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相相接相接相接相相相相接相相接相接相相接相相相接相接相相接相相相接相相相接相相接相相接相相接相相相相相相接相相相相相相相接相相相相相接相相相相相相相相相相相相相相相相相相相相相相相相相相. **何等为圆所花.** 每个嵌入式模型呼叫——尝试,每个法官样本,理事会——被计数:结果带有 `usage`,卡片结尾 `Spent 68.8k tok · $0.0000`。一回合从 TUI 返回开始,然后完成,所以没有工具结果可以携带它;而Loops 写一个 `type: "usage"` 按模式排列到会话的条目(种类) `loops`,注释命名跑步),即入门类"皮"(Pi sunds)入出其符和成本总计并显示于页脚. 因此,一个背景圆 降落在 `/cost` 脚跟跟其他模特一样 `/resume` 这届大会还是这样. **运行时方向.** 在TUI中,工具在回合开始后立即返回,当裁判完成后卡片作为信息到达,所以对话保持开放: `loop_status` (进展), `loop_talk("R1-bold", "…")` (为该尝试的会议发出指导信息), `loop_rule("…")` 由法官从本轮开始执行,留作后一轮), `loop_pick("wild")` (保持这一企图,或 `CURRENT`无论法官的成绩如何, `loop_stop()` (牲畜;工作树木), `loop({ from })` 页:1 在牌后, `loop_apply()` 将运行的最好结果带入出局——胜利者从承诺中更改了跟踪文件,作为一次承诺;它所添加或删除的文件被列出,没有应用. 无头 (`pi -p`或与 `wait: true` 工具块,直到回合完成. `/loop apply ` 选择精确运行( e) (`/loop apply` 使用会话的最后一次运行; `/loop stop ` 同样也只停止运行。 应用拒绝已上演或未上演的更改与胜者的文件相重叠并留下了不相干已上演的已上演的已上演的文件,在生成的承诺之外. 这些路径上相互矛盾的清洁承诺,因为运行基线也被拒绝(已经匹配的胜者内容是无害的);无关的承诺被保留. 在一回合运行时进行的出站编辑被保留下来,并根据原始基线的单独副本进行判断. 可疑的企图在离职时使该回合没有结果,并停止检查,从未自动重设或恢复。 这不是针对外部作者的跨进程交易,也不是对钩子竞速一个明确的应用. **终极状态.** 启动/设置失败、判断失败、无结果的比较和无任何完成候选人的回合记录为有原因的错误,没有留下运行或标签。 候选人承诺/工作树木在失败或停止后幸存;重试可以清除旧的终端错误并重新使用已完成的工作。 不变候选人或保持现有候选人资格的有效比较是正常完成的无改进结果。 由于没有完成候选人变更,Loops不花法官电话。 在Pi的终端状态到来之前,UI中仍有一站不停地运行;仅HTTP发送并不能证明停止. 空可选命令字符串和空可选 `protect`编号 :`shots`编号 :`routes` 列表作为省略处理,包括在模型生成的结构化呼叫中。 它们不会抹去配置的检查/保护或恢复运行的基准。 为了有意清除这些部分,改变配置并开始新的光谱. 在第1轮长椅前 **理事会** (两个提议+综合)写法官反对的题 `rules` 成为其中的决定性标准. 工具从不应用赢家本身:结果包括: `git checkout -- ` 对于您基线中已跟踪到的获胜者更改的文件,该行列出在工作树上留下的尝试(切入检查、帮助)的新文件,这样您就可以决定。 无头 (`pi -p`)无取取取者:法官取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取. ## 皮单位 | 什麽 | 何处 | | --- | --- | | 样式代理 | `agents/safe.md`, (中文(简体) ), `bold.md`, (中文(简体) ), `wild.md` - 前题 `tools`编号 :`model`身体附着在尝试的系统上 | | 法官 | `agents/judge.md` —— 说 `read, grep, find, ls, bash`,从不编辑;在长凳模式下,一个真正的会话(在尝试旁边列出),用于衡量和审查候选人目录;在视觉模式下,一个一拍面板 | | 理事会 | `agents/council.md` 没有工具; 一次性的代理会话, 从而获得 Pi 的认证、 提供者和会话头 | | 提示 | `prompts/loop.md` → `/loop` | | 尝试 | `SessionManager.forkFrom(, worktree, sessionDir)` + 键 `createAgentSession` —— 说 `pi --session` 在你的旁边列出它们; `/resume` 一个看它做了什么 | | 工作树木 | `.pi/loops//r-