From 074ca4147f41582b3851b06697253e51290fa6cf Mon Sep 17 00:00:00 2001
From: LoveLosita <2810873701@qq.com>
Date: Tue, 12 May 2026 16:26:16 +0800
Subject: [PATCH] doc:update AGENTS.md

---
 AGENTS.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index e977b378..fc5fd305 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -33,6 +33,9 @@
 # 运行/调试/构建/测试/依赖
 优先使用uv
 依赖项以 pyproject.toml 为准，要同步更新requirements.txt
+前端改动后，如需走离线发布工作流，必须先在 `dashboard` 目录执行 `npm run build`（例如：`D:\Nodejs\npm.cmd run build`），确保生成最新的 `dashboard/dist`
+当前项目的离线发布工作流依赖仓库中已提交的 `dashboard/dist`；在修改 `dashboard/src`、`dashboard/public`、`dashboard/package.json`、`dashboard/package-lock.json` 或其他影响构建产物的前端文件后，要同步提交对应的 `dashboard/dist`
+不要在离线发布场景中假设服务器或 runner 可以联网安装 Node.js 依赖；除非明确确认发布机已具备可用的 `npm` 环境，否则默认按“本地构建 `dashboard/dist` 并随仓库提交”处理
 
 # 语言规范
 项目的首选语言为简体中文，无论是注释语言，日志展示语言，还是 WebUI 展示语言都首要以简体中文为首要实现目标
@@ -56,4 +59,4 @@
 https://github.com/Mai-with-u/maibot-plugin-sdk/blob/main/docs/guide.md
 
 # 如何提交maibot插件
-https://github.com/Mai-with-u/plugin-repo/blob/main/CONTRIBUTING.md
\ No newline at end of file
+https://github.com/Mai-with-u/plugin-repo/blob/main/CONTRIBUTING.md