CommunityImagegithub.com

深空当铺 人物立绘(4× 单轨 · 公开版)

为像素风游戏角色制作 4× 胸像立绘(1152×844)并接入 SpriteDict:一次生图、抠图、28–30 色量化、2px 描边、PPU 400、Bilinear 无 mipmap。适用于新增/替换顾客或 NPC 形象、同人角色、矮小体型,以及 4× 与 1× 规格换算;生图为强约束(每个角色一次调用,2–3 版里挑一版)。

Qu'est-ce que 深空当铺 人物立绘(4× 单轨 · 公开版) ?

Cette compétence est conçue pour les artistes et développeurs qui travaillent sur un jeu de type pixel art (Deep Space Pawnshop) et qui ont besoin de générer des portraits en buste haute résolution (4×, 1152×844) pour des personnages clients, PNJ ou personnages de fanworks. Elle impose un flux de travail strict et unique : une seule génération d'image par personnage, qui produit 2 à 3 variantes parmi lesquelles l'utilisateur doit choisir la version finale. Le pipeline complet comprend la génération d'image avec un modèle, le détourage (matting), la quantification des couleurs (28–30 couleurs), le contour de 2px, la conversion au format 4× avec PPU 400 et filtrage Bilinear sans mipmap. La compétence soutient les personnages de petite taille, les personnages aux cheveux larges, et fournit des règles précises pour les dimensions, la composition et l'emplacement des sprites. Elle intègre des mécanismes de validation et de journalisation pour garantir qu'aucun personnage ne reçoit de seconde génération, et fournit des outils de script pour la conversion, la mesure et la pré-vérification des palettes. La compétence est utilisée avec des outils d'IA comme Claude Code, Cursor ou Codex, et nécessite que l'utilisateur suive exactement les instructions du workflow-hires.md pour chaque nouveau personnage.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bilngd/probably-stolen-character-portraits-public/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait 深空当铺 人物立绘(4× 单轨 · 公开版) ?

2026-11-19 口径:只做 4×。 1× 只作为辅助信息存在——保留它的数值做换算基准(288×211 ×4)、原版 1× 胸像做画风参考、旧 1× 成品做对照;不再生成新的 1× 图片,也不再做 A/B 双版。

4× 三条硬口径(2026-11-20 起,生图为强约束):

  1. 一次生图,终身有效:每个角色只允许调用 1 次 image_gen,在一次请求里出 2–3 版候选;之后任何理由都不得再调用——包括“构图太宽”“头太大”“再贴一下人设”“补一张 4× 首图”。
  2. 只从首批里挑:定稿只能来自这一次调用返回的图;不合格只能在批次内换一版,或改裁切/转换参数,不得重生成。
  3. 嘴部不限制表情:不写唇线粗细、不写深几档、不写禁止半张嘴/禁止露齿;闭口、微笑、张嘴、大笑都按角色设定需求来。

工具占位名:image_gen 指你所用平台的图像生成工具(一次请求出 2–3 版);upload_reference 指把本地参考图变成模型可读 URL / file id 的上传接口;image CLI 指你的抠图命令。换成实际工具名即可,流程与规格不变。

生图强约束(点生成前逐条打勾)

检查项必须成立
形象已锁定有现成同人形象就先把 2–3 张参考图找齐;不靠“生成时试”
构图句胸像 + 下缘到胸部下方一点 + 头 38–40% + 头顶 8% + 左右 8–10%
长发/披肩写“发丝收拢在肩后、不碰左右边缘”;宽发角色可放宽“不越肩线”,宽度按肩线宽口径判
参考顺序1–3 原版同性别胸像,4–6 原作 / 同人形象(只选 2 张原作时到 5)
体型目标写进 prompt,按 4× 体型表选档
生图次数本角色此前 0 次;已有过一次就直接停,回批次里挑

违规判定:同一角色出现第二次 image_gen 调用,不论理由,都算违规废稿。一次请求只出 2–3 版,多出来的每一版都是成本。

次数登记(跨会话的硬闸):生图前先看 ref/<角色>_gen.log。

  • 文件不存在 → 才允许调用 1 次;生成后立刻写入日期、工具、候选数、选中的文件名。
  • 文件已存在 → 直接停,只允许从日志指向的那批图里挑,不准再调 image_gen。
  • 日志里写清 batches=1;出现 batches>1 视为违规,需在记录里标注废稿。

4× 硬规格(每次核对)

项值依据
画布1152×844288×211 × 4
PPU / pivot400 / (0.5, 0.5)文件名带 4x → 加载器自动 ×4
过滤Bilinear、mipmap 关(由 MOD 代码在 Rebuild 时设置,不在 PNG 里)像素画被缩到 0.686× 时不能糊
alpha只有 0 / 255(硬边)背景 alpha 0
人物高度按体型,4× 表见 workflow-hires.md §8;bottom_gap = 0原版 1× 146×162 只是比例锚点
人物宽度按体型表;宽发角色按“肩线宽”口径,肩线外飘散发丝不计(见 §8 下方说明)总 bbox 另记,另受“不碰边 + ≤1.15×高”约束
水平位置人物中心 ≈ x=576原版 1× 中心 145 → ×4
描边统一 2px #292234thin 1px + add_outline_rings.py 1 补 1 圈
颜色数28–30 色4× 下 18–24 档必断层
存放<MOD>/Textures/Items/<key>4x.png只有 Items 子目录给 pixelArt Sprite

4× 体型表:唯一一份在 references/workflow-hires.md §8,本页不再复制。选档顺序:特别矮小 → 纤细 → 普通 → 高挑 → 丰腴(宽肩);表里的宽度是肩线宽。

宽度口径(2026-11-20 修订):表里的“4× 宽度”指肩线 / 躯干宽,不是含两侧飘散发丝的总 bbox。

  • 宽发女角色(长卷发、双马尾、披肩大波浪、发量明显超出肩线的类型):肩线以外的发丝不计入宽度。只要同时满足下面三条,总 bbox 可以超出表里的宽度区间:
    1. 发丝不碰边:左右各留 ≥8% 画布(1152 宽下每侧 ≥92px),任何发丝不得触到画布左右边缘;
    2. 总宽有上限:figure 总 bbox 宽 ≤ 1.15×人物高(超过就换批次里更窄的一版,或按“极宽发”降 --height);
    3. 不 squeeze:不得为了把发丝压进表里调 --squeeze。
  • 判定用肩线宽落表(普通 480–560 / 纤细 400–480 / 宽肩 560–620 等):在 4× 图上量左右肩头 / 上臂外缘(含袖子、不含肩线外飘散发丝)的水平距离;figure 仍记录总 bbox,ref/<角色>_gen.log 里另记 body_width=<肩线宽>。

构图与景别:image model 胸像模式

  1. 固定景别与裁切边界:生成所有角色图像时,必须严格采用胸像(Bust-up / 胸部以下一点)中特写构图。画面顶部留出适当头顶空间,画面下边缘必须精确裁切在胸部下方、肋骨上沿附近(仅展示头部、颈部、双肩、上臂及胸口以上的服饰细节);严禁拉远至腰部、腹部或全身。

  2. 提示词自动拼接句(写进每一次生图 prompt,开头或结尾都行):

    胸像立绘构图,中特写镜头,画面取景从头顶到胸部下方一点精确裁切,聚焦人物面部神态、肩颈线条与胸口衣领配饰细节,不出现腰部及以下身体部位。

    常规带背景版本就带这一句;套 workflow-hires.md 的模板时不要漏、不要改写。

  3. 肢体动作收敛:为防止模型为了容纳大动作把镜头拉远,禁止写叉腰、插兜、大幅度挥舞手臂或展示下半身的动作;动作只落在肩部与胸口高度以内((动作要符合角色设定))。

唯一流程(8 步)

  1. 参考图:3 张原版同性别胸像(<gender>Upper_4/6/9_full.png)+ 2–3 张原作设定(合计 5–6 张,只选 2 张原作时没有图 6);存 <MOD>/ref/,用 upload_reference 上传拿 URL。
  2. 唯一一次生图(强约束):先查 ref/<角色>_gen.log,不存在才允许调用。image_gen、image model、5–6 张参考(1–3 原版、4–6 原作);模板照抄 workflow-hires.md §1.5②。一次请求出 2–3 版候选,不写任何嘴部/唇线约束。这次调用之后,本角色不得再生成任何图片,并立即写 batches=1 日志。
  3. 选首图(只能在批次内挑):从这次返回的 2–3 版里挑构图、脸、服装最合适的一版;它就是角色基准。不许新开批次、不许换 prompt 再试。
  4. 抠图:image CLI image remove-image-background --scene general(不要用 human)。
  5. 定体型:普通角色按 --height = min(目标高, 宽上限 / aspect) − 1;宽发女角色改按肩线宽口径(外侧发丝不计入宽度),--height 按目标档直接定;见 workflow-hires.md §8 下方。不要用 squeeze 改体型。
  6. 配色板:references/palettes/<角色>_4x.json,28–30 色,头发/衣料/皮肤各 6–7 档,眼睛 2–3 档,描边 1 档。
  7. 转换:convert_character.py --canvas 1152x844 --palette <角色>_4x.json --squeeze 1.0 --outline-mode thin --despeckle 7 → add_outline_rings.py 1。
  8. 验收与落位:alpha [0,255]、28–30 色、edge_bad 0、body_width(肩线宽)落 workflow-hires.md §8 的宽度区间、figure 高度落档、center_x ≈ 576、bottom_gap 0;复制到 Textures/Items/<key>4x.png,需要时同步 dist。接入时按 workflow-integrate.md 的 Rebuild 重建(PPU ×4、FullRect、Bilinear),不要直接注入 mod.Sprites。

最高原则:首图定人物,转换只保真

  • 首图 = 第一次生成那批里选中的一版:脸型、五官比例、发色、服装轮廓都以它为准。后续任何调整都不应该把人物改成“另一个版本”。
  • 不要再为 4× 生第二张首图:第二次生成几乎一定换脸;4× 允许的清晰度来自 1152×844 画布本身,不是来自重生成。
  • 挑版只看三件事:构图(头占比、肩线、下缘裁切)、脸(五官与表情)、服装/配饰轮廓。分辨率不用挑——所有候选都够 4×。
  • 转换阶段只做保真:缩放、色板、alpha 二值化、2px 描边、收边。4× 压缩比约 1/2,损失远小于 1×,但不能改变五官形状和神态。
  • 丢细节先分清哪一类:首图本来就没画(信息不足)→ 换首批里的另一版;首图画了、转换被量化掉(色阶不足)→ 补色板槽、调 --height、换色板,不重新生图。
  • 不要为了“统一画风”重生成:不同角色的脸本来就不一样,只要 4× 规格合规,就让它保持自己的样子。

返工闸门:一律不重生成(2026-11-20 强约束)

每个角色只有一次生图机会,返工=零容忍。量数字只用来决定从批次里挑哪一版,不是重生成的理由。

  1. 先量,再看:跑 scripts/measure_head.py <png>,或和现有 4× 同底并排。现有女性 4× 的画布头占比约 37–44%(DeepSeek 示例 43.2%;口径=发顶→下巴 / 画布 844)。落在 36–45% 画布 / 46–58% 人物 就是店内常态。
  2. 「38–40%」是构图指令,不是验收尺:拿它去卡人物 bbox,会把合格图判成不合格(实测多个角色都在 57%+)。
  3. 三条都不构成重生成理由:画布头占比 >46%、宽度/aspect 超体型表、五官被裁——即使三条同时成立,也只允许“批次内换一版”或“改裁切 / 按宽肩档收”;不得补版、不得重开批次。宽发角色先用肩线宽口径复核(见 workflow-hires.md §8 下方):肩线外发丝超宽不算超表,只有肩线宽也超表/发丝碰边/总宽 >1.15×高才需要收。
  4. 别凭一张的观感返工:曾有角色因为看着“头大”多生了 3 版废稿,最后定稿仍是首批那版;同一天另一个角色又因“肩宽超表”连开 3 批共 8 张,废稿 7 张。
  5. 真收不了就交用户定:首批全部不合规时,把 2–3 版并排+量出的数字交给用户选“用哪一版/换角色”,不自作主张再生成。

表情与高光(4×,表情不限)

  • 不限制表情:闭口微笑、平嘴、撇嘴、张嘴、大笑、露齿都可以按角色写;不要写唇线多少像素粗、深几档、禁止半张嘴、禁止露齿、降采样自检——那套只服务已经停用的 1×。
  • 情绪交给眉眼、唇角方向和整张脸,不要把情绪写成唇部尺寸要求。
  • 高光必须同色系:只取底色同色系亮 1–2 档;皮肤高光只从肤色板取,头发高光只从发色板取,衣服高光只从衣料板取;至少 8px 成簇(4× 尺度),不要跨色系亮斑、白色点或孤立高光。
  • 成品表情读不出时:先回到 references/workflow-hires.md §1.5③(选首图)换一版候选;4× 不做嘴部像素级返工,也不手绘补嘴。

1× 辅助信息(不再产出)

1× 只剩三种用途:

  1. 规格换算:288×211、figure 160、center_x 144 等数值 ×4 就是 4× 的目标。
  2. 参考图:原版 femaleUpper_*_full.png / maleUpper_*_full.png 用来定画风、构图、色板。
  3. 旧成品对照:已有 1× PNG 可以和 4× 并排看世界尺寸,但不作为交付或回退要求。
  • 不要再跑 1× 转换、不要再出 A/B、不要为新角色留 <key>.png。旧文件可以留着,但不属于交付。
  • 1× 旧流程(唇部特化、降采样自检、A/B 双版、嘴部返工)已停用,正常流程不要执行;本包只保留 4× 单版。

示例角色(DeepSeek)

角色识别特征色板
DeepSeek蓝白配色 + 鲸鱼尾元素female_deepseek_4x.json
  • 4× 成品:assets/example_deepseek_4x.png(1152×844)
  • 1× 对照:assets/example_deepseek_1x.png(288×211,仅规格参考)
  • 权利说明:DeepSeek 名称与形象归其所有者,这里只作为流程示例;对外分发或商用前请自行确认授权。

新角色在 references/palettes/ 建 <角色>_4x.json,不必回改本表。

按任务选读(不要全文通读)

这次要做什么读这些
做新角色 / 出 4× 立绘workflow-hires.md §1.5「标准流程」(照抄)
做有原作形象的同人角色workflow-fan-character.md(只取参考图与角色描述写法;1× 唇部段已作废) → workflow-hires.md §1.5 → workflow-integrate.md
做特别矮小 / 幼态成年角色workflow-petite-character.md(体型按 4× ×4) → workflow-hires.md §1.5
已有原版图,只换参考workflow-extract.md
只把现成 PNG 接进游戏workflow-integrate.md
查源码依据 / 池规则 / 性别判定spec.md
选 4× 色板workflow-hires.md §4;文件在 references/palettes/
1× 历史口径(A/B、唇部、降采样)不要读;1× 已停用

常见致命坑

坑现象正确做法
还为 1× 转一版多一轮返工,1× 已停用只交付 4×;1× 只做换算与参考
为 4× 再单独生一张首图第二次生成换脸,前后不是同一个人每个角色只允许 1 次生图,从首批 2–3 版里挑一版
首批不满意就再开一批多烧 5–8 张图,脸还对不上只在批次内换版,或改裁切 / 转换参数;不得重生成
觉得“头太大/太宽”就重生成一批多烧 3 张图积分,定稿还是首批那版只在批次内换一版;36–45% 画布属正常,宽了按宽肩档收
拿 38–40% 去卡人物 bbox多个角色的常态被判死,返工换脸38–40% 是构图指令;bbox 口径 46–58% 正常
4× 写嘴部特化句嘴被画成粗硬弧线、表情僵4× 不限制表情,不写唇线粗细/深几档/禁止半张嘴
4× 做 A/B多一版无用产物4× 只出单版
套物品图标规格16×16 或硬凑 16 的倍数立绘 1152×844,人物按 4× 体型表
背景 alpha=1 / 不透明人物周围一圈实心矩形纯深青 #1A2A33 平涂底 + matting tool general 抠图
参考图带背景生成图四角 alpha=255不重试生图;直接深青底 + matting tool general 抠图,或批次内换一版;不要用颜色键
小个子套普通尺寸24 岁像小学生却做成 640+ 高、560+ 宽按 4× 矮小档 500–580 / 340–420;先读 workflow-petite-character.md
强行拉宽肩 / 拉长身体宽肩壮汉或长颈纸片人按人设定体型;不要用 squeeze 改体型
宽发角色按总 bbox 判超宽把 height 一降再降,或 squeeze 压发丝按肩线宽口径:肩线外发丝不计宽,只查“不碰边 + 总宽 ≤1.15×高”
4× 沿用 18–24 色色阶断层、衣服死白、头发一团按原图实测重配 28–30 色
4× 跳过量化 / 二值化几万色、alpha 几百档,边缘发灰走 convert_character.py --canvas 1152x844,不要用插画脚本
描边补到 4px像贴上去的黑框(实测被否)2px:thin + add_outline_rings.py 1
构图放任模型头占六成、aspect 超标prompt 写死头占比与留白;按 aspect 反推 height,不 squeeze
镜头拉远到腰/腹/全身人物变小、脸缩水、aspect 变宽每次带“胸像立绘构图…不出现腰部及以下”整句;动作不写叉腰/插兜/挥手/下半身
4× 开 mipmap像素被糊成插画Bilinear、mipmap 关
拿 288 成品放大当 4×只是把方块放粗必须从高分辨率首图重转
放 Textures/ 根那里 mipmap 开、pixelArt=false,只会更糊一律放 Textures/Items/

资源

  • scripts/extract_portraits.py — 导原版立绘全帧 + bbox
  • scripts/convert_character.py — 4× 转换(--canvas 1152x844)
  • scripts/add_outline_rings.py — 2px 定稿(thin 1px + 1 圈)
  • scripts/measure_head.py — 头占比粗测(画布 / 人物两种口径;露颈、刘海切断时用 --chin)
  • scripts/measure_body_width.py — 宽发角色肩线宽粗测(逐行 central / span / 外侧发丝;body_width 取肩头那行的 central)
  • scripts/palette_preflight.py — 色板预检(眼白 / 主色槽是否缺失、档位是否够)
  • references/workflow-hires.md — 4× 唯一标准流程:§1.5(8 步、照抄 prompt)、构图、28–30 色、转换、2px 描边、验收、4× 体型表、坑
  • references/workflow-fan-character.md — 同人角色:选参考图、参考图排序、matting tool 抠图、按人设写角色描述(1× 唇部段已作废)
  • references/workflow-petite-character.md — 特别矮小 / 幼态成年角色(体型按 4× ×4)
  • references/workflow-extract.md / workflow-integrate.md
  • references/spec.md — SpriteDict / ModLoader 源码依据
  • references/palettes/ — 4× 用 <角色>_4x.json(28–30 色);包内附一个 DeepSeek 示例
  • 本包不含历史归档;1× 与插画版流程已停用,不要照做。

Skills associés