Skip to content

batu1579/hamibot-assistant

Repository files navigation

Welcome to Hamibot 开发助手 👋

GitHub package.json version GitHub

辅助开发 Hamibot 脚本的 VSCode 插件

🎉 特性

  • 自动在远程创建脚本
  • 可视化选择机器人
  • 指令上传和运行
  • 同时上传脚本文件和配置文件
  • 指定创建时使用的模板以快速开始

🚀 使用方法

因为此插件依赖于 Hamibot API ,所以在使用之前请先设置开发者令牌。

  1. 使用 新建 Hamibot 项目 指令创建新的脚本。

  2. 编写代码。

  3. 初次上传需要标记所需上传的文件:

    1. 在资源管理器界面找到需要上传的文件
    2. 在文件上点击右键选择标记选项
  4. 使用 上传标记的脚本文件上传并运行标记的脚本文件 指令上传。

📟 可用指令

此插件提供的所有指令都可以通过命令面板( Ctrl + pF1 )搜索 hamibot 关键字找到。

全局设置( Hamibot Config

  • hamibot-assistant.setApiToken: 设置 Hamibot API 令牌,在开始使用前请务必设置好。
  • hamibot-assistant.setShowOfflineRobot: 设置是否显示离线机器人(默认为 false )。
  • hamibot-assistant.setDefaultExecuteRobot: 设置默认调试机器人,在创建新项目时会选择,自动使用这个作为调试机器人。
  • hamibot-assistant.resetDialogs: 重置提示信息,用于恢复所有不再显示的提示信息。
  • hamibot-assistant.setProjectTemplate: 设置创建项目时使用的模板。

项目设置( Hamibot Project

  • hamibot-assistant.setProjectName: 设置项目名称,同时修改远程脚本名称。
  • hamibot-assistant.setExecuteRobot: 设置用于当前项目中调试脚本的机器人。

可用操作( Hamibot Operation

  • hamibot-assistant.initProject: 新建 Hamibot 项目,会自动在远程创建对应名称的脚本。
  • hamibot-assistant.uploadScript: 上传标记的脚本文件。
  • hamibot-assistant.uploadAndRunScript: 上传并运行标记的脚本文件。
  • hamibot-assistant.stopScript: 强制停止脚本运行。在运行前不必使用,因为 hamibot 会自动结束上一次执行的脚本。

⚙️ 扩展设置

此扩展提供以下设置:

  • hamibot-assistant.apiToken: 用于使用 Hamibot Api 的开发者令牌。

  • hamibot-assistant.showOfflineRobot: 选择调试机器人时显示离线机器人(默认不显示)。

  • hamibot-assistant.defaultExecuteRobot.enable: 启用默认调试机器人。启用后在创建项目时会使用此机器人,当项目设置中没有配置机器人时也会使用默认调试机器人代替。

  • hamibot-assistant.defaultExecuteRobot.robotInfo: 默认调试机器人信息,只有在启用默认调试机器人后才会生效。此设置包含两个字段:

    • id: 默认调试机器人 ID 。
    • name: 默认调试机器人名称。
  • hamibot-assistant.projectTemplate: 项目模板设置,在创建项目时使用对应的项目模板,来快速开始。此设置包含两个字段:

    • type: 设置模板类型,有三个可选项:

      • disabled: 禁用通过模板创建项目
      • local: 使用本地模板(本地文件夹)
      • remote: 使用远程模板( Github 仓库)
      • askWhenCreate: 每次创建项目时询问
    • path: 项目模板存放的路径,只能是绝对路径的本地文件夹或可用的 Github 远程仓库。

      注意:路径字段需要和类型对应,否则效果等同于禁用了模板。

📋 更新日志

查看 更新日志

🤝 贡献

欢迎提交 PR问题功能请求 !查看 问题页面

✨ 支持

如果有帮到你的话,帮我点颗小星星叭~ ⭐️


This README was generated with ❤️ by readme-md-generator