Enhance Beryl Agent detail and report views

2026-09-11 11:13:24 +08:00
parent 336bf88466
commit 15f067fff9
57 changed files with 1833 additions and 95 deletions
@@ -13,29 +13,24 @@ flowchart LR
  L --> S[Skills / Workspace / ModelRuntime]
 ```

-## 功能介绍与页面展示
-
-Beryl 是面向广告数据和素材工作的 Agent：通过自然语言任务，完成读取数据、分析、生成报告和验收。当前配置使用 `Qwen3.8-27B-FP8` 模型标识，通过 Anthropic 兼容接口接入；模型负责理解与生成，Agent + Harness 负责工具调用、状态管理及交付检查。
-
-![Beryl Agent 页面功能示意](./agent-page-overview.svg)
-
-> 页面功能示意，非运行截图；不包含真实账户、聊天记录或密钥。
-
- **对话与 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 全局文件。

-课堂 Demo：配置模型，发送“请使用 ads-analysis Skill，分析账户 demo-account 最近 7 天数据，找出异常 Campaign，并输出账户总结、关键指标和 3 条优化建议。最后使用 report-writer Skill 生成一份报告草稿。”可再附图并说明图片仅为辅助信号。`save_report_draft` 会暂停并等待批准；Approve 写入 Session 固定 `report.md`，Deny/Timeout 不写文件。
+课堂 Demo：配置模型，发送“请使用 demo-report Skill，读取 demo-account 最近 7 天演示数据，分析 Campaign，生成含 3 条建议的报告草稿。保存后读取报告并核对指标，明确验收是否通过。”该流程只使用固定演示数据，不查询客户账户。`save_report_draft` 会暂停并等待批准；Approve 写入 Session 固定 `report.md`，Deny/Timeout 不写文件。自动验收可在 apps/server 目录执行 `pnpm exec tsx ../../scripts/verify-demo.mts`；脚本仅自动批准自己新建会话的演示报告写入。
+
+## 页面与功能展示
+
+![Beryl Agent 工作台](./agent-page-overview.png)
+
+- **任务详情页**：历史任务可查看当前会话中的用户指令与 Agent 结果；所有详情页均提供“返回工作台”、右上角关闭、点击外部关闭和 `Esc` 退出。
+- **日报 / 周报**：Agent 完成 `save_report_image` 后，报告图片会直接出现在对话和对应报告页；支持页面内预览及打开大图。
+- **转化漏斗**：日报和周报按“曝光 → 点击 → 访问 → 加购 → 购买”展示关键指标，商品曝光包含所有视频与商品页曝光的汇总口径。
+- **快捷任务**：日报、周报、投放分析和素材策划卡片点击后仅带入指令，不会自动提交固定问题。
+- **运行详情**：右侧展示接收任务、分析规划、工具执行、人工确认和结果整理状态，并保留工具调用与错误诊断信息。
+- **技能目录**：展示已加载 Skill 及诊断状态，支持关闭按钮和点击外部退出。
+
+> 仓库展示图不包含 API Key、真实账户凭据或浏览器记录。模型凭据只允许放入本机 `.env` 或当前服务进程，不提交到 Git。

 ## 职责与行为