mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 10:45:22 +00:00
云服务部-叶林立andDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
0c45b1a438
根 AGENTS.md 从约 78KB 压缩到约 10KB，避免作为常驻规则加载时被截断： 只保留仓库定位、扩展清单、跨扩展硬规则与通用验证命令。各扩展的维护 约定与验证命令移入对应目录的 AGENTS.md（新增 extensions/AGENTS.md 承载 系统提示词与根目录 TS/LSP 约定），上游来源记录统一放进各目录的中文 UPSTREAM.md，并补齐 pi-permission-system 与 pi-rtk-optimizer 的来源记录。 Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2.1 KiB
2.1 KiB
my-pi 维护约定（pi-rtk-optimizer）
- 扩展入口是
pi-rtk-optimizer/index.ts，主要实现位于pi-rtk-optimizer/src/。 - 组合包运行环境为 Node.js 22.19 或更高版本；本子目录开发验证还需要 npm、Bun 和项目声明的开发依赖。
- RTK 默认只压缩非搜索输出，包括本地
bash与远端ssh_bash的 ANSI 清理、测试聚合、构建过滤、Git 压缩、Lint 聚合和兜底截断；ssh_bash只复用输出处理，远端命令不得进入 RTK rewrite。 - RTK 命令改写默认关闭（
commandRewritingEnabled默认false）；默认安装不依赖系统rtkCLI，只有用户主动开启命令改写时才需要rtk rewrite，其命令支持策略由已安装的rtk rewrite决定，不在扩展内重复维护规则。 - FFF override 独占搜索工具与搜索输出；RTK 不得处理本地或远端搜索工具的调用/结果（含
grep工具结果），也不得通过默认命令改写接管rg、grep、find、fd。 readCompaction.enabled、sourceCodeFilteringEnabled和smartTruncate.enabled当前均默认false，源码读取保持原样；未经用户明确决定，不因节省上下文而改变这些默认值。若以后开启 read 压缩，优先考虑readCompaction + smartTruncate，源码过滤仍独立评估；必须保留精确offset/limit读取、短文件和行锚点的完整性。- read 压缩属于有损能力。任何默认值调整都必须同时说明哪些内容可能被省略、精确读取如何恢复原文，以及对
edit文本匹配和排障证据的影响。 - 工具输出压缩可能损失证据。排障和审计相关改动应优先保证原始输出可恢复，并覆盖锚点完整性和截断边界。
- 修改配置结构时同步检查默认值、归一化逻辑、设置界面、类型定义、README 示例和相关测试。
验证
按改动范围选择最小充分验证：
npm run build：TypeScript 转译检查。npm run typecheck：完整类型检查。npm run test：运行 Bun 测试。npm run check：类型、测试和打包检查的完整验证。