Community影像github.com

probably-stolen-character-portraits-public

像素風遊戲角色 4× 胸像立繪(1152×844)製作與 SpriteDict 接入:一次生圖、自動摳圖、28–30 色量化、2px 描邊,支援 PPU 400 與 Bilinear 無 mipmap。專為顧客/NPC 形象新增、更換、同人角色及矮小體型設計。

probably-stolen-character-portraits-public 是什麼?

此技能旨在為像素風遊戲(如《深空當鋪》)高效製作高品質角色立繪。它採用強約束的一次性生成策略:每個角色僅允許一次 `image_gen` 呼叫,從 2–3 個候選版本中選定最終稿,之後不再重新生成,以節省成本並保持角色一致性。技能核心支援 4×(1152×844)規格,包含完整的自動化流程:從參考圖上傳、構圖提示詞(胸像中特寫)、摳圖、基於體型表的尺寸調整、28–30 色調色板量化、2px 描邊,到最終的 PNG 輸出與 SpriteDict 接入(PPU 400,Bilinear,無 mipmap)。此外,它還處理特殊情況,如寬髮角色(肩線寬口徑)、矮小體型、同人角色等,並提供詳細的驗收標準與常見錯誤清單,確保輸出符合遊戲引擎(如 ModLoader)要求。此技能主要用於替代或擴展現有角色、新增 NPC,尤其適用於需要嚴格控制風格一致性的像素風專案。

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

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

深空當鋪 人物立繪(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× 與插畫版流程已停用,不要照做。

相關技能