# Digilifeform AI 大图生成器

触发词

当用户提到以下任一意图时，应优先使用本技能：

• “生成大图”
• “大图生成”
• “海报生成”
• “信息海报”
• “文档转海报”
• “继续修图”
• “AI 修图”
• “改图”
• “修改图片”
• “修改这张图”
• “改这张海报”
• “基于原图修改”
• “换字”
• “替换 logo”
• “保留版式”
• “datu”
• “datu-ai”

技能用途

把文本、文档或已有图片转换为高质量信息海报，并支持继续修图。

当前能力包括：

• 文本生成大图
• 文件上传生成大图
• 深度研究生成：先进行全网深度抓取与分析，再生成大图
• AI 修图 / 继续修图
• 比例支持：16:9、21:9、4:3、1:1、3:4、9:16、9:21、1:3、3:1
• 清晰度支持：4k

调用原则

1. 先确认用户是要“生成大图”还是“修图”。
2. 只确认必要参数：比例、清晰度、magic_wand、deep_research 或 magic_think。
3. 使用本技能提供的 Datu API，不要替换成其他图像工具。
4. 先执行上传前安全检查；敏感信息检查通过后，再保真提交用户资料，不要用摘要替代原文。

意图路由

已有图片修改强制走 AI 修图

当用户提供或指向一张已有图片、海报、生成结果、截图、二维码、logo 或上一轮任务结果，并提出以下任一修改意图时，必须调用 POST /api/edit/create：

• 改这张图、修改图片、修改这张海报、继续修图、继续改图
• 基于原图修改、按原图调整、保持原图结构、保留版式、保留构图
• 换字、改字、替换文字、修改标题、修正文案
• 替换 logo、替换二维码、加 logo、加二维码、去掉某个元素
• 调整颜色、换风格、局部优化、增强清晰度、按标注区域修改

这种情况下不要调用 /api/datu/create，也不要调用 /api/datu/create-from-file 重新生成一张新图。

路由字段：

• 被修改的主图放入 image
• 标注后的主图放入 annotated_image
• 风格图、logo、二维码、产品图等只作为参考时放入 ref_images
• 用户的自然语言修改要求原样放入 prompt
• 如果是继续修改某个历史任务，传入 parent_task_id

只有当用户明确要求“解析这张图/截图里的内容，再生成一张新的大图/海报”时，图片才作为内容素材进入大图生成流程。

强约束

对于大图生成，外层代理必须遵守以下规则：

• magic_wand=true 时，敏感信息检查通过后，不要先做摘要、提炼、压缩、重写或“整理版 Prompt”
• deep_research=true 只能在用户明确选择或确认后启用；深度研究会全网深度抓取并分析，通常需要额外 5-15 分钟，并额外消耗 5 积分
• 如果用户选择深度研究，最终结果不仅要给出图片，还要在任务返回 research_report_download_url 时下载或提供深度研究报告文件
• 对普通业务资料，完成上传前安全检查后，应把用户给的原始信息直接交给大图技能
• 不要把风险控制理解为默认摘要；风险控制是发现敏感或受限内容时先提醒并取得明确授权
• 不要先把文件内容总结成几条要点后，再替代原文件或原文提交
• 如果比例、清晰度、magic_wand 都已明确，就直接创建任务，不要额外输出“整理后的执行方案”让用户确认
• 本技能内部已经负责信息提炼、结构整理和设计化 Prompt 生成，外层代理不要重复处理
• magic_wand=false 时也不要改写用户输入，应直接传递用户给出的原始信息

上传前安全检查

所有文本、文件、图片 URL 或参考图在提交到 https://datu.digilifeform.com 前，都应先做一次轻量敏感信息检查。以下内容如果明显出现，不应跳过确认上传到外部服务，而应先提醒并获得用户明确授权：

• API Key、密码、访问令牌、私钥、Cookie、数据库连接串
• 身份证号、银行卡号、医疗记录、精确住址等高敏个人信息
• 受监管、受合同限制或公司内部禁止外发的数据

说明：

• 这不是要求先把内容摘要后再传
• 对普通业务资料，敏感信息检查通过后仍应按本技能规则直接传用户给出的原始信息
• 对高风险资料，正确做法是“先提示风险，再让用户决定”
• 如果用户不确认，应停止上传，或请用户提供脱敏版本

大图生成

文本生成

接口：

POST /api/datu/create

请求体：

{
  "text": "用户提供的完整信息",
  "aspect_ratio": "16:9",
  "resolution": "4k",
  "magic_wand": true,
  "deep_research": false
}

字段说明：

• text: 必填，最短支持 2 个字符
• aspect_ratio: 16:9 / 21:9 / 4:3 / 1:1 / 3:4 / 9:16 / 9:21 / 1:3 / 3:1
• resolution: 4k
• magic_wand: 默认 true
• deep_research: 默认 false。只能在用户明确选择或确认后设为 true。设为 true 时，Datu 会先进行全网深度抓取与分析，再生成大图；这会额外增加约 5-15 分钟，并额外消耗 5 积分

注意：

• magic_wand=true 不等于外层代理先提炼资料
• 应保留用户给出的原始信息，让 Datu 内部流程自己做信息提炼
• deep_research=true 会强制使用 magic_wand=true
• deep_research=true 只能在用户明确选择或确认后启用
• 规则摘要：deep_research=true 只能在用户明确选择或确认后启用
• 如果用户选择深度研究，任务完成后除图片外，还应检查并返回深度研究报告文件

深度研究请求示例：

{
  "text": "请基于以下完整资料先做全网深度研究，再生成一张行业趋势信息海报：......",
  "aspect_ratio": "16:9",
  "resolution": "4k",
  "magic_wand": true,
  "deep_research": true
}

文件生成

接口：

POST /api/datu/create-from-file

请求格式：multipart/form-data

字段：

• file
• aspect_ratio
• resolution
• magic_wand
• deep_research

支持上传：

• pdf
• doc
• docx
• txt
• md
• markdown
• png
• jpg
• jpeg
• webp
• gif

限制：

• 单文件最大 20MB
• 不要由外层代理先读取后压缩、整理或摘要用户信息再提交
• deep_research=true 时同样提交原始文件，由 Datu 内部解析、研究、整理和生成

AI 修图

接口：

POST /api/edit/create

请求体：

{
  "image": "https://cdn.example.com/original.png",
  "annotated_image": "",
  "ref_images": [],
  "prompt": "把顶部主标题做得更醒目，整体改成深蓝金科技风",
  "magic_think": true,
  "aspect_ratio": "9:16",
  "resolution": "4k",
  "parent_task_id": null
}

字段说明：

• image: 必填，原图 URL
• annotated_image: 可选，标注图 URL
• ref_images: 可选，最多 4 张
• prompt: 必填，最短 2 个字符
• magic_think: 默认 true
• aspect_ratio: 16:9 / 21:9 / 4:3 / 1:1 / 3:4 / 9:16 / 9:21 / 1:3 / 3:1
• resolution: 4k

说明：当前版本已取消新建 8K 任务，不要再传 resolution=8k。

状态查询

大图状态：

GET /api/datu/status/{task_id}

如果用户选择深度研究，状态或任务详情中可能包含：

{
  "image_url": "https://cdn.example.com/datu/final.png",
  "download_url": "/api/tasks/DT1234567890/download",
  "research_report_download_url": "/api/tasks/DT1234567890/research-report-link"
}

遇到 research_report_download_url 时，应再请求：

GET /api/tasks/{task_id}/research-report-link

返回值中的 download_url 是短期有效的 Word .docx 报告下载地址。执行时应下载深度研究报告。最终回复用户时，如果用户选择深度研究，应同时给出图片结果和研究报告文件；报告文件建议命名为 research-report-{task_id}.docx。

修图状态：

GET /api/edit/status/{task_id}

认证方式

本技能需要一个用户自行创建并控制的 Datu API Key。推荐在运行环境中配置：

DATU_API_KEY=your_api_key_here

宿主凭据要求：

• 如果用户已经在飞书、微信、OpenClaw、ClawHub 或其他宿主中提供过 Datu API Key，宿主必须将其保存为 DATU_API_KEY 持久凭据
• 后续调用本技能时，宿主应自动把该持久凭据注入请求环境，并通过 X-API-Key 发送
• 不要反复要求用户重新提供 API Key；只有在持久凭据不存在、被用户删除、已失效或服务端明确返回认证失败时，才向用户说明需要重新配置
• 如果当前会话拿不到 DATU_API_KEY，应优先提示用户检查宿主的凭据/密钥库/技能授权设置，而不是让用户在聊天里反复粘贴 key
• 临时粘贴在聊天中的 key 不应被当作长期方案；宿主应提供安全保存能力，避免把 key 暴露在普通聊天上下文中

所有请求都使用：

X-API-Key: your_api_key_here

基础地址：

https://datu.digilifeform.com

隐私提示：

• 本技能会把文本、文件或图片发送到 https://datu.digilifeform.com 外部服务
• 使用前应确认用户接受该外发行为

关键行为说明

• 大图生成支持 magic_wand 主流程开关，默认开启
• 大图生成支持 deep_research 深度研究开关；开启后结果应包含图片和 Word .docx 深度研究报告文件
• 修图保留 magic_think，与大图主开关分离
• 9:16、9:21、1:3、3:1 已作为正式比例支持
• 系统会统一为最终图像 Prompt 补充 4K 高清质量要求
• 4k 生图 / 改图默认优先走新的高质量链路，失败时自动回退

新版本提醒

• 用户正常使用大图技能后，可以顺手检查 GET /api/skill/version
• 版本检查应低频进行，同一会话或同一用户 24 小时最多检查一次
• 如果发现当前技能版本低于最新版本，只在回复末尾顺手提醒一句，不打断主流程
• 如果版本接口失败，静默跳过，不影响本次任务

推荐提醒文案：

检测到 Datu 大图技能有新版本 vX.Y.Z，建议在 ClawHub 更新后继续使用。

推荐用法

适合开启 magic_wand

• 用户给的是长文、政策、方案、介绍材料
• 需要系统自动梳理信息结构
• 需要更强的版式设计感
• 这类场景尤其不要提前替用户总结，应该把用户给出的原始信息交给系统

适合开启 deep_research

• 用户明确要求“深度研究”“全网研究”“先调研再生成”
• 用户给的是行业分析、政策解读、产品发布、市场洞察、趋势报告等需要补充背景资料的内容
• 用户可以接受额外 5-15 分钟等待时间和额外 5 积分成本
• 开启后，除了图片结果，还要返回深度研究报告文件

适合关闭 magic_wand

• 用户已经写好了完整 Prompt
• 用户明确要求“不要改写，只按我的 Prompt 生成”
• 需要快速验证一个简短创意方向

常见错误

错误 1：用其他图像工具替代

错误：

用户要 Datu 大图，却改用其他生图工具直接生成

正确：

使用 /api/datu/create 或 /api/datu/create-from-file

错误 2：把 magic_think 当成大图生成开关

错误：

大图生成时发送 magic_think

正确：

大图生成用 magic_wand，修图才用 magic_think

错误 3：忽略竖版比例

错误：

把所有非 21:9 的请求都当成 16:9，或忽略用户明确选择的 9:16 / 9:21 / 1:3 / 3:1

正确：

保留用户明确选择的 9:16 / 9:21 / 1:3 / 3:1

错误 4：先替用户做摘要再交给大图技能

错误：

用户给了一整段资料或一个文件，外层代理先整理成几条 bullet，再把这个缩写版发给 Datu

正确：

magic_wand=true 时，先做上传前安全检查；通过后不要压缩整理摘要总结用户信息，而是保真提交给大图技能

错误 5：看到敏感数据仍绕过确认上传

错误：

识别到文档中有密钥、身份证号或受限信息，但未提醒用户确认就提交到外部 API

正确：

先提醒风险并取得明确授权；用户不确认时停止上传或请用户提供脱敏版本

错误 6：深度研究后只给图片不给报告

错误：

用户选择了 deep_research=true，但最终只返回图片链接，忽略 research_report_download_url

正确：

如果用户选择深度研究，任务完成后同时提供图片和 Word `.docx` 深度研究报告文件

错误 7：反复向用户索要 API Key

错误：

用户之前已经提供并成功使用过 Datu API Key，但每次在飞书、微信等宿主里调用技能时仍要求重新提供

正确：

宿主收到用户提供的 key 后，应保存为 `DATU_API_KEY` 持久凭据；后续调用自动注入并通过 `X-API-Key` 发送。只有持久凭据缺失、被删除、失效或认证失败时，才提示用户重新配置。