mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 10:45:22 +00:00
云服务部-叶林立
879fc5d37f
把 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/ 路径未发生改变。
24 lines
1.6 KiB
Markdown
24 lines
1.6 KiB
Markdown
# 上游来源
|
||
|
||
- 官方仓库：<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 集成。
|