贡献 — 加入实验室
构建它 与我们一起。
面向 Web Standards Lab 的精确、Node 优先的贡献者工作流。
§1 — 环境设置
git clone https://github.com/open-element/openelement.git
cd openelement
pnpm install
pnpm testopenElement 核心 CLI、SSG、serverless API、测试、发布与文档站任务都运行在 Node 24.2+ 上，以 pnpm 作为包管理器。任务通过 pnpm run <task> 或 vp 任务器驱动——主工作流不需要 npm 或 npx 的全局安装。
发布线
- 运行 pnpm --dir tools/repo run version-bump
- 更新 changelog
- 运行 pnpm test
- 通过 pnpm --dir tools/release run pack:dry-run、pnpm run release:check、pnpm --dir tools/release run publish:npm 发布
- 创建 GitHub Release
§2 — 提交 PR 之前
- pnpm run fmt + pnpm run lint 保持干净
- Conventional Commits（feat / fix / docs / refactor / test / chore）
- 本地门禁全绿——推送前先跑 pnpm run check 和 pnpm test
- 涉及架构变更？先写 ADR
分层纪律：新增功能之前，先检查能否在更低层解决——L0 HTML、L1 CSS、L2 浏览器 API、L3 Hono/Vite/Lit，最后才是 L4 自定义代码。
§3 — 可以从哪里入手
第三方 WC 语料库
让 Lit / FAST / Stencil 组件跑通我们的 DSD 冒烟管线，并留下证据。
真实 dogfood
在稳定线上构建一个真实应用，把遇到的问题记录下来。这就是当前的试点。
文档真值
运行文档门禁，修掉过期论断，让公开面始终有证据支撑。