Tokeny 输入框伙伴制作

交付独立可安装的伙伴皮肤 ZIP 和可查看的动作预览。使用者不需要 Tokeny 源码、特定生图服务商或本技能作者的运行环境。默认制作皮肤文件，不修改应用内置资源。

从用户描述开始

• 参考图可有可无。有图时提取用户想保留的轮廓、配色、表情和配饰；没有图时直接根据文字设计，不要求补图。
• 角色、风格明确就开始。只有缺少会实质影响结果的信息时才询问；次要细节用合理设计补全。
• 默认覆盖待机、左右走动、提醒、成功、出错六个动作。角色不一定有腿，可用触手、轮子、漂浮等符合形体的移动方式。
• 小尺寸优先：主要使用场景是 44 / 58 / 74 px 的输入框伙伴。轮廓、眼睛和动作需要在缩小后仍可辨认。

生成角色动作

使用当前环境可用的图片生成或编辑能力，遵循该工具的使用规范。可用的 imagegen 技能能提供帮助，但不是本技能的必装依赖。不绑定模型、API 地址、密钥管理器或操作系统，不自行寻找用户其他应用的凭据。若当前没有生图能力，说明缺少的能力；仍可先准备提示词和打包流程，不把未生成的图称为成品。

读 image-prompts.md，按角色改写模板：

1. 推荐生成 6 列 × 6 行、共 36 帧的动作图集；六行分别对应六个动作，同一行是一个动作的连续阶段。
2. 有参考图且工具支持图片输入时，将其作为角色参考；不要保留原图的场景或文字。无图直接生图。
3. 优先真正透明的 PNG。若工具不支持透明输出，使用与角色颜色分离的纯色背景，随后去底；棋盘格不是透明通道。
4. 检查实际返回尺寸和内容，不把请求尺寸当作实际尺寸。先看动作数量、形象一致性和是否裁切，再做切帧。

若整张图集的角色或网格不稳定，可按动作分别生成，沿用同一角色参考并整理帧。不要为了凑够 36 帧复制同一静态图冒充行走或表情动画。

透明处理、切帧与打包

格式约束及特殊网格处理见 skin-format.md。随附脚本只需 Python 3.10+ 和 Pillow，不调用任何生成 API；缺依赖时在当前环境安装 Pillow。

以下 <skill-dir> 指本技能实际目录，<work-dir> 指本次产物目录，执行时替换为路径并按当前 shell 引用。路径不依赖运行命令的工作目录。

python "<skill-dir>/scripts/companion_pack.py" prepare --input "<work-dir>/generated.png" --output "<work-dir>/spritesheet.png"
python "<skill-dir>/scripts/companion_pack.py" pack --sheet "<work-dir>/spritesheet.png" --name "角色名称" --output "<work-dir>/my-companion.tokeny.zip"
python "<skill-dir>/scripts/companion_pack.py" validate "<work-dir>/my-companion.tokeny.zip"

• prepare 默认按透明间隔识别 6 × 6 帧，统一缩放至 128 px 单格、脚底 (64,118)，并为庆祝跳跃保留空间。纯色背景需显式添加 --key "#ff00ff" 等实际底色；已有正确透明度的图片不必指定。
• 识别不到六行或六列时先检查图片。只有确认格子均匀且角色没有越界后才用 --layout grid；不要盲目等分不规则输出。裁掉的配饰或肢体需要修图或重生成，缩小图片无法补回。
• 已有规范图集可跳过 prepare。特殊网格使用 pack --manifest "<work-dir>/manifest.json"，文件内容是 pet.json 内的 manifest 对象。
• pack 默认生成完整六种动作及合适帧时长，验证后输出 ZIP、同名 .preview.html 和 .validation.json。预览是自包含离线页面，可切换明暗背景，在实际尺寸和放大尺寸播放动作；提醒等非循环动作停在最后一帧，可重播。
• 现有文件默认不覆盖；确定是本次需要更新的产物后可加 --force。

验证与交付

脚本检查清单、ZIP 路径和大小、图像解码、透明度、引用帧及四边留白；这些检查不证明动作自然或角色相似。查看图集和预览，确认：

• 外形、颜色、配饰在各帧保持一致，左右朝向正确。
• 身体尺度稳定，脚底贴住轨道；漂浮角色保持稳定的视觉基线。
• 帽尖、角、触手和尾巴在跳跃帧仍完整；不残留背景色边或烘焙的棋盘格。
• 动作有可见变化，循环接缝自然，非循环动作最终表情符合状态。

如果能使用目标版本的 Tokeny，可导入并在设置页预览六个动作；有源码时也可在隔离目录调用真实导入器进一步验证。不能访问客户端或源码时，独立格式检查和视觉检查足以完成文件制作，但交付时明确未实测客户端安装，不将脚本检查称为真实应用安装验证。

提供 ZIP 下载链接、动作预览，以及安装路径：设置 → 外观 → 输入框与伙伴 → 管理伙伴皮肤 → 导入皮肤包，直接选择 ZIP，无需解压。说明支持的动作和验证范围；皮肤使用时无需联网或生成 API。包内只放皮肤清单及图像，提示词、预览和制作脚本留在包外。不要把本技能分发 ZIP 当成伙伴皮肤 ZIP。