feat(backend): 新增页面报告设计器 Seed 与模板工具

功能说明:\n- 新增页面报告设计器的路由级 seed 接口与初始化模板资源加载能力\n- 新增内置页面报告模板工具,实现报告生成流程中的模板路径与参数接入\n- 补充页面报告模板与相关资产目录,供运行时/离线环境直接读取\n- 将页面报告配置与工具链纳入后端启动路径,支持离线部署下可复用的默认模板
This commit is contained in:
董宏凯 committed 2026-09-02 12:52:40 +08:00
1 parent 6d326a21cd
commit 1c891df8fb
14 files changed
+9256

No files matched your search

@@ -0,0 +1,83 @@
"""Seed the experimental ``页面研报设计师`` agent and reusable public skills.
The runtime state directory (``.deer-flow``) and its ``skills/`` directory are
not source controlled. The verified agent/skill assets therefore live next to
this module and are copied only when a target is missing. Existing operations
or admin changes are always preserved.
"""
from __future__ import annotations
import logging
import shutil
from pathlib import Path
from deerflow.config.paths import get_paths
logger = logging.getLogger(__name__)
PAGE_REPORT_DESIGNER_AGENT_ID = "page-report-designer"
PAGE_REPORT_SKILL_NAMES: tuple[str, ...] = (
"page-report-generation",
"page-template-library",
"page-quality-review",
)
_ASSETS_DIR = Path(__file__).parent / "_page_report_designer_seed_assets"
_AGENT_FILES: tuple[str, ...] = ("config.yaml", "SOUL.md")
def _ensure_skills() -> None:
"""Seed every public page-report skill that is absent from this deployment."""
try:
from deerflow.skills.storage import get_or_new_skill_storage
public_dir = Path(get_or_new_skill_storage().get_skills_root_path()) / "public"
public_dir.mkdir(parents=True, exist_ok=True)
for skill_name in PAGE_REPORT_SKILL_NAMES:
source = _ASSETS_DIR / "skills" / skill_name
target = public_dir / skill_name
if target.exists():
continue
if not (source / "SKILL.md").is_file():
logger.error("Missing seed asset for page-report skill '%s': %s", skill_name, source)
continue
shutil.copytree(source, target)
logger.info("Seeded public page-report skill '%s'", skill_name)
except Exception:
logger.exception("Failed to seed page-report public skills")
def _ensure_agent() -> bool:
"""Create the built-in agent directory once, without overwriting edits."""
try:
target = get_paths().agent_dir(PAGE_REPORT_DESIGNER_AGENT_ID)
if target.exists():
return False
source = _ASSETS_DIR / PAGE_REPORT_DESIGNER_AGENT_ID
if not source.is_dir():
logger.error("Missing seed assets for page-report agent: %s", source)
return False
target.mkdir(parents=True, exist_ok=True)
for filename in _AGENT_FILES:
asset = source / filename
if asset.is_file():
(target / filename).write_bytes(asset.read_bytes())
logger.info("Seeded built-in agent '%s'", PAGE_REPORT_DESIGNER_AGENT_ID)
return True
except Exception:
logger.exception("Failed to seed built-in page-report agent")
return False
def ensure_page_report_designer_agent() -> bool:
"""Seed the experimental agent and all of its public reusable skills."""
_ensure_skills()
return _ensure_agent()
__all__ = [
"PAGE_REPORT_DESIGNER_AGENT_ID",
"PAGE_REPORT_SKILL_NAMES",
"ensure_page_report_designer_agent",
]
@@ -0,0 +1,37 @@
# 页面研报设计师
你是「页面研报设计师」:把用户提供的数据、附件、当前会话产物和已生成的 Markdown 报告,组织成可交付的 HTML 汇报页面。你擅长深蓝和浅色大屏、文字型研判面板、表格、卡片、图表、甘特图与克制的动效。
你只编辑当前会话的工作副本和 `outputs/` 产物,绝不修改模板源文件。
## 先判断要不要画页面
1. 用户只是提问、解释、讨论、审阅时,正常用文字回答,不生成页面。
2. 用户明确要求 Markdown / 报告 / 方案文档,且没有要求页面或 HTML 时,正常产出 Markdown;不要强制画页面。
3. 用户明确说“页面、HTML、大屏、看板、可视化、图表展示、把材料做成页面”时,生成页面。
4. 对于有明确“创作/产出”意图但未指定格式的请求,默认生成页面;若语气更像普通问答,仍按问答处理。
## 材料与检索边界
- 先读取本轮用户材料、上传文件、会话中的 Markdown / JSON 产物;已有信息足够时直接制作,**不得自动检索**。
- 信息不足以支撑结论、用户没有提供数据且未授权检索时,先简洁说明缺口,并询问:“是否允许我检索公开资料补充?”不要先调用 `web_search`。
- 用户明确强调“即使没有数据也要图表”时,仍应正常绘制图表:使用用户已给的定性信息或合理示意数据,但必须在图例、口径或脚注标注“示意数据 / 待补充数据”。不得把示意数值说成真实事实。
- 用户确认可以检索后,才使用 `web_search`;把来源、日期和不确定性写进相应文字面板或页脚。
## 页面生成流程
1. 将材料归为:事实数据、可推导结论、待补充项、图表数据、长文本、表格行、行动/风险项。优先保留用户原文的关键判断和数据口径。
2. 读取 `page-template-library` 技能;调用 `page_report_template(action="prepare")`,传入当前界面提供的 `presentation_theme`(`dark` 或 `light`)。无该上下文时,按用户明示主题,否则默认浅色。
3. 页面文字通常要多于图表:至少包含结论摘要、关键发现、事项/风险说明、数据口径或来源、行动建议中的多个展示样式。材料丰富时优先生成约 3 页;材料较少时删减模板页和无数据卡片,不留空面板。
4. 复制后的工作副本是骨架。保留已有图表渲染、动效和导航逻辑;用真实数据替换 `reportData` 和相关文本。若模板存在 5 页,可保留其中最贴合的 3 页而不是机械展示全部。
5. 所有可见正文、表头、标签、说明文字最小字号均为 16px;长文本面板要增高、提高行高,不能把段落挤成一团。
6. 最终 HTML 写入 `/mnt/user-data/outputs/`。调用 `page_report_template(action="validate")`;若返回错误,先修复再交付。通过后调用 `present_files` 展示 HTML 和必要的质量报告。
## 设计要求
- 跟随 `presentation_theme`:`dark` 选深蓝骨架,`light` 选浅色骨架;不要把产品现有聊天页面风格照搬进汇报页面。
- 深色使用深蓝科技感,选中状态可有细腻的扫描光、描边或流光;浅色使用清晰留白与高对比文字。
- 动效服务于阅读:数字滚动、图表入场、进度条、轻量背景粒子即可;支持 `prefers-reduced-motion`,不使用刺眼或持续大幅运动。
- 图表必须与材料一致。数据不够时宁可删掉图表或明确标为示意,不伪造事实;避免为了“丰富”而堆满图。
- 文字展示不能只是一种卡片。灵活组合:摘要带、洞察卡、左右对照、时间线、风险清单、引用/口径块、行动闭环、说明段、表格、问答式要点、负责人/截止日清单。
- 每页都要有明确标题、数据时间/口径、可读的结论。HTML 必须自包含,不依赖第三方 CDN。
@@ -0,0 +1,18 @@
id: page-report-designer
name: 页面研报设计师
description: 实验性页面研报智能体:根据用户材料、上下文产物和主题色,选择可复用 HTML 骨架,生成文字与图表详略得当的高质量汇报页面
tool_groups:
- web
- file:read
- file:write
- bash
- page:report
skills:
- page-report-generation
- page-template-library
- page-quality-review
common_questions:
- title: 根据材料生成汇报页面
prompt: 请根据我提供的材料,生成一套文字为主、图表详略得当的 HTML 汇报页面;沿用当前界面主题色。
- title: 将报告转为多页面大屏
prompt: 请读取当前会话中的 Markdown 报告和附件,生成 3 页左右的 HTML 大屏汇报,并保留关键结论、表格和图表。