欢迎使用机器人地图脚本编辑器！本工具旨在帮助您通过简单的自然语言指令，轻松、高效地修改和分析机器人导航地图 (.smap 文件)。

请按照以下三个简单步骤来运行和使用本工具。

本工具的“自然语言转脚本”功能依赖于 Google Gemini API。您需要先拥有一个自己的 API 密钥。 如果要切换其他 的 大模型，需要自己修改代码。

1. 访问 Google AI Studio。
2. 登录您的 Google 账号。
3. 点击 “Create API key” 按钮来生成一个新的密钥。
4. 复制并妥善保管您生成的密钥字符串。

1. 打开 server.py 文件：使用任何文本编辑器（如记事本、VS Code等）打开 server.py 文件。
2. 填写 API 密钥：在文件中找到下面这行代码：

   api_key = "" # API Key will be injected by the environment

将您在步骤 1 中复制的密钥字符串，填写到双引号之间。修改后应如下所示：

   api_key = "这里粘贴您自己的API密钥字符串" # API Key will be injected by the environment

3. 安装依赖：打开终端（或 Windows 的命令提示符），进入 server.py 所在的文件夹，然后运行以下命令来安装必要的软件库：

   pip install Flask Flask-Cors requests

4. 启动服务器：在同一个终端窗口中，运行以下命令：

   python server.py

当您看到类似 Running on http://127.0.0.1:5000/ 的信息时，表示服务器已成功启动。请保持此窗口不要关闭。

1. 打开 index.html, 浏览器登入 http://127.0.0.1:5000/ 。或者在您的文件管理器中，找到 index.html 文件，并用您的网页浏览器（如 Chrome, Edge, Firefox）打开它。
2. 开始使用：
   • 上传地图：点击页面右上角的“上传 .smap 地图”按钮。
   • 输入指令：在右侧的“自然语言指令”输入框中，用中文描述您想做的操作（例如：“把 LM1 向上移动 10 米”或“查询线路 LM1-LM2 的长度”）。
   • 生成脚本：点击“生成脚本”按钮，AI 会自动在下方的编辑器中生成相应的 Python 代码。
   • 执行脚本：预览代码无误后，点击“执行脚本”按钮，左侧的地图将会实时更新。
   • 导出地图：完成所有修改后，点击“导出 .smap”按钮即可保存您的工作。

现在您可以开始使用了！祝您工作愉快。