feat: 人格編號、Gitea 儲存（檔案區/Wiki 區）與人格圖示 (v0.0.4) #3
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-persona",
|
||||
"version": "0.0.6",
|
||||
"version": "0.0.7",
|
||||
"description": "AI 人格化記憶聊天 plugin：以 OpenClaw 相同的身分描述（IDENTITY/SOUL）建立人格（可用動漫作品＋角色名上網蒐集設定），結合 hook 強制的人格載入鎖與跨人格隔離、六正向+六負向十二情緒、語意分析、短期/長期記憶與固化條件、心智圖、思維導圖與人際關係圖；可用 sub agent 邀請其他人格同場對話（劇場模式只顯示人格對話）。於 Claude Code 以 /jsc-persona: 前綴呼叫。",
|
||||
"skills": "./skills",
|
||||
"author": {
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-persona",
|
||||
"version": "0.0.6",
|
||||
"version": "0.0.7",
|
||||
"description": "AI 人格化記憶聊天 skills：OpenClaw 相同的人格描述 + 十二情緒 + 語意分析 + 短期/長期記憶 + 心智圖 + 人際關係圖。（人格鎖與跨人格隔離的 hook 僅在 Claude Code 生效）",
|
||||
"skills": "./skills"
|
||||
}
|
||||
|
||||
@@ -34,15 +34,18 @@
|
||||
**同步失敗永遠不阻斷對話**；沒設 `GITEA_HOST`／`GITEA_TOKEN` 就純本機運作。
|
||||
11. **人格圖示在資料補齊之後才產生**：SVG 與 PNG 是同一張圖（共用單位座標與點陣字），
|
||||
PNG 由 `scripts/persona-icon.mjs` 自己柵格化＋zlib 編碼，**不得引入任何影像函式庫**。
|
||||
12. **圖示必須是人物形象圖（盡量有臉）**，來源是該人格「最新一次登場」的官方視覺
|
||||
（`/jsc-persona:persona-icon`）：上網找圖 → **用 Read 親眼看過** → 有 Pillow＋OpenCV 就
|
||||
`--photo` 裁臉，否則畫有五官的向量人物；配色一律 `--palette` 搭配 `--source-url`（CLI 強制存證）。
|
||||
**沒看過圖就不准填顏色、也不准亂挑臉**（多角色的圖先 `icon faces` 再挑，挑完打開確認）。
|
||||
12. **圖示必須是重新繪製的人物形象圖（有臉）**：上網找出該人格「最新一次登場」的官方視覺 →
|
||||
`icon headshot` 裁出**大頭照當底稿** → **用 Read 親眼看過** → 讀出髮型／瀏海／眼型／表情／
|
||||
髮飾等特徵 → `icon generate --palette ... --features ...` **重新繪製**。
|
||||
**絕對不要把找到的圖片直接當圖示**（底稿只留在 `.sync/`，不同步、不發佈；
|
||||
產出的 SVG 不得有 `<image>`／base64／外連）。
|
||||
**沒看過圖就不准填顏色或特徵、也不准亂挑臉**（多角色先 `icon faces` 再挑，挑完打開確認）。
|
||||
13. **選用工具缺了要「提示安裝」，不准靜默降級**：`toolReport()` 會列出缺什麼、為什麼要、
|
||||
怎麼裝（venv 免 sudo）。注意 **OpenCV 5 拿掉了 `CascadeClassifier`，必須裝 4.x**。
|
||||
plugin 本體仍然零依賴：沒有這些工具照樣能產生形象圖。
|
||||
14. **Wiki 必須保存形象圖**：`icon.svg` 與 `icon.png` 都在 Wiki 區，另有自動產生的 **Icon** 頁
|
||||
展示兩種格式並列出來源、樣式與裁切框。
|
||||
14. **Wiki 必須保存並同步形象圖**：`icon.svg` 與 `icon.png` 都在 Wiki 區，另有自動產生的
|
||||
**Icon** 頁展示兩種格式與來源。`icon generate` 推完會**回頭驗證**，`sync verify` 可隨時檢查。
|
||||
Wiki 產生的頁面**不得含每次都變的時間戳**，否則驗證永遠不會通過、也會每次多一個 commit。
|
||||
|
||||
## 慣例
|
||||
|
||||
|
||||
@@ -26,8 +26,8 @@ skills 是共通標準，**鎖與隔離的強制執行需要 hook，目前只有
|
||||
| **9. 人格可以匯出匯入** | `export` 把身分／情緒／記憶／心智圖／關係圖打包成單一 JSON bundle（可 `--gzip`、附 sha256），`import` 還原或換名複製；**不帶**載入鎖與 guest 租約，`journal/` 要明確 `--with-journal` 才帶走 |
|
||||
| **10. 人格有編號** | 編號 = **英文名全大寫 + 兩位索引**（同名才遞增）：`ASUNA-01`、`YUI-01`、`ASUNA-02`。編號同時是新人格的本機目錄名與 Gitea 存取庫名稱；中文名先轉羅馬拼音並跟使用者確認拼法 |
|
||||
| **11. 人格存在 Gitea，依更新頻率分區** | 每個人格一個**私有存取庫**（庫名＝編號）。**檔案區**放每輪都在變的活狀態（情緒／短期記憶／心裡話／說過的話／逐字），**Wiki 區**放低頻的身分與長期結構（IDENTITY／SOUL／長期記憶／心智圖／關係圖）當設定百科。本機仍是工作副本，同步失敗不阻斷對話 |
|
||||
| **12. 圖示是人物形象圖，取自最新登場的官方視覺** | `/jsc-persona:persona-icon` 上網找出該人格**最新一次登場**的官方視覺、**親眼看過**，有 Pillow＋OpenCV 就直接**裁出臉**當形象圖；沒工具則畫**有五官的向量人物**（配色同樣取自那張圖），並印出安裝指令。來源網址與裁切框存進 `config.json` 備查 |
|
||||
| **13. Wiki 保存形象圖** | `icon.svg` 與 `icon.png` 一起同步到 Wiki 區，另外自動產生一頁 **Icon** 同時展示兩種格式並列出來源、樣式與裁切框；PNG 同時設為存取庫頭像 |
|
||||
| **12. 圖示是重新繪製的人物形象圖（有臉）** | 上網找出該人格**最新一次登場**的官方視覺 → 裁出**大頭照當底稿** → **親眼看過** → 讀出髮型／瀏海／眼型／表情／髮飾等特徵 → **由本工具依人格資料重新繪製**。**絕不把找到的圖片當圖示**：SVG 裡沒有 `<image>`、沒有 base64、沒有外連，底稿只留在 `.sync/` 不同步。來源網址與重繪依據存進 `config.json` 備查 |
|
||||
| **13. Wiki 必須保存並同步形象圖** | `icon.svg` 與 `icon.png` 都同步到 Wiki 區，另有自動產生的 **Icon** 頁展示兩種格式與來源；`icon generate` 推完會**回頭驗證** Wiki 真的有這兩個檔案且與本機一致，另有 `sync verify` 可隨時檢查（不一致以非零結束）|
|
||||
|
||||
---
|
||||
|
||||
@@ -150,13 +150,23 @@ AI 最容易露餡的三件事：把推理過程講出來、一次講一大段
|
||||
建立人格**並補齊 IDENTITY／SOUL 之後**產生，512×512。**優先是人物形象圖（看得到臉）**，
|
||||
依環境有無工具分三種樣式：
|
||||
|
||||
流程是 **找圖 → 裁大頭照當底稿 → 親眼看過 → 讀出特徵 → 重新繪製**：
|
||||
|
||||
| 步驟 | 指令 | 產出 |
|
||||
| --- | --- | --- |
|
||||
| 1. 找臉 | `icon faces --photo <圖>` | 圖裡所有臉的座標（多角色務必先看） |
|
||||
| 2. 裁底稿 | `icon headshot --photo <圖> --pick N` | `.sync/headshot.png`（**不是圖示、不同步**） |
|
||||
| 3. 看 | Read 打開底稿 + 讀 IDENTITY/SOUL | 髮型、瀏海、眼型、表情、髮飾、領口 |
|
||||
| 4. 重繪 | `icon generate --palette ... --features ...` | `icon.svg` + `icon.png` |
|
||||
|
||||
| 樣式 | 條件 | 長什麼樣 |
|
||||
| --- | --- | --- |
|
||||
| **`photo`** | 有參考圖 **且** 有 Pillow＋OpenCV | 從官方視覺**裁出的臉**（自動臉部偵測），圓角＋瞳色外框 |
|
||||
| **`portrait`** | 有參考圖但缺工具 | **有五官的向量人物**：髮型、瞳色、服裝色都取自那張圖 |
|
||||
| **`portrait`** | 有底稿（給了調色盤）→ 預設 | 依特徵重繪的人物頭像，五官俱全 |
|
||||
| **`badge`** | 完全沒有參考圖 | 雙色漸層 + 編號前兩個字母 |
|
||||
|
||||
缺工具時 CLI **會印出安裝指令**再退回 `portrait`，不會靜默降級：
|
||||
**找到的圖片只能當底稿**：產出的 SVG 沒有 `<image>`、沒有 base64、沒有外連，每個像素都是畫出來的。
|
||||
|
||||
裁底稿需要的工具缺了，CLI **會印出安裝指令**，不會靜默降級：
|
||||
|
||||
```bash
|
||||
python3 -m venv ~/.cache/jsc-persona/venv
|
||||
@@ -187,24 +197,23 @@ curl -sL -o ~/.cache/jsc-persona/lbpcascade_animeface.xml \
|
||||
- PNG 由**自寫的柵格器**畫出（3× 超取樣 + 盒式縮減當反鋸齒），再用 `zlib` 手工組出
|
||||
IHDR／IDAT／IEND 與 CRC32。這台機器沒有 rsvg／inkscape／imagemagick，也沒有影像函式庫，
|
||||
而本專案禁止 npm 依賴——所以就自己畫。
|
||||
- **為什麼沒有 emoji、也不是把照片本身當圖示**：環境裡沒有任何影像解碼器
|
||||
（rsvg／imagemagick／Pillow／ffmpeg 都沒有），JPEG／WebP 讀不進來，無法把原圖轉成 PNG；
|
||||
而且把他人的美術作品原樣放進存取庫是散布、不是引用。**取配色**是有依據又不搬運原圖的做法。
|
||||
emoji 同理無法柵格化，但仍參與雜湊配色。
|
||||
- **為什麼不直接用找到的圖**：那是別人的美術作品。底稿只用來「看」，圖示由本工具重畫。
|
||||
- **為什麼沒有 emoji**：把 emoji 畫進 PNG 需要字型柵格化，環境裡連 emoji 字型都沒有；
|
||||
emoji 仍參與雜湊配色。
|
||||
- 圖示屬於低頻資料 → `icon.svg` 與 `icon.png` 都同步到 **Wiki 區**，並自動產生一頁 **Icon**
|
||||
展示兩種格式與來源；PNG 同時設成 Gitea **存取庫頭像**。
|
||||
|
||||
```bash
|
||||
# 先看參考圖裡有幾張臉（多角色的主視覺務必先看）
|
||||
node scripts/persona.mjs icon faces --session <id> --photo "<圖片網址>"
|
||||
node scripts/persona.mjs icon faces --session <id> --photo "<圖片網址>"
|
||||
node scripts/persona.mjs icon headshot --session <id> --photo "<圖片網址>" --pick 1
|
||||
|
||||
# 裁臉 + 取色（--palette 必須配 --source-url）
|
||||
node scripts/persona.mjs icon generate --session <id> --force \
|
||||
--photo "<圖片網址>" --pick 1 \
|
||||
--palette "hair=#d9a45b,eye=#9e5b3e,accent=#c0392b,secondary=#e77a8e,light=#f2ebe3" \
|
||||
--source-url "<官方視覺的網址>" --source-note "<作品（年份）＋造型描述>"
|
||||
--palette "hair=#d9a45b,eye=#9e5b3e,accent=#c0392b,secondary=#e77a8e,light=#f2ebe3,skin=#f7ddc4" \
|
||||
--features "hairstyle=straight,length=very-long,fringe=parted,eyes=almond,expression=calm,collar=v,ahoge=yes" \
|
||||
--source-url "<底稿那張圖的網址>" --source-note "<作品（年份）＋重繪依據>"
|
||||
|
||||
node scripts/persona.mjs icon show --session <id> # 看樣式、配色、來源與裁切框
|
||||
node scripts/persona.mjs icon show --session <id> # 樣式、配色、特徵、來源
|
||||
node scripts/persona.mjs sync verify --session <id> --area wiki # 確認 Wiki 真的同步了
|
||||
```
|
||||
|
||||
## 人格編號與 Gitea 儲存
|
||||
@@ -369,7 +378,7 @@ node scripts/persona.mjs said check --session <id> --text "<話>" # 這句是
|
||||
node scripts/persona.mjs room script --session <id> --room <room> # 乾淨對話稿（劇場模式用）
|
||||
node scripts/persona.mjs export --session <id> --out lumi.json # 離線搬家（單檔）
|
||||
node scripts/persona.mjs sync status --session <id> # Gitea 同步狀態
|
||||
node scripts/selftest.mjs # 148 項驗證：鎖、隔離、情緒、固化、說話節制、劇場模式、匯出匯入、編號與 Gitea 分區、形象圖與裁臉、hooks
|
||||
node scripts/selftest.mjs # 161 項驗證：鎖、隔離、情緒、固化、說話節制、劇場模式、匯出匯入、編號與 Gitea、形象圖重繪與 Wiki 同步、hooks
|
||||
```
|
||||
|
||||
檔案結構：`scripts/persona-lib.mjs`（核心：鎖／隔離／情緒／記憶）、`scripts/persona.mjs`（CLI）、
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-persona",
|
||||
"version": "0.0.6",
|
||||
"version": "0.0.7",
|
||||
"description": "AI 人格化記憶聊天 plugin：OpenClaw 相同的人格描述 + 十二情緒 + 語意分析 + 短期/長期記憶 + 心智圖 + 人際關係圖。於 Antigravity 以 /jsc-persona: 前綴呼叫。",
|
||||
"skills": "./skills/"
|
||||
}
|
||||
|
||||
@@ -462,7 +462,7 @@ export function wikiHome(slug, code) {
|
||||
.map((k) => `| ${k} | ${ident[k]} |`),
|
||||
`| 長期記憶 | ${longTerm.length} 則 |`,
|
||||
`| 關係人 | ${relations.nodes.length} 位 |`,
|
||||
`| 最後同步 | ${pl.nowIso()} |`,
|
||||
`| 圖示更新 | ${pl.loadConfig(slug).icon?.generated_at || "—"} |`,
|
||||
"",
|
||||
"## 頁面",
|
||||
"",
|
||||
@@ -610,6 +610,56 @@ export async function pullArea(slug, area, { code = null, owner = null, force =
|
||||
return { ok: true, area, code: theCode, changed: incoming, written };
|
||||
}
|
||||
|
||||
/**
|
||||
* 驗證某一區「本機 = 遠端」。
|
||||
* push 回報成功不等於遠端真的有東西（網路中斷、權限、非快轉都可能），
|
||||
* 形象圖這種一定要出現在 Wiki 的檔案更需要一個明確的檢查點。
|
||||
*/
|
||||
export async function verifyArea(slug, area, { code = null, owner = null } = {}) {
|
||||
const problem = giteaProblem();
|
||||
if (problem) return { ok: false, skipped: true, area, reason: problem };
|
||||
const theCode = code || personaCode(slug);
|
||||
if (!theCode) return { ok: false, skipped: true, area, reason: "沒有人格編號" };
|
||||
const theOwner = owner || (await resolveOwner());
|
||||
const { host } = giteaEnv();
|
||||
const dir = ensureClone(slug, area, repoUrl(host, theOwner, theCode, area));
|
||||
if (!git(["fetch", "--quiet", "origin"], dir).ok) {
|
||||
return { ok: false, area, reason: "fetch 失敗（連不上遠端）" };
|
||||
}
|
||||
const branch = git(["rev-parse", "--abbrev-ref", "HEAD"], dir).stdout || "main";
|
||||
const local = git(["rev-parse", "HEAD"], dir).stdout;
|
||||
const remote = git(["rev-parse", `origin/${branch}`], dir).stdout;
|
||||
// 再把工作副本疊上去，看看還有沒有沒推的差異
|
||||
if (area === "wiki") {
|
||||
pl.writeText(path.join(dir, "Home.md"), wikiHome(slug, theCode));
|
||||
pl.writeText(path.join(dir, "Icon.md"), wikiIconPage(slug, theCode));
|
||||
}
|
||||
const files = stageArea(slug, area, dir);
|
||||
const dirty = git(["status", "--porcelain"], dir)
|
||||
.stdout.split("\n").map((l) => l.replace(/^.{2}\s+/, "").trim()).filter(Boolean);
|
||||
git(["checkout", "--", "."], dir);
|
||||
git(["clean", "-qfd"], dir);
|
||||
return {
|
||||
ok: Boolean(local) && local === remote && dirty.length === 0,
|
||||
area,
|
||||
code: theCode,
|
||||
files: files.length,
|
||||
local,
|
||||
remote,
|
||||
pending: dirty,
|
||||
};
|
||||
}
|
||||
|
||||
/** 形象圖（SVG + PNG）是不是真的在 Wiki 上、而且和本機一致。 */
|
||||
export async function verifyIconInWiki(slug, opts = {}) {
|
||||
const res = await verifyArea(slug, "wiki", opts);
|
||||
if (res.skipped || !res.code) return res;
|
||||
const missing = ["icon.svg", "icon.png"].filter((f) => res.pending.includes(f));
|
||||
const dir = syncDir(slug, "wiki");
|
||||
const present = ["icon.svg", "icon.png"].filter((f) => fs.existsSync(path.join(dir, f)));
|
||||
return { ...res, icon_present: present, icon_pending: missing, ok: res.ok && present.length === 2 };
|
||||
}
|
||||
|
||||
/** 建立 Gitea 上的存取庫與 Wiki，並把兩區都推上去。 */
|
||||
export async function initRemote(slug, { code = null, owner = null, private_ = true } = {}) {
|
||||
const problem = giteaProblem();
|
||||
|
||||
+229
-96
@@ -184,7 +184,9 @@ export const paletteToString = (p) =>
|
||||
|
||||
export const STYLES = ["portrait", "badge"];
|
||||
|
||||
export function iconSpec(slug, { code = null, identity = null, palette = null, style = null } = {}) {
|
||||
export function iconSpec(slug, {
|
||||
code = null, identity = null, palette = null, style = null, features = null,
|
||||
} = {}) {
|
||||
const ident = identity || pl.identityFields(slug);
|
||||
const config = pl.loadConfig(slug);
|
||||
const theCode = code || config.code || slug;
|
||||
@@ -244,9 +246,11 @@ export function iconSpec(slug, { code = null, identity = null, palette = null, s
|
||||
dot: dot || ink,
|
||||
ringAlpha,
|
||||
dotAlpha,
|
||||
// 有調色盤（＝看過參考照片）就畫人物形象；沒有的話只能畫徽章
|
||||
style: style || config.icon?.style || (pal ? "portrait" : "badge"),
|
||||
// 有調色盤（＝看過大頭照）就重繪人物形象；沒有的話只能畫徽章
|
||||
// 只認得 STYLES 裡的樣式：config 可能殘留舊版本寫進去的值（例如已移除的 photo）
|
||||
style: [style, config.icon?.style].find((v) => STYLES.includes(v)) || (pal ? "portrait" : "badge"),
|
||||
palette: pal,
|
||||
features: features || parseFeatures(config.icon?.features || null),
|
||||
source: pal ? config.icon?.source || null : null,
|
||||
pattern,
|
||||
seed: h.subarray(0, 8).toString("hex"),
|
||||
@@ -291,6 +295,53 @@ const tint = (c, t) => mix(c, [255, 255, 255], t);
|
||||
const rect = (x, y, w, h, fill, alpha = 1) => ({ type: "rect", x, y, w, h, fill, alpha });
|
||||
const ellipse = (cx, cy, rx, ry, fill, alpha = 1) => ({ type: "ellipse", cx, cy, rx, ry, fill, alpha });
|
||||
const circle = (cx, cy, r, fill, alpha = 1) => ellipse(cx, cy, r, r, fill, alpha);
|
||||
/** 多邊形：畫髮尾、緞帶、V 領、呆毛這些橢圓做不出來的形狀。 */
|
||||
const poly = (points, fill, alpha = 1) => ({ type: "poly", points, fill, alpha });
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 五官與造型的特徵：這些決定「重新繪製」出來的人長什麼樣
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
export const FEATURE_SPEC = {
|
||||
hairstyle: ["straight", "twintails", "ponytail", "bob", "braid"],
|
||||
length: ["short", "medium", "long", "very-long"],
|
||||
fringe: ["blunt", "parted", "swept", "curtain"],
|
||||
eyes: ["round", "almond", "sharp", "droopy"],
|
||||
expression: ["gentle", "bright", "calm", "neutral"],
|
||||
accessory: ["none", "ribbon", "clip", "flower", "hairband"],
|
||||
side: ["left", "right"],
|
||||
collar: ["round", "v", "high", "sailor"],
|
||||
ahoge: ["no", "yes"],
|
||||
};
|
||||
|
||||
export const DEFAULT_FEATURES = {
|
||||
hairstyle: "straight",
|
||||
length: "long",
|
||||
fringe: "parted",
|
||||
eyes: "almond",
|
||||
expression: "gentle",
|
||||
accessory: "none",
|
||||
side: "right",
|
||||
collar: "round",
|
||||
ahoge: "no",
|
||||
};
|
||||
|
||||
/** `hairstyle=twintails,fringe=blunt,...` → 正規化過的特徵物件（不認得的值一律回退預設）。 */
|
||||
export function parseFeatures(raw) {
|
||||
const out = { ...DEFAULT_FEATURES };
|
||||
if (!raw) return out;
|
||||
for (const chunk of String(raw).split(",")) {
|
||||
const idx = chunk.indexOf("=");
|
||||
if (idx < 0) continue;
|
||||
const key = chunk.slice(0, idx).trim().toLowerCase();
|
||||
const value = chunk.slice(idx + 1).trim().toLowerCase();
|
||||
if (FEATURE_SPEC[key] && FEATURE_SPEC[key].includes(value)) out[key] = value;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
export const featuresToString = (f) =>
|
||||
Object.keys(DEFAULT_FEATURES).map((k) => `${k}=${f[k]}`).join(",");
|
||||
|
||||
/**
|
||||
* 人物形象（有臉）。全部用橢圓與矩形拼出來，所以 SVG 與自寫柵格器畫得出一模一樣的結果。
|
||||
@@ -307,42 +358,148 @@ function portraitShapes(spec) {
|
||||
const skinShade = shade(skin, 0.12);
|
||||
const mouth = shade(cloth, 0.25);
|
||||
|
||||
return [
|
||||
// 肩膀與衣服（露出一截，看得出服裝主色）
|
||||
ellipse(0.5, 1.18, 0.47, 0.36, cloth),
|
||||
ellipse(0.5, 1.14, 0.175, 0.22, cloth2), // 領口／胸前配色
|
||||
// 脖子
|
||||
rect(0.442, 0.64, 0.116, 0.14, skinShade),
|
||||
// 後髮（長髮往下鋪到兩側）
|
||||
ellipse(0.5, 0.50, 0.315, 0.395, hairDark),
|
||||
ellipse(0.235, 0.78, 0.080, 0.27, hairDark),
|
||||
ellipse(0.765, 0.78, 0.080, 0.27, hairDark),
|
||||
// 臉
|
||||
ellipse(0.5, 0.505, 0.212, 0.248, skin),
|
||||
// 瀏海：中央一大片 + 兩側鬢髮，蓋住額頭
|
||||
ellipse(0.5, 0.335, 0.238, 0.158, hair),
|
||||
ellipse(0.312, 0.435, 0.072, 0.155, hair),
|
||||
ellipse(0.688, 0.435, 0.072, 0.155, hair),
|
||||
// 眉毛
|
||||
rect(0.362, 0.452, 0.095, 0.015, hairDark),
|
||||
rect(0.543, 0.452, 0.095, 0.015, hairDark),
|
||||
// 眼睛：眼白 → 虹膜 → 瞳孔 → 高光
|
||||
ellipse(0.415, 0.538, 0.060, 0.073, [252, 252, 255]),
|
||||
ellipse(0.585, 0.538, 0.060, 0.073, [252, 252, 255]),
|
||||
ellipse(0.415, 0.543, 0.046, 0.059, eye),
|
||||
ellipse(0.585, 0.543, 0.046, 0.059, eye),
|
||||
ellipse(0.415, 0.549, 0.021, 0.030, shade(eye, 0.7)),
|
||||
ellipse(0.585, 0.549, 0.021, 0.030, shade(eye, 0.7)),
|
||||
circle(0.399, 0.520, 0.015, [255, 255, 255]),
|
||||
circle(0.569, 0.520, 0.015, [255, 255, 255]),
|
||||
// 腮紅與嘴
|
||||
ellipse(0.330, 0.598, 0.048, 0.025, cloth, 0.28),
|
||||
ellipse(0.670, 0.598, 0.048, 0.025, cloth, 0.28),
|
||||
ellipse(0.5, 0.626, 0.026, 0.015, mouth),
|
||||
// 側邊髮飾（用第二配色，讓不同角色更好分辨）
|
||||
ellipse(0.762, 0.345, 0.056, 0.038, cloth2),
|
||||
ellipse(0.800, 0.375, 0.030, 0.052, cloth2),
|
||||
];
|
||||
const f = spec.features || DEFAULT_FEATURES;
|
||||
const out = [];
|
||||
const mirror = f.side === "left" ? -1 : 1;
|
||||
const sideX = (base) => 0.5 + (base - 0.5) * mirror;
|
||||
|
||||
// ── 頭髮長度：側髮鋪到哪裡
|
||||
const bottom = { short: 0.66, medium: 0.78, long: 0.90, "very-long": 1.02 }[f.length] || 0.90;
|
||||
const sideCy = (0.46 + bottom) / 2;
|
||||
const sideRy = (bottom - 0.46) / 2;
|
||||
|
||||
// ── 肩膀與衣服
|
||||
out.push(ellipse(0.5, 1.18, 0.47, 0.36, cloth));
|
||||
if (f.collar === "round") out.push(ellipse(0.5, 1.14, 0.175, 0.22, cloth2));
|
||||
else if (f.collar === "high") out.push(rect(0.30, 0.90, 0.40, 0.10, cloth2));
|
||||
else if (f.collar === "sailor") {
|
||||
out.push(poly([[0.30, 0.92], [0.50, 1.06], [0.70, 0.92], [0.70, 1.10], [0.30, 1.10]], cloth2));
|
||||
} else if (f.collar === "v") {
|
||||
out.push(poly([[0.428, 0.900], [0.572, 0.900], [0.500, 1.030]], skinShade));
|
||||
}
|
||||
// 脖子
|
||||
out.push(rect(0.442, 0.64, 0.116, 0.15, skinShade));
|
||||
|
||||
// ── 後髮
|
||||
out.push(ellipse(0.5, 0.50, 0.315, 0.395, hairDark));
|
||||
if (f.hairstyle === "twintails") {
|
||||
out.push(ellipse(sideX(0.185), sideCy + 0.03, 0.085, sideRy, hairDark));
|
||||
out.push(ellipse(sideX(0.815), sideCy + 0.03, 0.085, sideRy, hairDark));
|
||||
out.push(ellipse(sideX(0.255), 0.415, 0.040, 0.030, cloth2)); // 髮束
|
||||
out.push(ellipse(sideX(0.745), 0.415, 0.040, 0.030, cloth2));
|
||||
} else if (f.hairstyle === "ponytail") {
|
||||
out.push(ellipse(sideX(0.815), sideCy, 0.075, sideRy * 1.05, hairDark));
|
||||
out.push(ellipse(sideX(0.735), 0.40, 0.042, 0.032, cloth2));
|
||||
out.push(ellipse(0.245, 0.62, 0.062, 0.14, hairDark));
|
||||
} else if (f.hairstyle === "bob") {
|
||||
out.push(ellipse(0.215, 0.60, 0.090, 0.175, hairDark));
|
||||
out.push(ellipse(0.785, 0.60, 0.090, 0.175, hairDark));
|
||||
} else if (f.hairstyle === "braid") {
|
||||
out.push(ellipse(0.235, sideCy, 0.072, sideRy, hairDark));
|
||||
out.push(ellipse(0.765, sideCy, 0.072, sideRy, hairDark));
|
||||
for (let i = 0; i < 3; i += 1) {
|
||||
out.push(ellipse(sideX(0.775), 0.60 + i * 0.11, 0.055, 0.048, shade(hair, 0.18)));
|
||||
}
|
||||
} else {
|
||||
out.push(ellipse(0.235, sideCy, 0.078, sideRy, hairDark));
|
||||
out.push(ellipse(0.765, sideCy, 0.078, sideRy, hairDark));
|
||||
}
|
||||
// 呆毛
|
||||
if (f.ahoge === "yes") out.push(poly([[0.482, 0.180], [0.548, 0.070], [0.540, 0.190]], hair));
|
||||
|
||||
// ── 臉
|
||||
out.push(ellipse(0.5, 0.500, 0.226, 0.256, skin));
|
||||
|
||||
// ── 瀏海
|
||||
if (f.fringe === "blunt") {
|
||||
out.push(ellipse(0.5, 0.300, 0.248, 0.150, hair));
|
||||
out.push(rect(0.252, 0.300, 0.496, 0.088, hair));
|
||||
} else if (f.fringe === "swept") {
|
||||
out.push(ellipse(sideX(0.560), 0.320, 0.235, 0.160, hair));
|
||||
out.push(poly([[sideX(0.30), 0.30], [sideX(0.78), 0.30], [sideX(0.30), 0.47]], hair));
|
||||
} else if (f.fringe === "curtain") {
|
||||
out.push(ellipse(0.5, 0.290, 0.235, 0.140, hair));
|
||||
out.push(ellipse(0.360, 0.400, 0.090, 0.155, hair));
|
||||
out.push(ellipse(0.640, 0.400, 0.090, 0.155, hair));
|
||||
} else {
|
||||
out.push(ellipse(0.5, 0.320, 0.244, 0.145, hair));
|
||||
out.push(ellipse(0.318, 0.410, 0.068, 0.140, hair));
|
||||
out.push(ellipse(0.682, 0.410, 0.068, 0.140, hair));
|
||||
}
|
||||
// 鬢髮（貼著臉頰的兩束）
|
||||
out.push(ellipse(0.268, 0.545, 0.038, 0.150, hair));
|
||||
out.push(ellipse(0.732, 0.545, 0.038, 0.150, hair));
|
||||
|
||||
// ── 眉毛（表情會影響傾斜）
|
||||
const browY = f.expression === "bright" ? 0.430 : 0.436;
|
||||
const brow = mix(hairDark, skin, 0.28); // 深髮角色的眉毛要和瀏海分得開
|
||||
const browTilt = { gentle: 0.006, bright: 0.010, calm: 0, neutral: 0 }[f.expression] ?? 0;
|
||||
out.push(poly([[0.372, browY + browTilt], [0.462, browY], [0.462, browY + 0.021],
|
||||
[0.372, browY + browTilt + 0.021]], brow));
|
||||
out.push(poly([[0.538, browY], [0.628, browY + browTilt], [0.628, browY + browTilt + 0.021],
|
||||
[0.538, browY + 0.021]], brow));
|
||||
|
||||
// ── 眼睛
|
||||
const eyeGeo = {
|
||||
round: { rx: 0.058, ry: 0.070 },
|
||||
almond: { rx: 0.063, ry: 0.060 },
|
||||
sharp: { rx: 0.066, ry: 0.049 },
|
||||
droopy: { rx: 0.060, ry: 0.065 },
|
||||
}[f.eyes] || { rx: 0.063, ry: 0.064 };
|
||||
const eyeY = f.eyes === "droopy" ? 0.558 : 0.552;
|
||||
for (const [cx, hl] of [[0.415, 0.399], [0.585, 0.569]]) {
|
||||
out.push(ellipse(cx, eyeY, eyeGeo.rx, eyeGeo.ry, [252, 252, 255]));
|
||||
out.push(ellipse(cx, eyeY + 0.005, eyeGeo.rx * 0.76, eyeGeo.ry * 0.80, eye));
|
||||
out.push(ellipse(cx, eyeY + 0.011, eyeGeo.rx * 0.34, eyeGeo.ry * 0.42, shade(eye, 0.7)));
|
||||
out.push(circle(hl, eyeY - 0.018, 0.015, [255, 255, 255]));
|
||||
// 上眼線：眼型的關鍵
|
||||
out.push(rect(cx - eyeGeo.rx, eyeY - eyeGeo.ry, eyeGeo.rx * 2, 0.014, hairDark));
|
||||
if (f.eyes === "sharp") {
|
||||
out.push(poly([[cx + eyeGeo.rx * 0.6, eyeY - eyeGeo.ry],
|
||||
[cx + eyeGeo.rx * 1.45, eyeY - eyeGeo.ry - 0.022],
|
||||
[cx + eyeGeo.rx * 1.05, eyeY - eyeGeo.ry * 0.35]], hairDark));
|
||||
}
|
||||
}
|
||||
|
||||
// ── 鼻子（很小一點，但少了它嘴巴會被看成鼻子）
|
||||
out.push(ellipse(0.5, 0.638, 0.010, 0.007, shade(skin, 0.22)));
|
||||
|
||||
// ── 腮紅與嘴（表情）
|
||||
if (f.expression !== "calm") {
|
||||
out.push(ellipse(0.318, 0.646, 0.042, 0.019, cloth, f.expression === "bright" ? 0.28 : 0.20));
|
||||
out.push(ellipse(0.682, 0.646, 0.042, 0.019, cloth, f.expression === "bright" ? 0.28 : 0.20));
|
||||
}
|
||||
if (f.expression === "bright") {
|
||||
out.push(ellipse(0.5, 0.690, 0.046, 0.022, mouth));
|
||||
out.push(rect(0.454, 0.676, 0.092, 0.009, shade(mouth, 0.35)));
|
||||
out.push(ellipse(0.5, 0.683, 0.034, 0.008, tint(mouth, 0.6)));
|
||||
} else if (f.expression === "calm" || f.expression === "neutral") {
|
||||
out.push(rect(0.480, 0.686, 0.040, 0.009, mouth));
|
||||
} else {
|
||||
out.push(ellipse(0.5, 0.688, 0.024, 0.013, mouth));
|
||||
}
|
||||
|
||||
// ── 髮飾
|
||||
const ax = sideX(0.775);
|
||||
if (f.accessory === "ribbon") {
|
||||
out.push(poly([[ax, 0.330], [ax + 0.085 * mirror, 0.288], [ax + 0.085 * mirror, 0.376]], cloth2));
|
||||
out.push(poly([[ax, 0.330], [ax - 0.075 * mirror, 0.292], [ax - 0.075 * mirror, 0.372]], cloth2));
|
||||
out.push(circle(ax, 0.332, 0.026, shade(cloth2, 0.18)));
|
||||
} else if (f.accessory === "clip") {
|
||||
out.push(rect(ax - 0.055, 0.318, 0.110, 0.026, cloth2));
|
||||
out.push(rect(ax - 0.055, 0.352, 0.075, 0.022, tint(cloth2, 0.25)));
|
||||
} else if (f.accessory === "flower") {
|
||||
for (let i = 0; i < 5; i += 1) {
|
||||
const a = (i / 5) * Math.PI * 2;
|
||||
out.push(circle(ax + Math.cos(a) * 0.042, 0.335 + Math.sin(a) * 0.042, 0.030, cloth2));
|
||||
}
|
||||
out.push(circle(ax, 0.335, 0.024, tint(cloth2, 0.45)));
|
||||
} else if (f.accessory === "hairband") {
|
||||
out.push(ellipse(0.5, 0.268, 0.246, 0.052, cloth2));
|
||||
out.push(ellipse(0.5, 0.300, 0.238, 0.052, hair));
|
||||
}
|
||||
|
||||
return out;
|
||||
}
|
||||
|
||||
/** 徽章樣式（沒有參考照片時）：點陣紋 + 編號字母。 */
|
||||
@@ -399,12 +556,16 @@ export function renderSvg(spec, size = DEFAULT_SIZE) {
|
||||
" </defs>",
|
||||
` <rect width="${S}" height="${S}" rx="${u(GEO.radius)}" ry="${u(GEO.radius)}" fill="url(#bg)"/>`,
|
||||
` <g clip-path="url(#badge)">`,
|
||||
...iconShapes(spec).map((sh) =>
|
||||
sh.type === "rect"
|
||||
? ` <rect x="${u(sh.x)}" y="${u(sh.y)}" width="${u(sh.w)}" height="${u(sh.h)}"` +
|
||||
` fill="${hex(sh.fill)}"${sh.alpha < 1 ? ` opacity="${sh.alpha}"` : ""}/>`
|
||||
: ` <ellipse cx="${u(sh.cx)}" cy="${u(sh.cy)}" rx="${u(sh.rx)}" ry="${u(sh.ry)}"` +
|
||||
` fill="${hex(sh.fill)}"${sh.alpha < 1 ? ` opacity="${sh.alpha}"` : ""}/>`),
|
||||
...iconShapes(spec).map((sh) => {
|
||||
const paint = ` fill="${hex(sh.fill)}"${sh.alpha < 1 ? ` opacity="${sh.alpha}"` : ""}/>`;
|
||||
if (sh.type === "rect") {
|
||||
return ` <rect x="${u(sh.x)}" y="${u(sh.y)}" width="${u(sh.w)}" height="${u(sh.h)}"${paint}`;
|
||||
}
|
||||
if (sh.type === "poly") {
|
||||
return ` <polygon points="${sh.points.map(([x, y]) => `${u(x)},${u(y)}`).join(" ")}"${paint}`;
|
||||
}
|
||||
return ` <ellipse cx="${u(sh.cx)}" cy="${u(sh.cy)}" rx="${u(sh.rx)}" ry="${u(sh.ry)}"${paint}`;
|
||||
}),
|
||||
" </g>",
|
||||
` <rect x="${u(0.012)}" y="${u(0.012)}" width="${u(0.976)}" height="${u(0.976)}"`,
|
||||
` rx="${u(GEO.radius - 0.012)}" ry="${u(GEO.radius - 0.012)}"`,
|
||||
@@ -468,6 +629,17 @@ export function encodePng(rgba, width, height) {
|
||||
]);
|
||||
}
|
||||
|
||||
/** 點是否在多邊形內（crossing number；與 SVG 的 nonzero 對簡單多邊形結果一致）。 */
|
||||
function pointInPoly(x, y, pts) {
|
||||
let inside = false;
|
||||
for (let i = 0, j = pts.length - 1; i < pts.length; j = i, i += 1) {
|
||||
const [xi, yi] = pts[i];
|
||||
const [xj, yj] = pts[j];
|
||||
if ((yi > y) !== (yj > y) && x < ((xj - xi) * (y - yi)) / (yj - yi) + xi) inside = !inside;
|
||||
}
|
||||
return inside;
|
||||
}
|
||||
|
||||
/** 內縮 inset 之後的圓角矩形內外判定（用來畫出與 SVG 描邊相同的環帶）。 */
|
||||
function insideInset(x, y, inset) {
|
||||
const span = 1 - 2 * inset;
|
||||
@@ -511,6 +683,8 @@ export function renderPng(spec, size = DEFAULT_SIZE, { supersample = 3 } = {}) {
|
||||
let hit;
|
||||
if (sh.type === "rect") {
|
||||
hit = u >= sh.x && u < sh.x + sh.w && v >= sh.y && v < sh.y + sh.h;
|
||||
} else if (sh.type === "poly") {
|
||||
hit = pointInPoly(u, v, sh.points);
|
||||
} else {
|
||||
const dx = (u - sh.cx) / sh.rx;
|
||||
const dy = (v - sh.cy) / sh.ry;
|
||||
@@ -576,28 +750,11 @@ export function renderPng(spec, size = DEFAULT_SIZE, { supersample = 3 } = {}) {
|
||||
* 回傳裡的 `photo` 說明走了哪條路、缺什麼工具。
|
||||
*/
|
||||
export function generateIcon(slug, {
|
||||
size = DEFAULT_SIZE, code = null, palette = null, source = null, style = null,
|
||||
photo = null, pick = null, face = null,
|
||||
size = DEFAULT_SIZE, code = null, palette = null, source = null, style = null, features = null,
|
||||
} = {}) {
|
||||
const spec = iconSpec(slug, { code, palette, style });
|
||||
let svg;
|
||||
let png;
|
||||
let photoResult = null;
|
||||
if (photo) {
|
||||
const tmp = path.join(pl.personaDir(slug), ".sync", "portrait.tmp.png");
|
||||
fs.mkdirSync(path.dirname(tmp), { recursive: true });
|
||||
photoResult = renderPhotoPng(photo, tmp, size, { pick, face });
|
||||
if (photoResult.ok) {
|
||||
png = fs.readFileSync(tmp);
|
||||
svg = photoSvg(spec, png, size);
|
||||
spec.style = "photo";
|
||||
}
|
||||
fs.rmSync(tmp, { force: true });
|
||||
}
|
||||
if (!png) {
|
||||
svg = renderSvg(spec, size);
|
||||
png = renderPng(spec, size);
|
||||
}
|
||||
const spec = iconSpec(slug, { code, palette, style, features });
|
||||
const svg = renderSvg(spec, size);
|
||||
const png = renderPng(spec, size);
|
||||
pl.writeText(iconSvgPath(slug), svg);
|
||||
fs.mkdirSync(path.dirname(iconPngPath(slug)), { recursive: true });
|
||||
fs.writeFileSync(iconPngPath(slug), png);
|
||||
@@ -610,11 +767,8 @@ export function generateIcon(slug, {
|
||||
size,
|
||||
generated_at: pl.nowIso(),
|
||||
palette: spec.palette ? paletteToString(spec.palette) : null,
|
||||
features: featuresToString(spec.features),
|
||||
source: source || spec.source || null,
|
||||
crop: photoResult?.ok
|
||||
? { method: photoResult.info.method, face: photoResult.info.face,
|
||||
box: photoResult.info.box, faces_found: photoResult.info.faces_found }
|
||||
: null,
|
||||
};
|
||||
pl.writeJson(pl.configPath(slug), config);
|
||||
return {
|
||||
@@ -622,7 +776,6 @@ export function generateIcon(slug, {
|
||||
svg: iconSvgPath(slug),
|
||||
png: iconPngPath(slug),
|
||||
size,
|
||||
photo: photoResult,
|
||||
bytes: { svg: Buffer.byteLength(svg, "utf8"), png: png.length },
|
||||
};
|
||||
}
|
||||
@@ -757,8 +910,11 @@ export function listFaces(imagePath) {
|
||||
}
|
||||
}
|
||||
|
||||
/** 用照片裁臉產生 icon.png（成功回傳結果，工具不足回 ok:false 與缺什麼）。 */
|
||||
export function renderPhotoPng(imagePath, outPath, size = DEFAULT_SIZE, { pick = null, face = null } = {}) {
|
||||
/**
|
||||
* 從參考圖裁出**大頭照**。這張是給 AI 看的**參考**，不是圖示本身——
|
||||
* 圖示一律由 renderSvg/renderPng 依人格資料重新繪製。
|
||||
*/
|
||||
export function cropHeadshot(imagePath, outPath, size = DEFAULT_SIZE, { pick = null, face = null } = {}) {
|
||||
const report = toolReport();
|
||||
if (!report.ready) return { ok: false, report };
|
||||
const args = [PORTRAIT_PY, "--input", imagePath, "--output", outPath, "--size", String(size),
|
||||
@@ -780,26 +936,3 @@ export function renderPhotoPng(imagePath, outPath, size = DEFAULT_SIZE, { pick =
|
||||
return { ok: true, report, info };
|
||||
}
|
||||
|
||||
/** 把裁好的 PNG 包成自成一體的 SVG（含圓角與瞳色外框）。 */
|
||||
export function photoSvg(spec, pngBuffer, size = DEFAULT_SIZE) {
|
||||
const S = size;
|
||||
const u = (v) => Math.round(v * S * 1000) / 1000;
|
||||
return [
|
||||
`<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"`,
|
||||
` width="${S}" height="${S}" viewBox="0 0 ${S} ${S}" role="img"`,
|
||||
` aria-label="人格 ${spec.code}${spec.name ? `（${spec.name}）` : ""}的形象圖">`,
|
||||
` <title>${spec.code}${spec.name ? ` ${spec.name}` : ""}</title>`,
|
||||
" <defs>",
|
||||
` <clipPath id="badge"><rect width="${S}" height="${S}" rx="${u(GEO.radius)}" ry="${u(GEO.radius)}"/></clipPath>`,
|
||||
" </defs>",
|
||||
` <g clip-path="url(#badge)">`,
|
||||
` <image x="0" y="0" width="${S}" height="${S}" preserveAspectRatio="xMidYMid slice"`,
|
||||
` href="data:image/png;base64,${pngBuffer.toString("base64")}"/>`,
|
||||
" </g>",
|
||||
` <rect x="${u(0.012)}" y="${u(0.012)}" width="${u(0.976)}" height="${u(0.976)}"`,
|
||||
` rx="${u(GEO.radius - 0.012)}" ry="${u(GEO.radius - 0.012)}"`,
|
||||
` fill="none" stroke="${hex(spec.ring)}" stroke-opacity="${spec.ringAlpha}" stroke-width="${u(0.012)}"/>`,
|
||||
"</svg>",
|
||||
"",
|
||||
].join("\n");
|
||||
}
|
||||
|
||||
+88
-43
@@ -1133,12 +1133,45 @@ commands.icon = async ({ flags, positional }) => {
|
||||
` 字母 ${spec.letters}｜配色 ${spec.palette ? "取自參考照片" : "由編號雜湊"}` +
|
||||
`：${JSON.stringify(spec.c1)} → ${JSON.stringify(spec.c2)}｜seed ${spec.seed}`,
|
||||
...(spec.palette ? [` 調色盤：${ic.paletteToString(spec.palette)}`] : []),
|
||||
...(spec.style === "portrait" ? [` 特徵：${ic.featuresToString(spec.features)}`] : []),
|
||||
...(src.url ? [` 參考來源：${src.url}${src.note ? `（${src.note}）` : ""}${src.date ? `｜${src.date}` : ""}`] : []),
|
||||
` ${ic.iconSvgPath(slug)}`,
|
||||
` ${ic.iconPngPath(slug)}`,
|
||||
]);
|
||||
return;
|
||||
}
|
||||
if (action === "headshot") {
|
||||
// 裁出「參考用大頭照」。這張不是圖示，也不會同步出去——它是給 AI 看的底稿。
|
||||
requireOwner(slug, session);
|
||||
const want = str(flags.photo);
|
||||
if (!want) die("需要 `--photo <圖片路徑或網址>`（該人格最新登場的官方視覺）。");
|
||||
let file;
|
||||
try {
|
||||
file = await ic.fetchPhoto(want, path.join(pl.personaDir(slug), ".sync"));
|
||||
} catch (err) {
|
||||
die(err.message);
|
||||
}
|
||||
const out = path.join(pl.personaDir(slug), ".sync", "headshot.png");
|
||||
const cropped = ic.cropHeadshot(file, out, num(flags.size, 384), {
|
||||
pick: str(flags.pick) || null,
|
||||
face: str(flags.face) || null,
|
||||
});
|
||||
if (!cropped.ok) {
|
||||
emit(cropped, flags.json, [
|
||||
`✖ 裁不出大頭照：${cropped.reason || "工具不足"}`,
|
||||
...ic.installHintLines(cropped.report || ic.toolReport()),
|
||||
]);
|
||||
process.exit(1);
|
||||
}
|
||||
emit({ persona: slug, file: out, ...cropped.info }, flags.json, [
|
||||
`✔ 大頭照已裁出：${out}`,
|
||||
` 偵測方式 ${cropped.info.method}｜原圖 ${cropped.info.source_size.join("×")}｜` +
|
||||
`找到 ${cropped.info.faces_found} 張臉｜裁切框 ${JSON.stringify(cropped.info.box)}`,
|
||||
" ⚠ 這張是**參考底稿**，不是圖示，也不會同步到 Gitea。",
|
||||
" 請用 Read 打開它，確認是本人，再依看到的髮型／眼型／配件下 `icon generate --features ...`。",
|
||||
]);
|
||||
return;
|
||||
}
|
||||
if (action === "faces") {
|
||||
requireMember(slug, session, Boolean(flags["as-guest"]));
|
||||
const want = str(flags.photo);
|
||||
@@ -1164,7 +1197,7 @@ commands.icon = async ({ flags, positional }) => {
|
||||
]);
|
||||
return;
|
||||
}
|
||||
if (action !== "generate") die(`\u672a\u77e5 action\uff1a${action}\uff08\u53ef\u7528 generate/show/faces\uff09`);
|
||||
if (action !== "generate") die(`未知 action：${action}（可用 generate/show/faces/headshot）`);
|
||||
requireOwner(slug, session);
|
||||
if (ic.hasIcon(slug) && !flags.force) {
|
||||
die(`人格 \`${slug}\` 已經有圖示了。改過身分或換了參考照片要重畫請加 --force。`);
|
||||
@@ -1193,40 +1226,22 @@ commands.icon = async ({ flags, positional }) => {
|
||||
: null;
|
||||
const style = str(flags.style) || null;
|
||||
if (style && !ic.STYLES.includes(style)) die(`--style 只能是 ${ic.STYLES.join("/")}。`);
|
||||
// 參考照片：給了就試著裁臉；工具不足會退回向量人物形象並印出安裝指令
|
||||
let photo = null;
|
||||
if (flags.photo || (flags["from-source"] && source?.url)) {
|
||||
const want = str(flags.photo) || source.url;
|
||||
try {
|
||||
photo = await ic.fetchPhoto(want, path.join(pl.personaDir(slug), ".sync"));
|
||||
} catch (err) {
|
||||
die(`${err.message}`);
|
||||
}
|
||||
}
|
||||
const res = ic.generateIcon(slug, {
|
||||
size, palette, source, style, photo,
|
||||
pick: str(flags.pick) || null,
|
||||
face: str(flags.face) || null,
|
||||
});
|
||||
const features = flags.features ? ic.parseFeatures(str(flags.features)) : null;
|
||||
const res = ic.generateIcon(slug, { size, palette, source, style, features });
|
||||
const lines = [
|
||||
`✔ 人格 \`${slug}\` 的圖示已產生（${size}×${size}）。`,
|
||||
` ${res.svg}（${(res.bytes.svg / 1024).toFixed(1)} KB）`,
|
||||
` ${res.png}（${(res.bytes.png / 1024).toFixed(1)} KB）`,
|
||||
res.spec.style === "photo"
|
||||
? ` 形象圖：真實照片裁臉（偵測方式 ${res.photo?.info?.method}，裁切框 ${JSON.stringify(res.photo?.info?.box)}）`
|
||||
: res.spec.style === "portrait"
|
||||
? ` 形象圖：向量人物（有臉）｜配色取自參考照片：${ic.paletteToString(res.spec.palette)}`
|
||||
: ` 徽章：字母 ${res.spec.letters}｜配色由編號 \`${res.spec.code}\`、名字與 emoji 決定`,
|
||||
res.spec.style === "portrait"
|
||||
? ` 形象圖：依人格資料重新繪製的人物頭像（有臉）`
|
||||
: ` 徽章：字母 ${res.spec.letters}｜配色由編號 \`${res.spec.code}\`、名字與 emoji 決定`,
|
||||
...(res.spec.style === "portrait"
|
||||
? [` 配色：${ic.paletteToString(res.spec.palette)}`,
|
||||
` 特徵：${ic.featuresToString(res.spec.features)}`]
|
||||
: []),
|
||||
...(source?.url || res.spec.source?.url
|
||||
? [` 參考來源：${(source || res.spec.source).url}${(source || res.spec.source).note ? `\n ${(source || res.spec.source).note}` : ""}`]
|
||||
: []),
|
||||
// 缺工具就把安裝方式講清楚，而不是默默降級
|
||||
...(photo && res.photo && !res.photo.ok
|
||||
? [
|
||||
...(res.photo.reason ? [` ⚠ 照片裁臉失敗：${res.photo.reason}`] : []),
|
||||
...ic.installHintLines(res.photo.report || ic.toolReport()),
|
||||
]
|
||||
: []),
|
||||
];
|
||||
// 圖示屬於低頻的身分資料 → Wiki 區；順便設成 Gitea 存取庫的頭像
|
||||
if (!flags["no-gitea"] && !gt.giteaProblem() && gt.personaCode(slug)) {
|
||||
@@ -1234,8 +1249,16 @@ commands.icon = async ({ flags, positional }) => {
|
||||
const owner = await gt.resolveOwner();
|
||||
const okAvatar = await gt.setRepoAvatar(owner, gt.personaCode(slug), fs.readFileSync(res.png));
|
||||
if (okAvatar) lines.push(" 📦 已設為 Gitea 存取庫頭像。");
|
||||
const pushed = await gt.pushArea(slug, "wiki", { message: `icon: 產生人格圖示 ${res.spec.letters}` });
|
||||
if (pushed.ok && pushed.changed) lines.push(" ↑ 圖示已同步到 Wiki 區。");
|
||||
const pushed = await gt.pushArea(slug, "wiki", { message: `icon: 重繪人格形象圖 ${res.spec.code}` });
|
||||
if (pushed.ok && pushed.changed) lines.push(" ↑ 形象圖已同步到 Wiki 區。");
|
||||
// 推完一定要回頭確認 Wiki 真的有這兩個檔案，且與本機一致
|
||||
const check = await gt.verifyIconInWiki(slug);
|
||||
lines.push(
|
||||
check.ok
|
||||
? ` ✔ Wiki 已保存形象圖並與本機一致（${check.icon_present.join(" + ")}）`
|
||||
: ` ✖ Wiki 形象圖驗證未通過：${check.reason || `缺少或未同步 ${(check.icon_pending || []).join(", ") || "?"}`}` +
|
||||
" → 跑 `sync push --area wiki` 再 `sync verify --area wiki`。",
|
||||
);
|
||||
} catch (err) {
|
||||
lines.push(` ⚠ 同步到 Gitea 失敗（不影響本機）：${err.message.slice(0, 120)}`);
|
||||
}
|
||||
@@ -1301,6 +1324,27 @@ commands.sync = async ({ flags, positional }) => {
|
||||
: `✖ ${gt.AREAS[r.area].label}：${String(r.reason).slice(0, 160)}`));
|
||||
return;
|
||||
}
|
||||
if (action === "verify") {
|
||||
const out = [];
|
||||
for (const key of areas) {
|
||||
try {
|
||||
out.push(await gt.verifyArea(slug, key));
|
||||
} catch (err) {
|
||||
out.push({ area: key, ok: false, reason: err.message });
|
||||
}
|
||||
}
|
||||
const bad = out.filter((r) => !r.ok && !r.skipped);
|
||||
emit({ persona: slug, results: out, ok: bad.length === 0 }, flags.json, out.map((r) =>
|
||||
r.skipped
|
||||
? ` ${gt.AREAS[r.area].label}：略過（${r.reason}）`
|
||||
: r.ok
|
||||
? `✔ ${gt.AREAS[r.area].label}：本機與 Gitea 一致（${r.files} 個檔案）`
|
||||
: `✖ ${gt.AREAS[r.area].label}：不一致` +
|
||||
(r.pending?.length ? `，還沒推上去的檔案：${r.pending.slice(0, 8).join(", ")}` : "") +
|
||||
(r.reason ? `（${r.reason}）` : "")));
|
||||
if (bad.length) process.exit(1);
|
||||
return;
|
||||
}
|
||||
if (action === "pull") {
|
||||
const out = [];
|
||||
for (const key of areas) {
|
||||
@@ -1324,7 +1368,7 @@ commands.sync = async ({ flags, positional }) => {
|
||||
: `✖ ${gt.AREAS[r.area].label}：${String(r.reason).slice(0, 160)}`));
|
||||
return;
|
||||
}
|
||||
die(`未知 action：${action}（可用 init/push/pull/status）`);
|
||||
die(`未知 action：${action}（可用 init/push/pull/status/verify）`);
|
||||
};
|
||||
|
||||
commands.gc = ({ flags }) => {
|
||||
@@ -1390,22 +1434,23 @@ const HELP = `persona.mjs — jsc-persona 人格 / 記憶 / 情緒 / 關係圖 C
|
||||
（post 會擋下「短時間內近似重複」與超過三句的發言；例外用 --allow-repeat / --force）
|
||||
|
||||
圖示（建立人格並補齊資料後跑）：
|
||||
icon generate|show|faces --session <id> [--size 512 --force --no-gitea]
|
||||
[--palette "hair=#..,eye=#..,accent=#..,secondary=#..,light=#.."]
|
||||
[--source-url <參考照片網址> --source-note <說明> --source-date <YYYY-MM-DD>]
|
||||
[--photo <圖片路徑或網址> | --from-source] [--style portrait|badge]
|
||||
[--pick largest|leftmost|rightmost|<索引> | --face x,y,w,h]
|
||||
faces 會列出參考照片裡偵測到的臉——多角色的圖務必先看過再用 --pick 指定。
|
||||
icon faces|headshot|generate|show --session <id>
|
||||
faces --photo <圖片路徑或網址> 列出圖裡偵測到的臉（多角色務必先看）
|
||||
headshot --photo <...> [--pick <索引>|--face x,y,w,h] [--size 384]
|
||||
裁出**參考用大頭照**到 .sync/headshot.png（不是圖示、不同步）
|
||||
generate [--size 512 --force --no-gitea --style portrait|badge]
|
||||
[--palette "hair=#..,eye=#..,accent=#..,secondary=#..,light=#..,skin=#.."]
|
||||
[--features "hairstyle=..,length=..,fringe=..,eyes=..,expression=..,accessory=..,side=..,collar=..,ahoge=.."]
|
||||
[--source-url <來源網址> --source-note <說明> --source-date <YYYY-MM-DD>]
|
||||
**依人格資料重新繪製**人物頭像；不會把來源圖放進圖示。
|
||||
沒帶 --palette → 徽章樣式（配色由編號／名字／emoji 雜湊）。
|
||||
show 看目前的樣式、配色、特徵與來源
|
||||
產出 icon.svg + icon.png，設為 Gitea 存取庫頭像並同步到 Wiki 區。
|
||||
沒帶 --palette → 徽章樣式，配色由編號／名字／emoji 雜湊而來。
|
||||
帶了 --palette → 向量人物形象（有臉），配色取自「你實際看過的參考照片」
|
||||
（必須同時帶 --source-url 存證）。
|
||||
帶了 --photo → 直接用那張照片裁出臉當形象圖；工具不足時會退回向量人物形象
|
||||
並印出安裝指令（Pillow / OpenCV / 動漫臉模型）。
|
||||
|
||||
編號與 Gitea（存取庫名稱 = 人格編號）：
|
||||
code show|assign|next --session <id> [--romaji <英文名> --code <ASUNA-01> --rename --force --public]
|
||||
sync status|init|push|pull --session <id> [--area files|wiki|all --if-due --force --message --owner]
|
||||
sync status|init|push|pull|verify --session <id> [--area files|wiki|all --if-due --force --message --owner]
|
||||
verify 會確認「本機 = Gitea」，不一致就以非零結束（形象圖必須同步）
|
||||
檔案區＝高頻活狀態（情緒／短期記憶／心裡話／逐字），每輪對話後背景 push
|
||||
Wiki 區＝低頻設定（IDENTITY／SOUL／長期記憶／心智圖／關係圖），固化或改身分時 push
|
||||
環境變數：GITEA_HOST / GITEA_TOKEN（或 PERSONA_GITEA_HOST / _TOKEN / _OWNER），
|
||||
|
||||
@@ -615,6 +615,69 @@ check("Wiki 有專頁保存形象圖，並寫明來源", (() => {
|
||||
check("Wiki 的保留檔不會被同步流程刪掉",
|
||||
["Home.md", "Icon.md"].every((f) => gt.wikiHome && typeof gt.wikiIconPage === "function"));
|
||||
|
||||
console.log("⑰ 依人格資料重繪（不直接使用網路圖）與 Wiki 同步驗證");
|
||||
check("特徵解析：只吃認得的值，其餘回退預設", (() => {
|
||||
const f = ic.parseFeatures("hairstyle=twintails,eyes=round,accessory=flower,bogus=x,expression=???");
|
||||
return f.hairstyle === "twintails" && f.eyes === "round" && f.accessory === "flower" &&
|
||||
f.expression === ic.DEFAULT_FEATURES.expression && !("bogus" in f);
|
||||
})(), JSON.stringify(ic.parseFeatures("hairstyle=twintails,bogus=x")));
|
||||
const basePal = ic.parsePalette("hair=#d9a45b,eye=#9e5b3e,accent=#c0392b");
|
||||
const draw = (feat) => ic.renderPng(ic.iconSpec("GAMMA-01",
|
||||
{ palette: basePal, style: "portrait", features: ic.parseFeatures(feat) }), 32);
|
||||
check("換髮型會畫出不同的圖",
|
||||
Buffer.compare(draw("hairstyle=straight"), draw("hairstyle=twintails")) !== 0);
|
||||
check("換眼型會畫出不同的圖",
|
||||
Buffer.compare(draw("eyes=round"), draw("eyes=sharp")) !== 0);
|
||||
check("換表情會畫出不同的圖",
|
||||
Buffer.compare(draw("expression=calm"), draw("expression=bright")) !== 0);
|
||||
check("加髮飾／呆毛會多出圖形", (() => {
|
||||
const plain = ic.iconShapes(ic.iconSpec("GAMMA-01",
|
||||
{ palette: basePal, style: "portrait", features: ic.parseFeatures("accessory=none,ahoge=no") }));
|
||||
const fancy = ic.iconShapes(ic.iconSpec("GAMMA-01",
|
||||
{ palette: basePal, style: "portrait", features: ic.parseFeatures("accessory=flower,ahoge=yes") }));
|
||||
return fancy.length > plain.length + 3;
|
||||
})());
|
||||
check("多邊形在 SVG 與柵格器都畫得出來（呆毛用的是 polygon）", (() => {
|
||||
const spec = ic.iconSpec("GAMMA-01",
|
||||
{ palette: basePal, style: "portrait", features: ic.parseFeatures("ahoge=yes") });
|
||||
const shapes = ic.iconShapes(spec);
|
||||
const polys = shapes.filter((sh) => sh.type === "poly").length;
|
||||
const svg = ic.renderSvg(spec, 64);
|
||||
return polys > 0 && (svg.match(/<polygon /g) || []).length === polys;
|
||||
})());
|
||||
check("config 裡殘留的舊樣式不會讓形象圖退回徽章", (() => {
|
||||
const cfg = pl.loadConfig("GAMMA-01");
|
||||
cfg.icon = { ...(cfg.icon || {}), style: "photo" }; // 舊版本寫進去、現已移除的樣式
|
||||
pl.writeJson(pl.configPath("GAMMA-01"), cfg);
|
||||
return ic.iconSpec("GAMMA-01").style === "portrait";
|
||||
})(), ic.iconSpec("GAMMA-01").style);
|
||||
check("`icon headshot` 需要 --photo",
|
||||
cli(["icon", "headshot", "--session", S_CODE], { expectOk: false }).status !== 0);
|
||||
check("重繪不會把來源圖塞進圖示（SVG 沒有內嵌影像）", (() => {
|
||||
const svg = fs.readFileSync(ic.iconSvgPath("GAMMA-01"), "utf8");
|
||||
// xmlns 本來就有 http，所以只看「有沒有內嵌影像」
|
||||
return !svg.includes("<image") && !svg.includes("base64") && !/href=/.test(svg);
|
||||
})());
|
||||
check("特徵有寫進 config（重畫才會一致）", (() => {
|
||||
cli(["icon", "generate", "--session", S_CODE, "--force", "--size", "64",
|
||||
"--features", "hairstyle=twintails,accessory=ribbon"]);
|
||||
const feat = pl.loadConfig("GAMMA-01").icon?.features || "";
|
||||
return feat.includes("hairstyle=twintails") && feat.includes("accessory=ribbon");
|
||||
})(), pl.loadConfig("GAMMA-01").icon?.features);
|
||||
check("沒設定 Gitea 時 sync verify 是「略過」不是崩潰", (() => {
|
||||
const res = cli(["sync", "verify", "--session", S_CODE], { expectOk: false });
|
||||
return res.stderr.includes("尚未設定") || res.stdout.includes("略過");
|
||||
})());
|
||||
check("Wiki 形象圖頁同時列出 SVG 與 PNG", (() => {
|
||||
const page = gt.wikiIconPage("GAMMA-01", "GAMMA-01");
|
||||
return page.includes("icon.svg") && page.includes("icon.png") && page.includes("SVG") && page.includes("PNG");
|
||||
})());
|
||||
check("Wiki 首頁不含每次都變的時間戳（否則永遠驗不過）", (() => {
|
||||
const a = gt.wikiHome("GAMMA-01", "GAMMA-01");
|
||||
const b = gt.wikiHome("GAMMA-01", "GAMMA-01");
|
||||
return a === b;
|
||||
})());
|
||||
|
||||
console.log(`\n${"=".repeat(60)}\n通過 ${passed} 項，失敗 ${failed} 項 → ${failed === 0 ? "全部通過 ✅" : "有測試失敗 ❌"}`);
|
||||
console.log(`（暫存倉庫留在 ${STORE}，可自行刪除）`);
|
||||
process.exit(failed ? 1 : 0);
|
||||
|
||||
@@ -1,13 +1,17 @@
|
||||
---
|
||||
name: persona-icon
|
||||
description: 產生或更新人格的形象圖（icon.svg + icon.png，盡量看得到臉）：先上網找出該人格「最新一次登場」的官方視覺（新作動畫主視覺、官方角色圖），親自看過那張圖，接著優先用臉部偵測從圖上裁出臉當頭像；缺少裁圖工具時改畫有五官的向量人物形象並提示如何安裝工具，完全沒有參考圖才退回編號徽章。來源網址與裁切框會存進 config 備查，圖示同時同步到 Gitea Wiki 與存取庫頭像。當使用者說要做人格頭像／形象圖／icon、要依角色最新造型更新圖示、說現在的圖示不像或看不到臉、或剛建立完人格要補圖示時觸發。不適用於：建立人格本身（persona-create／persona-anime，它們會叫用本技能的步驟）、同步到 Gitea（persona-sync）。
|
||||
description: 產生或更新人格的形象圖（icon.svg + icon.png，人物頭像、看得到臉）：先上網找出該人格「最新一次登場」的官方視覺，裁出**大頭照當底稿**，親眼看過之後萃取髮色／瞳色／服裝色與髮型、眼型、表情、配件等特徵，再**由本工具依人格資料重新繪製**——絕不把找到的圖片直接當圖示。來源網址、底稿裁切框與重繪依據都會存進 config 備查，圖示同步到 Gitea Wiki（SVG + PNG）並設為存取庫頭像，且會回頭驗證同步結果。當使用者說要做人格頭像／形象圖／icon、要依角色最新造型更新圖示、說現在的圖示不像或看不到臉、或剛建立完人格要補圖示時觸發。不適用於：建立人格本身（persona-create／persona-anime，它們會叫用本技能的步驟）、同步到 Gitea（persona-sync）。
|
||||
---
|
||||
|
||||
# 🎨 persona-icon — 依最新造型產生人格形象圖（有臉）
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（帶 `--session <PERSONA_SESSION>`）
|
||||
**時機**：**人格建立且 IDENTITY／SOUL 補齊之後**——形象綁在最終身分上。
|
||||
**目標**：圖示要是**人物形象圖，盡量看得到臉**；退而求其次才是抽象徽章。
|
||||
**目標**：圖示要是**人物形象圖，看得到臉**；退而求其次才是抽象徽章。
|
||||
|
||||
> **鐵則：找到的圖片只能當底稿，不能當圖示。**
|
||||
> 網路上的角色圖是別人的美術作品。這裡的做法是「裁出大頭照 → 看清楚 →
|
||||
> **依人格資料重新繪製**」，產出的每一個像素都是本工具畫的。
|
||||
|
||||
---
|
||||
|
||||
@@ -58,27 +62,22 @@ description: 產生或更新人格的形象圖（icon.svg + icon.png，盡量看
|
||||
| `secondary` | 服裝的第二色／配件色 |
|
||||
| `light` | 最亮的部位（白袖、皮膚亮面） |
|
||||
|
||||
### 4. 裁出臉（有工具的話，這是首選）
|
||||
|
||||
**圖示必須是人物形象，盡量看得到臉。** 環境裡如果有 Pillow（＋OpenCV 動漫臉模型），
|
||||
就直接從參考圖裁臉：
|
||||
### 4. 裁出大頭照當底稿
|
||||
|
||||
```bash
|
||||
# 先看看圖裡有幾張臉——多角色的主視覺一定要先看
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon faces --session <PERSONA_SESSION> --photo "<圖片網址或路徑>"
|
||||
|
||||
# 挑一張（索引由左到右；也可以用 largest/leftmost/rightmost，或 --face x,y,w,h 自己框）
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate --session <PERSONA_SESSION> --force \
|
||||
--photo "<圖片網址或路徑>" --pick <索引> \
|
||||
--palette "hair=#..,eye=#..,accent=#..,secondary=#..,light=#.." \
|
||||
--source-url "<那張圖的網址>" --source-note "<作品（年份）＋造型描述>"
|
||||
# 裁出底稿（索引由左到右；也可以用 largest/leftmost/rightmost，或 --face x,y,w,h 自己框）
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon headshot --session <PERSONA_SESSION> --photo "<圖片網址或路徑>" --pick <索引>
|
||||
```
|
||||
|
||||
**多角色的圖務必自己看過再挑**：`icon faces` 只會告訴你座標，哪張臉是本人要由你判斷
|
||||
（把裁出來的圖用 Read 打開確認一次最保險）。挑錯就是別人的臉。
|
||||
底稿寫到 `<人格>/.sync/headshot.png`，**不是圖示、不會同步、不會發佈**。
|
||||
|
||||
工具不齊時 CLI 會**印出安裝指令**並自動退回第 5 步的向量形象——不會靜默失敗。
|
||||
需要的工具：
|
||||
**多角色的圖務必自己看過再挑**：`icon faces` 只給座標，哪張臉是本人要由你判斷。
|
||||
裁完**一定要用 Read 打開確認是本人**——挑錯就是別人的臉。
|
||||
|
||||
工具不齊時 CLI 會**印出安裝指令**——不會靜默失敗。需要的工具：
|
||||
|
||||
| 工具 | 做什麼 | 怎麼裝（免 sudo） |
|
||||
| --- | --- | --- |
|
||||
@@ -89,17 +88,36 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate --session <PERSON
|
||||
> OpenCV **5.x 拿掉了 `CascadeClassifier`**，一定要裝 4.x。
|
||||
> venv 放在 `~/.cache/jsc-persona/venv` 會被自動偵測到；也可以用 `PERSONA_PYTHON` 指定別的。
|
||||
|
||||
### 5. 沒有工具時：向量人物形象（一樣有臉）
|
||||
### 5. 看著底稿，把特徵讀出來
|
||||
|
||||
用 Read 打開 `.sync/headshot.png`，**同時**讀這個人格的 `IDENTITY.md`／`SOUL.md`／canon 記憶。
|
||||
形象要同時對得起「他長什麼樣」與「他是誰」：
|
||||
|
||||
| 特徵 | 可選值 | 從哪裡判斷 |
|
||||
| --- | --- | --- |
|
||||
| `hairstyle` | straight / twintails / ponytail / bob / braid | 底稿的髮型 |
|
||||
| `length` | short / medium / long / very-long | 底稿的髮長 |
|
||||
| `fringe` | blunt / parted / swept / curtain | 底稿的瀏海 |
|
||||
| `eyes` | round / almond / sharp / droopy | 底稿的眼型 |
|
||||
| `expression` | gentle / bright / calm / neutral | **SOUL 的 Vibe** ＋ 底稿的神情 |
|
||||
| `accessory` | none / ribbon / clip / flower / hairband | 底稿或最新造型的髮飾 |
|
||||
| `side` | left / right | 髮飾在哪一側 |
|
||||
| `collar` | round / v / high / sailor | 服裝領口 |
|
||||
| `ahoge` | yes / no | 有沒有呆毛 |
|
||||
|
||||
### 6. 重新繪製
|
||||
|
||||
```bash
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate \
|
||||
--session <PERSONA_SESSION> --force \
|
||||
--palette "hair=#d9a45b,eye=#9e5b3e,accent=#c0392b,secondary=#e77a8e,light=#f2ebe3" \
|
||||
--source-url "<你剛才看的那張圖的網址>" \
|
||||
--source-note "<作品名（年份）＋造型描述：髮色、瞳色、服裝>" \
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate --session <PERSONA_SESSION> --force \
|
||||
--palette "hair=#d9a45b,eye=#9e5b3e,accent=#c0392b,secondary=#e77a8e,light=#f2ebe3,skin=#f7ddc4" \
|
||||
--features "hairstyle=straight,length=very-long,fringe=parted,eyes=almond,expression=calm,accessory=none,collar=v,ahoge=yes" \
|
||||
--source-url "<底稿那張圖的網址>" \
|
||||
--source-note "<作品（年份）＋底稿是誰＋重繪依據：髮型、眼型、神情、服裝>" \
|
||||
--source-date <YYYY-MM-DD>
|
||||
```
|
||||
|
||||
**畫完一定要用 Read 打開產出的 `icon.png` 看一眼**，不像就調特徵重畫（`--force`）。
|
||||
|
||||
- **`--palette` 一定要配 `--source-url`**：配色是從哪張圖來的必須留得下來（CLI 會強制）。
|
||||
- 兩者都會寫進 `state/config.json` 的 `icon` 欄位，之後 `icon show` 查得到。
|
||||
- 產出的 `icon.svg` + `icon.png` 會自動設成 Gitea 存取庫頭像、同步到 Wiki 區，
|
||||
@@ -108,7 +126,7 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate \
|
||||
找不到可靠的參考圖 → **不要硬掰**，直接 `icon generate` 不帶 `--palette`，
|
||||
用編號雜湊出的配色，並告訴使用者「沒找到最新造型的官方圖，先用預設配色」。
|
||||
|
||||
### 6. 回報
|
||||
### 7. 回報
|
||||
|
||||
一句話說明：用了哪部作品哪一年的視覺、取到什麼配色、圖示放哪裡。
|
||||
把來源網址附上，讓使用者可以自己核對。
|
||||
@@ -117,25 +135,34 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate \
|
||||
|
||||
| 樣式 | 什麼時候用 | 長什麼樣 |
|
||||
| --- | --- | --- |
|
||||
| `photo` | 有參考圖 **且**工具齊全（最佳） | 從官方視覺**裁出的臉**，圓角＋瞳色外框 |
|
||||
| `portrait` | 有參考圖但沒工具 | 向量人物形象：髮型、瞳色、服裝色都取自照片，**有五官** |
|
||||
| `portrait` | 有底稿（有調色盤）→ **預設** | 依特徵重繪的人物頭像：髮型、瀏海、眼型、表情、髮飾、領口全部照特徵畫 |
|
||||
| `badge` | 完全沒有參考圖（原創人格） | 雙色漸層徽章 + 編號前兩個字母 |
|
||||
|
||||
- `portrait` 與 `badge` 由 Node 自己柵格化，SVG 與 PNG **共用同一份圖形清單**，兩邊必然一致；
|
||||
PNG 是自寫的柵格器 + zlib 編碼，不依賴任何影像函式庫。
|
||||
- `photo` 的 SVG 會把裁好的 PNG 以 base64 內嵌，一樣自成一體（不外連）。
|
||||
- 兩種樣式都由 Node 自己柵格化，SVG 與 PNG **共用同一份圖形清單**（橢圓／矩形／多邊形），
|
||||
兩邊必然一致；PNG 是自寫的柵格器 + zlib 編碼，不依賴任何影像函式庫。
|
||||
- SVG **不會內嵌任何影像**——沒有 `<image>`、沒有 base64、沒有外連。
|
||||
- `badge` 樣式下若兩個顏色一深一淺（藍黑髮 + 淡粉洋裝），程式會把較亮的一端往較暗的壓，
|
||||
確保字讀得到——顏色仍然是照片來的，只是收斂色階。
|
||||
確保字讀得到。
|
||||
|
||||
## 界線
|
||||
|
||||
裁出來的是**角色臉部的縮圖**，用途是人格身分辨識（頭像）。原始美術作品的權利屬於原作者，
|
||||
存取庫預設私有；不要把它當成可以散布的素材，也不要重製整張原圖。
|
||||
- **找到的圖片只能當底稿**：裁出來的大頭照留在 `.sync/`，不進圖示、不同步、不發佈。
|
||||
圖示的每個像素都是本工具依特徵畫出來的。
|
||||
- 底稿的來源網址會記在 `config.json`，方便日後核對，但不重製原圖。
|
||||
|
||||
## Wiki 必須同步
|
||||
|
||||
`icon generate` 推完 Wiki 會**自動回頭驗證**，確認 `icon.svg` 與 `icon.png` 真的在 Wiki 上
|
||||
而且與本機一致；不一致會直接報錯。也可以手動查：
|
||||
|
||||
```bash
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sync verify --session <PERSONA_SESSION> --area wiki
|
||||
```
|
||||
|
||||
## 邊界
|
||||
|
||||
- 只能對「本 session 已載入的人格」產生圖示。
|
||||
- 已有圖示時要重畫必須加 `--force`。
|
||||
- 不帶 `--palette` 重畫會**沿用 config 裡已存的配色**（不會突然變回雜湊色）。
|
||||
- `.sync/reference.*` 是下載回來的參考圖快取，可以安全刪除。
|
||||
- `.sync/reference.*` 與 `.sync/headshot.png` 是底稿快取，可以安全刪除（不會同步出去）。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
Reference in New Issue
Block a user