Files

85 lines
7.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: yahoo-japan-page-generator
description: 生成或绘制中文 Yahoo! JAPAN 风格日本综合门户的可交付单文件 HTML;仅在用户明确要求制作雅虎日本、Yahoo Japan 网页或点名本技能时使用。先把材料或检索结果整理成读者文案全中文的十模块 JSON,再用内置模板确定性渲染,页面保留右上角模块化 JSON 编辑弹窗。
allowed-tools:
- 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`:
```json
{"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:
```text
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](references/data-schema.md)。
5. 校验 JSON:
```text
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. 确定性渲染:
```text
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 正常渲染。