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:
云服务部-叶林立
2026-10-13 23:19:01 -07:00
parent ff1e7400da
commit 879fc5d37f
12 changed files with 127 additions and 136 deletions
+23 -23
View File
@@ -1,31 +1,31 @@
# Upstream sources
# 上游来源(多个)
This package is maintained directly in `my-pi` and combines two separately licensed sources with a new local Context Authority.
本包由 `my-pi` 直接维护,组合了两份独立许可的来源,并新增了一套本地 Context Authority。
## pi-condense reference
## pi-condense 参考
- Official repository: https://github.com/jjuraszek/pi-condense
- Snapshot: `59c95110aacd8131db71e21296765dd80b72fae8`
- Tag/version: `v2.9.1`
- Used as a behavioral and summarizer-reliability reference. The new segment/index/runtime implementation is local and intentionally does not retain legacy formats.
- License: `LICENSES/pi-condense-MIT.txt`
- 官方仓库:https://github.com/jjuraszek/pi-condense
- 快照:`59c95110aacd8131db71e21296765dd80b72fae8`
- Tag/版本:`v2.9.1`
- 作为行为与摘要器可靠性参考使用。新的 segment/index/runtime 实现为本地实现,且有意不保留旧格式。
- 许可证:`LICENSES/pi-condense-MIT.txt`
## Pi Codex compaction source
## Pi Codex compaction 源码
- Official repository: https://github.com/ogulcancelik/pi-extensions
- Package path: `packages/pi-codex-compaction/`
- Snapshot: `c4d6ca8fb484ba51684296ba8b4715f8c7b3ac91`
- Version at snapshot: `0.1.4`
- Imported source: remote compaction protocol, Response API conversion, retention helpers, retry parsing, and request sanitization in `src/native-compaction.ts`.
- Local changes: unified checkpoint kind/version, removed raw-branch effective-input construction and legacy checkpoint parsing, exported the shared message projection, made retained-user budget configurable, and renamed the client user agent.
- License: `LICENSES/pi-codex-compaction-MIT.txt`
- 官方仓库:https://github.com/ogulcancelik/pi-extensions
- 包路径:`packages/pi-codex-compaction/`
- 快照:`c4d6ca8fb484ba51684296ba8b4715f8c7b3ac91`
- 快照时版本:`0.1.4`
- 导入源码:`src/native-compaction.ts` 中的远端压缩协议、Response API 转换、保留辅助函数、重试解析和请求净化。
- 本地改动:统一 checkpoint kind/version,移除 raw-branch effective-input 构造与旧 checkpoint 解析,导出共享消息投影,使保留用户预算可配置,并重命名客户端 user agent。
- 许可证:`LICENSES/pi-codex-compaction-MIT.txt`
No npm tarball, npm cache, `node_modules`, build output, or nested Git metadata is used as an import source.
不得以 npm tarball、npm 缓存、`node_modules`、构建产物或嵌套 Git 元数据作为导入源。
## Sub2API protocol reference
## Sub2API 协议参考
- Official repository: https://github.com/Wei-Shaw/sub2api
- Reference commit: `ab99d56e9626e6cd731592dae8553c9758a0efa2`
- Protocol evidence: `backend/internal/service/openai_compact_body_signal.go` identifies native remote compaction v2 as Responses plus `stream: true` and `compaction_trigger`, and handles the Codex beta feature.
- The local `src/native-provider.ts` adapter is independently implemented against that protocol. No Sub2API source was imported; the existing Codex serializer, stream parser and checkpoint format are reused.
- This reference describes upstream capability, not a guarantee about any particular deployment, model or account. The separate Responses compact endpoint is not used by this adapter.
- 官方仓库:https://github.com/Wei-Shaw/sub2api
- 参考 commit:`ab99d56e9626e6cd731592dae8553c9758a0efa2`
- 协议证据:`backend/internal/service/openai_compact_body_signal.go` 指出原生远端压缩 v2 为 Responses 加 `stream: true` 与 `compaction_trigger`,并处理 Codex beta 特性。
- 本地 `src/native-provider.ts` 适配器是针对该协议独立实现的。没有导入任何 Sub2API 源码;复用现有 Codex 序列化器、流解析器和 checkpoint 格式。
- 该参考描述的是上游能力,不构成对任何特定部署、模型或账号的保证。本适配器不使用单独的 Responses compact 端点。