# @fadhilp/pylon 中文文档

规范地址：https://npmcn.com/package/%40fadhilp/pylon/

版本：3\.7\.4
npm 元数据更新时间：2026-10-28T03:54:20.453Z
中文译文更新时间：2026-11-14T08:38:05.881Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fadhilp/pylon
原文对照：https://npmcn.com/package/%40fadhilp/pylon/?lang=original
项目主页：https://github.com/FadhilP/pylon#readme
源码仓库：https://github.com/FadhilP/pylon

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：33.7 MB，4343 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：10 个
- peer 依赖：typebox \*，@earendil-works/pi-ai 1\.2\.0，@earendil-works/pi-tui 1\.2\.0，@earendil-works/pi-coding-agent 1\.2\.0
- 首次发布：2026-08-01T04:14:38.801Z
- 最新版本发布：2026-10-28T03:54:20.116Z
- 近 30 天下载量：3026（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

Pi工作流程扩展和一个本地网络界面.

## 安装

```sh
npm install @fadhilp/pylon
```

也可以使用：`pnpm add @fadhilp/pylon`、`yarn add @fadhilp/pylon`、`bun add @fadhilp/pylon`

## README

# 皮龙

Pylon 是一个基于网络首个编码代理工作空间 [Pi](https://pi.dev/)该系统将规划、储存库研究、授权执行、核查、安全控制、检查站和低噪音接口结合在一起.

Pylon 已优化用于 **成本效益和产出质量,而不是速度**它将重点工作引向成本效益高的模式,并为从中得益的决定保留更强大的模式,而核查和专家审查有助于保护质量。 这个工作流程比直接使用单一模型需要更长的时间.

![Pylon web app](https://npmcn.com/package/%40fadhilp/pylon/docs/pylon-web.png)

## 皮龙做什么

-   **决定性收缩**: 连续截取手动和自动 `/compact` 从结构化会话状态(目标、计划、待办事宜、限制、核查、文件活动)重建上下文,而不是要求模型进行总结。 一个可选的收缩审查员可以完善结果,任何失败都回落到决定性的.
-   **专用副剂**顾问(建筑和故障恢复的无工具推理)、童子军(捆绑回波和公共网络侦察)、Grunt(在孤立的Git工作树中授权执行)和Spawn(可恢复的私人线程和儿童会议)。 每个模型都有自己的模型,所以价格低廉的模型做体积,强健的模型做决定.
-   **文件索引**: Discover 保存 Git 跟踪源文件的机器本地 SQLite 索引,在会话启动时刷新,每转弯调节,支持 `symbol_search` 财务报告和审定财务报表 `code_search` 所以,看不花费 一个完整的repogrep。 若干工作空间共享的存储器被索引一次.
-   **边界上下文**: 发现保留可选工具计划,直到 `search_tools` 激活它们,每个软件包都会限制自己的输出.
-   **检查站和安全**: 时间线将Git后置的文件系统检查站捆绑在每个提示上,这样你就可以列出,恢复,或叉出它们; 警卫拦截破坏性的外壳并进行文件操作,需要确认.
-   **建立于**:在时间和产出预算下验证检测和运行您现有的项目检查,并在结果上锁定任务完成.
-   **规划和任务清单**: 明确计划模式,并附有结构澄清、可见的任务清单和可选 `/plan review`。 。 。 .
-   **工具意识记忆**: 持久工作空间注释,在打入的生命周期和工具事件上激活,而不是模糊的瞬间相似. 一个附在路径或工具上的注释,当你实际触摸它时,每会话一次.

## Web App 设置( 建议)

需要22.19.0节点或更新.

```sh
npm install --global @fadhilp/pylon
cd /path/to/your/project
pylon
```

打开 [http://127.0.0.1:3141 (中文(简体) )](http://127.0.0.1:3141/) (仅循环)和使用 **设置** 配置提供者、软件包模型和软件包选项。 建议OpenAI订阅:主用GPT 5.6 Sol Medium,顾问用Sol High,Scout Luna Medium,Grunt Terra.

见完整 [Pylon 网络指南](https://npmcn.com/package/%40fadhilp/pylon/docs/web/README.md) 用于工作空间,会话,表面,设置,安全,存储,以及排除出故障.

-   `PYLON_CWD` 设置项目目录, `PYLON_PORT` 端口( r)`3141`, (中文(简体) ), `PYLON_NO_UPDATE_CHECK=1` 禁用启动更新检查.
-   会话、设置和软件包状态 `~/.pylon/agent` (单位:千美元)`PI_CODING_AGENT_DIR` (原始内容存档于2017-03-25). overse. 现有 `~/.pi/agent` 在第一次运行时复制数据; `pylon migrate` 重试.
-   运行 `pylon changelog` 对于安装的释放, `pylon changelog <version>` 旧释放,或 `pylon changelog --list` 以列出可用的版本.
-   管理 Pi- 本地扩展 **设置- 扩展**. 扩展以服务器权限运行任意代码——启用前审查源.
-   运行 `pylon install <source>` 将 npm, Git 的 Pi 扩展/ package 安装到 Pylon 中。 例如: `pylon install /absolute/path/extension.ts`。 Pi 的安装选项不转出;使用 `--local --approve` 项目范围审查后 `pylon install --help` 用于使用。 之后在设置中重新装入扩展名 .
-   Pylon Web 代理可以使用延迟 `pylon_settings` 用于检查软件包设置的工具,并在确认后应用修订后检查的更新。 该工具不披露钩子,项目政策,信任,扩展,Guard控制,证书,或原始配置文件.
-   代理可以激活延迟 `pylon_docs` 用于搜索、列出和阅读已发送的Web和软件包文档的工具。文档不会被注入到每个提示中.

## 终端设置( 替代)

需要一个已有的 [Pi](https://pi.dev/) 1.0.4 安装(网络应用捆绑自己的).

```sh
pi install npm:@fadhilp/pylon   # or an absolute path to a local checkout
```

重新装入 Pi `/reload`,然后选择儿童代理商的模型——在配置前不提供:

```text
/advisor select
/grunt select
/scout select
```

使用每个没有参数的命令来显示状态; `set provider/model[:thinking]` 非交互配置, `reset` 使用当前的主要模型,以及 `disable` 把包裹关掉 运行 `/pylon doctor` 检查模型、资质、依赖性和包健康.

## 套装软件包

| 软件包 | 它会做什么 |
| --- | --- |
| [平分键](https://npmcn.com/package/%40fadhilp/pylon/packages/pylon-core) | 协调各种软件包的工具政策;增加有修订保护的已读/已编辑工具以及每个工具符号的报告. |
| [烟花和类固醇](https://npmcn.com/package/%40fadhilp/pylon/packages/pylon-android) | 独立的Android SDK/模拟器生命周期,静态Gradle构建,APK检查,无损部署,app生命周期,以及有界包日志. |
| [pi 连续](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-continuity) | 计划模式,任务列表,澄清,确定性收缩,以及持久的工具意识记忆. |
| [顾问](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-advisor) | 要求无工具模式帮助硬规划,架构审查以及故障恢复. |
| [皮鲁特](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-grunt) | 代表执行部分给在一棵孤立的吉特工作树上运行的工人. |
| [鸡尾酒](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-scout) | 封锁了仓库侦察和孤立的公共网络研究. |
| [pi- spound (英语)](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-spawn) | 私人复用子剂线程和一等儿童会. |
| [pi - 发现](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-discover) | 索引源,搜索回波和过去的 Pi 会话,并通过 `search_tools`。 。 。 . |
| [平时线](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-timeline) | 每快取出吉特后卫检查站:列出,还原,分叉,清空. |
| [皮卫](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-guard) | 确认或屏蔽破坏性外壳和文件操作. |
| [pi 验证](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-verify) | 查找和运行您工程的现有检查, 并带有限定的时间和输出 . |
| [心脏跳动](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-heartbeat) | 运行边框背景 shell 任务, 您可以检查或取消 . |
| [双螺旋花](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-helios) | 同意的Playwright浏览器,Appium Android模拟器,以及Windows窗口捕获. |
| [pi 状态](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-stateql) | 安全的状态数据库查询 具有持久的结果手柄和确认的写作. |
| [剪纸](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-papercut) | 长期积压小工作流程摩擦. |
| [pi 焦点](https://npmcn.com/package/%40fadhilp/pylon/packages/pi-focus) | 低噪声 Pi 终端 UI 和 `focus-dark` 主题. |

每个包独立运作. Pylon安装后,Pi-facing软件包通过有定界,有版本的事件-bus元数据协调——验证结果门连续完成并标出时间线检查站,Guard在破坏性确认前请求设置检查站,Heartbeat发布工作生命周期,Scout接收有定界的核查上下文. 原始验证和心跳日志从不交叉包事件. 详情见每个软件包README.

## 发展

安装工作空间依赖性并从寄存器根启动本地网络应用程序 。 词根 `package-lock.json` 是唯一的工作空间锁文件;不生成软件包级锁.

```sh
npm run install:packages
npm run web
```

没有生产建设的发展,运行 `npm run dev --workspace @pylon/web`。 。 。 .

运行 `npm run verify` 全部检查。 测试输出默认隐藏了传递结果和成功摘要,包校验打印只显示失败的任务. 失败的细节和退出代码被保存. 对于正常输出, 通过 `--verbose` npm 的参数分隔符后 : `npm test --workspace @pylon/web -- --verbose`, (中文(简体) ), `npm run test:bundle -- --verbose`,或 `npm run verify -- --verbose`。 。 。 .

在 Windows 上,在 Git Bash 和本地节点/ Pylon 工具之间通过路径时使用工作空间相对的临时文件; MSYS 路径, 如 `/tmp/...` 非本地 Windows 路径。 停止运行 Pylon 进程, 或在操作前使用单独的工作树/ 副本 `npm ci`,因为 Windows 无法替换被活动进程加载的本地加通.

## 常见问题

### @fadhilp/pylon 是什么？

Pi工作流程扩展和一个本地网络界面\.

### 如何安装 @fadhilp/pylon？

在项目目录运行 npm install @fadhilp/pylon，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（\*）、@earendil-works/pi-ai（1\.2\.0）、@earendil-works/pi-tui（1\.2\.0）、@earendil-works/pi-coding-agent（1\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 pylon，可以用 npx pylon 直接运行。

### @fadhilp/pylon 支持 TypeScript 吗？

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

### @fadhilp/pylon 支持 ESM 还是 CommonJS？

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

### @fadhilp/pylon 需要什么版本的 Node\.js？

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

### @fadhilp/pylon 可以商用吗？

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

### @fadhilp/pylon 的下载量有多少？

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

### @fadhilp/pylon 还在维护吗？

最新版本 3\.7\.4 发布于 2026/10/28（17 天前）；至今共发布 54 个版本，其中过去 12 个月发布了 54 个；首次发布于 2026/08/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。