Show Beryl features and UI overview directly in README

agent-studio-mini/README.md

@@ -13,6 +13,24 @@ flowchart LR
   L --> S[Skills / Workspace / ModelRuntime]
 ```
 
+## 功能介绍与页面展示
+
+Beryl 是面向广告数据和素材工作的 Agent：通过自然语言任务，完成读取数据、分析、生成报告和验收。当前配置使用 `Qwen3.8-27B-FP8` 模型标识，通过 Anthropic 兼容接口接入；模型负责理解与生成，Agent + Harness 负责工具调用、状态管理及交付检查。
+
+![Beryl Agent 页面功能示意](./agent-page-overview.png)
+
+> 页面功能示意，非运行截图；不包含真实账户、聊天记录或密钥。
+
+- **对话与 Skills**：自然语言交互，加载广告分析、日报、周报、素材脚本和报告等能力。
+- **运行进度**：展示分析阶段、工具执行、按需审批和结果整理。
+- **报告与 PPT**：按任务要求生成产物并验收；依赖有效模型连接和相关运行环境。
+- **SW Ads 多账户预警**：检查所有授权 TikTok 账户，使用各 Campaign 实际目标 ROI，支持账户筛选、异常提示及人工建议。非电商记录暂不套用电商 ROI 规则。
+- **安全边界**：预警不自动修改广告；数据缺失或过期时明确提示，不把失败当完成。
+
+[查看完整模型介绍与使用方式](./AGENT-OVERVIEW.md) · [获取最新源码包](./BERYL-RELEASE-20260909.md)
+
+> 版本说明：以上功能对应最新封装版本；仓库旧的展开源码未整体替换，以下保留原课堂版说明。
+
 ## 快速开始
 
 要求 Node.js 20+ 与 pnpm。运行 `pnpm install`，复制 `.env.example` 为 `.env` 并按需填写，然后 `pnpm dev`；Web 为 <http://localhost:5173>，API 为 <http://localhost:3001>。也可不写环境密钥，在顶部“模型设置”中提交 Provider、API、Base URL、Model ID、Vision 能力与 API Key。密钥只在当前服务进程的 Session 内存中保存，不回传、不写 Web Storage 或 Pi 全局文件。