From 48b31823e6fff4829f9973fb4a3e4671ef12f942 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8F=8D=E7=BC=96=E8=AF=91=E5=B7=A5=E4=BD=9C=E5=8C=BA?=
 <decompiled@local>
Date: Wed, 29 Apr 2026 13:06:16 +0800
Subject: [PATCH] docs: add frontend-source AGENTS.md

Former-commit-id: ac5061eebdc5816947e33127ed5091d9aa5e1f4b
---
 frontend-source/AGENTS.md | 42 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 frontend-source/AGENTS.md

diff --git a/frontend-source/AGENTS.md b/frontend-source/AGENTS.md
new file mode 100644
index 00000000..940661e2
--- /dev/null
+++ b/frontend-source/AGENTS.md
@@ -0,0 +1,42 @@
+# frontend-source/ — 前端源码目录
+
+## OVERVIEW
+从 `frontend/` dist 产物反编译还原的前端源码。分为两类：
+- `decompiled/` — B 级反编译（4 个核心应用已产出，可读参考）
+- `projects/` — C 级重建（4 个核心应用脚手架，可构建部署）
+
+## WHERE TO LOOK
+
+| 任务 | 目录 | 说明 |
+|------|------|------|
+| 查看反编译源码 | `decompiled/<app>/src/` | 格式化后的 JS 模块 |
+| 开发核心应用 | `projects/<app>/` | 可构建的 Vue 2 工程 |
+| 反编译工具 | `scripts/` | unpack-webpack、beautify、API/路由提取器 |
+
+## 当前产出
+
+| 应用 | decompiled/ 模块数 | projects/ 脚手架 |
+|------|-------------------|------------------|
+| cwos-portal | 93 | ✅ |
+| elevator-front | 316 | ✅ |
+| alarm-front | 8 | ✅ |
+| front_acs | 99 | ✅ |
+
+## CONVENTIONS
+
+- `decompiled/` 下文件**不可用于构建**，仅供阅读参考
+- `projects/` 下工程可正常 `npm run dev` / `npm run build`
+- 技术栈: Vue 2.6 + Element UI 2.15 + axios 0.21 + vue-router 3 + vuex 3
+- 构建使用 Vue CLI 4.5
+
+## ANTI-PATTERNS
+
+- 不要修改 `decompiled/` 下的源码后试图构建
+- 不要混用 Vue 3 / Element Plus
+- 不要删除 `frontend/` 原 dist 目录
+
+## NOTES
+
+- 反编译工具在 `scripts/` 下，Node.js 18+
+- JS bundle 反编译无法恢复原始变量名和 .vue SFC 结构
+- 4 个核心应用的逐页面重写为后续迭代工作