<yacodeblocks ya-version="202" language="zh-CN">
  <content>
    <!-- 所有积木块都在这里 -->
    <block type="controls_if" id="123" x="100" y="100">
      <!-- 积木块内容 -->
    </block>
    
    <block type="component_event" id="456">
      <!-- 组件事件 -->
    </block>
    
    <!-- 更多积木块... -->
  </content>
</yacodeblocks>

myproject.aia (ZIP压缩包)
├── Screen1.bky        ← 包含<yacodeblocks>的积木块文件
├── Screen1.scm        ← 界面布局文件
├── Screen2.bky
├── Screen2.scm
├── assets/            ← 资源文件
│   ├── image.png
│   └── sound.mp3
└── project.properties ← 项目配置

扩展（.aix）包含：
├── Java代码（.java）
│   └── 定义新组件和方法
├── 资源文件
│   └── 图标、配置
└── 积木块定义（自动生成）
    └── 添加到yacodeblocks中

<!-- 内置积木块 -->
<block type="controls_if" id="builtin1">
  <!-- 标准结构 -->
</block>

<!-- 扩展积木块 -->
<block type="extension_component_method" id="ext1">
  <mutation component_type="com.example.MyExtension"></mutation>
  <field name="COMPONENT_SELECTOR">MyExtension1</field>
  <field name="METHOD_NAME">myMethod</field>
  <!-- 扩展特有的结构 -->
</block>

lineNumber: 1
columnNumber: 113572
The element type "yacodeblocks" must be terminated

场景：
1. 项目很大（113572字符 ≈ 100KB+）
2. 编辑时网络不稳定
3. 保存到一半中断
4. 文件被截断

结果：
<yacodeblocks...>
  <content>
    ...（部分内容）
  <!-- 缺少闭合标签！
</content></yacodeblocks>

场景：
1. 积木块很多（500+）
2. 浏览器占用内存过大
3. 保存时崩溃或超时
4. 数据未完整写入

症状：
- 浏览器卡顿
- 保存时间很长
- 突然刷新页面

场景：
1. 使用了多个扩展
2. 某个扩展的积木块格式异常
3. 保存时生成错误的XML

判断方法：
- 检查.bky文件中是否有异常的<mutation>标签
- 查看是否有未识别的积木块

场景：
在文本积木块中输入了特殊字符：
- 引号 "
- 与符号 &
- 小于号 <
- 大于号 >

这些字符应该被转义为：
- &quot;
- &amp;
- &lt;
- &gt;

如果未转义，会破坏XML结构

请回答以下问题：

1. 项目大小？
   □ 小型（< 10个Screen，< 200个积木块）
   □ 中型（10-20个Screen，200-500个积木块）
   □ 大型（> 20个Screen，> 500个积木块）

2. 使用了多少扩展？
   □ 0个
   □ 1-3个
   □ 4-6个
   □ > 6个

3. 编辑时是否遇到以下情况？
   □ 网络不稳定
   □ 浏览器卡顿
   □ 意外刷新
   □ 长时间未保存

4. 能否导出.aia文件？
   □ 可以
   □ 不能（按钮无响应）
   □ 导出失败

# 解压并检查
unzip yourproject.aia -d project_check

# 查看文件大小
ls -lh project_check/*.bky

# 检查XML结构
xmllint --noout project_check/Screen1.bky

# 查看文件末尾
tail -50 project_check/Screen1.bky

尝试以下步骤：

1. 检查Checkpoints
   Projects → Checkpoints
   如果有之前的版本，恢复它

2. 清理浏览器
   - 清除缓存
   - 关闭其他标签页
   - 刷新页面

3. 尝试删除最近的修改
   - 回忆最后添加的积木块
   - 尝试删除它们

4. 联系MIT支持
   - 发送错误截图
   - 描述操作步骤

步骤：
1. 打开项目列表页
2. 找到问题项目
3. 点击"Checkpoints"按钮
4. 查看历史版本列表
5. 选择最近的正常版本
6. 点击"Restore"

优点：
- 最简单
- 最安全
- 通常能恢复大部分工作

缺点：
- 可能丢失最近的修改
- 如果Checkpoints也损坏，则无效

# 1. 解压.aia文件
unzip myproject.aia -d extracted

# 2. 备份原文件
cp extracted/Screen1.bky extracted/Screen1.bky.backup

# 3. 检查文件
cat extracted/Screen1.bky | grep -o "</yacodeblocks>" | wc -l
# 如果输出是0，说明确实缺少闭合标签

# 4. 查看文件末尾
tail -100 extracted/Screen1.bky

# 5. 如果确实缺少闭合标签，添加它们
echo '</content></yacodeblocks>' >> extracted/Screen1.bky

# 6. 验证修复
xmllint --noout extracted/Screen1.bky
# 如果无输出，说明修复成功

# 7. 重新打包
cd extracted
zip -r ../myproject_fixed.aia *

# 8. 导入修复后的项目

如果项目太大，建议：

1. 创建新的Screen
2. 将部分功能迁移到新Screen
3. 删除原Screen中的重复代码
4. 使用TinyDB或变量传递数据

最佳实践：
- 每个Screen < 300个积木块
- 使用过程封装重复代码
- 定期清理无用积木块

建议备份频率：

小型项目：
- 每天结束前导出一次.aia
- 保留最近3个版本

中型项目：
- 每半天导出一次
- 保留最近5个版本
- 重要修改前额外备份

大型项目：
- 每小时导出一次
- 保留最近10个版本
- 使用版本号命名：project_v1.0, project_v1.1...

1. 只使用必要的扩展
   - 评估每个扩展的价值
   - 删除不用的扩展

2. 选择稳定的扩展
   - 查看扩展的评价和更新时间
   - 优先选择MIT官方或知名开发者

3. 定期更新扩展
   - 检查扩展是否有新版本
   - 阅读更新日志

4. 测试扩展兼容性
   - 添加新扩展后测试编译
   - 确保不影响现有功能

好习惯：

1. 定期保存
   - 每15分钟检查是否已保存
   - 重要修改后立即手动保存

2. 避免大改动
   - 一次只修改一个功能
   - 修改后测试编译

3. 清理代码
   - 定期删除无用的积木块
   - 使用"Show warning for unused blocks"

4. 稳定环境
   - 使用稳定的网络
   - 不要在手机热点编辑大型项目

□ 已了解yacodeblocks是内置格式
□ 已检查项目的Checkpoints
□ 已导出.aia文件备份
□ 已评估项目大小
□ 已检查扩展使用情况
□ 已建立定期备份习惯