模擬市議員｜巷口，開始 v13.8.0
這是以臺北文山木柵街區意象製作的虛構市議員選戰模擬原型。你安排競選行動、和合成居民交談，再看一場簡化的模擬開票。人物、居民、遭遇、候選人和選舉結果皆為虛構；遊戲數值不是現實民調、選舉預測或競選建議。
開始遊玩
直接遊玩：https://atomchung.github.io/councillor-simulator/。不需登入，進度保存在目前瀏覽器；線上版與本機版的存檔各自獨立。
若要在本機執行：
需要 Node.js 18 或 Python 3，不需安裝 npm 套件，也不需帳號、API 金鑰或雲端服務。
在 macOS 可雙擊 start.command。也可以在專案資料夾執行：
npm start
或使用 Python：
python3 -m http.server 4173 --bind 127.0.0.1 --directory dist
接著開啟 http://127.0.0.1:4173。伺服器只接受本機連線，終端機視窗須保持開啟；按 Control-C 停止。遊戲存檔留在目前瀏覽器的本機儲存空間，不會隨程式檔案一起分享。
公開發布包
GitHub Pages 只上傳 npm run build:pages 產生的 .pages/。來源仍放在 dist/；舊版與美術交件原檔留在倉庫供歷史測試使用，不再發布，也不在現行遊戲提供舊版連結。
發布包從現行 HTML 的程式與樣式依賴，以及美術登錄表和實際地圖輸出收集檔案，包含雨天、走路動畫、結局與備援場景。npm run test:pages 在臨時目錄驗證發布資源及舊版排除。建置輸出必須是空目錄；CI 每次使用乾淨 checkout，避免帶入前次殘留檔案。本機已有 .pages/ 時，請先移走該生成目錄再重建。
目前玩法
- 一局 30 天、9 回合，三幕各 3 回合；第 7 回合政見發表會，第 8–9 回合可催票。每回合只有一個主要行程。
- 選身分與政黨時可先安排拜訪、研究或直播首站，開始後仍可調整。幕僚依首站安排、基本盤、實際行動與當下情報，說明本回合建議及取捨；點建議會實際預選行程，出發才提交。
- 新局素人與政二代各 2 位助手，現任 3 位；招募採 2→3→4 人，每次新增一人、下回合到職，最多 4 位。人數不含主角；招募占主要行程，按剩餘天數預付薪水。舊存檔保留已付薪的超額助手，但不能繼續招募。
- 助手研究、直播與募款攤共用人力，摘要顯示實際分工；不能同一人同時做兩件事。助手研究在回合結束完成，從下一回合用得到。
- 公開行程每次都需回答，即使已講過同一題也先標出原立場，玩家可確認或改口。助手研究顯示大致方向，親自研讀顯示強弱；作答時不顯示預估票數，改口與違約後果另行提示。
- 每回合停在結算卡：列出回答、助手、小隊、里長、合作、對手及事件的實際影響，以及名次、距當選線的變化。玩家按繼續才進下一回合；完整紀錄可展開。
- 實際拜訪取得里長支持後，成立一支地方小隊。玩家可指定已取得支持的地點與本局公開政見，小隊從下一回合起行動。它使用真實人群反應，講錯政見仍會掉票；不增加受薪助手人數。
- 第 4 回合當天才出現撞期邀約：去地方成立會，可成立或擴編同一支小隊並取得該地點；或接免費指定議題專訪，省下節目費。兩邊都不去，也會失去這次機會。
- 準備過的具體政見在節目、直播或政見會得到正面迴響，會帶來下一回合的接續直播邀約。邀約觸及依題目與青年觀眾的吻合度調整，過期就消失；它仍占一回合，也必須作答與看結算。電視疲乏按整場累計，不會因穿插其他行程而重置。
- 合作、危機、當回合邀約和需要回應的質疑直接出現在操作區。第 7 回合有政見會直接入口。地圖提示首次選地點後消失，小馬標記明示是行程傳聞。
- 研究清單依固定順序排列；本人與助手研究預設收合，已完成題目留在原位。黑料從檔案選發布管道即可出發，發布結果保留供回看。
- 結局依名次分為高票當選、穩上、險勝或落選，標出到下一級的票差；本機保存每個身分與政黨的最佳紀錄。另列實際公開的最多三項最近政見、改口紀錄與逐回合成績。
GAME_DESIGN.md、CAMPAIGN_ROUTES.md 與下列舊版紀錄保留設計背景；現行規則以本節、介面規範 與實際引擎為準，驗證範圍另見 VERIFICATION.md。
舊版紀錄
v12.1.0
- 三種開局身分取代原本的背景：全新素人、政二代、現任議員，各有不同的錢、起始支持、可信度與一條特殊規則。
- 合作約定改成第 2 或第 3 回合的邀約，當回合由玩家接受或婉拒；開局不再預選。
- 團隊預設派一位夥伴查資料，可調整人數；人數越多，同一回合依民調熱度查越多議題。主角準備政見時，其餘夥伴改去街訪。
- 還沒選行動時，底部按鈕改為「選一個行動 ↓」；電視自動選題改挑民調最熱的議題。
- 平衡門檻新增一項：每種身分看局面的最佳當選率都不低於 60%，彼此差距不超過 20 個百分點。
v12.0.0
- 議題局面：每局隨機的議題熱度與做法偏好，只在合成選民層級產生，不與地點、背景、政黨或真實群體綁定。
- 研究分兩級：助手當回合查到多數偏好或「兩邊接近」；主角親自準備看到比例，可信度 +3。
- 可信度與未兌現保證：方案、坦白、更正加分，空頭保證與改口扣分；開票前沒更正的保證會讓聽過的人流失。
- 對手預告與回應期限、選行動前的天氣預報、若現在開票的估計與當選線、因果回顧與開票關鍵因素。
- 平衡門檻
npm run test:balance：不看局面的固定路線、看局面的打法、不同路線與隨機遊玩的當選率都有上下限，已併入 npm test。
- 助手街訪的觸及遞減改為每人各自計算；街訪議題限於該地點的話題。v11 舊版入口與存檔 key 保留於
dist/legacy-v11/。
v11.0.0
- 首次導覽說明勝負、資金與回合流程；各背景提供附官方來源的政黨預設，官方主題與遊戲規則分開標示，所有背景都可覆寫同一組虛構約定。
- 居民有個別對話感受；約定衝突只對實際接觸者產生差異化回應，並與支持傾向及抽樣民調分開呈現。
- 新增廟前廣場、單一情境式重玩，以及展示已結算結果、可略過的四秒開票。v11 儲存資料與 v10.3 分開，v10.3 舊版入口及 key 保留於
dist/legacy-v10-3/。
目前限制
遊戲以 1,000 名合成選民、27 名虛構候選人和 13 席作縮小演算；只有一位主要對手會採取行動，其他候選人只參與計票。目前透過幕僚建議、固定時間的撞期邀約、地方小隊與限時媒體邀約，驗證「計畫、取捨、後果」是否有趣。尚未完成真人趣味與五分鐘計時驗收，完整策略平衡門檻也尚未通過；不以通過功能測試代替這兩項判斷。
需求與參與
目前需求與驗收見需求文件，協作方式與測試指南見貢獻指南。
專案內容
dist/：遊戲 HTML、CSS、JavaScript、原創向量場景，以及保存的舊版入口。scripts/serve.cjs、start.command：本機啟動工具。tests/：引擎、介面接線、平衡門檻（strategy-balance.cjs）和匯出完整性測試。package.json：本機啟動與測試指令。VERSION.txt：遊戲版本。FILE_LIST.txt、SHA256SUMS.txt：發布檔案清單與 SHA-256 校驗值。
目前版保留霧面玩具風 WebP 場景與原創 SVG 風格切換；頁面沒有外部字型或圖片下載。遊戲內背景資料會連到相關的官方來源頁面，只有使用者點擊時才會開啟。
此 repo 以 v10.1.0 遊戲匯出包為基礎；v10.2.0 加入一鍵新局，v10.3.0 改善結局重玩入口，v11.0.0 加入來源化背景、居民反應、廟前廣場、單一重玩及四秒開票，v12.0.0 加入議題局面、可信度、對手預告與期限、天氣預報和因果回顧。v11 與 v10.3 舊版分別保留於 dist/legacy-v11/、dist/legacy-v10-3/，本機啟動方式與未指定授權狀態維持不變。清單與校驗值依本次發布內容產生。
測試
npm run test:quick
npm test
歷史紀錄：v12.1.0 的 npm test 通過：v12 引擎 17,859 項檢查、v12 介面 255 個 DOM 斷言、保留的 v11 與 v10 回歸套件，以及平衡門檻 npm run test:balance（約 3 分鐘；種子 1–300 中，不看局面的最佳固定路線 42%，看局面的最佳打法 85.3%，完全隨機 5.7%；三種身分的最佳當選率 85.3%–94.7%）。這些自動驗證不代表真人五分鐘遊玩已完成；瀏覽器在 1366×900 與 375×812 走過一局。
授權
本專案目前尚未指定開源授權，也沒有附上 LICENSE。公開原始碼不代表授予複製、修改或散布的權利。若日後加入第三方素材，需保留其原有授權與來源資訊。
