跳到主要内容

使用AI辅助开发

Alia 语法与常见编程语言差异较大（语法式调用、禁止逗号分隔参数、alias 定义语法关键字等），未经 Alia 训练的大语言模型直接编写容易产出非法代码。本文提供一份面向 AI 的语法参考包，将其提供给 AI 即可获得符合语法的生成结果。

下载语法参考包​

⬇ 下载 alia-ai-docs.zip

压缩包内含：

  • Grammar.md：Alia 全部语法概览（AI 适配版），每项含语法签名、最小示例、关键规则与禁止项，并链接到对应详细文档。
  • docs/：Base/Docs/docs 下全部文档的原始 Markdown（基础语法、进阶语法、内置类、标准库、工具链等），保留原有目录结构与相对链接。

打包内容与文档站同步，无需构建工具或 CI，解压即用。

提供给 AI 的方法​

将 zip 解压后，按场景选用：

  1. 作为附件/上下文：将 Grammar.md 直接附入对话，并补充指令：

    请严格遵循 Grammar.md 中的 Alia 语法编写代码。

  2. 作为可查阅目录：若 AI 支持读取本地文件，可将解压目录提供给 AI，让其在需要时打开 docs/ 下对应主题的文档（如 docs/advanced/classes.md）。
  3. 作为仓库工作区：在 Alia 项目中开启 AI 编码助手，将 Grammar.md 与 docs/ 一并纳入其可访问范围。

文档维护​

  • Grammar.md 与 docs/ 均随代码库更新。
  • 修改 Base/Docs/docs 下文档或 Base/Docs/ai-grammar/Grammar.md 后，重新生成压缩包：
cd Base/Docs
npm run build:ai-docs
  • 生成文件为 Base/Docs/static/ai/alia-ai-docs.zip，随仓库提交后由文档站直接提供下载。