Paper2Galgame 论文转 Galgame

很多内容躺在 PDF、DOCX 或 PPT 里，读者不会真的翻完。Paper2Galgame 面向“把材料变成可分享故事”的场景：解析文档，选择角色，生成可播放的 galgame 式剧情，并把结果保存到 Paper2Gal 账户。

它解决什么问题

• 长文、论文、课件的信息密度高，但传播性差；换一个角色口吻重写，更容易吸引点开和转发。
• 手动整理角色、生成、轮询、保存会打断工作流。本技能把这些步骤封装成一次可复用的流程。

技能如何工作

核心是 Paper2Gal CLI 的一条链路：

1. 解析输入：PDF/DOCX 默认 local，PPT/PPTX 建议 smart；生成前会确认文件存在。
2. 处理角色：先用 characters:list 选择角色；直接调用 stories/generate 时，需要先 GET /api/v1/characters/{id} 并附带 customCharacter 对象，避免 503。
3. 生成与轮询：推荐使用随附的 oneclick.cjs，它会完成获取角色 → POST /api/v1/stories/generate 拿 jobId → 轮询 → 保存 → 输出 title、frames、saveId、playUrl 和 savesPage。
4. 播放与分享：可播放地址形如 https://paper2gal.com/?save=；要让链接公开，需要在网页应用的“我的保存”里点击分享，因为 CLI token 调用 /api/saves/{id}/share 会返回 401。

适用边界与注意点

• 需要 Node.js 18+，并在 Windows/macOS/Linux 上使用相同的 Node 启动方式；P2G_CLI_PATH 要指向 CLI JavaScript 文件，而不是 npm 的 .cmd shim。
• 首次账户操作前要先 auth:login，浏览器会打开 OAuth 授权页；这是技能触发的等待点。如果页面打不开或报缺少 client_id、redirect_uri，用 auth:login --no-browser 打开 CLI 打印的完整 URL，不要缩短或重组。
• 不要让用户粘贴密码或在聊天里暴露 token；除非用户明确要求临时环境认证，不要使用 --token。
• 失败或超时的任务要用返回的 jobId 继续轮询，不要自动重提，以免消耗配额；遇到 429 要报告限流时间，不要激进重试。
• 创建/更新角色和背景、借用角色、上传背景、导入保存等属于写入操作；删除前必须二次确认。
• 本地角色图片需要 CLI 0.2.1+；上传前检查 --help 是否列出 --avatar-file 等字段。本地文件优先于 URL，更新时提供的 CG 文件会替换完整 CG 列表。
• 只用外部图片时，要先验证 HTTP 状态、MIME、可解码性、尺寸和画面内容，下载为临时文件再上传，不要直接保存未经验证的热链。