@_tc/template-core 0.2.12 → 0.3.0

package/AGENT_README.md

@@ -8,8 +8,9 @@ TemplateCore 是一个 TypeScript + Koa + React 的后台框架包。它提供
 
 - Koa 服务启动和约定式后端加载。
 - 内置 Dashboard、Schema CRUD 页面和 React UI 组件库。
-- `model/` 配置驱动的菜单、项目和 CRUD 页面。
+- `models/` 配置驱动的菜单、项目和 CRUD 页面。
 - 前端构建 `buildFE()` 输出服务端可渲染的 `.entry.tpl`，并写入 `FEBuildKey` 供 HTML ETag 缓存失效使用。
+- SSR 页面构建 `buildSSR()` 输出 server/client 双产物，默认通过 `/fessr/:page` 服务端渲染。
 - 消费方 Node/backend 构建 `buildBE()`。
 - 类型扩展机制，用于扩展 SchemaForm 字段、SchemaTable 单元格渲染组件、CallCom 组件和 Koa app 类型。
 
@@ -18,16 +19,20 @@ TemplateCore 是一个 TypeScript + Koa + React 的后台框架包。它提供
 | 入口 | 用途 |
 | --- | --- |
 | `@_tc/template-core` | `serverStart`、`baseFn`、Koa/Controller/Service 类型。 |
-| `@_tc/template-core/bundler` | `buildFE()`、`buildBE()`。 |
-| `@_tc/template-core/fe` | 前端初始化、动态组件渲染辅助、请求方法、Dashboard/Schema 类型、token 工具、RAF 计时器、共享状态、业务前端组件。 |
+| `@_tc/template-core/bundler` | `buildFE()`、`buildBE()`、`buildSSR()`、`watchSSRFiles()`。 |
+| `@_tc/template-core/ssr` | `SSRPropsContext`、`SSRPageMetaResolver`、`StreamingRender`、`useSuspensePromise`。 |
+| `@_tc/template-core/ssr/createSSREntry` | SSR 页面客户端 hydration 工厂。 |
+| `@_tc/template-core/ssr/components` | SSR 组件汇总入口，导出 `StreamingRender`。 |
+| `@_tc/template-core/ssr/hooks` | SSR hooks 汇总入口，导出 `useSuspensePromise`。 |
+| `@_tc/template-core/fe` | 前端初始化、动态组件渲染辅助、请求方法、Dashboard/Schema 类型、token 工具、RAF 计时器、共享状态、项目侧前端组件。 |
 | `@_tc/template-core/fe/main` | 前端初始化入口。 |
 | `@_tc/template-core/fe/common/request` | 请求实例、请求方法和请求类型的显式子路径。 |
 | `@_tc/template-core/fe/rc` | React UI 组件和 SchemaForm 组件。 |
 | `@_tc/template-core/fe/rc/hooks` | React hooks 汇总入口。 |
 | `@_tc/template-core/fe/tailwind_ui.css` | 内置前端/UI 全局样式。 |
-| `@_tc/template-core/model` | `ModelDataType` 等 model 配置类型。 |
+| `@_tc/template-core/models` | `ModelDataType` 等 models 配置类型。 |
 
-## 2. 最小业务项目
+## 2. 最小使用方项目
 
 推荐结构：
 
@@ -40,11 +45,13 @@ my-admin/
 │       └── product.ts
 ├── config/
 │   └── config.default.ts
-├── model/
+├── models/
 │   └── product/
 │       ├── mode.ts
 │       └── project/
 │           └── demo.ts
+├── ssr/
+│   └── apps/          # SSR 页面入口，可选
 └── index.ts
 ```
 
@@ -86,7 +93,7 @@ export default {
 }
 ```
 
-`auth.ATKey` / `auth.RTKey` 是业务鉴权中间件读取短 token 和刷新 token header 的默认约定；默认分别是 `Authorization` / `RT`。
+`auth.ATKey` / `auth.RTKey` 是项目鉴权中间件读取短 token 和刷新 token header 的默认约定；默认分别是 `Authorization` / `RT`。
 
 `resourceCacheTimeMs` 控制生产环境静态资源缓存时间，单位是 ms，默认 5 分钟。
 
@@ -96,24 +103,25 @@ export default {
 http://localhost:9000/dash?projk=demo
 ```
 
-`projk` 对应 `model/{modelKey}/project/{projectKey}.ts` 里的 `projectKey`，运行时按 project key 全局查找，建议保持全局唯一。
+`projk` 对应 `models/{modelKey}/project/{projectKey}.ts` 里的 `projectKey`，运行时按 project key 全局查找，建议保持全局唯一。
 
 ## 3. 后端约定
 
-`serverStart({ baseDir })` 会按目录自动加载业务代码；`model/` 由内置 project service 通过 `modelLoader(app)` 读取，不会在 `serverStart` 阶段直接挂到 `app.model`：
+`serverStart({ baseDir })` 会按目录自动加载项目代码；`models/` 由内置 project service 通过 `modelLoader(app)` 读取，不会在 `serverStart` 阶段直接挂到 `app.model`：
 
 ```text
 app/controller/**/*.(js|ts)      -> app.controller
 app/service/**/*.(js|ts)         -> app.service
 app/middlewares/**/*.(js|ts)     -> app.middlewares
-app/middleware.(js|ts)           -> 全局中间件编排，按 frame -> business 顺序执行
+app/middleware.(js|ts)           -> 全局中间件编排，按包内置 -> 使用方项目顺序执行
 app/router/**/*.(js|ts)          -> Koa router
 app/router-guard.(js|ts)         -> 兜底路由守卫
 app/router-schema/**/*.(js|ts)   -> app.routerSchema
 app/extends/*.(js|ts)            -> app.extends
 config/config.default.(js|ts)    -> app.config
 config/config.{env}.(js|ts)      -> app.config
-model/**/*.(js|ts)               -> 内置 project service 读取的项目模型配置
+models/**/*.(js|ts)               -> 内置 project service 读取的项目模型配置
+ssr/apps/**/*.entry.(js|jsx|ts|tsx) -> SSR 页面入口，可选
 ```
 
 常用后端类型：
@@ -185,7 +193,7 @@ export default ((app, router) => {
 - 每个 `app/router/*.ts` 文件都会获得独立的 `koa-router` 实例。
 - 可以通过 `router.level = number` 控制挂载顺序，数值越小越早挂载。
 - 默认 `level` 是 `0`，框架兜底 router 是 `99`。
-- 通配、兜底、重定向类路由建议设置较大的 `level`，避免抢先匹配业务 API。
+- 通配、兜底、重定向类路由建议设置较大的 `level`，避免抢先匹配项目 API。
 
 ```ts
 import type { RouterFN } from '@_tc/template-core'
@@ -217,21 +225,21 @@ export default (_app: KoaApp) => {
 
 - `app.extends.$fetch`：Node 侧 axios 风格 fetch 实例。
 - `app.extends.crypto`：Node 侧加密辅助方法，支持 base64url 编解码、HMAC 签名、签名 payload 和常量时间比较。
-- `app.extends.db`：默认 SQLite 数据存储，可用业务 `app/extends/db.ts` 覆盖。
+- `app.extends.db`：默认 SQLite 数据存储，可用项目侧 `app/extends/db.ts` 覆盖。
 
-## 4. model 配置
+## 4. models 配置
 
-`model` 是内置 Dashboard 和 Schema CRUD 的数据源。
+`models/` 是内置 Dashboard 和 Schema CRUD 的数据源。
 
 ```text
-model/{modelKey}/mode.ts                  -> 模型模板
-model/{modelKey}/project/{projectKey}.ts  -> 项目覆盖
+models/{modelKey}/mode.ts                  -> 模型基础配置
+models/{modelKey}/project/{projectKey}.ts  -> 项目覆盖
 ```
 
 `mode.ts` 示例：
 
 ```ts
-import type { ModelDataType } from '@_tc/template-core/model'
+import type { ModelDataType } from '@_tc/template-core/models'
 
 const model: ModelDataType = {
   mode: 'MB',
@@ -349,7 +357,7 @@ export default {
 - `project` 会继承同目录上层 `mode`。
 - 对象递归合并，`project` 覆盖 `mode`。
 - 数组按 `key` 合并：同 key 覆盖，不同 key 新增。
-- `model/index.ts` 和 `model/index.js` 会被 loader 跳过。
+- `models/index.ts` 和 `models/index.js` 会被 loader 跳过。
 
 常见菜单模块：
 
@@ -429,7 +437,7 @@ import { Button, DataTable, Form, Input, Modal, Select } from '@_tc/template-cor
 - 多语言：`addLanguageResources()` 追加或新增某语种文案，`setLanguage()` 切换语言。React render 中用 `useText()`，非 React 工具代码用 `getText()`；`$i18n::` 前缀会被去掉后查询资源，无前缀字符串会按原 key 查询，未命中时原样返回。配置文案推荐写 `$i18n::...`，也可写普通字符串。
 - 主题：`ThemeSwitch` 会同步根节点 `dark` class 和 `localStorage`。
 - `Input type="password"` 会自动显示密码显隐按钮；`allowClear` 不作用于密码输入。
-- RAF 风格计时器由 `@tc/common/rafTimer` 提供，浏览器优先使用 RAF，Node/SSR 自动降级到 `setTimeout`。
+- RAF 风格计时器通过 `@_tc/template-core/fe` 对外提供，浏览器优先使用 RAF，Node/SSR 自动降级到 `setTimeout`。
 
 不要直接依赖 `frontend/src/...`、`packages/react/ui/...` 这类包内部路径。
 
@@ -490,7 +498,7 @@ frontend/report/index.html      yes
 frontend/report/report.html     yes
 ```
 
-不要在插槽文件里写 `<!DOCTYPE html>`、`<html>`、`<body>` 或 `<div id="root"></div>`。页面外壳由 TemplateCore 的 `app/view/entry.tpl` 统一生成，`window._basePath`、`window._projKey`、`window._signKey`、`window.appOptions` 也由它注入。构建器会把合成后的临时 HTML 写入 `.tc-entry-html/`，这个目录不要提交，也不要在业务代码中引用。
+不要在插槽文件里写 `<!DOCTYPE html>`、`<html>`、`<body>` 或 `<div id="root"></div>`。页面外壳由 TemplateCore 的 `app/view/entry.tpl` 和 `app/html/shell.ts` 共同生成，`window._basePath`、`window._projKey`、`window._signKey`、`window._renderMode`、`window._isSSR`、`window.appOptions` 由共享 shell 片段注入。构建器会把合成后的临时 HTML 写入 `.tc-entry-html/`，这个目录不要提交，也不要在应用代码中引用。
 
 ## 6. 构建
 
@@ -504,9 +512,20 @@ await buildFE('prod', { output: 'run' })
 await buildFE('prod', { output: 'run', minifyHtml: true })
 ```
 
-`buildFE('dev')` 是构建一次并监听业务 `frontend/` 变化后重建，不是 Vite dev server/HMR。
+`buildFE('dev')` 是构建一次并监听使用方 `frontend/` 变化后重建，不是 Vite dev server/HMR。
 `minifyHtml: true` 会压缩最终 `.tpl` 模板输出；构建完成后会写入 `FEBuildKey`，服务端渲染 HTML 时用它判断本地 HTML ETag 缓存是否需要清空。
 
+SSR 页面构建：
+
+```ts
+import { buildSSR, watchSSRFiles } from '@_tc/template-core/bundler'
+
+await buildSSR({ baseDir, output: 'run' })
+await watchSSRFiles({ baseDir, output: 'run' })
+```
+
+SSR 入口约定为 `ssr/apps/{page}/{page}.entry.tsx`，客户端 hydration 工厂从 `@_tc/template-core/ssr/createSSREntry` 引入。页面可导出静态字符串或函数式 `pageTitle` / `pageDescription`，函数会在 `getServerProps()` 后执行，入参包含 `params`、`query`、`path`、`app`、`ctx` 和 `props`。组件级流式异步数据用 `@_tc/template-core/ssr/components` 的 `StreamingRender`；底层 Suspense Promise hook 从 `@_tc/template-core/ssr/hooks` 引入。`buildSSR()` 会输出私有 `{ssrPrivateRoot}/ssr-server/{page}.mjs`、私有 `{ssrPrivateRoot}/ssr-manifest/manifest.json`，SSR hydration 入口并入 FE browser build，页面默认通过 `/fessr/:page` 访问，浏览器静态资源走普通 `/dist/assets/*`；`/dist/ssr-server/*` 和 `/dist/.vite/*` 会被拦截为 404。成功 SSR 会用 React streaming bootstrap 动态 import 客户端入口，带 `Suspense` 边界的 shell 可以先启动 hydration，pending 内容继续 stream。入口文件会被 server/client 两次构建，顶层代码必须同时兼容 Node 和浏览器。`getServerProps()` 运行在 Node 侧，不要直接复用依赖 `window` / `localStorage` 的前端 API 层；服务端请求逻辑拆到 `*.server.ts` 并在 `getServerProps()` 内动态导入。`StreamingRender` 的 `getData()` 返回值会写入 HTML，不能包含 token、密钥等敏感信息；客户端找不到注入数据时也可能执行 `getData()`，需要兼容浏览器 fallback。
+
 Node/backend 构建：
 
 ```ts
@@ -517,7 +536,7 @@ await buildBE()
 
 `buildBE()` 默认：
 
-- 构建当前工作目录的 `index.ts`、`index.js`、`app`、`config`、`model`。
+- 构建当前工作目录的 `index.ts`、`index.js`、`app`、`config`、`models`。
 - 输出到 `dist`。
 - 输出格式为 `cjs`。
 - 外部化 Node 内置模块和 npm 包。
@@ -528,13 +547,13 @@ await buildBE()
 
 ```ts
 await buildBE({
-  input: ['app', 'config', 'model/index.ts'],
+  input: ['app', 'config', 'models/index.ts'],
   outDir: 'dist',
   format: ['es', 'cjs'],
   dts: true,
   alias: {
     '@app': './app',
-    '@model': './model',
+    '@model': './models',
   },
 })
 ```
@@ -546,7 +565,7 @@ await buildBE({
 import { buildBE } from '@_tc/template-core/bundler'
 
 await buildBE({
-  input: ['index.ts', 'index.js', 'app', 'config', 'model'],
+  input: ['index.ts', 'index.js', 'app', 'config', 'models'],
   outDir: 'dist',
   format: 'cjs',
 })
@@ -559,7 +578,7 @@ await buildBE({
 import chokidar from 'chokidar'
 import { buildBE } from '@_tc/template-core/bundler'
 
-const input = ['index.ts', 'index.js', 'app', 'config', 'model']
+const input = ['index.ts', 'index.js', 'app', 'config', 'models']
 
 let building = false
 let pending = false
@@ -613,7 +632,7 @@ chokidar
 
 新增一个 Schema CRUD 页面：
 
-1. 在 `model/{modelKey}/mode.ts` 或 `project/{projectKey}.ts` 添加菜单项。
+1. 在 `models/{modelKey}/mode.ts` 或 `project/{projectKey}.ts` 添加菜单项。
 2. 菜单项使用 `menuType: 'module'`、`moduleType: 'schema'`。
 3. `schemaConfig.api` 指向后端资源 API。
 4. 字段在 `schema.properties` 中配置 `tableOption`、`searchOption`、`createFormOption`、`editFormOption`、`detailPanelOption`。
@@ -621,7 +640,7 @@ chokidar
 
 新增自定义前端页面：
 
-1. 在业务 `frontend/` 下添加入口 `*.entry.tsx`。
+1. 在项目 `frontend/` 下添加入口 `*.entry.tsx`。
 2. 需要样式时引入 `@_tc/template-core/fe/tailwind_ui.css`。
 3. 如需改 head 或 root 前后内容，只添加入口同目录 `.html` 插槽文件，不要写完整 HTML。
 4. 在 `model` 菜单中使用 `moduleType: 'custom'`，让 `customConfig.path` 指向页面路径。
@@ -630,11 +649,11 @@ chokidar
 扩展前端类型或组件：
 
 1. SchemaForm 字段类型、SchemaTable 单元格渲染组件、CallCom 组件、Koa app 类型都支持 TypeScript 声明合并。
-2. 运行时组件通常放在业务 `frontend/extended/`。
+2. 运行时组件通常放在项目 `frontend/extended/`。
 3. 表格单元格渲染组件注册到 `frontend/extended/SchemaPage/SchemaTable/data.ts`，字段上用 `tableOption.renderComponent` 和 `renderComponentProps`。
 4. Dashboard 扩展点包括 `frontend/extended/dash/init.ts`、`frontend/extended/dash/customRoutes.tsx`、`frontend/extended/dash/components.tsx`、`frontend/extended/dash/routeGuard.ts`。
 5. `dash/init` 在 React 渲染前执行，适合注册 axios 拦截器等全局初始化逻辑；类型是 `DashInit`。
-6. `dash/routeGuard` 用来判断登录。返回登录页 URL 字符串时，Dashboard 用 `window.location.href` 跳转；`DashRouteGuardResult` 是 `string | undefined`，`undefined`（包括已登录分支的隐式返回）会打断 Dashboard 内置重定向，业务方可自行跳转。
+6. `dash/routeGuard` 用来判断登录。入参包含 `renderMode: 'csr' | 'ssr'` 和 `isSSR`；返回登录页 URL 字符串时，Dashboard 用 `window.location.href` 跳转；`DashRouteGuardResult` 是 `string | undefined`，`undefined`（包括已登录分支的隐式返回）会打断 Dashboard 内置重定向，项目侧可自行跳转。
 7. 自定义入口的 `initApp` 支持 `beforeRender` / `afterRender`，分别在 React 渲染前和首次渲染提交后触发。
 8. 优先查看公开入口 `.d.ts` 和 npm 包根目录 `README.md`；如果当前环境是源码仓库，再继续读 `docs/type-extension.md` 和 `docs/schema-form.md`。
 
@@ -647,10 +666,10 @@ chokidar
 | 完整安装和使用说明 | npm 包根目录 `README.md` |
 | 生成项目、model、CRUD | npm 包：`.skills/tc-generator/SKILL.md`；源码仓库：`skills/tc-generator/SKILL.md` |
 | 组件选型和用法 | npm 包：`.skills/tc-component-usage-skills/SKILL.md`；源码仓库：`skills/tc-component-usage-skills/SKILL.md` |
-| model/schema 配置细节 | npm 包：`.skills/tc-generator/reference/model-schema.md`；源码仓库：`skills/tc-generator/reference/model-schema.md` |
+| models/schema 配置细节 | npm 包：`.skills/tc-generator/reference/model-schema.md`；源码仓库：`skills/tc-generator/reference/model-schema.md` |
 | 完整 CRUD 示例 | npm 包：`.skills/tc-generator/reference/example.md`；源码仓库：`skills/tc-generator/reference/example.md` |
 | 可复制项目骨架 | npm 包：`.skills/tc-generator/reference/project-template/`；源码仓库：`skills/tc-generator/reference/project-template/` |
 | UI 组件现场预览 | 启动服务后访问 `/ui-components` |
 | 已安装包的类型细节 | 查看对应公开入口的 `.d.ts` 文件 |
 
-如果当前环境是源码仓库而不是 npm 安装目录，还可以继续读 `docs/`、`frontend/README.md`、`model/README.md`、`bundler/README.md` 和 `BUILD.md`。
+如果当前环境是源码仓库而不是 npm 安装目录，还可以继续读 `docs/`、`frontend/README.md`、`models/README.md`、`bundler/README.md`、`ssr/README.md` 和 `BUILD.md`。

package/CHANGE.md

@@ -1,3 +1,46 @@
+# V0.3
+
+TemplateCore v0.3 的首个版本，核心是正式引入 SSR V1。这个版本提供从页面约定、构建产物、运行时渲染到示例文档的一整套 SSR 基础能力。
+
+## SSR V1
+
+- 新增根级 `ssr/apps/{page}/{page}.entry.tsx` 页面入口约定，SSR 页面与原有 CSR 页面目录分离。
+- 新增 `buildSSR()` / `watchSSRFiles()`，从 `@_tc/template-core/bundler` 对外提供 SSR server/client 双产物构建与监听能力。
+- 新增稳定入口 `@_tc/template-core/ssr/createSSREntry`，用于 SSR 页面客户端 hydration。
+- 新增 `@_tc/template-core/ssr`、`@_tc/template-core/ssr/components`、`@_tc/template-core/ssr/hooks` 等稳定入口，导出 `SSRPropsContext`、`SSRPageMetaResolver`、`StreamingRender`、`useSuspensePromise` 等 SSR 类型与辅助能力。
+- SSR 运行时新增默认 `/fessr/:page` 页面路由，并支持通过 `serverStart({ ssrPageBasePath })` 自定义 SSR 页面前缀。
+- SSR controller 支持加载页面 server bundle、调用可选 `getServerProps()`、解析静态或函数式 `pageTitle` / `pageDescription`、注入 `window.__SSR_DATA__`、解析 manifest preload，并通过 React streaming bootstrap 动态 import hydration 入口。
+- SSR / CSR HTML shell 会注入 `window._renderMode` 和 `window._isSSR`，Dash 共用路由守卫可按渲染模式分别处理跳转。
+- 新增 SSR document shell 与错误 fallback，非法页面、bundle 缺失、render / getServerProps 异常都会返回统一 HTML 错误页。
+- SSR 成功渲染支持 shell 到达后提前启动客户端入口；带 `Suspense` 边界的 pending 内容可继续流式补齐。
+
+## 构建与产物
+
+- SSR 构建产物固定输出到私有 `{ssrPrivateRoot}/ssr-server`、私有 `{ssrPrivateRoot}/ssr-manifest`，SSR hydration 入口并入 FE browser build。
+- SSR client 静态资源通过普通 `/dist/assets/*` 对外服务，并可与 CSR 入口共享 chunk。
+- 发布构建采用独立临时目录生成 SSR 产物，并只同步 `ssr` 子目录，保持 FE/Common/UI 等既有发布产物独立。
+- SSR 静态资源按普通 public `/dist/assets/*` 处理，server bundle/manifest 按对应私有 `{publicPath}/../.tc/ssr` 定位，支持 business/frame/additional public paths。
+- CSR 入口扫描与 SSR 入口扫描边界独立，V1 统一使用 `ssr/apps` 入口约定。
+
+## 示例、文档与验证
+
+- 新增内置 SSR 示例页面 `demo`、`server-data`、`ui-components`，覆盖基础 hydration、服务端数据和组件预览场景。
+- 对外文档补充 SSR 使用方式：`ssr/apps` 目录、`buildSSR/watchSSRFiles`、`createSSREntry`、`/fessr` 访问路径和 SSR 双端边界。
+- AI/Agent 文档补充 SSR 入口、构建链路、运行时文件和生成器约束。
+- 补充 SSR 自动化测试，覆盖入口收集、输出路径、hydration、manifest、HTML shell、错误 fallback 和静态资源映射。
+
+# V0.2.13-beta
+
+## 功能
+
+- 文档调整
+- skill 调整语义
+- tc-generator skill 增加判断，遇到需要&不存在的 comType 直接跳过&输出
+
+## 修复
+
+- 修复 DataTable loading 骨架屏覆盖时真实表格内容露出的问题
+
 # V0.2.x
 
 ## 功能
@@ -11,13 +54,13 @@
 - 补充 `ControllerFN`、`Ctx`、`MiddlewareFN`、`RouterFN`、`ServiceFN` 等后端公开类型说明
 - 同步更新 `README.agent.md`，补充 AI 助手侧后端类型和 `ctx.reqData` 使用说明
 - 新增通用 RAF 风格计时器工具 `rafSetTimeout`、`rafSetInterval`、`rafClearTimeout`、`rafClearInterval` 和 `clearRafTimer`，缺少 RAF 时自动降级到 `setTimeout`
-- `packages/react/hooks/useRefState` 新增可选 `delayTiming`，支持延迟提交 state 并复用 `@tc/common/rafTimer`
+- `packages/react/hooks/useRefState` 新增可选 `delayTiming`，支持延迟提交 state 并复用包内 RAF 风格计时器
 - 页面渲染命中 HTML ETag 缓存时返回 `304 Not Modified`
 - 新增前端主题工具 `initThemeMode`、`applyThemeMode` 等，默认 Dashboard 渲染前会恢复已保存主题
 - 发布包新增 `@_tc/template-core/fe/rc/hooks` hooks 汇总入口
 - `@_tc/template-core/fe` 补充导出 `renderImportComponent` 和 `clearAuthToken`，并同步文档说明前端 token 工具
 - `@_tc/template-core/fe` 补充语言工具，支持新增语种、追加语种文案、切换当前语言、设置兜底语言和批量设置语言资源
-- 新增 SchemaTable 单元格渲染组件扩展，支持内置 `PreviewImage` 和业务侧 `frontend/extended/SchemaPage/SchemaTable/data.ts` 注册
+- 新增 SchemaTable 单元格渲染组件扩展，支持内置 `PreviewImage` 和项目侧 `frontend/extended/SchemaPage/SchemaTable/data.ts` 注册
 - 完善前后端 i18n：新增请求语言解析、服务端错误翻译工具、前端 `useText`/`getText` 翻译入口和内置语言资源按需注册能力
 - Date 组件文案接入统一 i18n，并支持注册 `date-fns` 语言包
 - 重构 UI 组件预览 Demo，拆分 core、date、menu 示例并展示发布包导入路径
@@ -33,13 +76,13 @@
 
 # V0.1
 
-TemplateCore 首个可用版本，提供一套基于 TypeScript、Koa、React 和 Vite 的后台框架模板。
+TemplateCore 首个可用版本，提供一套基于 TypeScript、Koa、React 和 Vite 的后台框架 npm 包。
 
 ## 功能
 
 - Koa 服务启动入口，支持按目录自动加载 `controller`、`service`、`router`、`middlewares`、`router-schema`、`extends` 和 `config`。
-- 支持框架内置 `app/` 与业务项目 `app/` 双层加载，方便项目侧扩展和覆盖。
-- 通过 `model/` 配置生成后台菜单、路由和 Schema CRUD 页面。
+- 支持框架内置 `app/` 与使用方项目 `app/` 双层加载，方便项目侧扩展和覆盖。
+- 通过 `models/` 配置生成后台菜单、路由和 Schema CRUD 页面。
 - 内置 React Dashboard、Schema 页面和基础 UI 组件库。
 - 前端支持多语言配置，可在 model / Schema 中使用 `$i18n::...`。
 - 提供 `buildFE` 前端构建能力，支持开发模式和生产构建。