sync update from LAN repo (source dhk-1 @ 3e87be55)
This commit is contained in:
1 parent
ab6068a7c1
commit
42f2a26fa8
1482 files changed
+227759
-9584
No files matched your search
+883
-746
File diff suppressed because it is too large.
Load diff
+239
-27
@@ -9,8 +9,8 @@ from functools import lru_cache
|
||||
from typing import TYPE_CHECKING
|
||||
from zoneinfo import ZoneInfo
|
||||
|
||||
from deerflow.config.agents_config import load_agent_soul
|
||||
from deerflow.config.system_settings import load_system_settings
|
||||
from deerflow.config.agents_config import load_agent_soul
|
||||
from deerflow.config.system_settings import load_system_settings
|
||||
from deerflow.skills.storage import get_or_new_skill_storage
|
||||
from deerflow.skills.types import Skill, SkillCategory
|
||||
from deerflow.subagents import get_available_subagent_names
|
||||
@@ -283,10 +283,23 @@ def _build_es_query_routing_section(
|
||||
``es_query`` is in that allowlist. The default lead agent has no allowlist,
|
||||
so the operator-controlled config switch is authoritative there.
|
||||
"""
|
||||
if available_skills is not None and "es_query" not in available_skills:
|
||||
return ""
|
||||
|
||||
config = app_config
|
||||
if available_skills is not None and "es_query" not in available_skills:
|
||||
return ""
|
||||
|
||||
# An explicit operator takedown is authoritative even for the default
|
||||
# agent, whose allowlist is represented by ``None``. Without this check
|
||||
# the prompt would still instruct the model to invoke an offline skill.
|
||||
try:
|
||||
from deerflow.config.extensions_config import ExtensionsConfig
|
||||
|
||||
es_query_state = ExtensionsConfig.from_file().skills.get("es_query")
|
||||
if es_query_state is not None and not es_query_state.enabled:
|
||||
return ""
|
||||
except Exception:
|
||||
logger.warning("Failed to verify es_query availability; suppressing routing prompt", exc_info=True)
|
||||
return ""
|
||||
|
||||
config = app_config
|
||||
if config is None:
|
||||
try:
|
||||
from deerflow.config import get_app_config
|
||||
@@ -487,7 +500,7 @@ task(description="Oracle Cloud analysis", prompt="...", subagent_type="general-p
|
||||
</subagent_system>"""
|
||||
|
||||
|
||||
_ORDINARY_QA_MARKDOWN_FORMAT_SECTION = """
|
||||
_ORDINARY_QA_MARKDOWN_FORMAT_SECTION = """
|
||||
<ordinary_qa_markdown_format>
|
||||
当普通问答需要输出带章节结构的较长内容时,必须采用以下 Markdown 规范,以便下载为 Word 后得到正确的自动编号和公文标题格式:
|
||||
- 文档主标题使用 `# 主标题`;主标题只写标题文字,不添加章节编号。
|
||||
@@ -496,19 +509,143 @@ _ORDINARY_QA_MARKDOWN_FORMAT_SECTION = """
|
||||
- 默认禁止使用以 `-`、`*`、`+` 或 `•` 开头的无序圆点列表;并列内容优先改写为完整自然段,确需逐项表达时使用有序列表。只有用户明确要求无序列表时才使用。
|
||||
- 简短问答不必为了套用格式而强行添加标题;本规范只约束实际使用的标题和列表。
|
||||
</ordinary_qa_markdown_format>
|
||||
"""
|
||||
|
||||
|
||||
def _ordinary_qa_markdown_format_enabled() -> bool:
|
||||
"""Return the admin-controlled formal Markdown prompt switch."""
|
||||
try:
|
||||
return bool(load_system_settings().prompt_prefix.ordinary_qa_markdown_format_enabled)
|
||||
except Exception:
|
||||
logger.debug("Failed to read the ordinary Q&A Markdown format switch; using disabled", exc_info=True)
|
||||
return False
|
||||
|
||||
|
||||
SYSTEM_PROMPT_TEMPLATE = """
|
||||
"""
|
||||
|
||||
|
||||
_ORDINARY_QA_VISUALIZATION_SECTION = """
|
||||
<ordinary_qa_visualization>
|
||||
以下输出分流规则优先级高于技能说明、绘图库说明和页面模板说明,必须先判断输出载体,再决定是否调用工具:
|
||||
|
||||
- 只有用户在本次请求中明确要求生成“HTML”“HTML 网页”“网页”“页面”“大屏”“看板”或 `.html` 文件,才属于 HTML 页面任务。
|
||||
- “画流程图”“画图表”“画地图”“画思维导图”“做可视化”“画得好看”等说法本身都不代表用户要求 HTML,也不得据此推断为页面任务。
|
||||
- 没有明确 HTML 页面意图时,禁止读取或调用 `page-report-generation`、`page_report_template` 等网页生成技能或工具,禁止创建、写入或交付 HTML 文件。
|
||||
- 用户只要求画流程图时,必须直接在当前消息中输出 Mermaid,不创建文件;流程图分支、节点较多也不能改变这一规则。
|
||||
- 用户只要求画图表时,必须沿用原有的消息内图表回答方式,不创建 HTML 文件。
|
||||
- 如果是否需要 HTML 不明确,默认使用消息内展示,不要自行升级为 HTML 页面任务。
|
||||
- 一旦用户明确要求 HTML 页面,任务就必须作为文件交付:读取并遵循 `page-report-generation` 技能,在沙箱中从空白文件生成 `.html`。此时禁止读取或执行 `web-app`、Vite、React 页面脚手架,即使其技能说明提到“多页面网站”;本任务的多页面是单一 HTML 制品中的锚点逻辑页。
|
||||
- 默认禁止读取 `page-template-library` 或调用 `page_report_template(action="prepare")`,也不要套用任何现成页面模板。只有用户本次明确说“使用模板”“按某个模板生成”或指定模板名称时,才允许选择并准备模板。
|
||||
- 在默认的从零生成流程中,第一项文件操作必须是用 `write_file` 创建一个与用户主题对应的最终文件,例如 `/mnt/user-data/outputs/美国服务网络大屏.html`。不要读取、打开、复制或复用已有的 `report-page.html`、旧 outputs 页面或任何工作副本;不要在最终文件写入前打开模板预览。
|
||||
- 从零生成的 HTML 必须追求首写即正确:写入前在本轮思考中完成结构检查,首个 `write_file` 直接写完整成品,不能先写骨架、再读回、再整页重写。对多页面门户,写入前逐项确认本地 Bootstrap/Alpine 引用、`.pages`、每个 `.page` 的 `id`/`data-page`、全部真实导航锚点、图表 JSON、地图纯文本 description 和深色文字配置。默认只做一次 `validate`。写入和校验会自动补齐深色卡片/表格/弹窗和深色图表文字,不要为这些机械项反复改文件。若仍失败,`errors` 已是完整清单:必须在同一次回复里按 `repair_checklist` 全部修完,再用最少次数的 `str_replace` 打局部补丁(CSS、导航、单个 JSON 或单个 DOM 区块),然后只再 `validate` 一次。禁止修一个错误就立刻校验、再修下一个。除非文件不存在或用户明确要求重做,禁止第二次 `write_file` 覆盖整个 HTML,也禁止重新调用 catalog/prepare 或再次读取模板。
|
||||
- 将最终 HTML 文件放到 `/mnt/user-data/outputs/`,并调用 `present_files` 打开制品预览。
|
||||
- 明确要求 HTML 页面时,禁止在消息正文中直接输出完整 HTML 源码或使用 `html` 代码围栏代替文件;最终消息只能简要说明并指向已经打开的 HTML 制品。除非工具明确失败,否则不得退化为粘贴源码。
|
||||
- HTML 页面默认必须是单页面:用户只说生成 HTML、网页、页面、看板或大屏时,`preferred_page_count` 必须传 `1`,所有内容在同一页面内通过纵向区块组织。
|
||||
- 只有用户在本次请求中直接明确说“多页面”“多页”“多个页面”“分页门户”或指定页面数量时,才允许 `preferred_page_count > 1`、选择多页面模板或创建页面切换导航。内容很多、报告章节很多、已有 Markdown 很长,都不能作为生成多页面的理由。用户明确要求多页面但未指定数量时,默认规划 3 个有业务意义的页面,并传 `preferred_page_count=3`;同时在 `page_brief` 写明各页的目标和导航关系。每一条导航 `<a href="#page-...">` 必须精确指向一个真实 `.page` 的 `id`,每个逻辑页必须有导航入口;脚本切页也只能写同样的 `location.hash="#page-..."`,不能写 `#overview`、`#stations` 一类的 `data-page` 值,更不能仅在 CSS 注释中伪造锚点文本。
|
||||
|
||||
仅当用户明确要求在普通问答中展示地图时,才输出地图数据代码块;普通文字问答保持原有回答方式,不要主动插入地图或思维导图。
|
||||
用户只说“画地图”“标注地点”“显示坐标”而没有明确要求生成 HTML、网页、看板、大屏或 `.html` 文件时,必须在消息列表中输出 `map-json`,不得为了展示地图创建或写入 HTML 文件。
|
||||
用户仅在**本次请求明确要求**“思维导图”“脑图”“知识导图”,或明确点名 `analysis-mindmap` 技能时,才可在消息列表中输出 `mindmap-json`;普通分析、总结、提纲、结构化 JSON、流程图或图表都不得自行升级为思维导图。
|
||||
思维导图必须基于当前可见的分析结构或用户提供的材料,只保留结论层级,不编造事实;先用一句极短说明引出,再立即输出一个严格 JSON 的 `mindmap-json` 代码块,让 JSON 写入过程可在消息中显示;代码块闭合后前端才会渲染导图。不创建文件、不输出 HTML、不要改用 Mermaid 或任何流程图数据围栏。每张图恰好一个根节点,`nodes` 为扁平数组,字段为 `id`、`parentId`(根为 `null`)、`label`、`kind`(仅可为 `topic/dimension/finding/evidence/risk/action`)、可选 `detail` 和 `sourceRefs`;可选 `title`、`summary`、`rootId`。节点 id 必须唯一、父节点必须存在、不能成环。导图是概要而不是报告逐条转录:目标 12–24 个节点,硬上限 36 个;中心主题保留 3–6 个一级维度,任一非根节点最多 3 个子节点,最多 4 层(含中心主题)。绝不按每个数据点、段落、引用、句子或项目符号各建一个节点;同类事实合并为一个结论节点,把必要解释合并到 `detail`,把少量依据标识放进 `sourceRefs`。材料过多时优先压缩与归类,而不是增加节点。格式示例:
|
||||
`{"title":"形势分析","summary":"按关键维度归纳","rootId":"root","nodes":[{"id":"root","parentId":null,"label":"形势分析","kind":"topic"},{"id":"risk","parentId":"root","label":"主要风险","kind":"risk","detail":"简要说明"}]}`
|
||||
流程图和图表沿用上述原有消息内能力。
|
||||
用户明确要求 Markdown 报告文件(`.md` / md 报告 / 写入沙箱)时,不要只在消息里贴全文;必须按 `<markdown_file_deliverable>` 用 `write_file` 写入 `/mnt/user-data/outputs/*.md`,以便右侧沙箱打开。
|
||||
|
||||
- 地图使用 `map-json`,坐标一律按 `[经度,纬度]`,格式为:
|
||||
`{"title":"地点分布","center":[116.4,39.9],"zoom":6,"markers":[{"name":"北京","coordinate":[116.4,39.9],"description":"可选"}],"lines":[],"polygons":[]}`
|
||||
- 代码块必须是严格 JSON:双引号、无注释、无尾逗号;只输出地图数据,不输出 JavaScript、HTML 或回调函数。
|
||||
- 禁止在地图数据中放入 URL、CDN、在线图片、在线图标、在线字体或在线绘图服务链接。标记只使用文字。
|
||||
- 地图代码块前后可以有简短说明。
|
||||
</ordinary_qa_visualization>
|
||||
"""
|
||||
|
||||
|
||||
_HTML_ARTIFACT_VISUALIZATION_SECTION = """
|
||||
<html_artifact_visualization>
|
||||
只有通过 `<ordinary_qa_visualization>` 中的 HTML 页面意图门禁后,才允许阅读和执行本节;否则必须完全忽略本节的绘图契约。
|
||||
触发本节的前提是:用户在本次请求中明确要求生成 HTML、网页、看板、大屏页面或 `.html` 文件。
|
||||
不得仅因为用户要求画地图、标注地点或显示坐标,就推断用户需要 HTML;这类普通地图请求必须在消息列表中使用 `map-json`。
|
||||
通过门禁后,必须在沙箱中生成并通过 `present_files` 交付实际 `.html` 文件,以便右侧制品面板打开预览;不得只在聊天消息中粘贴 HTML 代码。
|
||||
除非用户直接明确要求多页面或指定多个页面,生成的 HTML 必须是单页面,且质量校验时 `preferred_page_count` 必须传 `1`。不得因为报告较长、章节较多或模板自带导航而擅自生成多页面。
|
||||
“单页面”表示一个可以自然纵向滚动的 HTML 文档,不等于把所有内容压进一个固定尺寸的单屏。
|
||||
除非用户本次明确要求“大屏、驾驶舱、单屏或 1920×1080 固定画布”,普通 HTML 页面必须使用响应式文档布局:`body` 允许纵向滚动,主体使用 `width:min(100% - 32px, 1200px)` 一类的最大宽度,区块高度随内容增长,移动端改为单列。
|
||||
普通报告页面禁止固定 1920×1080 舞台、禁止 `html/body { overflow:hidden }`、禁止用 JavaScript 按 1920×1080 对整个页面做 `scale()`。不要把长报告做成 KPI 驾驶舱,不要为了装饰虚构指标;优先保留原报告的标题、摘要、章节、结论和来源层级。
|
||||
页面视觉应克制清晰:默认使用浅色低饱和配色、充足留白和稳定卡片层级;除非用户明确要求,禁止粒子背景、跑马灯、持续漂浮光斑、数字翻牌等循环动画,也不要用 emoji 充当功能图标。
|
||||
满足 HTML 触发条件后,才使用下列平台内置绘图契约。生成的 HTML 源码必须直接引用 Gateway 提供的浏览器版 AntV G6、ECharts 和本地 GeoJSON 地图资源,内网部署不依赖 CDN,也不依赖前端 React 构建产物。
|
||||
|
||||
- 用户上传了图片并要求把它作为页面背景时,必须把 `<uploaded_files>` 里该图片的 Public URL(`/api/public/html-images/...` 绝对地址)直接写成背景:单页面写成 `html, body` 的唯一背景;多页面只写到用户指定的 `.page` 选择器,未指定时写到首页 `.page`。两种情况均使用 `background-image: url('Public URL'); background-size: cover; background-position: center; background-repeat: no-repeat;`。禁止再叠 `linear-gradient`、`.overlay` 全屏蒙层、半透明遮罩或任何 rgba 滤镜;图片背景不得意外扩展到其他逻辑页面。禁止写 `/mnt/user-data/uploads/...`、相对路径、制品 API 路径,也禁止把图片转成 base64。理解图片内容仍只调用 `view_image`。没有 Public URL 时不要编造链接。禁止把 HTML 源码、Public URL 或 CSS 原文粘贴进聊天消息。
|
||||
- 用户明确要求多页面 HTML 时,启用“轻量交互门户”模式:仍然只交付一个 `.html` 制品(预览器以 `blob:` 打开,不能可靠跳转相对的 `page2.html`),用 `<main class="pages">` 包住多个带唯一 `id` 与 `data-page` 的 `<section class="page">`。导航只使用 `href="#page-..."`;首页默认显示,其余页默认隐藏,页面切换由预览器已注入的锚点处理器完成。不要用相对 `.html` 链接、`window.location`、iframe 嵌套或前端构建流程。每个页面必须有明确业务职责,例如概览、地图/分析、站点/明细。
|
||||
- “轻量交互门户”模式必须使用后端托管的 Bootstrap 与 Alpine:`<link rel="stylesheet" href="__DF_HTML_RUNTIME_BASE__/bootstrap.min.css">`、`<script defer src="__DF_HTML_RUNTIME_BASE__/alpine.min.js"></script>`、`<script defer src="__DF_HTML_RUNTIME_BASE__/bootstrap.bundle.min.js"></script>`。Bootstrap 负责响应式网格、导航、表格、按钮和标准 `modal`;Alpine 负责小范围状态、筛选、列表渲染与动态详情。可根据业务需要编写足量的局部 CSS/JavaScript,不限制代码行数;但禁止引入 jQuery、React、Vue、Babel、npm、CDN 或重复的组件库。详情弹窗优先使用 Bootstrap `data-bs-*` 或 `bootstrap.Modal`,地图标点/区域详情仍由 DeerFlow 地图运行时提供。
|
||||
- 只能按需使用以下后台地址,必须写进 HTML 源码的 `<head>`,并保留这里给出的顺序;禁止使用 CDN、npm 网站或其他在线绘图服务:
|
||||
- 流程图:`<script defer src="__DF_HTML_RUNTIME_BASE__/g6.min.js"></script>`
|
||||
- 图表:`<script defer src="__DF_HTML_RUNTIME_BASE__/echarts.min.js"></script>`
|
||||
- 地图:`<script defer src="__DF_HTML_RUNTIME_BASE__/echarts.min.js"></script>`。地图与普通图表共用同一个 ECharts 浏览器包;不要引入 Leaflet 或任何地图瓦片库。
|
||||
- 只要页面使用上述任一种图形,都必须在所有绘图库引用之后添加:`<script defer src="__DF_HTML_RUNTIME_BASE__/deerflow-runtime.js"></script>`。
|
||||
- 页面使用哪一种图形,就必须包含对应引用;同一页面使用多种图形时,同时包含对应引用。不要在 HTML 中省略这些引用,不要依赖前端预览器注入,也不要自行复制绘图库源码。
|
||||
- 从已有 Markdown 报告生成页面时,必须先盘点报告中的 Mermaid 代码块以及流程图、图表、地图内容,并在 `page_report_template` 的 `required_features` 和 `page_brief` 中如实声明。
|
||||
- Markdown 中的 Mermaid 流程图必须转换成下述 `data-df-flow` G6 契约,禁止原样复制 Mermaid,也禁止改画成手写 HTML/CSS 节点、箭头或步骤条。
|
||||
- 调用 `page_report_template` 校验时必须继续传入相同的 `required_features`。校验返回 `ok: false` 时必须按错误修复并重新校验,不得忽略错误或直接交付。
|
||||
- 流程图不要使用 Mermaid。写一个有明确高度的容器,例如 `<div id="process-flow" class="df-flow" style="height:420px"></div>`;紧随严格 JSON:
|
||||
`<script type="application/json" data-df-flow="process-flow">{"title":"业务流程","direction":"LR","nodes":[{"id":"start","label":"需求受理","description":"接收并登记需求","type":"start"},{"id":"review","label":"方案评审","description":"确认范围与风险","type":"decision"},{"id":"finish","label":"交付上线","type":"end"}],"edges":[{"source":"start","target":"review","label":"提交"},{"source":"review","target":"finish","label":"通过"}]}</script>`
|
||||
`direction` 只能是 `LR` 或 `TB`;节点 `type` 使用 `start/end/decision/risk/process/stage/task`。平台用 AntV G6 自动生成带卡片节点、状态色、箭头、标签和交互缩放的流程图,不要写 `new G6.Graph` 初始化代码。
|
||||
单张流程图优先控制在 8 个节点以内;超过 8 个节点时应按阶段拆成多张图,确实不能拆时必须用 `TB` 并给容器至少 `600px` 高度。
|
||||
每张流程图独占一行,不要把多个流程图塞进固定高度的两列网格。父级区块必须允许高度随内容增长,禁止依赖运行时修改容器高度。
|
||||
- 图表:写一个有明确高度的容器,例如 `<div id="sales-chart" class="df-chart" style="height:360px"></div>`;紧随一个严格 JSON 数据块:
|
||||
`<script type="application/json" data-df-chart="sales-chart">{"title":{"text":"销售趋势"},"tooltip":{},"xAxis":{"type":"category","data":["一月","二月"]},"yAxis":{"type":"value"},"series":[{"type":"line","data":[12,18]}]}</script>`
|
||||
`data-df-chart` 的内容必须能被 `JSON.parse` 直接解析:禁止 `function (...)`、箭头函数、回调、注释、未加引号的键、尾逗号和任何 JavaScript 表达式。不要写 `color: function(p){...}`、`formatter: function...` 等回调;颜色使用字面量色值或每个数据项的 `itemStyle.color`,提示词使用 ECharts 字符串模板(例如 `"{b}: {c}"`)。不要写 `echarts.init`,平台自动初始化。声明式图表配置只保留 `data-df-chart` JSON;不得为同一图表另写未被使用的 `const option`,或用 `document.write` 生成隐藏占位容器。
|
||||
深色页面必须在 `<html>` 声明 `data-df-theme="dark"`,正文、表格、输入和弹窗使用浅色前景。每张深色图表必须设置根 `textStyle.color`,有标题时设置 `title.textStyle.color`,有图例时设置 `legend.textStyle.color`;每个 x/y 轴设置 `axisLabel.color`,带轴名时设置 `nameTextStyle.color`;饼图、漏斗图和雷达图系列设置 `label.color`。禁止在深色背景留下 ECharts 默认黑字或 `#000` 一类深色文字。
|
||||
若使用 Bootstrap 卡片、表格、弹窗或表单,不能依赖 `body { color: ... }` 的继承:Bootstrap 组件可能覆盖它。必须同时设置 `html[data-df-theme="dark"]` 的 `--bs-body-color`、`--bs-emphasis-color`、`--bs-secondary-color` 等 token,并显式给 `.card`、`.data-table`/`.data-table td`、`.modal-content`/`.modal-body`、`.form-control`/`.form-select` 设置浅色 `color`;表头、辅助文案可用较浅的次级文字色。深色页面应只用一个统一的语义色变量组,保证正文的对比度至少 4.5:1。
|
||||
- HTML 网页中的地图一律使用本地 GeoJSON + ECharts Canvas 契约,禁止 Leaflet、`data-df-map`、
|
||||
地图瓦片 URL、CDN、外部地图服务,以及页面内的 `echarts.init` / `echarts.registerMap`。
|
||||
普通问答消息列表的 `map-json` 保持原有前端瓦片渲染,不受本条影响。
|
||||
写一个有明确高度的容器,例如 `<div id="area-map" class="df-geo-map" style="height:560px"></div>`;紧随严格 JSON:
|
||||
`<script type="application/json" data-df-geo="area-map">`
|
||||
`{"title":"全国服务网络","map":"china-provinces","mode":"background","roam":true,"showLabels":false,`
|
||||
`"regions":[{"name":"北京市","value":86,"description":"华北服务中心","color":"#2c78b7"}],`
|
||||
`"markers":[{"name":"北京","coordinate":[116.4,39.9],"description":"华北服务中心"}],"lines":[]}</script>`
|
||||
内置地图目录如下,坐标统一为 `[经度,纬度]`:中国省级 `china-provinces`、美国州级 `us-states`、日本都道府县 `japan-prefectures`、台湾地区县市 `taiwan-counties`。根据用户指定国家或城市自动选择对应地图;若没有给出国家,默认使用 `china-provinces`。不要猜测或引用未内置的国家、行政区或在线地图。
|
||||
平台自动加载本地 GeoJSON、注册地图、绘制区域/标记/连线,并支持拖拽缩放与点击。多页面中地图所在 `.page` 初始隐藏时,运行时会等容器可见后再初始化,并跟随容器尺寸变化自动 resize;不要调用不存在的 `deerflowMapReady`,也不要为切页手写延迟初始化、`echarts.init` 或 `chart.resize()`。`regions` 与 `markers` 中的 `description` 会在用户点击区域或标点时自动显示为可关闭的详情浮层;`description` 必须是纯文本,不能包含 `<a>`、`<span>`、`onclick` 或其他 HTML/事件属性,因为运行时会转义它。不要自己写地图弹窗。`us-states`、`japan-prefectures` 和 `taiwan-counties` 的区域名应使用地图中的标准英文名称(例如 `California`、`Osaka Prefecture`、`Taipei City`)。
|
||||
如需把点击结果联动到页面内已有的信息卡、筛选站点或切换明细页,只能监听 `window` 的 `deerflow:geo-map-click` 事件,并读取 `event.detail.name`、`event.detail.description` 或 `event.detail.data` 更新文字;需要切页时在事件回调内设置一个真实导航锚点,例如 `window.location.hash="#page-stations"`,再执行筛选。禁止在地图 `description` 中伪造“查看全部”链接,也禁止为此自行初始化 ECharts。
|
||||
用户明确要求“地图网页、地图看板或地图大屏”时,默认采用“深蓝三栏态势数据大屏”风格,而不是通用报告卡片或整页背景地图。桌面宽度(至少 1180px)使用 `min-height:100dvh` 的三栏网格:左列约 24%–27%,中列约 46%–52%,右列约 24%–27%,间距 12px–16px;窄屏时改为单列纵向布局,地图优先显示,禁止通过 `min-width` 强行产生横向滚动。
|
||||
顶部使用 72px–84px 的细标题带:左侧放日期、资料范围或状态,中央放中文主标题和一行大写英文副标题,右侧只放数据更新时间等已知信息;可用低透明斜线和一条青色发光分隔线增强层次,但没有真实时间数据时不要虚构实时时钟。主内容左列优先放 2 个紧凑 KPI 和一张趋势图;中列放一张占满列高的 `.df-geo-map`;右列放横向排名图和占比环图或与用户任务同等重要的两张分析图。所有图表必须对应用户给出的主题,缺少真实数据时清晰标注“示意数据”。
|
||||
面板使用深蓝半透明渐变、细蓝色边框、青色标题竖条、左上/右下的小角标和克制内发光;主色为深蓝和青色,金色只用于用户关注的枢纽、告警或最高优先级数据。标题可以有中英双层信息,但正文和交互控件最小字号为 16px;不要使用 emoji、厚重不透明白卡、夸张霓虹、无意义动画或外部字体/CDN。所有可点击控件须保留悬停、按下和键盘焦点状态,并尊重 `prefers-reduced-motion`。
|
||||
中列地图必须始终是视觉主角,作为面板主体背景而非 `body` 背景。这种三栏结构中的中列就是“中间地图舞台”,中间至少 65% 的地图画面保持无遮挡。地图容器高度至少 560px,使用 `mode:"background"`、`showLabels:false`,地图头部另放标题和小图例;用户提到的城市必须写入 `markers`,提到的行政区必须同时写入 `regions` 并高亮,每个标点/区域提供 `description`,由运行时弹出详情浮层。需要联动页面内摘要时只监听 `deerflow:geo-map-click`;不要手写地图弹窗、`echarts.init`、`echarts.registerMap`、视觉映射或函数式 ECharts 配置。
|
||||
地图面板层级必须保持可点击:地图容器在最底层,装饰网格、角标和渐变遮罩都使用 `pointer-events:none`,信息卡仅存在于左右列,不得覆盖中列地图的主体画面;卡片之外的透明区域不得拦截鼠标事件,使地图标点和区域始终可点击。
|
||||
- 每个流程图、图表或地图旁边都要有可读标题和一句文字结论;即使绘图失败,页面主体仍应能理解。容器必须设置高度,不能只依赖百分比高度。
|
||||
- 默认直接用 `write_file` 在 `/mnt/user-data/outputs/` 创建最终 `.html` 文件,以便生成过程中自动打开右侧沙箱预览;不要先写 workspace 后再用 `cp`/bash 复制。整个过程只能使用这个最终路径:不得先 `present_files` 一个模板/占位页,也不得把完成版换到另一个文件名。
|
||||
完成后对同一路径调用 `page_report_template(action="validate")`,同时传入 `preferred_page_count`、完整的 `required_features` 和 `page_brief`;通过后再 `present_files`。若校验发现图表 JSON、地图或流程图契约错误,必须修复后重新校验,不能交付带“图形数据格式错误”的页面。
|
||||
- 只有用户明确要求使用模板时,才调用 `page_report_template(action="prepare", template_id="...")`。此时其 `working_copy` 同时也是 `final_output`,直接编辑、校验并交付即可。
|
||||
</html_artifact_visualization>
|
||||
"""
|
||||
|
||||
|
||||
_MARKDOWN_FILE_DELIVERABLE_SECTION = """
|
||||
<markdown_file_deliverable>
|
||||
本节只在用户本次明确要求 Markdown 报告文件时生效。普通短问答、解释、对比和口头总结继续只在消息里回答,不要主动打开沙箱。
|
||||
|
||||
触发条件(满足任一即可):
|
||||
- 用户明确要求生成 `.md`、Markdown 文件、md 报告或 markdown 报告
|
||||
- 用户明确说「写 md 报告」「保存为 md」「输出 markdown 文件」「报告文件」
|
||||
- 用户明确要求把报告写入沙箱或打开沙箱预览
|
||||
|
||||
未触发时:不要因为回答较长或带了 `#` 标题就写入文件。
|
||||
用户明确要求 HTML / 网页 / 大屏时走 HTML 文件交付,不要改写成 Markdown 文件。
|
||||
|
||||
触发后必须:
|
||||
- 用 `write_file` 把完整 Markdown 直接写入 `/mnt/user-data/outputs/` 下的 `.md` 文件,例如 `/mnt/user-data/outputs/形势分析报告.md`
|
||||
- 这样右侧沙箱会在写入过程中自动打开;不要只在聊天消息里粘贴全文代替文件
|
||||
- 不要先写 `/mnt/user-data/workspace/` 再复制
|
||||
- 写入后可以 `present_files` 同一路径;最终聊天回复只做简短说明并指向制品
|
||||
</markdown_file_deliverable>
|
||||
"""
|
||||
|
||||
|
||||
def _build_html_artifact_visualization_section(app_config: AppConfig) -> str:
|
||||
"""Render browser-reachable backend runtime URLs into the HTML contract."""
|
||||
base_url = app_config.html_runtime.base_url.rstrip("/")
|
||||
return _HTML_ARTIFACT_VISUALIZATION_SECTION.replace(
|
||||
"__DF_HTML_RUNTIME_BASE__", base_url
|
||||
)
|
||||
|
||||
|
||||
def _ordinary_qa_markdown_format_enabled() -> bool:
|
||||
"""Return the admin-controlled formal Markdown prompt switch."""
|
||||
try:
|
||||
return bool(load_system_settings().prompt_prefix.ordinary_qa_markdown_format_enabled)
|
||||
except Exception:
|
||||
logger.debug("Failed to read the ordinary Q&A Markdown format switch; using disabled", exc_info=True)
|
||||
return False
|
||||
|
||||
|
||||
SYSTEM_PROMPT_TEMPLATE = """
|
||||
<role>
|
||||
You are {agent_name}, an internal super agent.
|
||||
</role>
|
||||
@@ -642,6 +779,12 @@ You: "Deploying to staging..." [proceed]
|
||||
|
||||
{ordinary_qa_format_section}
|
||||
|
||||
{ordinary_qa_visualization_section}
|
||||
|
||||
{html_artifact_visualization_section}
|
||||
|
||||
{markdown_file_deliverable_section}
|
||||
|
||||
<citations>
|
||||
**CRITICAL: Always include citations when using web search results**
|
||||
|
||||
@@ -860,6 +1003,8 @@ RAG/reference display mode is enabled.
|
||||
acp_section=acp_and_mounts_section,
|
||||
)
|
||||
|
||||
if not writing_mode:
|
||||
prompt += _MARKDOWN_FILE_DELIVERABLE_SECTION
|
||||
prompt = prompt + rag_mode_section + _current_time_context()
|
||||
return prompt
|
||||
|
||||
@@ -888,6 +1033,8 @@ def _get_memory_context(agent_name: str | None = None, *, app_config: AppConfig
|
||||
|
||||
user_id = get_effective_user_id()
|
||||
config = get_effective_memory_config(user_id)
|
||||
if not config.enabled:
|
||||
return ""
|
||||
|
||||
manager = build_memory_manager(
|
||||
user_id=user_id,
|
||||
@@ -1415,6 +1562,44 @@ def build_report_structure_setup_prompt(
|
||||
"""
|
||||
|
||||
|
||||
def build_gongwen_template_setup_prompt(*, quick_mode: bool = False) -> str:
|
||||
"""Minimal, confirmation-gated assistant for personal Gongwen templates.
|
||||
|
||||
It deliberately reuses ``setup_report_structure`` as the transport-only
|
||||
approval tool: the frontend maps title/name/content into its own template
|
||||
form and is the only layer that persists a template.
|
||||
"""
|
||||
clarification_rule = (
|
||||
"不要追问,直接根据用户描述给出合理的公文模板结构。"
|
||||
if quick_mode
|
||||
else "关键信息缺失时可调用 ask_clarification,但最多两轮;每次提问后立即结束本轮。"
|
||||
)
|
||||
tools_rule = (
|
||||
"你只有一个工具:setup_report_structure。"
|
||||
if quick_mode
|
||||
else "你只有两个工具:ask_clarification 和 setup_report_structure。"
|
||||
)
|
||||
return f"""你是「公文模板中心」的模板结构助手。你的工作不是起草具体公文,而是帮助用户创建一套可复用的**公文模板结构**。
|
||||
|
||||
【严格边界】
|
||||
- 只讨论模板名称、适用场景、正文结构和固定的落款/要素;绝不撰写任何具体公文正文,不虚构单位、日期、事项或数据。
|
||||
- {tools_rule} 不可检索、不可调用技能、不可写文件、不可调用其它工具。
|
||||
- {clarification_rule}
|
||||
|
||||
【对话流程】
|
||||
1. 用户描述用途后,先用 Markdown 给出完整模板骨架:`#` 为模板标题,`##` 为正文主要章节;必要时可用 `###` 表示固定子项。每个标题应体现该文种真实需要交代的内容,避免所有模板都套用“工作目标/工作要求”。
|
||||
2. 询问用户是否确认;用户要求调整时,重新给出完整骨架。
|
||||
3. **只有用户明确确认结构后**,调用 `setup_report_structure` 提交建议。调用前用一句话概括;调用后不再输出其它内容。
|
||||
|
||||
【提交字段映射】
|
||||
- `title`:模板名称,例如“重点工作部署通知”。
|
||||
- `name`:一句话说明适用场景。
|
||||
- `content`:刚与用户确认的完整 Markdown 模板骨架;只含标题层级/结构说明,不含具体正文。
|
||||
- `structure_mode`:固定结构用 `fixed`,可按具体事项增减小节用 `adaptive`;未说明时为 `adaptive`。
|
||||
- `retrieval_directions` 和 `retrieval_skills` 一律留空。
|
||||
"""
|
||||
|
||||
|
||||
def apply_prompt_template(
|
||||
subagent_enabled: bool = False,
|
||||
max_concurrent_subagents: int = 3,
|
||||
@@ -1547,13 +1732,37 @@ When a search, knowledge, skill, or MCP tool returns a result list:
|
||||
if rag_mode_enabled
|
||||
else ""
|
||||
)
|
||||
ordinary_qa_format_section = (
|
||||
_ORDINARY_QA_MARKDOWN_FORMAT_SECTION
|
||||
if _ordinary_qa_markdown_format_enabled()
|
||||
and not is_bootstrap
|
||||
and not writing_mode
|
||||
and not is_notebook_mode
|
||||
and not is_scheduled_run
|
||||
ordinary_qa_format_section = (
|
||||
_ORDINARY_QA_MARKDOWN_FORMAT_SECTION
|
||||
if _ordinary_qa_markdown_format_enabled()
|
||||
and not is_bootstrap
|
||||
and not writing_mode
|
||||
and not is_notebook_mode
|
||||
and not is_scheduled_run
|
||||
else ""
|
||||
)
|
||||
ordinary_qa_visualization_section = (
|
||||
_ORDINARY_QA_VISUALIZATION_SECTION
|
||||
if not is_bootstrap
|
||||
and not writing_mode
|
||||
and not is_notebook_mode
|
||||
and not is_scheduled_run
|
||||
else ""
|
||||
)
|
||||
html_artifact_visualization_section = (
|
||||
_build_html_artifact_visualization_section(app_config)
|
||||
if not is_bootstrap
|
||||
and not writing_mode
|
||||
and not is_notebook_mode
|
||||
and not is_scheduled_run
|
||||
else ""
|
||||
)
|
||||
markdown_file_deliverable_section = (
|
||||
_MARKDOWN_FILE_DELIVERABLE_SECTION
|
||||
if not is_bootstrap
|
||||
and not writing_mode
|
||||
and not is_notebook_mode
|
||||
and not is_scheduled_run
|
||||
else ""
|
||||
)
|
||||
|
||||
@@ -1573,6 +1782,9 @@ When a search, knowledge, skill, or MCP tool returns a result list:
|
||||
subagent_thinking=subagent_thinking,
|
||||
acp_section=acp_and_mounts_section,
|
||||
ordinary_qa_format_section=ordinary_qa_format_section,
|
||||
ordinary_qa_visualization_section=ordinary_qa_visualization_section,
|
||||
html_artifact_visualization_section=html_artifact_visualization_section,
|
||||
markdown_file_deliverable_section=markdown_file_deliverable_section,
|
||||
)
|
||||
|
||||
prompt = prompt + rag_mode_section + _current_time_context()
|
||||
|
||||
Reference in new issue
Block a user