diff --git a/docs/agent-view-design-v2.md b/docs/agent-view-design-v2.md
new file mode 100644
index 0000000..5c77bfe
--- /dev/null
+++ b/docs/agent-view-design-v2.md
@@ -0,0 +1,237 @@
+# 公网 Agent 页(`AgentView.vue`)设计方案 v2
+
+> 本文按 `breezell-design` 两遍流程产出,核心是**先列清功能、再谈设计**:
+> 第二节把本页应有的 **27 项能力**逐条落位(含 5 处当前页面看不到的能力),第四节按功能分区。
+>
+> 取代 `docs/agent-view-design.md`(v1 只做了结构搬家,未解决"功能不可见"问题);
+> 也取代 `docs/agent-view-refactor-plan.md`。更新日期:2026-09-23
+
+---
+
+## 一、Pass 1a:栈与设计系统检测
+
+| 检测项 | 实际值 |
+| --- | --- |
+| 框架 | Vue 3 + `