Skip to content

Commit 278aa63

Browse files
committed
fix: docs
1 parent b59add3 commit 278aa63

1 file changed

Lines changed: 4 additions & 12 deletions

File tree

docs/advanced-features/using-skill-to-integrate-local-ai-agent.md

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ TinyEngine 现在支持将 **File 存储模式** 与一份标准化的 **DSL Ski
4343
4444
4545
┌───────────────────────┐
46-
│ MockServer (File 模式) │ ◄── 启动命令:MOCK_DB_MODE=file npm run dev
46+
│ MockServer (File 模式) │ ◄── 启动命令:pnpm dev:file
4747
└───────────────────────┘
4848
4949
@@ -54,7 +54,7 @@ TinyEngine 现在支持将 **File 存储模式** 与一份标准化的 **DSL Ski
5454

5555
- **文件即数据**:File 模式下,MockServer 直接扫描 `mockServer/data/` 目录的 JSON 文件,文件名优先取 `name || label`(冲突时自动追加后缀)。
5656
- **可编辑性**:页面 / 区块的 `occupier` 必须为 `null`,否则进入画布后会提示被占用而无法编辑。
57-
- **命名与关联**:页面通过 `app` 字段关联所属应用,`route` 需在应用内唯一;Skill 推荐应用与页面的 ID 统一使用整数。
57+
- **命名与关联**:页面通过 `app` 字段关联所属应用,`route` 需在应用内唯一;应用与页面的 ID 统一使用整数(字符串格式也兼容)
5858

5959
## 前置条件
6060

@@ -108,8 +108,6 @@ pnpm serve:backend:file
108108

109109
数据将读写 `mockServer/data/` 目录。
110110

111-
> 想自定义数据目录时:`MOCK_DB_MODE=file MOCK_FILE_DB_PATH=/path/to/data npm run dev`
112-
113111
### 2. 向 AI Agent 描述目标
114112

115113
明确告诉 Agent 你要生成什么,越具体越好。例如:
@@ -147,7 +145,7 @@ Agent 会遵循 Skill 内定义的标准流程:
147145

148146
### 文件输出路径
149147

150-
| 产物 | 落盘路径 | 文件名规则 |
148+
| 产物 | 文件路径 | 文件名规则 |
151149
| --- | --- | --- |
152150
| 应用 | `mockServer/data/apps/<app-name>.json` | 应用 `name` |
153151
| 页面 | `mockServer/data/pages/<PageName>.json` | 页面 `name` |
@@ -221,7 +219,7 @@ Agent 会遵循 Skill 内定义的标准流程:
221219

222220
- 文件名优先使用记录的 `name || label`;同名冲突时 MockServer 会自动追加随机后缀。
223221
- 页面的 `route` 需在所属应用内唯一,否则会被唯一性约束拦截。
224-
- 页面的 `app` 字段必须引用所属应用的 `id`,二者类型保持一致(Skill 推荐统一使用整数)。
222+
- 页面的 `app` 字段必须引用所属应用的 `id`,二者类型保持一致(推荐统一使用整数,也兼容字符串格式)。
225223

226224
## 示例:生成一个登录页
227225

@@ -332,12 +330,6 @@ python3 .agents/skills/tinyengine-dsl-generator/scripts/check_css.py mockServer/
332330
| 组件 ID | 全局唯一 | 复用 ID 导致渲染/选中异常 |
333331
| 保留名 | 禁止自定义组件叫 `Page`/`Block`/`Text`/`Template`/`Slot`/`Collection` | 与内置容器冲突 |
334332

335-
更完整的协议定义、组件清单与常见模式,请查阅 Skill 的参考文档:
336-
337-
- [协议规范 protocol.md](../../.agents/skills/tinyengine-dsl-generator/references/protocol.md)
338-
- [组件清单 components.md](../../.agents/skills/tinyengine-dsl-generator/references/components.md)
339-
- [常见模式 patterns.md](../../.agents/skills/tinyengine-dsl-generator/references/patterns.md)
340-
341333
## 常见问题
342334

343335
### 页面在设计器中不可编辑 / 提示被占用

0 commit comments

Comments
 (0)