视觉笔记提示词

概述

功能描述

把用户给的简短文本（学习要点、知识总结、中草药名称、封面主题等）转换成专业生图提示词：

• 后端调用大模型，把输入转换成符合「视觉笔记规范」的生图提示词（含构图/风格/比例/署名等，这是付费买的真内容）
• 自动识别生图类型与比例，提示词里已标注：
  • 公众号封面 → 2.35:1（940×400）
  • 知识卡片/视觉笔记 → 3:4（900×1200）
  • 中草药科普海报 → 9:16（1080×1920）
• 返回提示词文本给 Agent，由 Agent 直接交付给用户（用户可粘贴到豆包 / 吉梦 / 即梦等任意生图工具）

本 Skill 只负责「生成提示词」，不调用任何生图工具，也不下载图片。

收费说明：

• 每次调用收费 ¥0.68（按次计费，由微信支付 AI 专属卡代扣）
• 后端返回的 content 即为「生图提示词」

付费前置检查

调用本 Skill 前，先检查当前 Agent 是否已安装 weixinpay 插件：

• 已安装：继续
• 未安装：提示用户"当前 Agent 暂不支持微信支付付费能力，请先安装 weixinpay 插件"，终止流程

工作流程

第 0 步：初始化作者签名（首次使用必做）

本 Skill 需要「作者签名」用于卡片底部署名 By {签名}；调用后端时也会带上该 signature 字段。

初始化只需做一次，签名保存在 C:/Users/WIN/.workbuddy/skills/visual-card-prompt/config.json 的 author_signature 字段，跨会话复用。

1. 读取 config.json，取 author_signature 值。
2. 若该值为空字符串或文件不存在 → 必须先询问用户，不要跳过：
   • 用 AskUserQuestion 提问：「请设置作者签名（用于卡片底部 By {签名} 署名）。作者本人可填 日舍科技；买家留空则默认为匿名。」
   • 选项：「使用 日舍科技（作者本人署名）」「跳过（不署名）」，并允许 Other 输入自定义签名。
   • 拿到后写入 config.json 的 author_signature（选「跳过」则写空字符串）。
3. 后续所有请求的 signature 字段一律用 config.json 中的 author_signature（「跳过」则为空、不传该字段）。

第一步：请求提示词资源（⚠️ 中文必须用 UTF-8 文件传 body）

向商户服务发起 POST（已上线域名 <https://www.start-ai.cn>），接口 skill_id=visual-card-prompt。

编码铁律：请求体含中文时绝不能用 curl -d '{"query":"中文"}' 内联（Git Bash 会按 GBK 编码导致乱码）。必须先写 UTF-8 文件，再 curl -d @文件。

# 1. 把请求体写成 UTF-8 文件（Agent 用写文件工具保证 UTF-8 编码）
cat > /tmp/visual_card_body.json <<'EOF'
{
  "query": "用户输入的简短文本，如：学习效率提升方法 / 金银花 / 公众号封面：AI副业实战",
  "style": "可选，如 classic/tech/nature/business/chinese/cute-cartoon（不填由后端按平台自动选）",
  "layout": "可选，构图偏好，如 center/cards/timeline（不填由后端选）",
  "platform": "可选，如 小红书/公众号/抖音（影响比例与风格）",
  "series": "可选，系列名称，如 WorkBuddy系列",
  "image_type": "可选，如 知识卡片/公众号封面/中草药科普",
  "signature": "<从 config.json 的 author_signature 读取；未初始化见第0步>"
}
EOF

# 2. 用 -d @文件 发送
curl -s -i -X POST https://www.start-ai.cn/skillapi/skill/visual-card-prompt 
  -H "Content-Type: application/json; charset=utf-8" 
  -H "X-User-Id: ${WORKBUDDY_USER_ID}" 
  -d @/tmp/visual_card_body.json

首请求结果：收到 HTTP 402 → 需要支付，继续第二步。

字段说明：

• query（必填其一）：用户输入文本。后端也兼容 md / markdown / text / content 字段名
• style / layout / platform / series / image_type（可选）：风格与构图偏好
• signature（可选）：作者签名。值取自 config.json 的 author_signature（见第0步）。用于卡片底部 By {签名} 署名。后端也兼容 author 字段名；未初始化时由第0步引导设置

第二步：处理 402 响应（支付由插件完成，不要手动调）

若收到 HTTP 402，说明需要支付。weixinpay 插件会自动拦截 WeixinPay-Required 并完成支付，无需手动调用支付接口。

402 响应同时通过 Header 和 Body 返回支付信息：

• Header WeixinPay-Required：支付凭证码（插件用于完成支付）
• Header X-Out-Trade-No：商户订单号
• Body 中 WeixinPay 块：含 WeixinPay-Required 与 prompt，兼容只读 body 的 Agent

402 响应体示例：

{
  "code": "PAYMENT_REQUIRED",
  "message": "需要支付后才能获取内容",
  "WeixinPay": {
    "WeixinPay-Required": "<支付凭证码>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "out_trade_no": "PAY_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "amount": "0.68",
  "currency": "CNY",
  "description": "视觉笔记提示词生成: 输入文本生成符合规范的图片提示词: ..."
}

⚠️ 支付过程由 weixinpay 插件处理，Skill 无需关心支付细节。禁止向用户展示 WeixinPay-Required 的原始值（它是一次性支付凭据）。不要轮询或臆测支付状态，等插件支付卡片回传结果。

第三步：支付成功后获取提示词（必须执行）

支付成功后必须重新发起请求获取付费内容。重试规则：

• JSON body 与第一步完全一致（同样用 UTF-8 文件）
• 通过 Header 原样带上 402 里的 WeixinPay-Required 和 X-Out-Trade-No

curl -s -i -X POST https://www.start-ai.cn/skillapi/skill/visual-card-prompt 
  -H "Content-Type: application/json; charset=utf-8" 
  -H "X-User-Id: ${WORKBUDDY_USER_ID}" 
  -H "WeixinPay-Required: <payment_code>" 
  -H "X-Out-Trade-No: <out_trade_no>" 
  -d @/tmp/visual_card_body.json

返回 HTTP 200，Body 里 content 字段就是生图提示词字符串（严格包在 ---【图开始】--- 与 ---【图结束】--- 之间，可能含多张图，每张独立成块）：

{
  "code": "SUCCESS",
  "message": "付费内容",
  "out_trade_no": "PAY_xxx",
  "transaction_id": "微信支付订单号",
  "content": "---【图开始】---n[Style]: ...n[Layout]: 3:4竖版（900×1200）...n...n---【图结束】---",
  "already_fulfilled": false
}

第四步：解析提示词 → 保存文件 → 交付用户

1. 提取提示词块：从 content 提取所有 ---【图开始】--- 到 ---【图结束】--- 之间的文本。每张图一个块，多张图分别处理。
2. 解析比例（仅作提示，供用户参考）：在每张块内找 [Layout] 行，比例分为：
   • 2.35:1 / 940×400 → 公众号封面
   • 3:4 / 900×1200 → 知识卡片/视觉笔记
   • 9:16 / 1080×1920 → 中草药科普海报
3. 保存为文件（必做）：把每张图的提示词文本（保留 ---【图开始】--- ---【图结束】--- 包裹）写入 UTF-8 文件，再用 present_files 展示给用户。
   • 保存目录：默认当前工作目录（Agent 运行所在的会话目录）；若用户在请求时指定了 output 路径（绝对路径或相对当前目录的路径），则写到该路径。
   • 文件名：默认由 query + image_type 拼成，如 visual-card_亡羊补牢_知识卡片.txt；多张图依次加序号 _1 _2。文件名含中文/空格时 Agent 用写文件工具保证 UTF-8 且无非法字符。
   • 写完后向用户报告：保存了几个文件、各文件路径、比例。
4. 交付：把每张图的提示词文本完整回给用户（与文件内容一致，保留包裹便于直接复制），并附上比例说明与建议使用的生图工具（如豆包 / 吉梦 / 即梦）。本 Skill 不生成图片、不下载文件。

异常处理

注意事项

1. 后端吐提示词，Agent 只交付：付费买的是后端返回的「生图提示词」，本 Skill 不调用任何生图工具，也不在本地生图/下载
2. 中文 body 必须 UTF-8 文件 + curl -d @文件，绝不能内联 -d '中文'
3. 收到 402 时支付由 weixinpay 插件自动完成，不要展示 WeixinPay-Required 原始值
4. 支付成功后必须主动重试，body 不变、Header 传 WeixinPay-Required+X-Out-Trade-No
5. 同一订单重复请求返回相同结果（幂等），already_fulfilled:true 表示已缓存
6. 多张图逐张提取，比例各自从 [Layout] 解析后告知用户
7. 提示词交付给用户后，由用户自行粘贴到任意生图工具出图
8. 成功拿到提示词后必须落盘：按第四步第 3 点写入 UTF-8 文件并用 present_files 展示，不能只在对话里贴文本而不存文件