mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 10:45:22 +00:00
根 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-chrome)
- 扩展入口是
pi-chrome/extensions/chrome-profile-bridge/index.ts,Companion MV3 扩展位于browser-extension/,Session 快照存储位于src/session-snapshot-store.ts,测试保留在test/与test-suite/,来源记录是UPSTREAM.md。 - 同步上游必须从官方
tianrendong/pi-chrome的明确 tag/commit 移植并保留 README、CHANGELOG、SECURITY、文档、测试、作者和 LICENSE;不得导入嵌套.git、node_modules或构建产物。 - 根包必须通过
file:./pi-chrome提供依赖并直接加载仓库源码,不得同时安装或加载 npm 预编译入口。 - 控制默认锁定,每个 Pi session 必须显式
/chrome authorize;未授权时不注册 Chrome 工具。显式授权后出现的 21 个chrome_*工具必须由 Tool Search 分入chrome-navigation、chrome-interaction、chrome-debugging,不得落入 unknown-tools 模型增强路径。授权撤销或过期时必须停用全部 21 个工具,包括chrome_find/chrome_inspect;Tool Search 重新激活 schema 不能替代每次执行时的授权校验。 - 完整 Chrome snapshot 不得进入普通工具文本或
details;只能原子写入当前项目.pi/chrome-context/<session>/<target>/snapshot.json,使用哈希目录、POSIX700目录 /600文件,并只返回工作区相对路径和有界元数据。快照不得跨 Session 持久化,Session 启动/关闭、撤销和授权过期必须清理。 chrome_snapshot和带includeSnapshot=true的动作必须引导模型立即使用ctx_execute_file,不得使用read/cat把原始 JSON 重新塞入上下文;任何可能改变页面或目标的成功操作必须使旧快照失效,chrome_find只可额外返回有界匹配摘要。- 修改 bridge、Companion 扩展、授权 lifecycle、快照存储或加载入口后至少运行包内
npm test、根 Tool Routing/Tool Search/扩展联合加载测试、npm pack --dry-run --json和实际 packed tarball 隔离安装验证;未经明确要求不得连接或控制真实 Chrome。