Files
my-pi/pi-chrome/UPSTREAM.md
T
云服务部-叶林立 879fc5d37f docs(upstream): 将 UPSTREAM.md 来源记录统一改为中文维护
把 12 份 UPSTREAM.md 来源记录全部翻译为中文,并把中文定为这份仓库自有
维护文档的强制语言。

- 翻译 hippo-memory-pi、pi-ask-user、pi-chrome、pi-compaction、
  pi-extension-codex-fast-mode、pi-minimal-footer、pi-notify、
  pi-permission-system/docs/auto-review、pi-ssh、pi-subagents 与
  pi-tool-search 的来源记录。
- 在 AGENTS.md 增加纪律:每个自维护扩展目录必须保留中文 UPSTREAM.md,
  内容涵盖官方仓库、tag/commit、导入版本、导入日期、许可证归属、本地
  改动清单与同步上游时的约束。
- 明确边界:UPSTREAM.md 属于仓库自有的维护文档,因此使用中文;上游自带
  的源码、测试、文档、README、CHANGELOG 与 LICENSE 一律保持原文,不翻
  译、不改写,避免同步上游时产生无意义 diff 并破坏许可证原文完整性。
- 所有 40 位 commit、tag/版本号、仓库 URL 与许可证路径原样保留,仅翻译
  叙述性文字。

验证:12 份文件均无残留英文正文;逐份复核了 commit、版本、URL 与
LICENSES/ 路径未发生改变。
2026-10-13 23:19:01 -07:00

1.6 KiB
Raw Blame History

上游来源

  • 官方仓库:https://github.com/tianrendong/pi-chrome
  • 导入 npm 版本:pi-chrome@0.15.46
  • 导入 commit:017ff4b9a639f0b8b213e58a3f30613fc38edcc8
  • Commit 日期:2026-07-07T01:30:54-04:00
  • 导入依据:pi-chrome@0.15.46 官方 npm 元数据中记录的 gitHead;没有任何上游 tag 指向该 commit。
  • 初始本地导入:2026-08-28

被跟踪的上游源码、测试、文档、脚本和许可证均从官方 Git 仓库导入。不保留嵌套 .git、依赖目录、覆盖率与构建产物。

本地维护

本目录由 my-pi 组合包直接维护,不是 submodule。根包加载本目录中的 extensions/chrome-profile-bridge/index.ts,并通过 file:./pi-chrome 依赖它;不得并行加载 npm 预编译扩展入口。

导入后的本地改动:

  • Chrome 快照以原子方式写入当前项目 .pi/chrome-context/ 目录下的 owner-only、Session 临时文件,而不是把原始页面结构返回给模型上下文。
  • 每个 Session/目标只保留最新快照;浏览器交互会使陈旧捕获失效,Session 关闭时移除该 Session 目录。
  • chrome_find 返回紧凑的排序匹配,同时把完整结构化快照保留在 Session 本地捕获中,供可选的 ctx_execute_file 分析使用。
  • click/type/fill/key 上的 includeSnapshot=true 会保存动作后的快照并返回其捕获路径,而不是把快照嵌入工具结果。

同步上游时,请以导入 commit 为基准比较并选择性移植改动。不得整体覆盖这些本地生命周期、隐私和 Context Mode 集成。