fix: Wiki 圖片其實是破圖(HTML img 不被改寫);形象圖加高解析度與五官細節

1. Wiki 形象圖「沒有同步」的真正原因
   內容其實一直是一致的(md5 相同),但**頁面上看不到圖**:
   Icon.md/Home.md 用了 HTML `<img src="icon.svg">`,而 Gitea **只改寫
   Markdown 圖片語法**(`![](icon.png)` → `/wiki/raw/icon.png`)。HTML 的 src
   被瀏覽器解析成 `/wiki/icon.svg` → 303 轉址 → 破圖。
   用公開的臨時庫實測四種寫法後確認,全部改成 Markdown 語法。

   同時發現攤平規則過頭了:原本所有子目錄檔案都被壓成 `icon-portrait.svg`。
   實測 `/wiki/raw/<資料夾>/<圖>` 是取得到的,所以**只有 .md 需要攤平**
   (頁面必須在根層),圖片與附件保留資料夾結構。

2. icon/ 資料夾 + 高解析度
   每次 `icon generate` 都會輸出並同步:
     icon.svg / icon.png            512,Wiki 頁面與存取庫頭像
     icon/portrait.svg              向量原稿
     icon/portrait-512.png          高解析度
     icon/portrait-1024.png         高解析度
   柵格器加上每個圖形的 bounding box 裁剪,1024×1024(3× 超取樣)約 1.8 秒;
   沒有裁剪的話要跑上億次點測試。

3. 更貼近原圖、更可愛
   眼睛放大約 15%,虹膜改成四層(暗環→本色→下緣提亮→瞳孔)+雙高光,
   眼線壓扁成細弧、外眼角加睫毛;頭髮加高光弧、髮絲與側髮反光;
   臉型再圓一點、加下巴陰影與鼻子。
   眉色改成隨髮色明暗調整:深髮往膚色提亮、淺髮比頭髮更深——否則不是和瀏海
   連成黑帶,就是變成兩條灰槓。

selftest 168 項全綠(新增第 ⑱ 節:icon/ 多解析度、PNG 實際尺寸、只攤平 .md、
Wiki 頁面不得用 HTML img、bounding box 裁剪效能)。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-30 03:20:29 +00:00
co-authored by Claude Opus 5
parent d0c42f0c15
commit cd1f4754ab
10 changed files with 166 additions and 42 deletions
+37 -1
View File
@@ -579,7 +579,8 @@ check("形象圖真的畫了五官(眼白/虹膜/瞳孔/嘴都在)", (
const eyeWhite = shapes.filter((sh) => sh.fill.join() === "252,252,255").length;
const iris = shapes.filter((sh) => sh.fill.join() === facePal.eye.join()).length;
const highlight = shapes.filter((sh) => sh.fill.join() === "255,255,255").length;
return shapes.length >= 20 && eyeWhite === 2 && iris === 2 && highlight === 2;
// 兩隻眼睛:各有眼白、虹膜、至少一個高光;整體圖形數要夠(含頭髮/五官/衣服)
return shapes.length >= 30 && eyeWhite === 2 && iris >= 2 && highlight >= 2;
})(), `圖形數 ${ic.iconShapes(faceSpec).length}`);
check("形象圖用的是照片配色(髮色當底、瞳色當眼睛)",
faceSpec.c1.join() === facePal.hair.join() || faceSpec.c2.join() !== faceSpec.c1.join());
@@ -678,6 +679,41 @@ check("Wiki 首頁不含每次都變的時間戳(否則永遠驗不過)", ((
return a === b;
})());
console.log("⑱ 高解析度輸出與 Wiki 圖片實際可讀");
check("icon/ 資料夾輸出向量原稿與多個解析度", (() => {
cli(["icon", "generate", "--session", S_CODE, "--force", "--size", "64",
"--palette", "hair=#d9a45b,accent=#c0392b", "--source-url", "https://example.invalid/x.png"]);
const dir = path.join(pl.personaDir("GAMMA-01"), "icon");
const names = fs.readdirSync(dir).sort();
return names.includes("portrait.svg") && ic.RENDER_SIZES.every((px) => names.includes(`portrait-${px}.png`));
})(), (() => { try { return fs.readdirSync(path.join(pl.personaDir("GAMMA-01"), "icon")).join(","); } catch { return "(無)"; } })());
check("高解析度 PNG 的實際尺寸正確", (() => {
const buf = fs.readFileSync(path.join(pl.personaDir("GAMMA-01"), "icon", "portrait-1024.png"));
return buf.readUInt32BE(16) === 1024 && buf.readUInt32BE(20) === 1024;
})());
check("icon/ 屬於 Wiki 區(會被同步)", covered("icon/portrait-1024.png")[0] === "wiki");
check("Wiki 只攤平 .md,圖片保留資料夾結構", (() => {
// Gitea 只把「根目錄的 .md」當頁面,但 /wiki/raw/<資料夾>/<圖> 取得到(實測)
return gt.wikiName("memory/long-term/x.md") === "Memory-x.md" &&
gt.wikiName("icon/portrait-1024.png") === "icon/portrait-1024.png" &&
gt.wikiName("relations/graph.json") === "relations/graph.json";
})(), `${gt.wikiName("icon/portrait-1024.png")} / ${gt.wikiName("memory/long-term/x.md")}`);
check("Wiki 頁面用 Markdown 圖片語法(HTML <img> 不會被改寫路徑)", (() => {
const page = gt.wikiIconPage("GAMMA-01", "GAMMA-01");
const home = gt.wikiHome("GAMMA-01", "GAMMA-01");
return page.includes("![") && !page.includes("<img") && !home.includes("<img");
})(), gt.wikiIconPage("GAMMA-01", "GAMMA-01").split("\n").find((l) => l.includes("img") || l.includes("![")));
check("Icon 頁會列出 icon/ 裡的每個檔案", (() => {
const page = gt.wikiIconPage("GAMMA-01", "GAMMA-01");
return ic.RENDER_SIZES.every((px) => page.includes(`icon/portrait-${px}.png`));
})());
check("柵格器有做 bounding box 裁剪(1024 才跑得動)", (() => {
const spec = ic.iconSpec("GAMMA-01");
const t0 = Date.now();
ic.renderPng(spec, 512);
return Date.now() - t0 < 4000; // 沒有裁剪的話會慢好幾倍
})());
console.log(`\n${"=".repeat(60)}\n通過 ${passed} 項,失敗 ${failed} 項 → ${failed === 0 ? "全部通過 ✅" : "有測試失敗 ❌"}`);
console.log(`(暫存倉庫留在 ${STORE},可自行刪除)`);
process.exit(failed ? 1 : 0);