docs: 同步 template 文档

docs/api/motajs-render-vue/BaseProps.md

@@ -131,4 +131,4 @@ export const MyUI = defineComponent(() => {
     - 如果不允许交互，那么光标也不会显示
     - 同 `zIndex` 下，后插入的元素会在上层，但是这也意味着如果是动态插入的元素（例如由于响应式更改而插入了一个新元素），会显示在后面代码的元素之上
 4. **常见问题**
-    - 参考 [指南](../../guide/ui-faq.md)
+    - 参考 [指南](../../guide/ui/faq.md)

docs/api/motajs-render-vue/标签 sprite.md

@@ -43,7 +43,7 @@ interface SpriteProps extends BaseProps {
 
 ## 使用示例
 
-以下的示例代码均应该在**组件内部**编写，哪里是组件内部请参考[指南](../../guide/ui.md)。
+以下的示例代码均应该在**组件内部**编写，哪里是组件内部请参考[指南](../../guide/ui/ui.md)。
 
 ### 示例 1：基础图形
 

docs/api/motajs-system-ui/UIController.md

@@ -11,7 +11,7 @@ graph LR
 
 ## 类描述
 
-`UIController` 是 UI 控制系统的核心类，负责管理 UI 实例的显示栈、背景控制以及多种显示模式。继承自 `EventEmitter`，支持事件监听。想要编写 UI 请参考[深度指南](../../guide/ui.md)。
+`UIController` 是 UI 控制系统的核心类，负责管理 UI 实例的显示栈、背景控制以及多种显示模式。继承自 `EventEmitter`，支持事件监听。想要编写 UI 请参考[深度指南](../../guide/ui/ui.md)。
 
 ---
 
@@ -222,7 +222,7 @@ function showAll(stack?: boolean): void;
 function showCustom(config: IUICustomConfig): void;
 ```
 
-切换显示模式：使用自定义模式（需实现 `IUICustomConfig`），参考[指南](../../guide/ui-system.md#自定义显示模式)
+切换显示模式：使用自定义模式（需实现 `IUICustomConfig`），参考[指南](../../guide/ui/system.md#自定义显示模式)
 
 ---
 

docs/api/user-client-modules/functions.md

@@ -408,4 +408,4 @@ const userData = await waitbox(
 4. **额外参考**
     - [组件 ConfirmBox](./组件%20ConfirmBox.md)
     - [组件 Choices](./组件%20Choices.md)
-    - [组件 Waitbox](./组件%20Waitbox.md)
+    - [组件 WaitBox](./组件%20WaitBox.md)

docs/api/user-client-modules/组件 FloorSelector.md

@@ -0,0 +1,85 @@
+# FloorSelector 楼层选择器组件 API 文档
+
+本文档由 `DeepSeek R1` 模型生成并微调。
+
+## 组件描述
+
+楼层选择器组件用于在地图浏览或地图选择场景中切换不同楼层，其尺寸与内置状态栏组件匹配，适合在地图浏览时将状态栏替换为此组件。
+
+---
+
+## Props 属性说明
+
+| 属性名   | 类型         | 默认值 | 描述                 |
+| -------- | ------------ | ------ | -------------------- |
+| `floors` | `FloorIds[]` | 必填   | 可选择的楼层 ID 数组 |
+| `now`    | `number`     | -      | 当前选中的楼层索引   |
+
+---
+
+## Events 事件说明
+
+| 事件名       | 参数类型                             | 触发时机               |
+| ------------ | ------------------------------------ | ---------------------- |
+| `close`      | -                                    | 点击关闭按钮时触发     |
+| `update`     | `(floor: number, floorId: FloorIds)` | 当选中的楼层改变时触发 |
+| `update:now` | `(value: number)`                    | v-model 双向绑定事件   |
+
+---
+
+## Slots 插槽说明
+
+无插槽
+
+---
+
+## Exposed Methods 暴露方法
+
+无暴露方法
+
+---
+
+## 使用示例
+
+### 基础用法 - 地图浏览界面
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { FloorSelector, STATUS_BAR_HEIGHT } from '@user/client-modules';
+
+export const MapBrowserCom = defineComponent(() => {
+    const currentFloor = ref(0);
+
+    // 可用的楼层列表
+    const availableFloors = core.floorIds;
+
+    const handleFloorChange = (floorIndex: number, floorId: string) => {
+        console.log(`切换到楼层: ${floorId} (索引: ${floorIndex})`);
+        // 这里可以执行切换楼层的逻辑
+    };
+
+    const handleClose = () => {
+        console.log('关闭楼层选择器');
+        // 返回主界面或执行其他关闭逻辑
+    };
+
+    return () => (
+        <FloorSelector
+            loc={[0, 0, 180, STATUS_BAR_HEIGHT]}
+            floors={availableFloors}
+            v-model:now={currentFloor.value}
+            onUpdate={handleFloorChange}
+            onClose={handleClose}
+        />
+    );
+});
+```
+
+---
+
+## 注意事项
+
+1. **尺寸匹配**: 组件设计为与内置状态栏尺寸匹配，可直接替换
+2. **索引基准**: 楼层索引从 0 开始
+3. **内置集成**: 通常不需要直接使用，因为样板已内置完整的地图浏览界面
+4. **倒序排列**: 楼层列表会自动倒序排列

docs/api/user-client-modules/组件 Input.md

@@ -0,0 +1,113 @@
+# Input 输入框组件 API 文档
+
+本文档由 `DeepSeek` 生成并微调。
+
+## 组件描述
+
+输入框组件用于接收用户的文本输入，支持单行和多行模式，提供边框样式自定义和实时/确认两种值变化事件。
+
+---
+
+## Props 属性说明
+
+| 属性名                    | 类型                | 默认值  | 描述                                                  |
+| ------------------------- | ------------------- | ------- | ----------------------------------------------------- |
+| `placeholder`             | `string`            | -       | 输入框的提示内容                                      |
+| `value`                   | `string`            | -       | 输入框的值                                            |
+| `multiline`               | `boolean`           | `false` | 是否是多行输入，多行输入时允许换行                    |
+| `border`                  | `string`            | -       | 边框颜色                                              |
+| `circle`                  | `RectRCircleParams` | -       | 边框圆角                                              |
+| `borderWidth`             | `number`            | -       | 边框宽度                                              |
+| `pad`                     | `number`            | -       | 内边距                                                |
+| 继承自 `TextContentProps` | -                   | -       | [查看完整属性](./组件%20TextContent#Props%20属性说明) |
+
+---
+
+## Events 事件说明
+
+| 事件名         | 参数类型          | 触发时机                                 |
+| -------------- | ----------------- | ---------------------------------------- |
+| `change`       | `(value: string)` | 当输入框的值被确认时触发，例如失焦时     |
+| `input`        | `(value: string)` | 当输入框的值发生改变时触发，例如实时输入 |
+| `update:value` | `(value: string)` | v-model 双向绑定事件                     |
+
+---
+
+## Slots 插槽说明
+
+无插槽
+
+---
+
+## Exposed Methods 暴露方法
+
+无暴露方法
+
+---
+
+## 使用示例
+
+### 基础用法 - 单行输入框
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { Input } from '@user/client-modules';
+
+export const MyCom = defineComponent(() => {
+    const inputValue = ref('');
+
+    const handleChange = (value: string) => {
+        console.log('输入确认:', value);
+    };
+
+    const handleInput = (value: string) => {
+        console.log('实时输入:', value);
+    };
+
+    return () => (
+        <Input
+            placeholder="请输入文本"
+            v-model={inputValue.value}
+            onChange={handleChange}
+            onInput={handleInput}
+            loc={[208, 208, 300, 40, 0.5, 0.5]}
+            border="#ccc"
+            borderWidth={1}
+            circle={[4]}
+            pad={8}
+        />
+    );
+});
+```
+
+### 多行文本输入
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { Input } from '@user/client-modules';
+
+export const MyCom = defineComponent(() => {
+    const multilineValue = ref('');
+
+    return () => (
+        <Input
+            multiline
+            placeholder="请输入多行文本..."
+            v-model={multilineValue.value}
+            loc={[208, 208, 300, 120, 0.5, 0.5]}
+            border="#007acc"
+            borderWidth={2}
+            circle={[8]}
+            pad={12}
+        />
+    );
+});
+```
+
+---
+
+## 注意事项
+
+1. **事件区别**：`input` 事件在每次输入时触发，`change` 事件在失焦或确认时触发
+2. **多行模式**：启用 `multiline` 后支持换行输入，高度需要足够容纳多行文本
+3. **样式继承**：支持从 `TextContentProps` 继承文本相关样式属性

docs/api/user-client-modules/组件 InputBox.md

@@ -0,0 +1,315 @@
+# InputBox 输入对话框组件 API 文档
+
+本文档由 `DeepSeek` 生成并微调。
+
+## 组件描述
+
+输入对话框组件是一个完整的弹出式输入界面，包含提示文本、输入框、确认和取消按钮。适用于需要用户输入文本的交互场景，提供了便捷的异步获取输入方法。
+
+---
+
+## Props 属性说明
+
+| 属性名                    | 类型             | 默认值   | 描述                                                  |
+| ------------------------- | ---------------- | -------- | ----------------------------------------------------- |
+| `loc`                     | `ElementLocator` | 必填     | 输入框对话框的位置                                    |
+| `input`                   | `InputProps`     | -        | 传递给内部 Input 组件的配置参数                       |
+| `winskin`                 | `ImageIds`       | -        | 窗口皮肤图片ID，用于对话框背景绘制                    |
+| `color`                   | `CanvasStyle`    | -        | 对话框背景颜色（未设置 winskin 时生效）               |
+| `border`                  | `CanvasStyle`    | -        | 对话框边框颜色（未设置 winskin 时生效）               |
+| `pad`                     | `number`         | -        | 对话框内部所有元素的内边距                            |
+| `inputHeight`             | `number`         | -        | 内部输入框区域的高度                                  |
+| `text`                    | `string`         | -        | 对话框顶部的提示文本                                  |
+| `yesText`                 | `string`         | `"确认"` | 确认按钮的显示文本                                    |
+| `noText`                  | `string`         | `"取消"` | 取消按钮的显示文本                                    |
+| `selFont`                 | `Font`           | -        | 确认/取消按钮的字体样式                               |
+| `selFill`                 | `CanvasStyle`    | -        | 确认/取消按钮的文本颜色                               |
+| 继承自 `TextContentProps` | -                | -        | [查看完整属性](./组件%20TextContent#Props%20属性说明) |
+
+---
+
+## Events 事件说明
+
+| 事件名         | 参数类型          | 触发时机                                   |
+| -------------- | ----------------- | ------------------------------------------ |
+| `confirm`      | `(value: string)` | 当确认输入框的内容时触发                   |
+| `cancel`       | `(value: string)` | 当取消时触发                               |
+| `change`       | `(value: string)` | 继承自 Input 组件 - 输入框值被确认时触发   |
+| `input`        | `(value: string)` | 继承自 Input 组件 - 输入框值实时变化时触发 |
+| `update:value` | `(value: string)` | 继承自 Input 组件 - v-model 双向绑定       |
+
+---
+
+## Slots 插槽说明
+
+无插槽
+
+---
+
+## Exposed Methods 暴露方法
+
+无暴露方法
+
+---
+
+## 工具函数
+
+### `getInput(controller, text, loc, width, props?)`
+
+弹出一个输入框并异步返回用户输入的结果。
+
+**参数**
+
+- `controller: IUIMountable` - UI 控制器
+- `text: string` - 提示文本内容
+- `loc: ElementLocator` - 确认框的位置
+- `width: number` - 确认框的宽度
+- `props?: InputBoxProps` - 额外的配置属性（可选）
+
+**返回值**: `Promise<string>`
+
+### `getInputNumber(controller, text, loc, width, props?)`
+
+与 `getInput` 类似，但会将结果转换为数字。
+
+**参数**: 同 `getInput`
+**返回值**: `Promise<number>`
+
+---
+
+## 使用示例
+
+### 基础用法 - 组件形式
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { InputBox } from '@user/client-modules';
+
+export const MyCom = defineComponent(() => {
+    const handleConfirm = (value: string) => {
+        console.log('用户输入:', value);
+        // 处理用户输入
+    };
+
+    const handleCancel = (value: string) => {
+        console.log('用户取消输入，最后值为:', value);
+    };
+
+    return () => (
+        <InputBox
+            text="请输入您的姓名："
+            loc={[240, 240, 300, 180, 0.5, 0.5]}
+            input={{
+                placeholder: '在此输入姓名',
+                border: '#007acc',
+                borderWidth: 1,
+                circle: [4],
+                pad: 8
+            }}
+            color="#ffffff"
+            border="#cccccc"
+            borderWidth={2}
+            pad={16}
+            inputHeight={40}
+            yesText="确定"
+            noText="取消"
+            onConfirm={handleConfirm}
+            onCancel={handleCancel}
+        />
+    );
+});
+```
+
+### 使用 getInput 工具函数（推荐）
+
+```tsx
+import { defineComponent } from 'vue';
+import { getInput, getInputNumber } from '@user/client-modules';
+
+export const MyCom = defineComponent(props => {
+    const handleGetName = async () => {
+        // 获取文本输入
+        const name = await getInput(
+            props.controller,
+            '请输入您的姓名：',
+            [208, 208, void 0, void 0, 0.5, 0.5],
+            280,
+            {
+                input: {
+                    placeholder: '姓名'
+                },
+                color: '#f8f8f8'
+            }
+        );
+
+        if (name) {
+            console.log('用户姓名:', name);
+            // 处理姓名
+        } else {
+            console.log('用户取消了输入');
+        }
+    };
+
+    const handleGetAge = async () => {
+        // 获取数字输入
+        const age = await getInputNumber(
+            props.controller,
+            '请输入您的年龄：',
+            [208, 208, void 0, void 0, 0.5, 0.5],
+            280
+        );
+
+        if (!isNaN(age)) {
+            console.log('用户年龄:', age);
+            // 处理年龄
+        }
+    };
+
+    return () => (
+        <container>
+            <text
+                loc={[240, 180, void 0, void 0, 0.5, 0.5]}
+                onClick={handleGetName}
+                text="输入姓名"
+            />
+            <text
+                loc={[240, 220, void 0, void 0, 0.5, 0.5]}
+                onClick={handleGetAge}
+                text="输入年龄"
+            />
+        </container>
+    );
+});
+```
+
+### 带自定义样式的输入对话框
+
+```tsx
+import { defineComponent } from 'vue';
+import { getInput } from '@user/client-modules';
+
+export const StyledInputCom = defineComponent(props => {
+    const handleStyledInput = async () => {
+        const value = await getInput(
+            props.controller,
+            '请输入任务描述：',
+            [240, 240, void 0, void 0, 0.5, 0.5],
+            320,
+            {
+                text: '任务创建',
+                input: {
+                    placeholder: '描述任务内容...',
+                    multiline: true,
+                    border: '#4CAF50',
+                    borderWidth: 2,
+                    circle: 8,
+                    pad: 12
+                },
+                color: '#ffffff',
+                border: '#4CAF50',
+                borderWidth: 3,
+                pad: 20,
+                inputHeight: 80,
+                yesText: '创建',
+                noText: '取消',
+                selFill: '#4CAF50'
+            }
+        );
+
+        if (value) {
+            console.log('创建任务:', value);
+        }
+    };
+
+    return () => (
+        <text
+            loc={[240, 240, void 0, void 0, 0.5, 0.5]}
+            onClick={handleStyledInput}
+            text="创建新任务"
+        />
+    );
+});
+```
+
+### 游戏中的设置界面
+
+```tsx
+import { defineComponent } from 'vue';
+import { getInput } from '@user/client-modules';
+
+export const SettingsCom = defineComponent(props => {
+    const settings = ref({
+        playerName: '玩家',
+        serverIP: '127.0.0.1'
+    });
+
+    const changePlayerName = async () => {
+        const newName = await getInput(
+            props.controller,
+            '修改玩家名称：',
+            [240, 240, void 0, void 0, 0.5, 0.5],
+            280,
+            {
+                input: {
+                    value: settings.value.playerName,
+                    placeholder: '玩家名称',
+                    border: '#FF9800',
+                    borderWidth: 1
+                }
+            }
+        );
+
+        if (newName) {
+            settings.value.playerName = newName;
+            console.log('玩家名称已更新:', newName);
+        }
+    };
+
+    const changeServerIP = async () => {
+        const newIP = await getInput(
+            props.controller,
+            '修改服务器IP：',
+            [240, 240, void 0, void 0, 0.5, 0.5],
+            280,
+            {
+                input: {
+                    value: settings.value.serverIP,
+                    placeholder: '服务器IP地址',
+                    border: '#2196F3',
+                    borderWidth: 1
+                }
+            }
+        );
+
+        if (newIP) {
+            settings.value.serverIP = newIP;
+            console.log('服务器IP已更新:', newIP);
+        }
+    };
+
+    return () => (
+        <container loc={[240, 240, 300, 200, 0.5, 0.5]}>
+            <text
+                loc={[0, -40, void 0, void 0, 0.5, 0.5]}
+                onClick={changePlayerName}
+                text={`玩家名称: ${settings.value.playerName}`}
+            />
+            <text
+                loc={[0, 0, void 0, void 0, 0.5, 0.5]}
+                onClick={changeServerIP}
+                text={`服务器IP: ${settings.value.serverIP}`}
+            />
+        </container>
+    );
+});
+```
+
+---
+
+## 注意事项
+
+1. **推荐使用工具函数**: `getInput` 和 `getInputNumber` 提供了更简洁的异步输入获取方式
+2. **宽度设置**: 在使用工具函数时，高度由组件自动计算，只需指定宽度
+3. **皮肤优先级**: 如果设置了 `winskin`，则 `color` 和 `border` 设置将失效
+4. **异步处理**: 工具函数返回 Promise，需要使用 `await` 或 `.then()` 处理结果
+5. **空值处理**: 用户取消输入时，`getInput` 返回空字符串，`getInputNumber` 返回 `NaN`

docs/api/user-client-modules/组件 List.md

@@ -0,0 +1,184 @@
+# List 列表组件 API 文档
+
+本文档由 `DeepSeek` 生成并微调。
+
+## 组件描述
+
+列表组件用于展示可选择的项目列表，内置滚动条功能和选中项高亮效果。适用于菜单选择、内容导航、设置选项等场景。
+
+---
+
+## Props 属性说明
+
+| 属性名       | 类型                 | 默认值 | 描述                            |
+| ------------ | -------------------- | ------ | ------------------------------- |
+| `list`       | `[string, string][]` | 必填   | 列表内容，[id, 显示文本] 的数组 |
+| `selected`   | `string`             | 必填   | 当前选中的项 ID                 |
+| `loc`        | `ElementLocator`     | 必填   | 列表的位置和尺寸                |
+| `lineHeight` | `number`             | `18`   | 每行的高度                      |
+| `font`       | `Font`               | -      | 列表项的字体样式                |
+| `winskin`    | `ImageIds`           | -      | 使用 winskin 作为光标背景       |
+| `color`      | `CanvasStyle`        | -      | 使用指定样式作为光标背景        |
+| `border`     | `CanvasStyle`        | -      | 使用指定样式作为光标边框        |
+| `alphaRange` | `[number, number]`   | -      | 选择图标的不透明度范围          |
+
+---
+
+## Events 事件说明
+
+| 事件名            | 参数类型          | 触发时机               |
+| ----------------- | ----------------- | ---------------------- |
+| `update`          | `(key: string)`   | 当用户选中某一项时触发 |
+| `update:selected` | `(value: string)` | v-model 双向绑定事件   |
+
+---
+
+## Slots 插槽说明
+
+无插槽
+
+---
+
+## Exposed Methods 暴露方法
+
+无暴露方法
+
+---
+
+## 使用示例
+
+### 基础用法 - 简单列表
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { List } from '@user/client-modules';
+
+export const MyCom = defineComponent(() => {
+    const selectedItem = ref('item1');
+
+    // 列表数据：[id, 显示文本]
+    const listData = [
+        ['item1', '第一项'],
+        ['item2', '第二项'],
+        ['item3', '第三项'],
+        ['item4', '第四项']
+    ];
+
+    const handleSelect = (key: string) => {
+        console.log('选中项:', key);
+        selectedItem.value = key;
+    };
+
+    return () => (
+        <List
+            list={listData}
+            v-model:selected={selectedItem.value}
+            loc={[0, 0, 100, 300, 0, 0]}
+            selected={selectedItem.value}
+            onUpdate={handleSelect}
+        />
+    );
+});
+```
+
+### 带样式的列表
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { List } from '@user/client-modules';
+
+export const StyledListCom = defineComponent(() => {
+    const selected = ref('opt2');
+
+    const options = [
+        ['opt1', '开始游戏'],
+        ['opt2', '游戏设置'],
+        ['opt3', '帮助文档'],
+        ['opt4', '关于我们']
+    ];
+
+    return () => (
+        <List
+            list={options}
+            v-model:selected={selected.value}
+            loc={[0, 0, 100, 300, 0, 0]}
+            lineHeight={24}
+            color="#e3f2fd"
+            border="#2196f3"
+            borderWidth={1}
+        />
+    );
+});
+```
+
+### 使用皮肤图片的列表
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { List } from '@user/client-modules';
+
+export const SkinnedListCom = defineComponent(() => {
+    const currentSelection = ref('cat');
+
+    const animalList = [
+        ['cat', '猫咪'],
+        ['dog', '小狗'],
+        ['bird', '小鸟'],
+        ['fish', '小鱼']
+    ];
+
+    const handleUpdate = key => {
+        const item = animalList.find(item => item[0] === key)?.[1];
+        currentSelection.value = key;
+        console.log('选择了:', item);
+    };
+
+    return () => (
+        <List
+            list={animalList}
+            selected={currentSelection.value}
+            loc={[0, 0, 100, 300, 0, 0]}
+            winskin="winskin.png"
+            lineHeight={20}
+            onUpdate={handleUpdate}
+        />
+    );
+});
+```
+
+### 长列表滚动示例
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { List } from '@user/client-modules';
+
+export const ScrollListCom = defineComponent(() => {
+    const selected = ref('item5');
+
+    // 创建长列表数据
+    const longList = Array.from({ length: 20 }, (_, i) => [
+        `item${i + 1}`,
+        `列表项 ${i + 1}`
+    ]);
+
+    return () => (
+        <List
+            list={longList}
+            v-model:selected={selected.value}
+            loc={[0, 0, 100, 300, 0, 0]}
+            lineHeight={20}
+            color="#fff3e0"
+            border="#ff9800"
+        />
+    );
+});
+```
+
+---
+
+## 注意事项
+
+1. **数据格式**: `list` 属性需要 `[id, text]` 格式的二维数组
+2. **选中状态**: `selected` 需要与列表项中的 id 匹配
+3. **滚动支持**: 自动显示滚动条
+4. **样式优先级**: 如果设置了 `winskin`，则 `color` 和 `border` 设置将失效

docs/api/user-client-modules/组件 ListPage.md

@@ -0,0 +1,226 @@
+# ListPage 列表页面组件 API 文档
+
+本文档由 `DeepSeek` 生成并微调。
+
+## 组件描述
+
+列表页面组件结合了列表选择和内容展示功能，左侧显示可选项列表，右侧显示选中项的详细内容。适用于说明文档、设置界面、内容导航等场景。
+
+---
+
+## Props 属性说明
+
+| 属性名             | 类型             | 默认值  | 描述                                           |
+| ------------------ | ---------------- | ------- | ---------------------------------------------- |
+| `loc`              | `ElementLocator` | 必填    | 组件整体位置和尺寸                             |
+| `basis`            | `number`         | -       | 列表区域所占比例                               |
+| `right`            | `boolean`        | `false` | 列表是否排列在右侧                             |
+| `close`            | `boolean`        | `false` | 是否显示关闭按钮                               |
+| `closeLoc`         | `ElementLocator` | -       | 关闭按钮的位置（相对于组件定位）               |
+| 继承自 `ListProps` | -                | -       | [查看完整属性](./组件%20List#Props%20属性说明) |
+
+---
+
+## Events 事件说明
+
+| 事件名            | 参数类型          | 触发时机                             |
+| ----------------- | ----------------- | ------------------------------------ |
+| `close`           | -                 | 当用户点击关闭按钮时触发             |
+| `update`          | `(key: string)`   | 继承自 List - 当用户选中某一项时触发 |
+| `update:selected` | `(value: string)` | 继承自 List - v-model 双向绑定事件   |
+
+---
+
+## Slots 插槽说明
+
+### `default`
+
+接收当前选中的 key 并返回对应的内容
+
+**参数**
+
+- `key: string` 当前选中的项 ID
+
+### 具名插槽
+
+以列表项 ID 为名称的具名插槽，用于定义每个选项对应的详细内容
+
+---
+
+## 使用示例
+
+### 基础用法 - 说明文档界面
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { ListPage } from '@user/client-modules';
+
+export const HelpCom = defineComponent(() => {
+    const selected = ref('intro');
+
+    const helpTopics = [
+        ['intro', '功能介绍'],
+        ['usage', '使用方法'],
+        ['settings', '设置说明'],
+        ['faq', '常见问题']
+    ];
+
+    return () => (
+        <ListPage
+            list={helpTopics}
+            v-model:selected={selected.value}
+            loc={[208, 208, 400, 300, 0.5, 0.5]}
+            basis={0.3}
+        >
+            {{
+                // 使用具名插槽定义每个选项的内容
+                intro: () => (
+                    <container>
+                        <text text="这里是最新版本的功能介绍..." loc={[0, 0]} />
+                        <text text="欢迎使用本系统" loc={[0, 40]} />
+                    </container>
+                ),
+                usage: () => (
+                    <container>
+                        <text text="使用方法指南" loc={[0, 0]} />
+                        <text text="1. 点击左侧菜单选择功能" loc={[0, 40]} />
+                        <text text="2. 在右侧查看详细说明" loc={[0, 80]} />
+                    </container>
+                ),
+                settings: () => <text text="设置说明内容..." loc={[0, 0]} />,
+                faq: () => <text text="常见问题解答..." loc={[0, 0]} />
+            }}
+        </ListPage>
+    );
+});
+```
+
+### 使用默认插槽
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { ListPage } from '@user/client-modules';
+
+export const SimpleCom = defineComponent(() => {
+    const selected = ref('item1');
+
+    const items = [
+        ['item1', '选项一'],
+        ['item2', '选项二'],
+        ['item3', '选项三']
+    ];
+
+    return () => (
+        <ListPage
+            list={items}
+            v-model:selected={selected.value}
+            loc={[208, 208, 350, 250, 0.5, 0.5]}
+        >
+            {key => (
+                <container>
+                    <text
+                        text={`当前选中: ${items.find(item => item[0] === key)?.[1]}`}
+                        loc={[0, 0]}
+                    />
+                    <text text={`ID: ${key}`} loc={[0, 30]} />
+                </container>
+            )}
+        </ListPage>
+    );
+});
+```
+
+### 带关闭按钮的弹窗
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { ListPage } from '@user/client-modules';
+
+export const ModalCom = defineComponent(props => {
+    const selected = ref('weapon');
+
+    const gameItems = [
+        ['weapon', '武器'],
+        ['armor', '防具'],
+        ['potion', '药水'],
+        ['material', '材料']
+    ];
+
+    const handleClose = () => {
+        props.controller.close(props.instance);
+        console.log('关闭物品栏');
+    };
+
+    return () => (
+        <ListPage
+            list={gameItems}
+            v-model:selected={selected.value}
+            loc={[208, 208, 400, 320, 0.5, 0.5]}
+            close
+            // 设定关闭按钮的位置
+            closeLoc={[0, 300]}
+            basis={0.35}
+            onClose={handleClose}
+        >
+            {{
+                weapon: () => (
+                    <container>
+                        <text text="武器列表" loc={[0, 0]} />
+                        <text text="• 长剑" loc={[0, 30]} />
+                        <text text="• 弓箭" loc={[0, 60]} />
+                        <text text="• 法杖" loc={[0, 90]} />
+                    </container>
+                ),
+                armor: () => <text text="防具装备信息..." loc={[0, 0]} />,
+                potion: () => <text text="药水效果说明..." loc={[0, 0]} />,
+                material: () => <text text="合成材料列表..." loc={[0, 0]} />
+            }}
+        </ListPage>
+    );
+});
+```
+
+### 列表在右侧的布局
+
+```tsx
+import { defineComponent, ref } from 'vue';
+import { ListPage } from '@user/client-modules';
+
+export const RightListCom = defineComponent(() => {
+    const selected = ref('profile');
+
+    const menuItems = [
+        ['profile', '个人资料'],
+        ['security', '安全设置'],
+        ['privacy', '隐私设置'],
+        ['notifications', '通知设置']
+    ];
+
+    return () => (
+        <ListPage
+            list={menuItems}
+            v-model:selected={selected.value}
+            loc={[240, 240, 500, 280, 0.5, 0.5]}
+            right
+            basis={0.4}
+        >
+            {key => (
+                <container>
+                    <text text="显示一些内容..." loc={[0, 60]} />
+                    <text text="这里是详细的设置内容..." loc={[0, 0]} />
+                </container>
+            )}
+        </ListPage>
+    );
+});
+```
+
+---
+
+## 注意事项
+
+1. **插槽使用**: 可以使用具名插槽（以列表项 ID 为名）或默认插槽来定义内容
+2. **布局控制**: 通过 `basis` 控制列表区域比例，`right` 控制列表位置
+3. **关闭功能**: 设置 `close` 为 `true` 显示关闭按钮，通过 `closeLoc` 自定义位置
+4. **事件处理**: `close` 事件需要手动处理界面关闭逻辑
+5. **内容更新**: 切换列表选项时，右侧内容会自动更新为对应插槽的内容

docs/api/user-client-modules/组件 Thumbnail.md

@@ -0,0 +1,119 @@
+# Thumbnail 地图缩略图组件 API 文档
+
+本文档由 `DeepSeek` 生成并微调。
+
+## 组件描述
+
+地图缩略图组件用于在游戏界面中显示当前楼层的迷你地图，可展示地图布局、角色位置、伤害区域等信息。适用于小地图显示、地图预览等场景。
+
+---
+
+## Props 属性说明
+
+| 属性名     | 类型             | 默认值 | 描述                                   |
+| ---------- | ---------------- | ------ | -------------------------------------- |
+| `loc`      | `ElementLocator` | 必填   | 缩略图的位置和尺寸                     |
+| `floorId`  | `FloorIds`       | 必填   | 楼层 ID                                |
+| `padStyle` | `CanvasStyle`    | -      | 缩略图填充样式                         |
+| `map`      | `Block[]`        | -      | 楼层信息                               |
+| `hero`     | `HeroStatus`     | -      | 角色信息                               |
+| `damage`   | `boolean`        | -      | 是否显示地图伤害                       |
+| `all`      | `boolean`        | -      | 是否完全展示地图（false 时只显示部分） |
+| `noHD`     | `boolean`        | -      | 是否使用高清模式                       |
+| `size`     | `number`         | -      | 缩略图的比例（1 表示与实际地图一致）   |
+
+---
+
+## Events 事件说明
+
+无事件
+
+---
+
+## Slots 插槽说明
+
+无插槽
+
+---
+
+## Exposed Methods 暴露方法
+
+无暴露方法
+
+---
+
+## 使用示例
+
+### 基础用法 - 显示当前楼层缩略图
+
+```tsx
+import { defineComponent } from 'vue';
+import { Thumbnail } from '@user/client-modules';
+
+export const MiniMapCom = defineComponent(() => {
+    return () => (
+        <Thumbnail
+            loc={[400, 50, 120, 120, 1, 0]}
+            floorId="main_floor"
+            padStyle="#2c3e50"
+            size={0.1}
+        />
+    );
+});
+```
+
+### 带角色位置的小地图
+
+```tsx
+import { defineComponent } from 'vue';
+import { Thumbnail } from '@user/client-modules';
+
+export const GameHUDCom = defineComponent(props => {
+    const heroStatus: HeroStatus = {
+        // 角色状态信息
+        loc: { x: 100, y: 150 }
+        // ... 其他角色属性
+    };
+
+    return () => (
+        <container loc={[400, 50, 150, 150, 1, 0]}>
+            <Thumbnail
+                loc={[0, 0, 150, 150, 0.5, 0.5]}
+                floorId="dungeon_1"
+                hero={heroStatus}
+                padStyle="#34495e"
+                damage
+                size={0.08}
+            />
+            <text text="小地图" loc={[0, 0]} />
+        </container>
+    );
+});
+```
+
+### 完整地图预览
+
+```tsx
+import { defineComponent } from 'vue';
+import { Thumbnail } from '@user/client-modules';
+
+export const MapPreviewCom = defineComponent(() => {
+    return () => (
+        <Thumbnail
+            loc={[240, 240, 300, 300, 0.5, 0.5]}
+            floorId="boss_arena"
+            all
+            padStyle="#1a1a1a"
+            size={0.3}
+        />
+    );
+});
+```
+
+---
+
+## 注意事项
+
+1. **楼层标识**: `floorId` 必须与游戏中的楼层标识匹配
+2. **比例控制**: `size` 参数控制缩略图与实际地图的比例关系
+3. **显示范围**: `all` 为 false 时，大地图只会显示当前可视区域

docs/guide/diff.md

@@ -28,7 +28,7 @@ lang: zh-CN
 
 相比于 2.10.3 及 2.A，有如下改动：
 
-- [系统说明](./system)
+- [系统说明](./system.md)
-- [UI 编写](./ui)
+- [UI 编写](./ui/ui.md)
-- [UI 系统](./ui/system)
+- [UI 系统](./ui/system.md)
-- [音频系统](./audio)
+- [音频系统](./audio.md)

docs/guide/implements/animate.md

@@ -8,7 +8,7 @@
 
 ## 定义动画属性
 
-我们以一个自定义 UI 为例，来讲述如何编写一段动画。自定义 UI 参考[此指南](./new-ui.md)和[此教程](../../guide/ui.md)。
+我们以一个自定义 UI 为例，来讲述如何编写一段动画。自定义 UI 参考[此指南](./new-ui.md)和[此教程](../../guide/ui/ui.md)。
 
 假设自定义 UI 在 `packages-user/client-modules/src/render/ui` 文件夹下，我们需要引入 `transitioned` 接口，并调用它定义动画属性：
 

docs/guide/implements/choice.md

@@ -275,7 +275,7 @@ export const MyCom = defineComponent(props => {
 
 - [ConfirmBox](../../api/user-client-modules/组件%20ConfirmBox.md)
 - [Choices](../../api/user-client-modules/组件%20Choices.md)
-- [Waitbox](../../api/user-client-modules/组件%20Waitbox.md)
+- [WaitBox](../../api/user-client-modules/组件%20WaitBox.md)
 - [getConfirm](../../api/user-client-modules/functions.md#getconfirm)
 - [getChoice](../../api/user-client-modules/functions.md#getchoice)
-- [waitbox](../../api/user-client-modules/functions.md#waitbox)
+- [waitbox 方法](../../api/user-client-modules/functions.md#waitbox)

docs/guide/implements/index.md

@@ -14,7 +14,7 @@
     - [新增勇士属性](./status-bar.md#拓展-新增勇士属性) （既包含客户端，也包含数据端）
 - [编写新 UI](./new-ui.md)
     - [UI 与组件的区别](./new-ui.md#拓展-ui-与组件的区别)
-    - [UI 编写参考](../ui.md)
+    - [UI 编写参考](../ui/ui.md)
 - [新增按键](./hotkey.md)
     - [添加辅助按键](./hotkey.md#拓展-添加辅助按键)
     - [在 UI 内实现按键](./hotkey.md#拓展-在-ui-内实现按键)
@@ -36,7 +36,6 @@
     - [用函数声明属性](./special.md#拓展-用函数声明属性)
     - [地图伤害](./special.md#拓展-地图伤害)
     - [光环属性](./special.md#拓展-光环属性)
-    - [输出回合数](./special.md#拓展-输出回合数)
 - [主动技能](./skill.md)
     - [多技能设计思路](./skill.md#拓展-多技能设计思路)
     - [战后自动关闭技能](./skill.md#拓展-战后自动关闭技能)

docs/guide/implements/new-ui.md

@@ -82,7 +82,7 @@ controller.close(ins);
 
 ## UI 编写参考
 
-参考[此文档](../ui.md)，此文档将会教你如何从头开始编写一个 UI，并解释 UI 运行与渲染的基本逻辑。
+参考[此文档](../ui/ui.md)，此文档将会教你如何从头开始编写一个 UI，并解释 UI 运行与渲染的基本逻辑。
 
 ## 拓展-UI 与组件的区别
 

docs/guide/implements/skill.md

@@ -53,7 +53,7 @@ export function toggleSkill1() {
 import { getSkill1Enabled } from '../machanism/skill'; // [!code ++]
 
 export function calDamageWith(
-    info: UserEnemyInfo,
+    info: EnemyInfo,
     hero: Partial<HeroStatus>
 ): number | null {
     // ... 原有内容
@@ -241,7 +241,7 @@ export function getEnabledSkill() {
 import { getEnabledSkill, SkillType } from './skill';
 
 export function calDamageWith(
-    info: UserEnemyInfo,
+    info: EnemyInfo,
     hero: Partial<HeroStatus>
 ): number | null {
     // ... 原有内容
@@ -260,7 +260,7 @@ export function calDamageWith(
 import { getEnabledSkill, SkillType } from './skill';
 
 export function calDamageWith(
-    info: UserEnemyInfo,
+    info: EnemyInfo,
     hero: Partial<HeroStatus>
 ): number | null {
     // ... 原有内容

docs/guide/implements/special.md

@@ -26,13 +26,13 @@ export const specials: SpecialDeclaration[] = [
 
 ## 实现特殊属性
 
-打开 `packages-user/data-state/src/enemy/damage.ts`，在文件最后的 `calDamageWith` 函数中编写：
+打开 `packages-user/data-state/src/enemy/damage.ts`，在文件最后的 `calDamageWithTurn` 函数中编写：
 
 ```ts
-export function calDamageWith(
+export function calDamageWithTurn(
-    info: UserEnemyInfo,
+    info: EnemyInfo,
     hero: Partial<HeroStatus>
-): number | null {
+): DamageWithTurn {
     // ... 原有内容
 
     // 在需要降低勇士伤害的地方将勇士伤害乘以 0.9 即可
@@ -102,13 +102,13 @@ export const specials: SpecialDeclaration[] = [
 
 ### 属性实现
 
-修改 `damage.ts` `calDamageWith` 中的实现：
+修改 `damage.ts` `calDamageWithTurn` 中的实现：
 
 ```ts
-export function calDamageWith(
+export function calDamageWithTurn(
-    info: UserEnemyInfo,
+    info: EnemyInfo,
     hero: Partial<HeroStatus>
-): number | null {
+): DamageWithTurn {
     // ... 原有内容
 
     // 在乘以 1 - (myAttr / 100)，除以 100 是因为 myAttr 是百分制
@@ -210,10 +210,11 @@ class DamageEnemy {
 
 ### 自定义形状
 
-如果想要自定义光环形状，我们打开 `packages-user/data-utils/src/range.ts`，拉到最后可以看到形状定义，目前包含两个：
+如果想要自定义光环形状，我们打开 `packages-user/data-utils/src/range.ts`，拉到最后可以看到形状定义，目前默认的包含这些：
 
 - `square`: 中心点+边长的正方形
 - `rect`: 左上角坐标+宽高的矩形
+- `manhattan`: 曼哈顿距离，坐标之和小于半径
 
 我们以曼哈顿距离为例，展示如何自定义形状。
 
@@ -262,27 +263,3 @@ col.applyHalo(
     }
 );
 ```
-
-## 拓展-输出回合数
-
-样板默认的 `calDamageWith` 函数只允许输出伤害值，而有时候我们可能会需要战斗的回合数，这时候我们需要修改一下这部分内容，将伤害计算逻辑单独提出来，命名为 `calDamageWithTurn`，然后在 `calDamageWith` 中调用它。在需要回合数的时候，我们调用 `calDamageWithTurn` 函数即可，如下例所示：
-
-```ts
-/** 包含回合数的伤害计算 */
-export function calDamageWithTurn(
-    info: UserEnemyInfo,
-    hero: Partial<HeroStatus>
-) {
-    // ... 原本 calDamageWith 的计算逻辑，记得删除最后返回伤害的那一行返回值
-
-    // 返回回合数和伤害
-    return { turn, damage };
-}
-
-export function calDamageWith(info: UserEnemyInfo, hero: Partial<HeroStatus>) {
-    // 调用单独提出的函数计算伤害值
-    const damageInfo = calDamageWithTurn(info, hero);
-    // 如果伤害不存在，那么返回无穷大
-    return damageInfo?.damage ?? Infinity;
-}
-```

docs/guide/implements/status-bar.md

@@ -210,7 +210,7 @@ const realStatus: (keyof HeroStatus)[] = [
 
 ```ts
 export function calDamageWith(
-    info: UserEnemyInfo,
+    info: EnemyInfo,
     hero: Partial<HeroStatus>
 ): number {
     // ... 原有逻辑
@@ -224,4 +224,4 @@ export function calDamageWith(
 
 ## 拓展-了解 UI 编写的基本逻辑
 
-参考[此文档](./ui.md)，此文档将会教你如何从头开始编写一个 UI，并解释 UI 运行与渲染的基本逻辑。
+参考[此文档](../ui/ui.md)，此文档将会教你如何从头开始编写一个 UI，并解释 UI 运行与渲染的基本逻辑。

docs/guide/quick-start.md

@@ -4,7 +4,7 @@
 
 ## 常见需求实现指南
 
-参考[此文档](./implements.md)
+参考[此文档](./implements/index.md)
 
 ## 热重载
 
@@ -22,7 +22,7 @@
 
 当你**制作完游戏**后，点击构建游戏，即可自动构建游戏，构建结果在 `dist` 文件夹，会自动打包到 `dist.zip` 压缩包，发塔或更新上传此压缩包即可。
 
-此帮助文档远比 2.x 的文档易读，也更容易理解，建议多阅读此文档来解决自己的问题，如果问题很复杂，或是短时间内解决不了，再去造塔群询问。
+此帮助文档远比 2.x 的文档易读，也更容易理解，但是遇到问题时我们依然建议直接在造塔群询问，因为你可能不能判断文档中是否有关于你的问题的解答。
 
 ```mermaid
 graph TD

docs/guide/ui/elements.md

@@ -27,7 +27,7 @@ type ElementLocator = [
 - `w` `h`: 元素的长宽，描述了在没有缩放时元素的矩形长宽，默认是没有放缩的。
 - `ax` `ay`: 元素的锚点位置，描述了元素参考点的位置，所有位置变换等将以此点作为参考点。0 表示元素最左侧或最上侧，1 表示最右侧或最下侧，可以填不在 0-1 范围内的值，例如 `[-1, 1]` 表示锚点横坐标在元素左侧一个元素宽度的位置，纵坐标在元素下边缘的位置。
 
-![锚点图示](./img/image.png)
+![锚点图示](../img/image.png)
 
 示例如下：
 

docs/logger/error/error1.md

@@ -6,6 +6,8 @@
 Unexpected error when posting danmaku. Error info: $1
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 报错原因：发送弹幕时发生报错。
 - 解决方案：查看后面的 Error info，检查报错信息内容，按照报错信息修复问题。
 
@@ -24,6 +26,8 @@ Unexpected loading error in loading resource '$1/$2'. Error info: $3
 Syntax error in parsing CSS: Unexpected ':'. Col: $1. CSS string: '$2
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 报错原因：解析 CSS 时报错，一般是在发送弹幕时引起。
 - 解决方案：检查弹幕 CSS 语法是否正确。
 
@@ -33,6 +37,8 @@ Syntax error in parsing CSS: Unexpected ':'. Col: $1. CSS string: '$2
 Syntax error in parsing CSS: Unexpected ';'. Col: $1. CSS string: '$2'
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 报错原因：解析 CSS 时报错，一般是在发送弹幕时引起。
 - 解决方案：检查弹幕 CSS 语法是否正确。
 
@@ -42,6 +48,8 @@ Syntax error in parsing CSS: Unexpected ';'. Col: $1. CSS string: '$2'
 Syntax error in parsing CSS: Missing property name after '-'. Col: $1. CSS string: '$2'
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 报错原因：解析 CSS 时报错，一般是在发送弹幕时引起。
 - 解决方案：检查弹幕 CSS 语法是否正确。
 
@@ -51,6 +59,8 @@ Syntax error in parsing CSS: Missing property name after '-'. Col: $1. CSS strin
 Syntax error in parsing CSS: Unexpected end of css, expecting ':'. Col: $1. CSS string: '$2'
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 报错原因：解析 CSS 时报错，一般是在发送弹幕时引起。
 - 解决方案：检查弹幕 CSS 语法是否正确。
 
@@ -60,6 +70,8 @@ Syntax error in parsing CSS: Unexpected end of css, expecting ':'. Col: $1. CSS
 Syntax error in parsing CSS: Unexpected end of css, expecting property value. Col: $1. CSS string: '$2'
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 报错原因：解析 CSS 时报错，一般是在发送弹幕时引起。
 - 解决方案：检查弹幕 CSS 语法是否正确。
 
@@ -69,6 +81,8 @@ Syntax error in parsing CSS: Unexpected end of css, expecting property value. Co
 Post danmaku with not allowed css. Info: $1
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 报错原因：弹幕 CSS 中使用了不允许的 css 属性类型。
 - 解决方案：目前仅支持 `color` `background-color` `font-size: x%` 属性。
 
@@ -133,7 +147,7 @@ Cannot use shader program for shader element that does not belong to it.
 ## ERROR CODE 18
 
 ```txt
-Cannot delete shader program for shader element that does not belong to
+Cannot delete shader program for shader element that does not belong to it.
 ```
 
 - 报错原因：在一个着色器上删除了不属于这个着色器的着色器程序。

docs/logger/warn/warn1.md

@@ -24,6 +24,8 @@ Repeat load of resource '$1/$2'.
 Unknown danmaku tag: $1
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 警告原因：出现了未知的弹幕标签（指 `[xxx:xxx]`）
 - 解决方案：目前仅支持 `[i:xxx]` 标签，如果需要显示方括号，请使用 `\[\]`。
 
@@ -33,6 +35,8 @@ Unknown danmaku tag: $1
 Ignored a mismatched ']' in danmaku.
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 警告原因：出现了不能匹配的右方括号。
 - 解决方案：如果需要显示方括号，请使用 `\[\]`。
 
@@ -42,6 +46,8 @@ Ignored a mismatched ']' in danmaku.
 Repeat post danmaku.
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 警告原因：同一个弹幕被发送了两次。
 - 解决方案：确保一个弹幕实例只调用了一次 `post` 方法。
 
@@ -51,6 +57,8 @@ Repeat post danmaku.
 Registered special danmaku element: $1.
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 警告原因：要注册的弹幕标签已经存在。
 - 解决方案：避免使用同一个标签名，如果内容不一样请换一个标签名。
 
@@ -150,6 +158,8 @@ Floor-damage extension needs 'floor-binder' extension as dependency.
 Uncaught error in posting like info for danmaku. Danmaku id: $1.
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置弹幕系统。
+
 - 警告原因：为弹幕点赞时出现报错。
 - 解决方案：可能是网络问题，检查网络。
 
@@ -159,6 +169,8 @@ Uncaught error in posting like info for danmaku. Danmaku id: $1.
 Repeat light id: '$1'
 ```
 
+> 应该不会遇到这个报错，因为样板并不内置点光源。
+
 - 警告原因：重复的光源 id。
 - 解决方案：避免光源 id 出现重复。
 
@@ -284,8 +296,7 @@ Sub-image exceeds texture dimensions, auto adjusting size.
 Cannot modify MotaOffscreenCanvas2D that is freezed.
 ```
 
--   警告原因：不能修改已冻结的画布属性。
+- 遇不到这个报错。
--   解决方案：如果这个画布后续还需要修改属性，那么就不要冻结它。
 
 ## WARN CODE 34
 

docs/logger/warn/warn2.md

@@ -116,3 +116,21 @@ Uncaught promise error in waiting box component. Error reason: $1
 
 - 警告原因：在等待 box 组件（选择框、确认框等）时，出现了异步报错。
 - 解决方案：根据报错内容解决问题。
+
+## WARN CODE 64
+
+```txt
+Text node type and block type mismatch: '$1' vs '$2'
+```
+
+- 警告原因：多行文本（TextContent）解析时节点类型和分块类型不一致。
+- 解决方案：理应不会遇到这个问题，如果遇到了，请到造塔群寻求帮助。
+
+## WARN CODE 65
+
+```txt
+Cannot bind a weather controller twice.
+```
+
+- 警告原因：一个天气控制器不能绑定到两个元素上。
+- 解决方案：如果两个元素需要天气，那么请创建两个天气控制器，一个天气控制器只能绑定一个，且不能解绑。