孵化區進駐規則（discipline）

給其他 workspace 的代理人看的。你在自己的目錄裡做事，這一頁講的是「東西要放上書同軌的網站」時，必須遵守的規矩。

站點：<https://shutonggui.cn>（主站，廣州）· <https://nissaya.cn>（鏡像，東京）
孵化區：<https://shutonggui.cn/incubator/>
維護者：葉健欣（碼僧善那）· yapcheahshen[at]gmail.com

0. 一句話

你只擁有自己那一個目錄；別人的檔案、首頁、選單，都歸維護者。

1. 三條硬規則

不要改 D:\nissaya.cn（本網站的工作區）。你的東西留在自己的 workspace，交付方式是「檔案」與「清單」，不是直接編輯本站。
只部署自己的目錄（例如 /huixintang/、/myproject/）。以下路徑任何情況都不要碰：

/var/www/html/index.html（首頁）
/var/www/html/yap/（發表紀錄）
/var/www/html/incubator/（孵化區，本檔所在）
/var/www/html/accelon26/（由 adb-converter 管理）

不要刪別人的檔案。要換版就覆蓋自己那一個；要清理舊檔，先問。

2. 進駐門檻

東西能放上孵化區，至少要通過這幾項（缺一項就會被退回）：

項目	標準
手機可用	390 px 寬不橫向溢出、字級 ≥ 16 px、按鈕 ≥ 44 px
沒有 console error	開頁 3 秒內不得有紅字
標題與描述	`<title>` 與 `<meta name="description">` 都要寫，別留空白
體積	首屏 ≤ 1 MB；圖片用 WebP 或壓過的 JPEG；單檔 ≤ 500 KB
繁簡	繁體是母本：HTML 以繁體撰寫與維護；簡體由 OpenCC `t2s` 無損轉出（只換字形與引號，不改詞彙）；每頁附「簡／繁」切換鈕。主站缺省簡體、鏡像缺省繁體（規格見 `agent-norms/writing-skill.md` §13）
計價	一律人民幣（¥）：費率、總額、圖表座標都用 ¥，不得出現 NT$／新台幣
不依賴外部 CDN	字型、JS、CSS 一律自帶或走本站；不要引用會消失的第三方
可分享	入口是一條乾淨的 URL，不是 `file://`、不是壓縮檔下載頁

3. 交付什麼

在你自己 repo 的 deploy/ 放一筆 incubator.json——格式就是本站 incubator/projects.json 裡 projects 陣列的一個元素：

{
  "id": "jingang",
  "title": "金剛經合注",
  "subtitle": "十一譯對讀 · 41 家注疏 · 梵藏逐詞 · zhu-combined",
  "status": "incubating",
  "owner": "zhu-combined",
  "since": "2026-10",
  "url": "/huixintang/vcpp.html",
  "desc": "羅什主文配昭明三十二分，點一句即列歷代注疏……",
  "why": "上線未滿一季，注疏還在補、面板還在改",
  "meta": "純靜態單頁",
  "links": [
    { "label": "操作導覽", "href": "/huixintang/use.html" }
  ],
  "path": "/var/www/html/huixintang"
}

欄位	必填	說明
`id`	✓	小寫英數與 `-`，穩定不變
`title`	✓	顯示名稱，≤ 12 字
`subtitle`	✓	一句話賣點，用「·」分隔
`status`	✓	`incubating`／`stable`／`retired`
`owner`	✓	你的 repo 或 workspace 名稱
`since`	✓	進駐年月 `YYYY-MM`
`url`	✓	入口，站內絕對路徑（`/foo/`）；不可指到 `/`、`/yap/`、`/incubator/`、`/accelon26/`
`path`	✓	伺服器上的目錄，供維護者部署
`desc`		一兩句介紹，會顯示在卡片上
`why`		「為什麼還在孵化」，一句話
`meta`		小字補充，例如「純靜態單頁」
`links`		額外入口，最多 3 個；`href` 用站內絕對路徑或完整網址

孵化區卡片不放 GitHub 連結：repo 欄位已移除，填了會被檢查器退回。

交付前自己跑一次檢查器（Node 18+，檔案在 incubator/check.mjs）：

node check.mjs deploy\incubator.json

維護者只做兩件事：把你的項目併進 incubator/projects.json、重新部署。不必改 HTML——列表是從 JSON 長出來的。

4. 部署方式

用 pscp 上傳到 *.tmp，再用 mv -f 換檔（同一個檔案系統，原子替換）。不要直接覆蓋、不要用「網頁後台」。
一次只動自己的目錄；上傳前後都 ls -l 確認。
傳完自己驗一次：HEAD 回 200、大小對、首頁打得開。
兩站都要傳（主站與鏡像），並確認兩邊檔案大小一致。

# 範例：只換自己目錄裡的一頁
pscp -batch -pw <PASS> .\index.html yap@shutonggui.cn:/var/www/html/myproject/index.html.tmp
plink -ssh -batch -pw <PASS> yap@shutonggui.cn "cd /var/www/html/myproject && mv -f index.html.tmp index.html"

5. 生命週期

階段	在哪裡	條件
孵化	`/incubator/` 列表	通過 §2 門檻；介面與資料都還會大改
穩定	首頁四個技術方向之一	連續一季沒有大改、有真實使用者、資料不再大幅變動
退役	下架，檔案保留	停止維護；把 `status` 改成 `retired`，並在 `note` 寫原因與日期

升到首頁是維護者的決定，不是自動的。專案方可以提議，但不要自己去改首頁。

6. 寫作與用語

對外文字遵循 agent-norms/writing-skill.md：三個語域、句長、詞表、禁用詞都在裡面。
繁體寫作、簡體轉出：頁面的母本一律是繁體；簡體頁由 t2s 產生，只換字形與引號（「」→“”），不換詞彙、不刪句、不重寫。簡體頁是衍生物，不要手改——要改就改繁體母本再轉。
「無損」的判準：繁簡兩頁除了字形與標點，git diff 應該只剩這類差異；出現整句不同，就是重寫了，退回。
繁簡切換鈕：每頁都要有（右下角「簡／繁」即可），點擊記住選擇；缺省值由 hostname 決定——主站簡體、鏡像繁體。
金額一律人民幣（¥）：費率、總額、圖表刻度都用 ¥；不再使用 NT$／新台幣。引用舊資料若原為台幣，附換算註。
名詞一致：缺字（缺碼）、字形、構形序、拼形、定址、標記、加值、互文連結。

7. 上架前檢查清單

[ ] 390 px 手機看過，不溢出、字夠大
[ ] <title>、description、og: 都寫了
[ ] console 沒有紅字
[ ] 首屏 ≤ 1 MB、單圖 ≤ 500 KB
[ ] 主站缺省簡體、鏡像缺省繁體，每頁都有「簡／繁」切換鈕（若有大陸讀者）
[ ] 簡體頁由繁體母本 t2s 轉出，沒有手改；繁簡差異只在字形與標點
[ ] 金額全部人民幣（¥），沒有 NT$／新台幣
[ ] 入口是乾淨 URL，兩站都回 200
[ ] deploy/incubator.json 填好、url 用站內絕對路徑
[ ] 沒有動到別人的目錄（尤其首頁、yap/、incubator/、accelon26/）

8. 有問題

寫信給維護者，或在 issue 裡說清楚：你動了哪個目錄、哪幾個檔案、為什麼。含糊的請求會被退回去問。