用途
Alien Journey 用于把用户提供的 URL、文章、文档或笔记，做成一个“太空旅行”风格的互动学习网站。它强调按原文顺序走完全程，每个章节一个页面，配合可视化图表帮助理解。适合把“这篇文章/文档/视频笔记/数据摘要做成互动图文/学习网站/学习旅程”的需求，也适合“用可爱的外星图表给我讲解这份文档”这类请求。不适合：包含大量数值序列的仪表盘（应使用常规图表库）、需要超过 12 步的单张流程图、以及需要严肃语气而活泼风格不合适的法律或正式文档（应先询问用户）。
主要能力
- 按顺序从源材料中提炼 4–7 个章节，每节一个核心想法，含标题、摘要、2–3 条要点、来源定位。
- 9 种图表类型：流程图、时间线、漫画、循环、测验、对比、热点探索、清单、抽认卡，按内容形态选择，至少使用 3 种不同图表，末尾建议用测验或清单供自测。
- 6 种太空背景（星空、深空、星云、黑洞、小行星带、月球基地）与 12 个卡通角色精灵。
- 每页提供固定的“上一页 / 目录 / 下一页”链接，由构建脚本按章节顺序生成，无 JS 也可用；首页为旅程地图，含编号卡片与已访问标记（localStorage）。
- 顶栏有目录、进度点、声音开关；键盘 ← → 翻页，Home 回目录。
- 可选的循环环境音（UFO 嗡鸣与星芒音效），需用户点击开启，不自动播放。
- 文字自动缩放适配固定尺寸容器，避免溢出；页面级文字正常流式换行。
- 支持繁体中文（含粤语口语文风）与英文，站点语言随学习者语言。
使用方式
安装方式为复制文件夹，各环境路径不同（Cursor 项目、Claude Code、Codex、Anti-Gravity、Grok Bot 等），然后在技能文件夹内创建虚拟环境、安装依赖：
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -r requirements-test.txt # 可选浏览器测试
playwright install chromium # 可选浏览器测试
若技能文件夹只读，先复制一份再操作。
流程：读取源材料（URL 抓取、文件读取），记录标题、作者、许可；选 4–7 节；用 new_journey.py 初始化或生成片段，编辑 src/journey.json；用 check 校验（错误须为 0）；用 build_site.py 构建静态站点并打包 zip；用 test.py 在 1280 与 390 宽度下做浏览器检查并产出截图拼版；最后交付 zip、截图、章节与图表类型清单及来源署名。
journey.json 包含站点 id、标题、副标题、语言、来源信息、封面角色、首页背景与 sections 数组；每个 section 含 id、title、summary、points、sourceRef、chartType、background、mascot 与 data。各图表的 data 结构在资料中有详细定义，例如流程图节点类型 start/step/decision/end 及 next/yes/no 字段，时间线事件 when/title/text，测验题目选项与答案索引等。
适用场景
把一篇科普文章、课程笔记、数据摘要做成可自测的分步学习网站；把流程、历史、循环、对比、术语等不同内容形态分别用对应图表呈现；需要展示给桌面与手机读者的轻量静态站点。
限制
- 静态站点，无需服务器，file:// 可打开；字体从 Google Fonts 加载，离线会回退系统字体，精确外观需联网；音效需每个浏览器会话一次用户点击，之后在允许时可跨页续播。
- 流程图超过约 12 个节点或边交叉过多会凌乱，应拆成两节；回边绘制较简单。
- 固定 9 种图表、12 个角色、6 种背景，风格固定为美式卡通太空风；换风格需重新生成精灵图。
- 智能体做的是要点提炼，长文档变 4–7 个亮点而非全文复制；必须保留署名、检查许可后再发布。
- 热点场景为装饰性背景，点位不与绘制物体绑定，标题需写得放之各处皆通。
- 已在 Chromium（Playwright）测试；Firefox/Safari 预计可用但不在测试套件中。
- 新增图表、背景、角色需改相应脚本与注册代码，资料给出了扩展步骤。