diff --git a/agent-studio-mini/AGENT-OVERVIEW.md b/agent-studio-mini/AGENT-OVERVIEW.md
new file mode 100644
index 0000000..afeb7e4
--- /dev/null
+++ b/agent-studio-mini/AGENT-OVERVIEW.md
@@ -0,0 +1,50 @@
+# Beryl · 素材与广告数据 Agent
+
+用自然语言提出任务，让 Agent 读取广告数据、分析投放表现、生成报告，并按交付要求验收结果。
+
+## 模型简介
+
+当前项目配置使用 **Qwen3.8-27B-FP8** 模型标识，通过 **Anthropic 兼容接口**接入。这里记录的是项目的接入配置，不代表已核实供应商的模型底层架构或官方性能指标。
+
+模型负责理解任务、组织分析和生成内容；**Beryl Agent + Harness** 负责工具调用、Skill 加载、任务状态、审批和产物验收。模型不会凭空拥有广告数据，必须通过已授权的 SW Ads 连接读取。图片理解取决于实际网关能力；视频生成由外部工具提供，不等同于对话模型自身的视频能力。
+
+## 页面展示
+
+下图是依据当前界面结构绘制的功能示意，**不是运行截图**，不包含真实账户数据。
+
+![Beryl Agent 页面功能示意](./agent-page-overview.png)
+
+| 页面区域 | 使用方式 |
+| --- | --- |
+| 模型设置 | 配置接口、模型名称和密钥，确认连接状态 |
+| Skills Catalog | 查看广告分析、日报、周报、素材和报告等能力 |
+| 对话区 | 输入任务；Enter 发送，Shift+Enter 换行 |
+| Agent Loop | 查看当前阶段、工具完成状态及错误提示 |
+| SW Ads 预警 | 检查全部授权 TikTok 账户，按账户筛选结果 |
+| 报告结果 | 查看生成的报告或产物，验收失败不能算完成 |
+
+## 能做什么
+
+- **广告数据分析**：读取已授权账户的数据，整理消耗、成交额、订单及投放效率。
+- **日报与周报**：按账户业务时区生成报告，检查日期、数据口径和交付结果。
+- **多账户预警**：使用每个 Campaign 实际目标 ROI；提供高潜、不达标、无订单和效率异常提示，数据过期或缺失时明确说明。
+- **素材与脚本**：通过已加载的 Skills 辅助素材分析、选题与脚本规划。
+- **PPT 与报告验收**：区分调试产物和正式产物，按要求验收；需要额外运行依赖及有效模型连接。
+
+预警只提供人工建议，**不会自动扩量、降预算或暂停广告**。平台归因成交额 / 广告消耗不等于净利润，未获得完整成本数据时不能直接认定亏损。非电商 Campaign 暂不套用电商 ROI 规则。
+
+## 快速使用
+
+1. 获取[完整源码包及还原说明](./BERYL-RELEASE-20260909.md)。注意：2026-09-09 最新实现保存在分包中，仓库旧的展开源码尚未整体替换。
+2. 安装 Node.js 22 与 pnpm，解压后安装项目依赖。
+3. 按 `.env.example` 配置凭据，运行 `pnpm dev`。
+4. 在运行服务的电脑打开 `http://localhost:5173/`；这是本机地址，不是公网演示链接。
+5. 连接模型后输入任务，例如：“生成指定账户昨天的日报，注明日期与币种，验收通过后给出结果。”
+
+## 使用边界
+
+模型可能给出错误日期、错误参数或不完整分析，最终应以真实数据和验收结果为准。显示“已连接”不保证每次请求成功；重启后需确认当前 Session 的连接状态。预警自动检查默认关闭，开启后仍需后端持续运行。
+
+本项目是本机单进程版本，不是生产级多租户服务。Docker 配置已提供，但是否真正隔离取决于部署与验证；不要把默认运行方式视为已启用沙盒。不要上传密钥、会话记录或真实广告数据到 Git。
+
+更新日期：2026-09-10。
diff --git a/agent-studio-mini/agent-page-overview.png b/agent-studio-mini/agent-page-overview.png
new file mode 100644
index 0000000..5f313f5
Binary files /dev/null and b/agent-studio-mini/agent-page-overview.png differ
diff --git a/agent-studio-mini/agent-page-overview.svg b/agent-studio-mini/agent-page-overview.svg
new file mode 100644
index 0000000..42a9efb
--- /dev/null
+++ b/agent-studio-mini/agent-page-overview.svg
@@ -0,0 +1,25 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720">
+<rect width="1280" height="720" fill="#f4f7fa"/>
+<g font-family="Arial, sans-serif" fill="#20313c">
+<rect x="24" y="24" width="1232" height="64" rx="12" fill="#142d38"/>
+<text x="48" y="64" fill="white" font-size="23" font-weight="bold">Beryl · Agent Studio</text>
+<text x="806" y="62" fill="#c1d9df" font-size="18">模型设置　　SW Ads 预警　　Session</text>
+<rect x="24" y="108" width="262" height="546" rx="12" fill="white"/>
+<text x="46" y="145" font-size="20" font-weight="bold">Skills Catalog</text>
+<g font-size="18"><text x="46" y="202">广告数据分析</text><text x="46" y="259">日报 / 周报</text><text x="46" y="316">素材与脚本规划</text><text x="46" y="373">报告 / PPT</text><text x="46" y="430">可扩展 Skills</text></g>
+<rect x="306" y="108" width="620" height="546" rx="12" fill="white"/>
+<text x="336" y="152" font-size="24" font-weight="bold">Beryl 的素材和数据 Agent</text>
+<text x="336" y="190" font-size="16" fill="#647783">理解任务 → 读取数据 → 分析 → 生成 → 验收</text>
+<rect x="336" y="232" width="560" height="74" rx="10" fill="#eaf2f5"/>
+<text x="356" y="263" font-size="17">任务示例</text><text x="356" y="290" font-size="17">生成指定账户昨天的日报，并验收结果。</text>
+<rect x="336" y="334" width="560" height="134" rx="10" fill="#f5f7f8"/>
+<text x="356" y="367" font-size="18">分析过程与报告结果</text><text x="356" y="403" font-size="16" fill="#647783">呈现工具进度、数据口径、产物和验收状态</text><text x="356" y="439" font-size="16" fill="#647783">数据不足或执行失败时明确提示</text>
+<rect x="336" y="535" width="560" height="85" rx="10" fill="#fff" stroke="#b9cbd4"/>
+<text x="354" y="568" font-size="17" fill="#647783">输入任务…</text><text x="354" y="601" font-size="14" fill="#647783">Enter 发送 · Shift+Enter 换行</text><text x="831" y="600" font-size="17" fill="#147d85">发送</text>
+<rect x="946" y="108" width="310" height="546" rx="12" fill="white"/>
+<text x="970" y="150" font-size="20" font-weight="bold">Agent Loop</text>
+<g font-size="18"><text x="970" y="208">① 接收任务</text><text x="970" y="258">② 分析与规划</text><text x="970" y="308">③ 工具执行</text><text x="970" y="358">④ 人工确认（按需）</text><text x="970" y="408">⑤ 整理与验收</text></g>
+<rect x="970" y="475" width="262" height="140" rx="10" fill="#edf5f2"/>
+<text x="988" y="507" font-size="18" fill="#246756">SW Ads 多账户预警</text><text x="988" y="543" font-size="15">实际目标 ROI · 账户筛选</text><text x="988" y="578" font-size="15">只读建议 · 不自动修改投放</text>
+<text x="26" y="693" font-size="16" fill="#647783">页面功能示意 · 非运行截图 · 不包含真实账户、聊天记录或密钥</text>
+</g></svg>