Files
deerflow-code/offline-backend-20260512/backend/skills/public/yahoo-japan-page-generator/SKILL.md
T

7.2 KiB
Raw Blame History

name, description, allowed-tools
name description allowed-tools
yahoo-japan-page-generator 生成或绘制中文 Yahoo! JAPAN 风格日本综合门户的可交付单文件 HTML;仅在用户明确要求制作雅虎日本、Yahoo Japan 网页或点名本技能时使用。先把材料或检索结果整理成读者文案全中文的十模块 JSON,再用内置模板确定性渲染,页面保留右上角模块化 JSON 编辑弹窗。
read_file
write_file
bash
present_files
web_search

雅虎日本中文页面生成器

本技能使用固定模板生成单文件日本综合门户。模型只负责收集材料和编辑 JSON,禁止重新手写页面结构、CSS 或运行时脚本。最终页面自带右上角设置按钮;用户可在弹窗中按模块编辑 JSON,并通过“应用并渲染”即时更新页面。

编辑弹窗还提供“上传图片/视频”:先把光标放进目标报道、帖子、视频或带 visual/media 的内容对象,上传文件会转换为 data: 地址并写入该对象的 media 字段。不设文件大小拦截;较大文件可能超过浏览器本地缓存容量,应同时下载 JSON 留存。

页面中已由 media 数据渲染的图片和视频还带悬浮上传图标:鼠标移入媒体后点击可任选图片或视频并直接替换,文件的实际类型会自动写入新的 media.type,结果同步写回页面 JSON 与浏览器缓存。头像、Logo 和无法映射回 JSON 的装饰图不会显示该入口;不按原媒体类型限制,也不设置文件大小拦截。

默认视觉直接复用模板原有的示例图:不要调用图像生成工具,不要让模型重新生成、拼装或内嵌新的内容型 SVG,也不要为了寻找“标准配图”延长检索。用户没有提供可直接使用的图片/视频且聚焦检索未得到可靠直链时,保留默认 JSON 的 visual 或内置视觉类型;这些是模板自带的静态示例,调用技能时不重新绘制。不要把大段 base64 示例图重复写进 JSON,图不合适时由用户在成品页面悬浮上传替换。

触发边界

  • 用户明确说“生成/画/制作雅虎日本、Yahoo! JAPAN、Yahoo Japan 网页、日本综合门户”或点名 yahoo-japan-page-generator 时使用。
  • 仅讨论雅虎日本、总结日本新闻或普通文本中出现 Yahoo 时不要使用。
  • 这是雅虎日本风格的概念门户,不改用新闻机构模板或通用页面模板,也不得声称是官方网站。

极速工作流(默认)

页面结构已经固定。完成必要检索或材料整理后,模型只写一份小型规格 JSON;未写字段继续使用模板默认数据与示例视觉,脚本在一次进程内合并、校验并渲染。

  1. 用 write_file 创建 /mnt/user-data/outputs/yahoo-japan-page-spec.json。直接写模块对象会递归合并;修改现有数组项优先用 $set:

    {"site":{"pageTitle":"Yahoo! JAPAN · 中文专题"},"$set":{"news.feature.kicker":"今日关注","news.feature.title":"中文头条","news.feature.summary":"中文摘要"}}
    
  2. 只执行一次 python /mnt/skills/public/yahoo-japan-page-generator/scripts/fast_page.py --spec /mnt/user-data/outputs/yahoo-japan-page-spec.json --output-dir /mnt/user-data/outputs。

  3. stdout 为 status: ok 后立即用 present_files 交付完整 JSON 与 HTML,最终只回复一句完成说明。

规格只允许本技能十个模块和 $set;路径必须指向默认 JSON 的已存在字段。品牌 Yahoo! JAPAN 可保留,其余读者可见内容必须是简体中文。未提供媒体直链时保留模板示例视觉。禁止读取默认数据、契约、模板、运行时或脚本源码,禁止 --help、独立 init/validate/render、生成后打补丁、临时脚本和冗长过程说明。规格报错时只修正一次并重跑。只有用户明确要求改变模块结构或批量重建完整数组时,才使用下面的完整工作流。

完整工作流(仅限结构改造)

  1. 读取当前会话材料、上传附件和已有产物,确定品牌、搜索、服务、新闻、账户、天气、交通与市场、购物、体育热榜和页脚内容。

  2. 用户要求当前新闻、实时天气、真实行情或近期事件时,必须先检索可靠来源再填 JSON;用户明确说不要检索时不得联网。日文或英文资料必须先准确翻译成简体中文。没有材料时使用中文中性演示内容,并在页脚明确说明不是官方网站。

  3. 初始化完整 JSON:

    python /mnt/skills/public/yahoo-japan-page-generator/scripts/render_yahoo_japan_page.py init --output /mnt/user-data/outputs/yahoo-japan-page-data.json
    
  4. 只修改 JSON。十个顶层模块必须全部保留:site、search、services、news、account、weather、utilities、shopping、pulse、footer。JSON 键名、id、href、visual、theme 等技术值保持契约格式;品牌 Yahoo! JAPAN 可以保留,其余读者可见文案必须使用简体中文,site.language 固定为 zh-CN。字段不确定时读取 references/data-schema.md。

  5. 校验 JSON:

    python /mnt/skills/public/yahoo-japan-page-generator/scripts/render_yahoo_japan_page.py validate --input /mnt/user-data/outputs/yahoo-japan-page-data.json
    
  6. 确定性渲染:

    python /mnt/skills/public/yahoo-japan-page-generator/scripts/render_yahoo_japan_page.py render --input /mnt/user-data/outputs/yahoo-japan-page-data.json --output /mnt/user-data/outputs/yahoo-japan-page.html
    
  7. 检查 stdout 的 status 为 ok、HTML 存在且占位符已经消失,再用 present_files 同时交付 HTML 与源 JSON。不要在聊天中粘贴完整 HTML。

内容映射

  • 品牌、日期、工具链接、顶部操作、公告和明暗模式文案放入 site。
  • 搜索类型、热门词和搜索反馈放入 search;常用与扩展服务放入 services。
  • 分类新闻、主专题和推荐内容放入 news;登录卡片与演示登录弹窗放入 account。
  • 城市天气与灾害入口放入 weather;路线查询和市场行情放入 utilities。
  • 商品卡片放入 shopping;体育比分和实时热榜放入 pulse;抽屉与页脚放入 footer。
  • visual 继续作为内置后备;具有视觉的对象可增加受校验的 media(image、video、webpage)替换当前视觉。所有文本由模板转义,不得包含 HTML、脚本或直接 iframe。

重要约束

  • 只编辑 JSON,不修改 assets/yahoo-japan-template.html 或 assets/yahoo-japan-runtime.js。
  • 初始化与渲染默认拒绝覆盖已有文件;路径存在时换新文件名,不删除旧产物。
  • 页面结构、样式和脚本完全自包含,不依赖新闻、天气、市场、购物或账户接口,也不依赖 CDN;仅当 JSON 明确提供受校验媒体 URL 时加载图片、视频或网页。
  • 保留搜索优先、红蓝品牌、密集双栏门户、服务入口、分类新闻、天气、交通、行情、购物、体育和热榜交互。
  • 除品牌 Yahoo! JAPAN 外,不得生成日文或英文读者文案;外文来源必须先翻译为自然、准确的简体中文。
  • 浏览器缓存以初始 JSON 指纹隔离;沙箱禁止持久存储时必须继续使用内嵌 JSON 正常渲染。