@lark-apaas/coding-template-nestjs-react-fullstack 0.1.42 → 0.1.43-alpha.20260918074821
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -0
- package/package.json +1 -1
- package/template/package-lock.json +692 -48
- package/template/package.json +4 -4
- package/template/scripts/build.sh +139 -52
- package/template/scripts/prune-smart.js +100 -11
- package/template/scripts/run.sh +4 -1
- package/template/tsconfig.node.json +2 -1
package/README.md
CHANGED
|
@@ -27,6 +27,16 @@ MIAODA_APP_TYPE=3 npx @lark-apaas/miaoda-cli@<latest> app init \
|
|
|
27
27
|
- `SANDBOX_PUBLIC_URL` —— 沙箱公网域
|
|
28
28
|
- `CLIENT_BASE_PATH=/app/<app_id>/` —— React Router basename + Vite base
|
|
29
29
|
|
|
30
|
+
## MCP UI 的类型与代码检查
|
|
31
|
+
|
|
32
|
+
创建 MCP UI 时，Agent 在 `server/mcp/ui` 中同时生成 `tsconfig.json` 和 `eslint.config.cjs`，修改 UI 或其 shared 依赖后主动运行独立检查。模板和 CLI 不生成 UI 配置，也不将 UI 检查接入主工程 lint/type:check。
|
|
33
|
+
|
|
34
|
+
主工程保留原 client/server 检查。Agent 从工程根执行 `npx --no-install tsc --noEmit --project server/mcp/ui/tsconfig.json`，再执行 `npx --no-install eslint --config server/mcp/ui/eslint.config.cjs "server/mcp/ui/**/*.{ts,tsx,js,jsx}" --max-warnings 0`；必须检查退出码并修复错误。无需辅助脚本或新增 npm 命令。
|
|
35
|
+
|
|
36
|
+
CLI 不注入 MCP UI 检查命令；主工程保留原有 client/server 检查，UI 由 Agent 按独立配置执行标准 tsc/eslint。
|
|
37
|
+
|
|
38
|
+
存量 sync 不改写 ESLint 源码；UI 全局排除项由平台 ESLint 预设提供。TS 仅向已有显式 `exclude` 数组追加目录，保留注释和原项；依赖继承且未显式声明 `exclude` 的自定义配置保持不变并提示人工调整。自定义检查命令保留。UI ESLint 配置可显式引用 `fullstack-presets/lib/mcp/eslint-ui`。
|
|
39
|
+
|
|
30
40
|
## 包结构
|
|
31
41
|
|
|
32
42
|
```
|
|
@@ -39,3 +49,11 @@ MIAODA_APP_TYPE=3 npx @lark-apaas/miaoda-cli@<latest> app init \
|
|
|
39
49
|
`template/` 内以下划线开头的占位文件（`_gitignore` / `_npmrc` / `_env.local`）在 `miaoda app init`
|
|
40
50
|
渲染时会按 RENAME 映射改回正常名（npm pack 会特殊处理 `.gitignore`、且 `.npmrc` 直接放
|
|
41
51
|
在包里会污染用户 `npm install` 行为，所以都要 underscore 前缀）。
|
|
52
|
+
|
|
53
|
+
## MCP 版本与 UI 检查
|
|
54
|
+
|
|
55
|
+
模板不生成 `mcp-build-id`，构建脚本沿用原流程。SDK 发布态使用 veFaaS 函数 ID 与发布 revision；开发态使用后端编译产物指纹，UI/Skill 内容继续独立计入修订。首次升级切换版本来源后，Host 应重新发现。
|
|
56
|
+
|
|
57
|
+
MCP UI 的 `tsconfig.json` 和 `eslint.config.cjs` 由 Agent 随 UI 在 `server/mcp/ui` 中创建，执行命令与完整示例见 coding-steering 的 `mcp-ui-guide`。主工程的 TS/ESLint 排除该浏览器目录，不自动运行 UI 检查；不为无 UI 的应用创建配置或检查命令。
|
|
58
|
+
|
|
59
|
+
`server/mcp/ui` 与 `server/mcp/skills` 变更应由平台判为后端发布；纯前端发布不替换已部署 MCP 产物，也不承诺热更 MCP UI。发布版本号仅在实际后端发布时更新。
|