跳到主要内容

开发者文档入口

如果你要参与 MaaStarResonance 的开发或文档维护,请从这里开始。

我应该先看哪一篇​

  1. 快速开始:本地环境准备、依赖安装、第一次运行。
  2. 个性化配置:开发工具、格式化、问题模板。
  3. 文档编写规范:文档页面模板、写法和术语约定。
  4. 开发随笔:记录一些常用命令。
  5. 生成Changelog:记录生成的更新日志的格式、原理、使用方式。

开发自动化功能​

仓库级开发约定见根目录 AGENTS.md。具体操作按任务查阅:

任务文档
添加任务、接入选项、选择参数传递方式如何添加新功能
修改识别、动作、共享参数与跨文件引用如何修改现有功能
查阅 Pipeline 字段、候选节点与错误分支Pipeline 参考手册
选择检查命令、调试节点、验收完整任务如何测试功能

Pipeline 可以独立完成任务,Python 自定义扩展和 Attach 读取函数按需使用,不要求每个功能都新增固定层数的文件。

开发插件​

使用前提醒​

  • 本仓库同时包含 Python、Node.js 和 Docusaurus 相关工具链。
  • 文档改动提交前至少运行一次 npm run docs:check。
  • 如果你只想使用程序而不参与开发,请转到 新手指南。