同步 CLIProxy 转换核心与渠道适配器

同步 CLIProxy 转换核心与渠道适配器

一次同步 CLIProxyAPI 的四协议纯转换核心、已登记 provider adapters 及其对应测试。保持 ccLoad Registry 和 provider wire 契约，不引入上游运行时系统。

• 默认调用 $sync-cliproxy-core 时，自动固定上游最新稳定版本，并在同一次操作中完成 core 与全部已登记 provider adapters 的比较、集成、来源更新和验证；用户明确指定 commit/tag 时使用指定目标。
• 仅审计时保持只读：固定比较目标、核对来源与 manifest、报告差异和验证结果，不进入集成变更或更新来源步骤；未指定比较目标时使用 UPSTREAM.md 已记录的 commit。
• 阅读或编辑本技能本身不执行同步。

原子同步契约

• core 与 provider adapters 必须来自同一 checkout 的同一不可变 commit；只生成一份变化清单，只更新一次来源 commit 和同步日期，只运行一套完成验证。
• 任一同步域无法移植、缺少匹配测试或验证失败时，整个同步未完成。不提供隐式 core-only 降级；用户明确缩小范围时只能审计，不得把部分写入报告成完整同步。

权威边界

1. 按任务读取 协议转换边界、internal/protocol/cliproxy/UPSTREAM.md、core snapshot manifest、provider adapter 语义边界和provider manifest。UPSTREAM.md 是来源、固定提交和已落地状态的唯一事实源；core manifest 记录直接映射根、特殊映射、明确排除和最近一次 core/provider 原子差异的审查 blob，provider manifest 是 provider、逐文件映射、生产接线和契约测试的唯一 allowlist。
2. internal/protocol/registry.go 定义四协议契约；internal/protocol/builtin/cliproxy_adapter.go 处理通用输入验证、JSON/SSE 规范化和流帧封装；internal/protocol/cliproxy/providers/ 保存 provider-specific 纯转换。
3. provider 选择留在 ccLoad 请求上下文边界，按实际 wire dialect/AuthType 决定；不要把 provider 注册成第五种通用客户端协议。
4. 不引入 CLIProxyAPI 的认证、配置、路由、缓存服务、插件、动态 Registry、executor 或网络刷新代码。Interactions 只有在 ccLoad 正式支持其线协议后才可登记。
5. 不添加 CLIProxyAPI 运行时 Go module 依赖或 replace。源码继续使用 ccLoad/internal/protocol/cliproxy/... 导入路径。
6. Registry 与 provider 边界测试是 ccLoad 兼容性权威。上游行为与本地线协议冲突时，修正根因并保留本地契约，不盲目覆盖。

同步流程

1. 预检

• 确认当前目录属于 ccLoad，并检查 git status --short。
• 保护已有修改。若工作区改动覆盖 core、providers、适配器、Registry、go.mod、go.sum 或 UPSTREAM.md，先区分用户修改与本次同步；无法安全隔离时停止并说明冲突。
• 记录当前同步 commit 和目标 commit。

2. 固定目标

• 上游 checkout：本机存在 ~/Source/go/CLIProxyAPI 时优先使用，否则在临时目录克隆 UPSTREAM.md 记录的仓库。core、provider 生产源码与测试必须全部来自这个 checkout 的同一个 commit。
• 用户指定 commit/tag 时，解析成完整不可变 commit SHA。
• 用户未指定目标或只说“同步最新”时，以当前记录 tag 去掉 MAJOR.MINOR.PATCH 后的前缀作为稳定 tag 系列（记录为 fork/vX.Y.Z 时系列为 fork/v），按语义版本选最高版本并解引用为 commit；忽略预发布 tag，禁止按字典序或提交时间猜版本：

repo=<UPSTREAM.md 的 Repository>; series=<tag 系列>; upstream=<上游 checkout>
tag="$(git ls-remote --tags --refs "$repo" "refs/tags/${series}*" | sed 's#.*refs/tags/##' \
  | grep -E "^${series}[0-9]+\.[0-9]+\.[0-9]+$" | sort -V | tail -1)"