小林清親在 1876 到 1881 年畫了一批東京。瓦斯燈、火災、月、雨後的橋——浮世繪最後一代的畫家, 用西洋的明暗畫他每天走過的城市,後人叫它「光線画」。這個專案把那批畫放回它們被畫的地點上。
玩: https://kiyochika-pixel.ferrari828.workers.dev/ (備援:https://simplyboys.github.io/kiyochika-pixel/ ——兩邊都在推送到 main 時自動更新; 從台灣實測 Cloudflare 下載 AI 影片快約 30 倍,見〈部署〉)
收 63 景、走過清親的五年,再加上弟子井上安治接下去畫的 4 幅。每一景看得到畫師畫了什麼、 那地方今天長什麼樣。畫帖收 73 幅,其中 10 幅查不到座標:畫不到地圖上就不放進遊戲, 理由見〈兩條規則〉。
39 秒看完這一作(點圖看完整影片):
上面這幾秒是片中 AI 重繪版那一段。完整版
docs/promo/kiyochika-promo-9x16.mp4(39 秒・5.4MB),
另有貼社群用的 16:9 三格海報 docs/promo/poster.jpg。
🔴 README 裡不要用 <video>:GitHub 會把整個標籤清掉,只留一個空的 <p></p>——
試過 src 指向 raw.githubusercontent 的絕對網址也一樣。它只認自己上傳附件的網址,
而那個上傳端點沒有公開 API。⇒ 會動的預覽只能用 GIF。
1080×1920 直式,給 Threads 這類手機動態用。⛔ 裡面沒有一張示意圖:畫面是跑真的遊戲截的
(手機版面 540×960@2x),原畫出自 assets/plate,動的那一段是 assets/motion 裡真的那一支,
配樂是遊戲裡那首雅樂「衣香」(宮內省樂部・約 1930 年錄音・公有領域)。片中的動態影像是 AI 重繪、非清親原作,
片尾卡把四個出處寫齊——⛔ 不能只放網址。
重做:bash tools/make-promo.sh(Playwright 截圖 + ffmpeg 組裝,中間檔放 research/promo/)。
系列前三作:東海道五十三次(線性旅程)、 名所江戶百景(面狀+四季)、東京二十景(川瀨巴水)。 這一作與江戶百景共用同一套地圖做法——一套真實座標,兩層皮。江戶百景的滑桿兩端是 1858 與 2026, 這裡是 1880 與 2026。
素材 NDL《清親畫帖》三冊 84 枚 → 收錄 73 幅東京光線画(清親 69・弟子井上安治 4)
座標 63/73(OSM 20・Wikidata 8・街區級 34・低信心 1);未定位 10,理由逐條寫在資料裡
地圖 63 個點在 1880/2026 兩層皮上,點一下看畫。地名:明治 15 区 + 水系 54
現在 63/63 有現代区名與町名,面板可直接跳街景
裁切 73/73 從整頁裁到和紙(灰底 → 台紙+襯紙 → 和紙;畫心那一層已廢,見〈裁切〉)
像素 73/73 → 480px・16 色・Bayer 8×8
日期 奧付判讀 14 幅(可用 6)+ 館方斷代 53 幅 ⇒ 55/73 查得到年份
其中 53 幅回填成年份閘門用的 published_year(63 與 82 的奧付日期還沒回填)
光線 41/73 從題名判得出時刻或天候(畫師自己寫在標題上的)
標註 216 個,每幅 2–3 個,機器提案、人工挑選命名
解說 維基百科導言 83 條繁中譯文,對應是人工挑的
動態 程式層 23 幅(雪・雨・燈火)+ AI 重繪版 63 幅(永久標示非原作)
玩法 兩層閘門 + 收景 + 兩個事件(1881 兩国大火・停筆結局)
python3 tools/serve.py # 用了原生 ES modules,file:// 開不起來
open http://localhost:8000
node tools/check-map.mjs # 畫面與玩法驗收(要 playwright 的 chromium)
node tools/check-pub.mjs # 走得完嗎——這個機制唯一的災難是鎖死check-pub 在推送到 main 時也會由 GitHub Actions 自動跑(.github/workflows/check.yml)。
完整的計畫與判斷記錄在 vault:projects/2026-09-kiyochika-pixel/清親東京名所図-像素遊戲-Action-Plan.md
- 兩條規則 — 這個 repo 的地基
- 玩法・兩層閘門 — 遊戲怎麼運作
- 標註・解說・今そこには何があるか — 三層知識
- 會動的浮世繪・AI 重繪版 — 兩種動態
- 配樂・像素化・井上安治
- 資料怎麼重建・兩種年份・出版日期
- 踩過的坑 — 地名比對、原寸檢視、帶我去、版面、裁切、進度分母
- 部署・素材與授權・接下來
斷詞只從題名來,座標只從 OSM/Wikidata 來。 加了題名以外的知識,根據就變成「我的印象」, 無從查證。所以每個座標都指得出是哪個 OSM 元素或哪個 Wikidata QID 給的。
沒有依據就留空。 places.json 的每一筆都要有 source 與 why;寫不出 why 的進 _unresolved,
把理由寫清楚:
12細目表寫「駿賀町」。OSM 只有神田駿河台(不同地方),Wikidata 查無日本橋駿河町。 ⛔ 不套用「駿河町=今の日本橋室町」這個未查證的等式。
66「柳原」=神田柳原(神田川南岸)。⛔ OSM 的柳原一丁目・柳原橋全在足立区, 距神田 6km,用了就是「看起來合理」的錯。
空白是資訊,猜出來的座標不是。目前未定位 10 筆:12、28、31、45、48、51、53、54、65、66。
每一筆 subject 都帶 place.anchor,說明它是怎麼來的:
"anchor": { "how": "osm-cluster×4", "name": "銀座",
"osm": "node/6271990033", "kind": "station", "confidence": "district" }confidence 四級:osm/wikidata = 指到題名說的那個地物本身;district = 只指到那一帶
(駅名或町名);low = 依據有明說的缺口。要拿畫面收斂的是 district 那 34 幅。
你在明治九年(1876)走進東京。地圖上只有那一年與年代未詳的畫。
- 🟡 金點是現在收得到的:金色實心+靜態暈圈+慢速漣漪(起始時間用 id 錯開,免得全圖同時呼吸)。 ⛔ 不只靠動畫——關掉動態效果的人看到的是同一圈暈。點它 → 看畫 → 收入畫帖
- ⚫ 暗點是已經出版、但光線不對:題名寫著「夜」「暁」「雪」的那些得等
- 帶我去(HUD 的「現在可收 N 幅」,或按
G)把地圖滑到下一個金點並亮出它的名字。 連按就是把現在收得到的景巡一遍,⛔ 不是每次都跳回同一個。帶到之後按Enter打開那一幅、 再按一次收入畫帖(G、Enter、Enter)——地圖上的點是 SVG,Tab 走不到,沒有這一鍵只用鍵盤的人到得了卻打不開 - 等一刻(或按
W)推進一刻:曉→晝→夕→夜,天候按日輪轉 - 收滿八景翻一年,1876 → 1882(最後一年是安治的畫)。地圖隨年份一張張長出來
- 收過的畫預設看真跡,按「16 色:看光的骨架」切成像素版,下面附那一幅被壓成 16 色之後 剩下的顏色與平均明度
- 每一景都附「今そこには何があるか」:標高・最寄り駅・250m 內的社寺橋公園・碑。 海運橋那幅畫的是第一國立銀行,今天原地是首都高架橋,39m 外立著「銀行発祥の地」
- 看原寸:全螢幕看 1523–1690px 的和紙掃描,滾輪繞游標縮放、拖曳或方向鍵移動(Shift 走快一點)。 瓦斯燈的玻璃、暖簾上的字、「東京日々新聞」的招牌,都要那個尺度才看得到
- 明治十四年那場兩国大火是一次事件——清親畫了四枚。結局是他停筆
畫卷(HUD 的「畫卷」,或按 E)把收進畫帖的景照畫帖順序連成一卷,由右往左展讀,兩端有軸木。
翻閱四條路都通:← → 一次一幅、Home/End 卷首卷尾、滾輪快轉、拖曳拉卷(手卷本來就是用拉的),
空白鍵自動展卷。⛔ 沒收的留一格白紙不跳過——卷長不隨進度變,才看得出還差哪幾幅。
連幅排開看得到的是那五年的光線在變:1876 的銀座是晴天白日,到 1881 只剩火與夜;格狀清單看不出那件事。
結局:收滿 63 幅之後,把這一局收來的畫攤成色帶,一列一年、一幅四格,顏色取自 palettes.json。
⛔ 不調色、不挑好看的、不重排,所以一列有多長就是那一年有幾幅。年代未詳的另成一列,
1882 那列標明是安治。底下給一顆「打開畫卷,從頭讀一次」。
開場(第一次進來自己跳出來,之後按 HUD 的「開場」重看)放的是這部作品的弧線: 依年份挑六幅淡入淡出——1876 的銀座是晴天白日,1881 只剩火與夜,五年就停筆。⛔ 不是隨機輪播漂亮圖。 介紹文的人物與畫風兩段是〈解說〉那一層的同一份引用(譯自維基百科,標了授權), 其餘是這個 repo 自己數得出來的事實,包含 AI 重繪版那一層的幅數與掛牌方式。
配樂(HUD 的「♪」,或按 M)預設開著,在開場按「入場」那一下開始播放——瀏覽器不准沒有使用者動作
就出聲,所以借的是那一下;明確關過的人就維持關。五首接著放,放完回到第一首。
沈浸模式(HUD 的「沈浸」,或按 F)全螢幕、把周邊收到剩下一點影子,只留地圖與畫;
碰到哪一塊哪一塊就亮回來,點地圖空白處也能整組叫出來(叫出來時的底色跟平常一模一樣)。
⛔ 出處不收——ODbL 要求標示出處,沈浸模式也一樣,只縮小不隱藏。
年代滑桿不跟著收。它不是周邊,它就是這一作的主題(1880 ⇄ 2026)。第一版把它一起壓到 0.18—— 技術上還拉得動,但在花花的地圖上看不見、又只有 16px 高,實際上就是不能用。 ⇒ 留在看得見的濃度、可點範圍加高一倍,碰到就全亮。
跑馬燈在地圖下緣跑作品介紹與每一幅的題名年份(滑過去會停)。⛔ 內容全部來自資料,不寫宣傳詞。
玩法頁(HUD 的「玩法」,或按 ?)給玩家查規則:點的顏色、時間怎麼走、為什麼收不到、
收了之後多什麼、每顆鈕與快捷鍵、進度存在哪(這台裝置的這個瀏覽器——線上版與本機的存檔不共用,
這件事本身就讓人以為「線上少了 AI 重繪版」過一次)。會跟著規則變的東西一律從規則讀(src/guide.js):
地圖上幾幅、幾景翻一年(PER_YEAR)、一天幾刻、天候輪替、哪幾幅有重繪版。
寫死的數字會在下一次改規則時安靜地變成謊話。圖例畫的是真的 .mark 元素、吃地圖本身那套 CSS,
驗收比對兩邊金點的顏色一致。
🟡 不給玩家看「把握/依據/備註/座標」。 那四格是做這份資料的人要的(confidence、OSM 元素 id、
比對過程、小數點後五位),玩家要的是這幅畫講什麼。⛔ 這不是把不確定藏起來:place.anchor 仍在
views.json 裡、仍是公開的,而且不確定本來就畫在地圖上——只定到「那一帶」的 35 個點畫成空心圓。
留下的七列(年・光・現在・最近車站・今日周邊・碑・典藏)每一列都在講那幅畫或那個地方。
🟡 介面文字一律繁中,題名與地名不動。 按鈕、欄名、提示、事件卡是「操作」,翻成繁中;
畫的題名(東京銀座街日報社)、地名(日本橋)、館名(国立国会図書館)是引用,照原樣。
多語系之後補上時,前者進字串表、後者留在資料裡。check-map.mjs 有一項專掃這條:
按鈕與欄名裡不得出現假名。
🔴 「等一刻」不是裝飾,是防鎖死的。 沒有它,光線閘門就是死結——edo-hyakkei 真的卡在 89/118 過,
原因正是時間只能靠收景推進。tools/check-pub.mjs 只用遊戲裡真的存在的兩個動作(收一景、等一刻)
走一遍,證明 63/63 收得完、最長只要等 3 刻。改動任何一個閘門數字之後跑它。
機制是兩層,各有各的資料:
| 層 | 管什麼 | 資料 | 覆蓋 |
|---|---|---|---|
| 年份 | 這一幅什麼時候出現在地圖上 | published_year(館方)+published(奧付) |
53/73 |
| 光線 | 這一幅什麼時候可收 | conditions.time_of_day / .weather |
41/73 |
年份分佈 1876:1 1877:4 1878:1 1879:15 1880:20 1881:11 1882:1 未詳:20,正好是清親光線画的五年, 加上安治的 1882;時刻 night 12・dusk 9・dawn 4・day 1,天候 snow 7・rain 5・fire 4・moon 2・fireworks 2・clear 1。
🔴 光線只採題名明說的,⛔ 不從畫面亮度推。 量過:夜景的畫面亮度中位 90、其餘 135–145——兩端分得開, 中間整片重疊(雪景亮是因為雪不是因為白天;火場暗是因為夜不是因為陰天)。沒寫時刻的那些標 null =不限光線。 那不是資料缺口,是設計:清親特意標了時刻的那些才是有條件的。
每幅 2–3 個,共 216 個,標在原位:人力車・車輪・窗・閃電・五重塔・瓦斯燈。候選由 DoG 局部極大提案, 而且算在像素版上——所以標得出來的必然是 480px/16 色之後還看得見的東西。我逐幅看判讀表挑 2–3 個並命名。
🟡 這一層原本是「找線索」(點畫面、找中了才顯示名字,同東海道那一作)。改掉是因為這一作的重點不是找, 是知道自己在看什麼——名字藏起來只是把「清親在這裡畫了一台人力車」換成一道關卡。 挑好的點原封不動,差別只在預設標出來、玩家自己決定要不要關掉。
🔴 這正是東京二十景踩過的坑的反面:那次 57 個座標挑在真跡上,約 1/4 在 480px/16 色下根本不存在 (低對比、靠色相分辨的、細密紋理三類被量化吃掉)。從源頭避開比事後檢查可靠。
認得出來的才給名字(瓦斯燈・閃電・五重塔・大字・人力車),認不準的只標「光」或「影」——
⛔ 不從 480px 的縮圖編造它是什麼。顯示用繁中,label_ja 留著當初看畫時寫下的日文判讀
(多語系那次不必重挑)。
🔴 標註座標要等裁切定案之後再挑。 我挑到一半才發現 43・44・48・49 的畫只佔上面六成、下面全是掃描尺 (判讀表一眼看得出來,數字上看不出來),修掉之後 41 幅的裁切變了,其中 19 幅已挑好的候選跟著移位、只能重挑。 東京二十景 Phase 1 就寫過這條,這次還是撞了一次。
拿掉了一道檢查:本來想驗「點上去真的看得到東西」,用 patch 的灰階標準差。試了絕對門檻 (標出來的全是夜景——量到的是「這幅畫很暗」)和相對門檻(標出 43 個,同樣不對)。 ⇒ 標準差不是「找得到」的度量:雪地上的一個小人影 patch 幾乎全平卻一眼看得到, 一叢樹葉標準差很高卻沒東西可找。那道閘要保證的事已經由「候選算在像素版上」保證了, 所以留下真正是不變量的兩條:編號對得上、判定圈不重疊(後者當場抓到 6 組重疊)。
知識層的第三層,回答「這是什麼」——畫裡那台人力車什麼時候出現在東京街上、海運橋旁那棟洋樓是誰開的、 清親的「光線画」在浮世絵裡是什麼位置。面板下方的〈解說〉:一條「這是什麼地方」+這一幅標註到的東西各一條。
🔴 六十九段畫論我一段都不寫。 解說逐字取自維基百科(日本語版)的導言,標出處與授權(CC BY-SA 4.0)、
連得回原文。我只做兩件事:決定哪一條目對應哪一幅畫或哪一個標註(data/topics.json),
以及把它譯成繁中(data/topics-zh.json,83 條)。日文原文原地留在 topics-text.json——
多語系那次直接拿來當 ja 版本,⛔ 不必重抓也不必重挑對應。
🔴 去重要跨兩欄。 有 5 幅的「這是什麼地方」跟「畫裡的東西」指同一條——4 海運橋=第一銀行、
42 兩國花火=隅田川花火大会、47 紙幣寮=国立印刷局、53 五角堂=内国勧業博覧会、72 大丸=大の字——
同一段話印兩次。⇒ 渲染時先把地方那條放進去重集合。topics.json 的值
可能是字串也可能是 {title, n},直接比物件永遠不相等。fetch-topics.py --write 會把這幾幅報出來,
check-map 也驗一幅之內不得有重複條目。
topics-zh.json 每一條記著翻譯當下原文的字數;
維基改版而字數對不上時 fetch-topics.py --write 會報出來,譯文與原文不會悄悄分家。
🔑 對應比文字重要,也比文字容易錯。 --propose 只出提案表給人看,⛔ 不自動採用搜尋第一名——
那個第一名給過:
| 詞 | 搜尋第一名 | 實際 |
|---|---|---|
| 柳島 | 新潟県道301号柳島信濃坂線 | 墨田区的町名 |
| 小梅 | ロッテ的梅味糖果 | 向島的舊町名 |
| 岸の人 | 岸惠子(女優) | 岸上的人 |
| 溜池 | ため池(農業灌溉) | 虎ノ門的溜池 |
⇒ 全部人工確認;指不準的留空(柳島・駿賀町・萬代橋・神田八雲神社…),理由逐條寫在 topics.json 的 _skip。
topics.json 指定句數。
**HUD 的「清親」**按鈕放一篇小傳:出身(幕臣之子、鳥羽伏見、上野戰爭、隨慶喜下靜岡)、 成為繪師(河鍋曉齋・柴田是真、版元松木平吉、光線畫的開始)、畫風、弟子(井上安治繼承光線畫)。 ⛔ 不是導言那兩句——那兩句講不出他是誰;維基的章節才講得出來,所以工具支援指定章節。
🔴 延伸閱讀是連結不是引用。 有人推薦了邱馨慧〈捕捉光影的浮世繪師〉(《藝術家》2015 年四月號), 寫得好,但它有版權 ⇒ 一個字都不抄,只放出處與連結。維基的文字可以逐字引用,是因為它是 CC BY-SA。 這是兩件事,不能混為一談。
這一作沒有東海道那種在圖裡找線索的玩法,知識層就得自己站得住。而玩家最想知道的其實是同一件事—— 清親畫的那個地方,今天長什麼樣?還美嗎?
🔴 但這一層絕不由我寫。 六十九段憑印象的「今昔對比」正是這個 repo 一路在拒絕的東西
(見 places.json 的 _rule、details.json 的 _label)。所以只放四件推導得出來、指得出出處的事:
| 來源 | 為什麼放它 | |
|---|---|---|
| 標高 | 国土地理院 標高 API | 清親畫的既有下町(−1m)也有山の手(25m),那決定了他站在哪裡看 |
| 最寄り駅 | OSM | 這條最實用——它回答的是「怎麼去看」 |
| 今この辺り | OSM,250m 內的社寺・橋・公園・水 | 現在站在那裡會看到什麼 |
| 碑 | OSM,200m 內名字帶「跡/発祥」 | 畫裡那個東西已經沒了,只剩一塊碑(20 景有) |
⛔ 沒有形容詞,沒有「今も昔も変わらず」那種句子。要不要覺得它還美,是玩家去看了才知道的。 「高いほう/低いほう」也是拿同一畫帖的點排出來的,不是外面的說法——這樣連比較級都指得出出處。
第一版把 historic 與名字帶「碑/旧」的也算進來,結果出來的是「至誠勤倹」「燈籠奉納記念」「旧石燈籠」——
街角的小石碑,不是「有東西不見了」的印。收成只認「跡」與「発祥」之後才有料:no.4 銀行発祥の地、
no.58 新橋跡の親柱、no.72 江戸伝馬町処刑場跡。
雪落、雨斜、燈火明滅——這些動起來不會替清親多決定任何事。⛔ 人物走動、船前進、火車進站就不行。 這條線不是保守,是這部作品的立足點:它的價值在於「1876–81 的東京真的長這樣」,一旦畫面開始演出沒發生過的事, 史料就變成想像圖。
🔑 動什麼、在哪裡動,全部來自既有資料,⛔ 不是看圖猜的:
| 效果 | 依據 | 幾幅 |
|---|---|---|
| 下雪・下雨 | conditions.weather,只從題名判 |
9 |
| 燈火明滅 | details 裡人工挑過、名字帶「燈/火/光/煙火」的標註座標 |
16 |
| 合計會動的(兩種都有的 2 幅只算一次) | 23 / 63 |
沒有資料的景就不動——跟這個 repo 其餘各處一樣:空白是資訊。
🔴 想加的「水光」撤掉了:標註裡沒有一個點是水本身——「渡船上的人」「岸上的人」「對岸的屋」
講的是船上的人、岸上的人、對岸的屋。用 /水|舟|岸/ 去比對,亮線就會畫在人臉與屋頂上。
⇒ 又一個「看起來合理」的錯,這次在寫進去之前抓到了。(唯二真的是水的標註「水上的光」「河面的燈火」,
本來就被燈火那條收走了。)
剩下的 40 幅沒有東西可以誠實地動:街道、寺社、樹、人。那正是 AI 重繪那條路要處理的。
check-map 驗的是「真的在動」(取兩次畫面的總亮度比對,截圖看不出動態)以及「沒寫天候的景不動」——
後者才是這一層的分寸。
地圖上 63 幅每一幅都有一支生成的影片。它們跟上面那層程式動畫是兩件事,也刻意分開掛牌。
起點是 no.50 御厩橋雷雨。管道全做好了(data/motion.json 的規矩、tools/make-motion.py 的逐幀把關、
面板的第三模式與永久標示),用 Veo 生了兩支:
| 第一支 | 第二支(第一幀餵墊成 16:9 的原畫) | |
|---|---|---|
| 裁切 | 上下各裁掉 64px ⇒ 第一關就擋下 | 沒被裁(首幀對上原畫差 3.8) |
| 逐幀構圖位移 | 基線 7.3、尖峰 16–26 | 基線 4–9、尖峰 21.5 |
| 看那幾格 | 天空重畫、閃電換形狀、多出一個撐傘的人 | 黃色團塊閃電被換成分叉的白色樹枝狀、天空打亮成藍、整片雨線 |
🔑 img2video 不是「讓這張畫動起來」,是「照這張畫再想像一段」。 把第一幀餵給它只是給了個起點, 不是給了個約束;提示詞寫多嚴都一樣,因為模型的工作方式就是重新生成每一幀,它沒有「只改這一層」的概念。
前一版的結論寫成「⇒ 不收」,而 Aaron 問了一句:「效果其實滿不錯的,不懂為何不能加入遊戲中?」 他是對的,而錯在哪很具體——「它重畫了」是一個量測結果,「不能收」是一個決定,前面把兩件事寫成了同一句話。 量測只證明「這不是那幅畫動起來」,不證明「這東西不能出現在遊戲裡」。後者取決於怎麼掛牌, 而那是作者的事,不是指標的事。
⇒ 這一層分成兩種,差別在宣稱,不在畫面好不好看:
kind |
宣稱 | 把關方式 |
|---|---|---|
atmosphere |
「那幅畫動起來了」 | 逐幀量構圖,位移 ≥ 16 直接擋。⛔ 不放寬這個數字 |
reinterpretation |
「模型照那幅畫重畫了一段」 | 不擋,但 differs 必須逐條寫出它改了什麼,而且那份清單印在玩家面板上 |
63 支全部掛成後者:面板上永遠是「AI 重繪・非原作」,底下逐條列出它跟原畫的差異; ⛔ 不進畫卷、不算收藏、不算進度。重畫不是罪,冒充原作才是。
工具擋得住的三件事:長寬比對不上(構圖被裁過)、第一幀跟原畫差 10 以上
(合格的實測 1.5–3.0,不合格的 29–43 = 起始幀沒被當起始幀用)、atmosphere 的位移超過門檻。
其餘要靠眼睛,而每一次退件的理由逐條記在 _attempts(53 筆)。
提示詞從忠實版一路長到貼近原畫版,每一版都是被某個失敗逼出來的:
| 症狀 | 改法 |
|---|---|
| 鏡頭慢慢推近,紙邊被推出畫外 | 補回忠實版的鏡頭禁令(不縮放、不推近、不平移) |
| 整幅被重畫成乾淨的新版畫,還附假題箋與假落款 | 「雕線、平塗的色塊、色調與紙質維持印刷原樣」 |
| 遠景的小人物被放大成近景人物 | 錨住距離與大小,⛔ 不寫「朝我們走來」 |
| 剪影被打亮成看得見臉的人 | 明寫「每個人都是平塗的深色剪影,沒有臉、沒有顏色」 |
| 焦點人物被複製成兩個 | 在演出句裡把數量數出來(剛好一位車伕、一盞燈籠) |
| 黃昏被改成白天、暗色調被「修亮」 | 開頭先錨住原畫本來的色調 |
| 火被重畫成乾淨的大火舌,或重畫完就凍住 | 把火的筆觸本身寫成錨,再要求那些筆觸持續閃動 |
🔴 又一個「看起來合理」的錯,這次在剪下去之前抓到:no.50 整支 9.9s 有 2.1s 的位移只有 6–10,
看起來「那一段沒重畫」,於是想剪那一段來用。去看那幾格才發現——6.5s 那一格的閃電就是那道分叉白閃,
7.4s 與 8.3s 則是閃電整個不見了。位移量不出來,只因為閃電佔畫面一小塊,邊的位置平均下來沒跳。
⇒ 指標低不等於忠實;剪片只會做出一支「看起來比較沒重畫」的片子,那正是把 reinterpretation
化妝成 atmosphere。
火災那四幅(60–63)另有一套模板。原本的規矩是「那是逃難的人,動起來就是替清親演一場災難」,
2026-09-22 由作者改成:60–62 的人依離火遠近而動(緊貼火場的帶著包袱奔逃、遠一點的停下觀望),
63 焼跡的人不動。這條規矩寫進 tools/motion-prep.py,看到 weather=fire 就自動換模板,
⛔ 生動版直接拒絕火災畫。
程式疊上去的那一層照舊獨立存在:no.50 的張力也用全幅一閃做(每 5 秒閃 0.09 秒),⛔ 不畫閃電的形狀—— 清親已經畫好了那道黃色團塊。那一層加什麼、加在哪裡都說得出出處,兩層是兩件事,不互相取代。
img2video 每一幀都整張重畫,所以沒在動的地方也會跟原畫不一樣——紙邊的字形被改、招牌的字糊掉、
遠景的窗多一格。那些差異不是演出,只是重畫的副作用,而原畫的像素手上就有。
⇒ 每個像素看它在整支片子裡的明度起伏:起伏小=只是被重畫、沒在動,換回原畫;起伏大才留模型畫的,
邊界羽化(tools/motion-lock.py 量與出預覽,tools/make-motion.py --lock 收進來)。
2026-11-11 量了 59 支(另 4 支的來源片不在),作者看過預覽後收了下面這些:
| 支數 | |
|---|---|
| 鎖回(靜止區佔四成以上) | 37 |
| 其中先校色再鎖 | 8 |
| 整幅都在動(雨、雪、鏡頭在滑),鎖了沒用 | 22 |
🔑 色調偏掉的要先校色。模型把整幅調藍、調亮的片子直接鎖回,換回原畫的地方跟旁邊接不起來,
變成一塊褐一塊藍(no.68)。拿靜止區當參考,求一組「片子的顏色 → 原畫的顏色」的整幅線性對應
(12 個數字,記在 motion.json 那一支的 lock.colour),套在每一格上再鎖。no.68 靜止區離原畫 16.4 → 3.5
(用沒拿來擬合的那一半驗)。試過二次式與低頻校正場,多出來的複雜度只換到零點幾,沒用。
⛔ 這一步的分寸:
- 鎖了也還是
reinterpretation,「AI 重繪・非原作」照掛。會動的部分仍是模型畫的—— no.15 原畫是兩個背對觀者的人影,模型畫成正面撐黃傘的人,這個鎖回修不了,只能重生。 - 面板多印一句「沒在動的地方(約佔畫面 N%)換回了原畫的像素」,數字是工具量的。 不說的話,玩家會以為整格都是重繪,或反過來以為整格都是原畫。
- 浮水印不鎖。它不會動,照規則會被原畫蓋掉;但那顆四角星「正好提醒這不是清親的作品」,明確排除在外。
- 差異清單跟著改:講整幅色調、紙邊假字的那幾條在鎖回後不成立了,逐條刪改(留著就是對玩家說假話)。
🔴 踩到的一個:第一版用 ffmpeg 的 -loop 1 原畫+maskedmerge 合成,無限長的輸入讓它播完也不停,
-shortest 在那裡不管用——編了十分鐘、寫出 36MB 才被中止。改成逐格在 Python 裡合成,長度只可能是來源片的長度。
Aaron 問「1876–1881 的音樂找得到嗎?找不到就用 WebAudio 編五首」。查下來:
🔴 那五年沒有錄音存在。 留聲機 1877 年才發明,日本最早的商業錄音是 1903 年 Gaisberg 來的那批。 所以「當年的錄音」是不存在的東西,⛔ 不能假裝有。
🔑 但當年演奏的曲目留下來了:Wikimedia Commons 上有 1925–31 年的唱片,公有領域,指得出盤號與演奏者—— 端唄「梅にも春」・新內「關取千兩幟」・民謠「松前追分」(Musik des Orients,Hornbostel 編,柏林 1931)、 雅樂「衣香」(宮內省樂部,Victor 13024)、尺八本曲「鹿の遠音」(荒木古童三世,Victor 13029)。
⇒ 不用 WebAudio 自己編。座標、標註、解說一路都拒絕沒有出處的東西,配樂沒有理由例外。
(tools/fetch-audio.py 下載前會自己驗一次授權,不是公有領域就 assert 擋下來——這一層是要上線發布的。)
面板上就照這樣寫,不含糊:這不是「明治九年的聲音」,是當時仍在演奏的曲目在 1925–31 年的錄音。
⛔ 可用而刻意不用的:君が代(現行旋律 1880 年制定,正好在這五年裡,1909 年帝國海軍軍樂隊的錄音
也是公有領域)——國歌當背景音樂是另一種語氣,而這一作講的是市井的光與影。記在 audio.json 的 _skip 裡,
因為「可用而不用」是個決定,不是遺漏。
⛔ 不是濾鏡,也不是預設的皮。 這一作叫光線畫——清親用色階處理光,而不是用線。 16 色量化留下來的那 16 個顏色,就是他那套色階被壓到極限之後剩下的東西。 ⇒ 面板顯示每一幅的十六色與平均明度,並拿同一本畫帖排名次。
🔴 預設改成真跡。 像素版與真跡同框(畫心那一層廢掉之後),前者的資訊嚴格少於後者—— 一部價值在文獻性的作品,沒有理由預設先給人看降過質的版本。⇒ 像素版變成明講的一個選擇, 鈕上直接寫按下去會看到什麼。
data/palettes.json 是 Phase 2 就產出的,很久沒有一行程式讀過它。「算出來卻沒人看」跟「沒算」
是一樣的——後來才接上:面板的十六色、結局的色帶都讀它。色盤自己會說話:
| 類別 | 幅數 | 平均明度 | 平均彩度 |
|---|---|---|---|
| 夕 | 9 | 145 | 72 |
| 雪 | 7 | 143 | 69 |
| 火 | 4 | 130 | 87 |
| 雨 | 5 | 117 | 69 |
| 夜 | 12 | 109 | 68 |
(明度=Rec.709 亮度,彩度=HSV 的 S,都是 0–255。)夜景最暗;火場在最暗的一群裡彩度最高。 這是從畫本身算出來的、可重現的,比任何一段賞析都硬。
《清親畫帖》第三冊最後四枚(81–84)是弟子井上安治的畫。Phase 0 先排除、標「待決定」; 2026-09-16 決定收錄——安治是繼承光線畫的弟子(維基百科〈小林清親〉弟子一節), 而這四枚本來就裝在同一套畫帖裡。
🔴 收錄不是把 include 改成 true 就好。 一幅畫在這個專案裡要有:原圖、和紙裁切、縮圖、像素版、色盤、
座標與現代地址、今日周邊、年份、光線條件、標註、解說與譯文——少任何一樣,它就是地圖上一個
點得開卻什麼都沒有的孤兒。四幅全部走過同一條管線,而每一站都撞到東西:
| 站 | 撞到什麼 | 怎麼處理 |
|---|---|---|
| 下載 | NDL 連線斷在最後幾 KB;84 用續傳也斷 | fetch-ndl 改用 fetchlib.download;84 最後用 curl 補 |
| 裁切 | 四幅的下緣紙邊全被切掉:印在那裡的題名、落款印、82 的御届日期都不見了;82 連畫面最下面一段都沒了;83 另外少了上緣與右邊四分之一的洋樓 | trim.py 加 MANUAL(量到和紙四邊的人工框)與 --ids,只重做這四幅。 |
| 年份 | 查不到:關鍵字寫死「小林清親」;細目表註「(井上安治 明13)」裡有空格,先切空白再去括號就永遠去不掉;旧字「淺草橋」搜不到新字「浅草橋」 | fetch-dates 三處都修;另外 --write 會把人寫的 _conflicts 整段洗掉,改成讀進舊檔再合併 |
| 年份 | 83 是明治十五年(1882),時鐘只到 1881 ⇒ 永遠不出現、整場走不完(check-pub:62/63) |
時鐘加一年 1882。⛔ 不把它夾回 1881——那等於改它的年份 |
| 座標 | 82「新吉原」OSM 沒有;84 OSM 有一個「紀伊国坂」,但在九段、離赤坂 2.6km | 82 取吉原大門跡(街區級);84 那個同名點記進 _same_name 不用——_reject 會把整幅擋掉(實際踩到) |
| 標註 | 裁切改了兩次,候選重算兩次 | 舊點用整頁座標換到新框、對回距離 ≤0.004 的新候選;對不上的放大看真跡重挑。84 只有 2 個(其餘候選是紙邊文字) |
| 解說 | 83 的「勧工場」轉到「日本の百貨店」整篇 | 只取其中〈勧工場〉一節(第三句:しばしば勧業場とも呼ばれていた)。keyOf 露出一個舊 bug:地方對應到某一節時永遠查不到,而且不報錯 |
🔑 最要緊的一件:畫師是誰,每一處都要照實標。 逐幅讀奧付時發現——81 淺草橋夕景與 84 赤坂紀伊國坂的欄外, 印的畫工是「小林清親」;NDL 細目表、江戸東京博物館、茅ヶ崎市美術館卻都著錄為井上安治。 維基百科〈井上安治〉的〈17歳でデビュー〉說明了 81:安治 1880 年 6 月以〈浅草橋夕景〉〈新吉原夜桜之景〉出道, 作品欄外添上清親的名字,被認為是清親當後見人的意思(82 的奧付也正好是明治十三年六月十二日)。 84 為什麼也印清親,沒找到出處 ⇒ ⛔ 不編理由。
⇒ 兩個事實並列,不替任何一邊下定論:面板多一列「畫師」(安治的畫寫「井上安治(清親的弟子)」,
欄外署名不同時再列一行)、解說先講畫的人;擋住時的理由(「那時井上安治才畫下它」)、AI 重繪版的差異清單主詞、
結局卡、開場(只挑清親的畫當那條弧線)、跑馬燈、玩法頁、AI 動畫提示詞(motion-prep.py 會把
by Kobayashi Kiyochika 換掉)——全部照 attribution 寫。check-map 驗 no.1/81/82 三幅的畫師列與解說。
另一個沒定案的:81 的年份。江戸東京博物館記明治 12 年(1879);NDL 細目表註「明13」、維基百科也說 1880 年出道。
奧付年份欄整組空白,沒有第一手證據 ⇒ 照同一條規則取館方斷代 1879,三個說法都記在
dates-external.json 的 _conflicts。
零依賴(標準庫 + Pillow)、零 build step。順序不能跳。
python3 tools/fetch-ndl.py --download # 84 筆骨架 → data/views.json;2400px 整頁 → research/ndl/
python3 tools/fetch-gazetteer.py # OSM 具名地物 23,565 筆 → data/geo/gazetteer.json
python3 tools/derive-subject.py --write # 題名裡的地名 → subject 座標
python3 tools/check-subjects.py # 把座標畫在水系上目視 ← 這步不能省,見下
python3 tools/fetch-colophon.py --sheet 4 # 裁出御届欄,拼成判讀用的表
python3 tools/derive-place.py --write # 座標 → 現代区名・町名(OSM 行政界,本機內外判定)
python3 tools/trim.py # 整頁 → assets/plate(和紙,含紙邊與奧付)
python3 tools/quantize.py # 和紙 → assets/pixel(480px・16 色・Bayer)
python3 tools/fetch-colophon.py --sheet 6 # 和紙的紙邊 → 判讀奧付用的表
python3 tools/fetch-dates.py --write # Japan Search → 館方斷代的出版年
python3 tools/derive-light.py --write # 題名 → 時刻與天候(conditions)
python3 tools/fetch-audio.py # 配樂:查授權與出處(--write 才下載轉檔)
python3 tools/fetch-topics.py --propose # 解說條目提案 → research/_topics.md(⛔ 提案不是結果)
python3 tools/fetch-topics.py --write # 依 topics.json 抓維基導言 → topics-text.json
#(順便報:疑似曖昧頁、還沒翻的、原文改了要重譯的)
python3 tools/derive-now.py --write # 標高(GSI)+最寄り駅・周邊・碑(OSM)→ views.json 的 now
python3 tools/derive-details.py --sheet 4 # 細節候選(DoG,算在像素版上)+ 判讀表
python3 tools/apply-details.py --write # 人工挑選 → views.json 的 details
python3 tools/make-thumbs.py # research/ndl 的整頁 → assets/thumb(面板用)
python3 tools/make-share.py # 分享預覽圖與網站圖示 → assets/share(index.html 的 og:image/icon)
python3 tools/fetch-commons.py --sheet # Commons 側交叉比對(不是主素材)
python3 tools/motion-prep.py --close 1-84 # AI 重繪版:起始幀(墊成 16:9)+ 提示詞
python3 tools/motion-review.py <片> <編號> # 生成片初審:第一幀、位移曲線、推近倍率、格圖
python3 tools/make-motion.py <編號> --video <片> # 過三道關 → assets/motion(webm+mp4)
python3 tools/motion-lock.py --survey # AI 重繪版「鎖回原畫」:量每一支沒在動的地方佔多少(只量、不動線上的片子)
python3 tools/motion-lock.py <編號…> # 出鎖回後的預覽與對照格圖 → research/motion/lock/(給人看過再決定)fetch-ndl.py 重跑不會洗掉座標——它只重建自己產生的欄位(題名/出處/頁碼/收錄與否),其餘原地帶過來。
第一版不是這樣:重跑一次就把 59 個查證過的座標清成 null,而且不報錯。
src/
clock.js 兩層閘門與兩個鐘。純函式——check-pub.mjs 直接 import 它跑模擬
zoom.js 原寸檢視(連續縮放+拖曳)。⛔ 不做旋轉:這批全是橫幅錦繪
map.js 地圖。從 edo-hyakkei 複製,砍掉玩法後再接回收集狀態
main.js 把閘門接到畫面上:時鐘、收景、進度、事件、結局
finale.js 結局卡:五年的顏色(色帶讀 palettes.json)
guide.js 玩法頁。數字一律從規則讀
weather.js 程式層的氛圍動畫(雪・雨・燈火)
data/
views.json 84 筆。include=false 的 11 筆留著不刪——刪了下次盤點又會把它們找回來
places.json 人工定位的座標(機器不覆寫)
published.json 人工判讀的出版年月(機器不覆寫)
meiji-places.json 地名白名單:明治 15 区(Wikidata,記 QID)+ 水系 54(名字沿用 edo-hyakkei)
reference-maps.json 當時的市街圖:連得出去的那一張,+三條查不到/不能用的紀錄
dates-external.json Japan Search 查到的館方斷代年(⚠️ 與奧付判讀分開存,見下)
palettes.json 每幅的 16 色色盤
audio.json 配樂五首的盤號、演奏者、授權與出處(含刻意不用的那一首)
details.json 標註的挑選與命名(人工檔;label 繁中、label_ja 當初的判讀)
topics.json 解說的條目對應(人工檔)/ topics-zh.json 繁中譯文(人工檔)
topics-text.json 是抓下來的日文原文(機器)
motion.json AI 重繪版:規矩、提示詞模板與演進、每一支的差異清單,以及 _attempts(53 筆
退件)與 _decision(改判的理由)——失敗要留下理由,改變主意也要
details-candidates.json 機器提案的候選(⛔ 不是最終座標)
inventory.json Commons 盤點結果,交叉比對用
geo/gazetteer.json OSM 具名地物索引(3.0MB)
geo/modern.json 街圖向量,從 edo-hyakkei 複製(1.8MB,ODbL)
geo/relief*.jpg 地形,從 edo-hyakkei 複製(同一個畫框、同一個投影,直接就對得上)
assets/plate/ 和紙(含奧付與紙邊)1523–1690px(38MB)。原寸檢視與奧付判讀用
assets/pixel/ 480px・16 色・Bayer 的像素版(2.5MB)
assets/thumb/ 面板用的 960px 和紙(6.9MB)。960 = 像素版在桌機的顯示寬(480×2),
兩者同寬,切換「像素/真跡」時才不會跳。plate 等玩家按了才載
assets/motion/ AI 重繪版 63 支,webm+mp4(51MB)
research/ 不進 build:ndl/ 整頁 107MB、colophon/ 奧付裁切、motion/ 起始幀與提示詞、
promo/ 宣傳片的截圖與中間檔、_subjects.png 目視驗收
docs/promo/ 宣傳影片(1080×1920・39.6 秒)與 README 用的海報。
⚠️ 不進網站:.assetsignore 擋掉整個 docs,玩家不必為了玩遊戲下載它
- 奧付(
published.json)=版上印的御届登記。我自己判讀的,14 幅,其中 6 幅讀得出可用的日期。 - 館方(
dates-external.json)=機構斷代,Japan Search 查的,53 幅 (東京都江戸東京博物館 26、ARC 立命館錦絵 19、其他 8)。可能出自同一張奧付, 也可能出自目錄學研究或推定。
⇒ 分開存,衝突時兩個都留著,⛔ 不讓新的蓋掉舊的。已記的例子:
no.1奧付我讀「明治九年八月廿一日」,江戸東京博物館記「明治9年8月31日」。 年月一致、日不同——廿(21) 與 卅(31) 只差一筆。
no.60館方記「明治14年1月26日」,但那正是畫面上印的火災日,而它的奧付年份欄只刻到十位 ⇒ 館方很可能也是照畫面著錄。當年用沒問題,當出版日用就是把火災日當成出版日。
比對規則:題名正規化後完全相等才採用。日本畫題共用字太多,模糊比對會安靜配錯。
御届確實印在紙邊:id 1 是「明治九年八月廿一日御届」= 1876 年 8 月 21 日,正好是光線画首發的那個月。 但版子本身有三種狀態:
- 印齊(1、21、61、63,加上安治的 82、83)——可以當日期用。
- 整組空白(11、37、58、59…):「明治 年 月 日」。不是讀不到,是版上就沒有。
- 🔑 只刻到十位(8、60):版上是「明治十 年」,個位留空——那是留給每一刷填的。 只知道落在明治十X年(1877–1886),⛔ 不能當年份用。
🔴 畫面上印的日期不一定是出版日。 60 兩国大火浅草橋 的畫面印著「明治十四年一月廿六日出火」—— 那是火災發生日。Phase 0 曾把它當成出版年記成 1881,已更正(它的奧付其實只有十位)。 同一場火的另外兩幅(61、63)奧付印著完整的「明治十四年」= 1881,與火災同年,互相佐證。
🔑 畫帖的排列不是編年的:1=1876、21=1879、61/63=1881。⛔ 不可用畫帖順序推日期。
其餘各幅未判讀。工具已就位,但六幅一張時看得出奧付結構、讀不準年份的個位,要逐幅放大—— 那是資料輸入工,不是工程問題。
日文地名比對會安靜地給出合理但錯誤的答案。以下每一條都真的發生過。
一、前綴贏過真地名。 「東京銀座街日報社」比中的是「東京」,於是三幅畫全指到東京駅。 前綴要剝掉而且排除在候選之外——只做其中一件,它會再贏一次。這個錯犯了兩次。
二、子字串。 「大川端石原橋」比中「原橋」(世田谷),「ためいけ」比中「いけ」。 判準是前一個字的文字種類:同種類代表切在詞中間。只對兩字名執行——三字以上的地名不會是別的詞的尾巴, 一律執行會把増上寺、永代橋也擋掉。
三、長度不是好判準,位置才是。 第一版用「兩字以下一律不採」擋子字串,結果 69 幅只中 10 幅: 日本地名本來就多半是兩個字(銀座・高輪・今戸・橋場・蔵前・大森)。清親的題名幾乎都以地名開頭, 所以先頭比中的兩字名可信,句中冒出來的不可信。
四、同名多筆有兩種,混在一起就會誤判。 隅田川 40 筆是同一條河被切成很多段(散佈 20km), 八雲神社 10 筆是十個不同的神社。前者要合併成一個地物,後者不能。判準是叢集直徑。合併後取重心, 但種類要從最可信的那筆拿:日本橋六筆裡有橋也有地鐵站,取到站就變成「日本橋夜」畫的是地鐵站。
五、只有眼睛抓得到的那個。 「萬代橋朝日出」比到 OSM way/1105144393,在世田谷。assert 過得了,
因為它在畫框內。抓出來的方法是把點畫在水系上看:其餘各幅全在舊市街與隅田川一帶,
只有它落在西邊 4 公里的郊區,而同一叢還有一座已因同樣理由否掉的常盤橋——那是戰後住宅區的橋群。
所以 check-subjects.py 是必要驗收不是加分項。自動檢查抓得到「掉出畫框」,抓不到「落在錯的區」。
🔴 一、瀏覽器的原生圖片拖曳。 按下去拖第一下有反應,接著瀏覽器認定這是「把圖片拖出視窗」的手勢、
接管指標,後面的 pointermove 一個都不送——症狀是「放大之後拖不動」,而量出來是拖 220px 只移動 22px
(只有第一個事件生效)。⇒ img.draggable = false(Safari 另外要 -webkit-user-drag:none)。畫卷的圖同理。
🔴 二、方向鍵在這一層根本沒接,而且地圖的方向鍵是掛在 window 上的。map.js 本來有一道
「上面蓋著東西就讓開」的判斷,但它問的是 .overlay 與 #hunt-ui——那是從 edo-hyakkei 抄過來的選擇器,
這一作沒有那兩個東西,所以它永遠回 false。⇒ 改問真的存在的那幾層
(.lightbox, .scroll-view, .intro, #panel.on),原寸檢視自己接方向鍵並 preventDefault。
🔴 三、夾限假設了圖是置中的,而它不是。 修好拖曳之後還是「卡在一些地方過不去」:容器是
place-items:center,但 grid 對「比容器大的元素」是靠左上排的——實測放大三倍時 left=0, top=0。
而夾限寫的是 ±(w − 視窗)/2(置中才成立),於是只走得到一半:看得到左上角,永遠到不了右下角。
⇒ 改成從實際的排版位置算範圍:offsetLeft/offsetTop 不受 transform 影響,正好拿來當基準。
比視窗大時「左緣最多到 0、右緣最少到視窗邊」,比視窗小時待在原地。繞游標縮放的錨點也跟著改
(原本以視窗中心為原點,圖不置中就會愈縮愈偏)。
同一件事更早發作過一次:transform: scale() 繞著那個已經偏掉的中心縮,圖的右緣會鑽到縮放鈕底下、
下緣掉出畫面(實測右緣 1407 對視窗 1440)。那次改成縮放改動排版尺寸、置中交給 grid、
transform 只管平移,順帶讓窄螢幕的控制列移到下方。
🔑 兩個教訓:抄過來的判斷要跟著改名字,否則它會安靜地永遠回 false; 同一段註解裡本來就寫著「grid 對比容器大的元素不會置中」——那是修版面時發現的, 但夾限那一行沒跟著改。知道一件事,跟程式的每一處都照它算,是兩回事。
金點只有幾個、地圖卻是整個東京,「在哪裡」本身是一道無謂的關卡。做法是滑過去不瞬移 (要看得到「從這裡到那裡」才不會迷失方向)、⛔ 不重設縮放(那是玩家自己調的視野, 只有縮到最遠時才拉近一級)。兩個錯都是連按四下才看出來的:
🔴 一、兩點之間乒乓。 第一版「排除上一個」——但帶過去之後,離新中心最近的就是剛剛離開的那個 ⇒ 在兩個點之間來回。改成記住這一輪巡過的,全部走完才重來。(而重來那一按還要排除現在正對著的, 否則巡完一圈會原地不動。)
🔴 二、舊計時器把新的亮點清掉。 每個點各自 setTimeout 取消高亮,連按第四次時 .lead 憑空消失——
那是第一次的計時器回來清的。⇒ 計時器只能有一個。
眼睛看得出「怪怪的」,但說不出差在哪。三個都是量了盒子才確定的:
一、圖置中、其他靠左。 面板加寬之後只設了圖的寬度,於是圖置中、標題與按鈕與資料全部靠左——
桌機上差 140px。⇒ 欄寬算一次,整個面板共用(CSS 的 --col),而欄寬依像素版的原生尺寸算
(views.json 的 pixel),不是依當下顯示的那張圖:切到真跡時那張的裁切不同(和紙含紙邊與奧付),
拿它算會讓版面在切換時跳。
二、切換「像素/真跡」時大小會跳。 像素版 480×2=960,縮圖卻只有 720。⇒ 縮圖提到 960, 兩邊同寬且各自都是 1:1 或整數倍。
三、面板從 top:0 蓋下來,HUD 的鈕按不到。 面板加寬之後,HUD 右半邊的鈕
(1440 寬時是清親・畫卷・開場・沈浸・♪,1280 寬連等一刻也算進去)看得到但按不到。
加「玩法」那顆鈕把畫卷往右推了 58px,驗收點畫卷點不到才露出來。
⇒ 面板上緣改從 HUD 底下開始;驗收逐顆問 elementFromPoint,⛔ 不只看位置有沒有重疊。
本來有第四層「畫心」(把和紙再削掉紙邊),2026/09/12 廢掉了。起因是 Aaron 看到 「新橋ステンション 的圖跟別幅明顯不一樣大」——追下去發現的不是版面問題:
🔴 畫心那一層用「最長的一段有墨」找邊界,而畫面中間只要有一條淡色的帶(白牆、雪地、霧), 那一段就被切成兩半,留下來的是比較長的那半。 no.1 東京銀座街日報社 的天空就是這樣整片不見的—— 和紙 1628×1084,畫心只剩 1549×637。69 幅裡有 9 幅被切掉兩成到四成,而每一幅看起來都還是一張完整的畫, 所以沒人發現。(面板尺寸會跳,是因為被切矮的畫落在不同的整數倍上——那只是症狀。)
🔑 修了兩版才發現不該修,該砍。 換成「只削紙邊」之後仍然錯:淡色的天空與淡色的和紙量起來沒有差別—— 27 三ッ又永代橋・65 神田川夕景 的天空,每列色差 5、標準差 6,跟紙邊同一個數量級。 ⇒ 這件事沒有可靠的界線可找。而判錯的兩個方向不對等:削過頭是切掉畫面,留過頭只是多一圈紙。那就留著。
附帶好處三件:像素版與真跡從此是同一個框(標註座標兩邊通用、切過去不必收起來)、 紙邊與奧付本來就是那件東西的一部分、少一層就少一整類 bug。
裁切本身還有三個坑:
一、外圈的中位數不是背景色。 這些頁的上緣是襯紙(米色)、下緣才是灰底,從整圈取中位數會落在哪一邊 要看那一頁——落錯就整個判定反過來(44 只留下 681 列)。灰底只從最底部 1.5% 取樣,那裡一律是掃描台。
二、單一列掉到門檻下就切斷連續段。 取最長連續段是對的(比例尺與台紙之間隔著一道灰, 用 first/last 會跨過去把尺收進來),但紙上一道摺痕就會製造假縫。先做 1-D 閉合再取最長段—— 而補多大是候選參數之一,不是定值。
三、保險絲要擋崩潰,不要擋正常裁切。 第一版設「裁掉超過一半就不採用」,但和紙本來就只佔台紙約 39% ⇒ 每一幅正常的裁切都被擋掉,全部退回整頁。
🔑 結論不是「調出一組萬用參數」,是「跑幾組、挑一個」。 補縫補得大,比例尺被連進來;補得小, 摺痕把台紙切成兩半。兩邊都試過,各壞一半。但整本畫帖的版面是一致的——和紙一律 1400–1800px 寬 (中位數 1640×1103),而這個先驗來自資料本身,可以拿它當選擇規則。
🔴 原本寫全部收錄數,而那個數字保證跑不完。 收錄 73 幅,其中 10 幅沒查到座標 (12・28・31・45・48・51・53・54・65・66),它們畫不到地圖上,就永遠點不到、收不了 ⇒ 結局卡也因此 永遠不會出現。
check-pub.mjs 卻一直說「走得完」,因為它只濾 include——模擬的世界比遊戲的世界多了 10 幅。
這是 edo-hyakkei 那個坑的新版本:那次是模擬多了一個遊戲沒有的動作(day++),這次是模擬多了遊戲沒有的景。
⇒ 兩邊的取景規則只能有一份:include && subject。現在模擬 63/63、面板也寫 63。
那 10 幅沒有消失——它們在 views.json 裡、在 README 裡、在 places.json 的 _unresolved 裡各有理由。
空白是資訊,但空白不該混進分母。
一、空心圓的中心是洞。 座標只定到「那一帶」的點畫成空心,看起來對,但 SVG 的 fill:none 不接
hit-test——點下去會穿過去打到底下的地形圖。一半以上的標記只有那圈 2px 的線點得到。pointer-events:all 一行。
二、抄過來的 CSS 帶著它原本的假設。 HUD 沿用 edo-hyakkei 的漸層背景,那邊地圖上緣是海(深色), 這邊是米色的陸地——同一段 CSS 在這張圖上等於白字印在白紙上。
三、面板的圖直接連 NDL 的 IIIF,被回 429。 那次是我們自己當天抓太多,但道理不變: 上線之後每個玩家開一次面板就打 NDL 一次。圖進 repo,執行期不依賴別人的伺服器。
(測試也踩了一個,那不是產品的錯:Playwright 點 .mark 會打到 <g> 的 bbox 中心,而 bbox 含右邊那條景名,
中心落在標籤那一半的空白上。改點圓本身。)
計畫本來指定 1880/1882 年的《東京方角一覽地圖》。查下來三條路:
- NDL 有藏也數位化了(pid 14433865/14433926),但 IIIF 回
checkResult: NG= 非公開 (館內或圖書館送信限定)。拿不到。 - David Rumsey 有一張 1882《東京繪圖》,17098×12188、IIIF 全開,原本藏於 UC Berkeley 東亞圖書館。 但 Cartography Associates 對掃描主張著作權(CC BY-NC-SA)⇒ 收進這個 MIT + 公有領域的 repo 會多一個 NC 的角落。只連結,不下載——連結不是重製。要不要真的用它是 Aaron 的決定, 同 Phase 0 對 MFA Boston 的處置。
- 明治迅速測図(1880–86)沒查:它是實測圖、有正確的地理參照,適合的用法是對位疊圖而不是 「當文獻用」,那是另一個決定。
🔴 中間踩了一個假陽性,記在 data/reference-maps.json 裡避免重犯:我從 NDL 的書目頁刮
dl.ndl.go.jp/pid/NNN 當作該書目的數位版,但書目頁會連到別的館藏——pid 1301528 拉出來是芳年的
《新撰東錦絵》,不是地圖。而掃描結果還一併報了尺寸與頁數,看起來完全合理。
判準:只認「搜尋結果的 link 本身就是數位館藏」,不要從頁面上刮 pid。
兩邊都接同一個 repo,推送到 main 就各自更新。從台灣實測(2026-09-18):
| GitHub Pages(Fastly 新加坡) | Cloudflare | |
|---|---|---|
| 一支 AI 影片 1.3 MB 完整下載 | 29–35 秒(約 40 KB/s) | 1.1–1.5 秒 |
| 地圖出現 | 3.1 秒 | 1.7 秒 |
| 按「AI 重繪版」到開始播 | 1.7–2.7 秒,之後常卡 | 0.5–0.9 秒 |
慢的不是回應時間(TTFB 都在 1 秒內),是下載速度:就算新加坡節點快取命中,也只有幾十 KB/s。 同一台電腦連 jsDelivr、raw.githubusercontent(都走 Fastly)一樣慢,連 Cloudflare 則是 MB/s 等級。
- repo 裡一定要有
wrangler.jsonc:沒有它,npx wrangler deploy會跑自動設定、把 wrangler 裝進專案node_modules/,上傳目錄又是根目錄 ⇒ 126 MB 的workerd被當成網頁檔案上傳而失敗。 哪些不上傳寫在.assetsignore(.git也要擋:部署是在 clone 裡跑的)。 - 快取要配版本碼:
_headers讓瀏覽器把影片存 7 天,但重生的影片檔名不變 ⇒ 面板的影片網址帶?v=內容雜湊(make-motion.py自動寫進data/motion.json),內容一變網址就變。 程式與資料不設長快取,改了馬上生效。
workers.dev 網址(例如 3b804292-…)是某一次部署的版本預覽,固定不動。
驗證線上版本要用沒有前綴的那個。
| 來源 | 授權 | |
|---|---|---|
| 清親版畫 84 枚 | 国立国会図書館デジタルコレクション《清親畫帖》寄別1-9-2-3(IIIF) | 公有領域 |
| 地形 | 国土地理院 標高タイル(DEM5A・DEM10B),經 edo-hyakkei 焼成 | 国土地理院コンテンツ利用規約(出典明示) |
| 出版年(館方斷代) | Japan Search 聚合:東京都江戸東京博物館・ARC 立命館錦絵・名古屋市博物館 等 | 各館目錄資料,僅取年份並記出處 |
| 街圖向量・地名索引 | OpenStreetMap | ODbL 1.0 — 必須標示 © OpenStreetMap contributors |
| 部分地名座標 | Wikidata | CC0 |
| 配樂 | Wikimedia Commons(1925–31 年唱片) | Public domain |
| 解說文字 | ウィキペディア日本語版 | CC BY-SA 4.0(繁中譯文為改作,面板標「譯自」並連回日文原文) |
| 交叉比對 | Wikimedia Commons(LACMA/Honolulu/Rijksmuseum 掃描) | 公有領域 |
| AI 重繪版 | Google Flow 生成,起始幀為上列公有領域原畫 | 生成內容,面板永久標示「AI 重繪・非原作」並逐條列出差異 |
| 宣傳影片 | docs/promo/,由上列素材組成(原畫・遊戲畫面・AI 重繪片・1931 年公有領域錄音) |
各素材依其授權;轉貼請保留片尾那張出處卡 |
| 程式 | MIT |
清親 1915 年歿、作品 1876–1884 年出版 ⇒ 日本、台灣、美國三地都已進入公有領域, 不需要按出版年做 build 區分。
逐件出處在 data/views.json 自己身上(source:館名・請求記号・pid・頁・授權),
⛔ 沒有另開一份 sources.json——同一個事實只放一個地方。
| Phase | 做什麼 |
|---|---|
地圖:map.js 複製過來砍掉玩法;滑桿 1880/2026 + 新橋鐵道(1872);明治 15 区地名;現代地址+街景連結;當時的市街圖(只連出去) |
|
| 裁切 73/73・量化 73/73・縮圖改吃裁好的和紙。奧付判讀只做了 14 幅——工具已就位,但要讀準年份的個位得逐幅放大,那是資料輸入工不是工程問題 | |
| 兩層閘門・收景・事件與結局・標註 216 個 | |
| 上線:Cloudflare 為主、GitHub Pages 備援。零依賴、零 build step | |
| AI 重繪版 63 幅,全部掛「非原作」並列出差異 | |
| 待辦 | 差異清單逐條複核;district 那 34 幅用畫面收斂座標;影片播放優化(ready 才換片、縮小體積、開面板先預取) |
為什麼這樣做、哪些路試過不通,寫在程式的註解裡——每個 🔴 都是一個踩過的坑。