Skip to content

fix(cli): 对齐 v2 扩展管理并完善贡献约定 - #153

Draft
xiaoland wants to merge 3 commits into
mainfrom
feat/ecosystem-contribution-dx
Draft

xiaoland wants to merge 3 commits into
mainfrom
feat/ecosystem-contribution-dx

Conversation

@xiaoland

@xiaoland xiaoland commented Oct 22, 2026 •

Copy link
Copy Markdown
Member

意图与范围

关联任务:生态开发与开源贡献体验。主要实现 scope:cli;受影响发布项目:inkcre-cli。贡献指南作为独立文档提交,便于分别审查。

真实运行发现 CLI 0.2.1 向旧安装接口发送请求,当前 Core 返回 405;配置 schema 也仍从已不提供该字段的共享 identity 读取。

  • 用 select --distribution python|module_federation --version VERSION [--peer] 和 unselect [--peer] 调用当前 selection API,保留 DELETE 回执。
  • 添加当前接入 Peer 的 status,从其 v2 状态读取配置 schema;不混淆共享配置与 Peer 本地选择。
  • 更新 CLI 帮助、开发说明和贡献指南;加入破坏性变更片段,不手工改版本或 changelog。
  • 将三项 HTTP 边界回归测试纳入 CLI check,不添加依赖。

验证证据

  • pdm run -p cli check 通过:lint、format、typecheck、3 项 unittest。
  • pdm build -p cli 成功生成 wheel/sdist。
  • 提交后 pdm run python scripts/release.py check --base origin/main 通过。
  • 在独立 Docker pgvector PostgreSQL 和真实 Core 上执行实际 wheel 生命周期:选择时下载、管理重启、启用、Source 创建/采集、状态与配置读取、disable/unselect;取消选择后共享配置、Source 和关系保留。实验资源已清理。
  • HTTP 测试覆盖两种 Distribution、Peer 路由 query、DELETE 回执和 schema 发现。没有运行整个根项目 pdm run check,也未端到端实测远端 Web Peer 转发。

风险与回退

这是命令兼容性变更:旧 install/uninstall 不再保留为含糊别名,使用者需迁移到 select/unselect。.removed.md fragment 交给现有发布系统计算版本。无数据库 schema 或迁移变化。发布前可回退本 PR;旧 CLI 仍有当前 Core 的 405 问题,不能视为可用的运行时回退方案。

交付影响

CLI 正式发版与网站命令说明需协调。当前仅创建 draft PR,不发布 CLI、不更新任何共享数据库,也不更改 Spoke 子模块指针。发布后应更新网站临时 checkout 安装说明。

关联交付

没有父子堆叠关系;同批交付如下。CLI 与网站需协调,UI 合并仍需明确发布审批。

- 区分主要实现 scope 与独立发布项目范围
- 补齐 fork CI、安装依赖和 CLI 验证说明
- 使用 Peer selection API 并保留取消选择回执
- 从当前 Peer 状态发现配置 schema,增加 status 命令
- 添加 HTTP 边界回归测试和破坏性变更片段

This branch was successfully deployed

1 active deployment
preview — a2c800c2 Deployed Oct 25, 2026 by xiaoland via impl-py preview #508
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant