中文宏语言开发手册（机器人词库专用）

---

第一章：语言基础

1.1 基本结构

<宏 名称="示例宏">
  <!-- 注释：支持中文标签嵌套 -->
  <条件 变量="时间" 值="上午">
    <输出>早安{用户}～今天{日期}的天气是{天气}</输出>
  </条件>
  <默认>
    <输出>你好呀！</输出>
  </默认>
</宏>

• 标签规范：
  • 宏定义使用<宏 名称="...">包裹
  • 变量使用{变量名}格式
  • 支持<!-- 注释 -->格式

1.2 变量类型

类型	示例	作用域
系统变量	{用户}	全局
环境变量	{时间}	会话级
临时变量	<设置 变量="x">	宏内有效

---

第二章：控制结构

2.1 条件分支

<条件 变量="天气" 值="雨天">
  <输出>记得带伞哦！</输出>
  <设置 变量="建议" 值="带伞"/>
</条件>
<否则条件 变量="温度" 值=">30">
  <输出>高温预警！</输出>
</否则条件>
<默认>
  <输出>今天天气不错～</输出>
</默认>

2.2 循环处理

<循环 模式="列表" 数据="苹果,香蕉,橘子" 变量="水果">
  <输出>第{循环索引}个水果是{水果}</输出>
</循环>

<循环 次数="3" 变量="i">
  <输出>倒计时{3-i}</输出>
</循环>

---

第三章：函数系统

3.1 内置函数

<输出>
  现在时间：{时间格式="HH:mm"}<br>
  随机选择：{随机项="吃饭,睡觉,打游戏"}
</输出>

3.2 自定义函数

<函数 名称="生成问候">
  <参数>时间</参数>
  <条件 变量="时间" 值="上午">
    <返回>元气满满的一天开始啦！</返回>
  </condition>
  <返回>今天也要加油哦～</返回>
</function>

---

第四章：高级特性

4.1 上下文记忆

<记忆 类型="话题" 保持时间="24h">
  <条件 存在="上次话题">
    <输出>我们上次聊到{上次话题}...</输出>
  </条件>
</记忆>

4.2 情感分析

<情感分析 输入="{用户消息}">
  <积极>
    <输出>哇你好开心呀～{随机表情}</输出>
  </积极>
  <消极>
    <输出>抱抱你...{安慰语句}</输出>
  </消极>
</情感分析>

---

第五章：编辑器指南

5.1 界面布局

左面板：
  - 代码编辑区（支持语法高亮）
  - 实时错误检查
  - 变量监视窗口

右面板：
  - 对话模拟器
  - 变量调试工具
  - 上下文可视化

5.2 调试技巧

1. 使用<调试 输出="变量值"/>标签
2. 快捷键：
   • Ctrl+Space：变量自动补全
   • F5：快速重载词库
   • Alt+Click：跳转到宏定义

---

第六章：最佳实践

6.1 拟人化技巧

<!-- 添加自然停顿 -->
<输出>让我想想看...{等待 时间="1s"}应该是这样！</输出>

<!-- 使用口语化表达 -->
<输出>哎呀这个我不太确定呢～要不我们聊聊{转移话题}？</输出>

6.2 性能优化

• 避免深层嵌套（建议不超过5层）
• 高频词库使用<缓存 时间="5m">
• 大型列表处理使用<延迟加载>

---

附录A：速查表

符号	含义	示例
{变量}	变量替换	{用户}
@func()	函数调用	@随机表情()
[...]	可选参数	[超时="3s"]
`A	B`	逻辑或

---

附录B：错误代码表

代码	含义	解决方案
E001	未闭合标签	检查标签嵌套
E002	未定义变量	添加变量声明
E003	类型不匹配	检查变量值类型
W001	性能警告	优化循环/条件结构

---

附录C：更新日志

• v1.0 (2025.05) 初始版本发布

---

本手册持续更新，建议定期访问官网获取最新版本。