mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 18:55:22 +00:00
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/ 路径未发生改变。
This commit is contained in:
+16
-16
@@ -1,23 +1,23 @@
|
||||
# Upstream source
|
||||
# 上游来源
|
||||
|
||||
- Official repository: <https://github.com/tianrendong/pi-chrome>
|
||||
- Imported npm version: `pi-chrome@0.15.46`
|
||||
- Imported commit: `017ff4b9a639f0b8b213e58a3f30613fc38edcc8`
|
||||
- Commit date: `2026-07-07T01:30:54-04:00`
|
||||
- Import basis: the `gitHead` recorded in the official npm metadata for `pi-chrome@0.15.46`; no upstream tag points at this commit.
|
||||
- Initial local import: 2026-08-28
|
||||
- 官方仓库:<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
|
||||
|
||||
The tracked upstream source, tests, documentation, scripts, and license were imported from the official Git repository. Nested `.git`, dependency directories, coverage, and build output are not retained.
|
||||
被跟踪的上游源码、测试、文档、脚本和许可证均从官方 Git 仓库导入。不保留嵌套 `.git`、依赖目录、覆盖率与构建产物。
|
||||
|
||||
## Local maintenance
|
||||
## 本地维护
|
||||
|
||||
This directory is maintained directly by the `my-pi` bundle and is not a submodule. The root package loads `extensions/chrome-profile-bridge/index.ts` from this directory and depends on it through `file:./pi-chrome`; the npm prebuilt extension entry must not be loaded in parallel.
|
||||
本目录由 `my-pi` 组合包直接维护,不是 submodule。根包加载本目录中的 `extensions/chrome-profile-bridge/index.ts`,并通过 `file:./pi-chrome` 依赖它;不得并行加载 npm 预编译扩展入口。
|
||||
|
||||
Local changes after the import:
|
||||
导入后的本地改动:
|
||||
|
||||
- Chrome snapshots are written atomically to owner-only, session-local files under the active project's `.pi/chrome-context/` directory instead of returning raw page structure to model context.
|
||||
- Each session/target keeps only its latest snapshot; browser interactions invalidate stale captures and session shutdown removes the session directory.
|
||||
- `chrome_find` returns compact ranked matches while keeping the complete structured snapshot in the session-local capture for optional `ctx_execute_file` analysis.
|
||||
- `includeSnapshot=true` on click/type/fill/key saves the post-action snapshot and returns its capture path rather than embedding the snapshot in the tool result.
|
||||
- Chrome 快照以原子方式写入当前项目 `.pi/chrome-context/` 目录下的 owner-only、Session 临时文件,而不是把原始页面结构返回给模型上下文。
|
||||
- 每个 Session/目标只保留最新快照;浏览器交互会使陈旧捕获失效,Session 关闭时移除该 Session 目录。
|
||||
- `chrome_find` 返回紧凑的排序匹配,同时把完整结构化快照保留在 Session 本地捕获中,供可选的 `ctx_execute_file` 分析使用。
|
||||
- click/type/fill/key 上的 `includeSnapshot=true` 会保存动作后的快照并返回其捕获路径,而不是把快照嵌入工具结果。
|
||||
|
||||
When syncing upstream, compare against the imported commit and port changes selectively. Do not overwrite these local lifecycle, privacy, and Context Mode integrations wholesale.
|
||||
同步上游时,请以导入 commit 为基准比较并选择性移植改动。不得整体覆盖这些本地生命周期、隐私和 Context Mode 集成。
|
||||
|
||||
Reference in New Issue
Block a user