@fadhilp/pylon

中文文档
3.7.4发布于 2026/10/28MITES Module构建来源已验证近 30 天下载 3026

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

中文使用文档
文档目录5 节
  1. 皮龙做什么
  2. Web App 设置( 建议)
  3. 终端设置( 替代)
  4. 套装软件包
  5. 发展

皮龙

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

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

Pylon web app

皮龙做什么

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

需要22.19.0节点或更新.

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

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

见完整 Pylon 网络指南 用于工作空间,会话,表面,设置,安全,存储,以及排除出故障.

  • 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 1.0.4 安装(网络应用捆绑自己的).

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

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

/advisor select
/grunt select
/scout select

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

套装软件包

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

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

发展

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

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 共发布 54 个版本,首次发布于 2026/08/01;过去 12 个月发布了 54 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.7.4latest2026/10/2817 天前
3.7.22026/10/2519 天前
3.7.12026/10/2420 天前
3.6.12026/10/2322 天前
3.5.72026/10/2223 天前
3.5.62026/10/2223 天前

关于 @fadhilp/pylon 的常见问题

@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 和提交记录判断。