Skip to content

docs: 说清真实的依赖布局与「本仓库 main 会进内核 CI」 - #4

Merged
worable233 merged 1 commit into
mainfrom
docs/contributing-kernel-ci
Oct 24, 2026
Merged

worable233 merged 1 commit into
mainfrom
docs/contributing-kernel-ci

Conversation

@worable233

Copy link
Copy Markdown
Owner

配套内核 PR #24 / #25。

改了什么

CONTRIBUTING.md 两节:

  1. 「本工作区无法独立安装」→「依赖并排的内核检出」:原文给的两种准备依赖的方式
    与现状不符。实际机制是 pnpm-workspace.yaml 里的
    link:../StackPanel/packages/*(外加 zod,保证跨边界只有一个 schema 实例),
    前提是内核并排检出、已 pnpm install、且 spec/sdk/ui/net-guard 已构建;
    pnpm dev:setup 会校验这些前置条件。

  2. 「提交前必须通过」:补 frontend 的单独构建,并说明两个实测约束 ——

    • 前端包只有 build: tsup、没有 prepare,全新 clone 没有 frontend/dist;
      只抄 manifest 不抄产物,内核会判定该包「未就绪」(/ready 503 且
      pendingFrontends 里是它)。
    • 内核 CI 现在会在 Test 前克隆本仓库默认分支、对本内核构建并安装
      referral/ticket/invoice,再跑内核侧集成测试。本仓库 main 构建坏了,
      表现是内核 CI 红
      ;本仓库自身只有 i18n 门禁,没有完整 CI。

CONTRIBUTING 里「本工作区无法独立安装」那节已经过时:现在 pnpm-workspace.yaml 用
`link:../StackPanel/packages/*` 覆盖,前提是内核并排检出并已构建 spec/sdk/ui/net-guard,
由 `pnpm dev:setup` 校验。

同时补两条实测踩到的约束:

- 插件前端是独立工作区项目,只有 `build: tsup`、没有 `prepare`,全新 clone 里没有
  `frontend/dist`;只抄 manifest 不抄产物,内核会判定该包「未就绪」。
- 内核 CI 现在会在 Test 前克隆本仓库默认分支并安装 referral/ticket/invoice(否则那
  几个套件会 skip,CI 绿但没覆盖),所以本仓库 main 构建坏了会表现为内核 CI 红。
@worable233
worable233 merged commit 725733a into main Oct 24, 2026
1 check passed
@worable233
worable233 deleted the docs/contributing-kernel-ci branch October 24, 2026 14:24
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