工程检查与部署
常用命令
| 命令 | 用途 |
|---|---|
pnpm env:check | 校验 Node、pnpm 与依赖安装 |
pnpm dev | 同步图标清单并启动 Vite |
pnpm harness context | 查任务域；追加 routing、ui、api 等可看实现入口和回归 |
pnpm harness verify ui | 按域运行定向测试 |
pnpm harness verify | 运行全量检查并生成本地报告 |
pnpm typecheck | 验证图标清单，检查应用、Node 配置和测试类型 |
pnpm dev-build / pnpm report | 构建开发版，或输出静态打包报告 |
pnpm build / pnpm preview | 构建并在本机验收产物 |
全量检查包含环境、Harness、图标同步、类型、ESLint、Prettier、Vitest 和生产构建。Harness 在 .harness-local/runs/ 写结果；Chrome 验收单独记录。改动交互或布局时，额外验收中英文、明暗主题和窄屏。
部署到子路径
pnpm build 输出 dist/production。将产物部署到与 vite.custom.config.ts 中 base 对应的路径。默认应用为 /ray-template/，域名根目录部署改为 /。Vite 默认打包本地依赖；可选 CDN 模式需另外确认目标环境能访问 CDN。
公开生产部署可在构建环境设置 RAY_TEMPLATE_SITE_ORIGIN 为实际站点源地址（例如 https://example.com），由 base 补足路径。未配置时应用产物使用 noindex。公开 sitemap 列出入口页，登录后的 hash 路由用于应用交互。
二次开发约定
- 新页面遵循 Vue 3 Composition API + TSX 或现有 SFC 模式。复用现有组件，声明按职责归档。
- Vue、Router、Pinia 的自动导入声明由生成器维护；类型使用
import type。应用、测试、Node 配置的 TS 边界不同。 - 格式由 Prettier 管理，ESLint 使用 flat config。提交约定和注释写法以应用仓库当前规则为准。
工程与部署入口 · AI Harness · 注释规范