前言¶
在 DSH Tavern 裏調人物卡，同類問題會反覆出現：同名的狀態字段、同一段正則、同一個腳本鉤子。換一張卡、隔一週再調，往往又會踩一遍，因爲結論散落在對話記錄裏，沒有按「哪張卡出的問題」歸檔。
宿主從 v2.3 起內置改卡記憶，擅長跨卡、可複用的經驗；但它和「這張卡歷史上出過什麼具體故障」不是同一套數據結構。維護者 XGUIMAX 的插件 dsh-tavern-wrongbook（社區目錄：SkillHub，GitHub：XGUIMAX/dsh-tavern-wrongbook）把坑記在出問題的那張卡名下，調試時固定順序：本卡錯題庫 → 其它錯題 → 跨卡查詢。分類屬於 DSH 插件生態裏的「記憶」方向；倉庫當前約 3 stars，版本 1.33.0，許可證 MIT，無額外 npm 依賴。
下面介紹它做什麼、怎麼進面板、和宿主記憶怎麼分工。
這是什麼¶
一句話定位：DSH Tavern 的 per-card 錯題本——按人物卡分桶記錄調試中踩過的坑，面板與 Agent 共用同一套檢索順序與排序。
插件以 DSH 插件形式運行（dsh.compatibility 要求 dsh >= 0.1.0-rc.8，Node >= 18）。不裝 Tavern 也能用卡片工作臺側的大部分功能；裝了 Tavern 會多出右側欄面板、以及助手消息下的「記進錯題庫」等入口。
核心功能¶
按卡分類與檢索順序¶
卡片目錄裏有幾張卡，面板就自動建幾項，帶卡名與頭像。原版卡與它的 MVU版本 互相認得，可以把一條結論一鍵複製到對應分類。
檢索順序固定爲：
- 本卡錯題庫
- 其它錯題（不掛在某張人物卡上的問題）
- 跨卡查詢
本卡命中始終排在前面，避免把已知答案重查一遍。
「其它錯題」預置「卡內故障」「卡片更新器」「通用 / 未歸類」等分類，也可自建；記一條不存在的分類名時會自動建新分類。註冊了三個工具，卡片 Agent 調試時按與面板相同的順序與打分規則查詢。
面板入口與頁籤¶
四個入口指向同一頁面（前兩個在卡片工作臺，後兩個依賴 Tavern 插件接口）：
- 設置 → 錯題庫
- 左下角側欄底部（與「插件市場 / 卡片更新器」同層）
- Tavern 右側欄「插件」一組（需 Tavern；側欄用接口 v2 的
registerPanel） - 每條助手消息下的「記進錯題庫」（需 Tavern）：按 Tavern 提供的卡文件位置歸類；自動把前兩輪正文放進「證據」欄
頁面內六個頁籤：人物卡錯題、其它錯題、卡腳本、宿主補丁、備份與還原、通用腳本。頂部篩選（如「未解決」）會同步過濾左側分類列表，只保留仍有命中條目的卡；未選篩選時不過濾。
錯題頁頂部有 「迴流到 Skill」：把結論寫進自建 skill 的 references/，供後續會話裏 Agent 讀取（見下文）。
來源失效標記（Tavern）¶
從「記進錯題庫」抓下的底稿除可讀 refs 外，還存結構化 { gameId, turn, textVersion }。回退、重新生成或編輯來源輪次後，正文可能對不上當初抓取的內容；插件在 onTimelineChanged 下給受影響底稿標 「來源已失效」，詳情說明輪次與變動類型，底稿正文本身不改。確認問題仍在可點「確認仍有效」清標記。早期或手工條目若無 source 字段，不會參與標髒。
與卡片更新器聯動¶
設置頁右上角 「● 卡片更新器 · 已連接」 通過 GET /dsh-card-updater/state 每 15 秒探測對方插件（dsh-tavern-card-updater），綠 / 灰 / 紅表示已連接、檢測中、未連接；點擊打開更新器倉庫頁。兩插件不讀寫對方數據文件。
若更新器狀態裏某卡 config.cards[].primary.gates 含 preset，人物卡列表會爲該卡顯示「專屬預設」標籤（只展示，不寫入錯題庫）。
迴流到 Skill 與自動同步¶
點 「迴流到 Skill」 可將選中條目寫入自建 skill 的 references/（內置 skill 在程序目錄，Tavern 更新會覆蓋，彈窗只列可寫 skill）。每條按現象 / 根因 / 修法 / 證據展開；同目標反覆迴流不會重複寫入。段落帶 <!-- wrongbook:… --> 標記：指紋一致則隨錯題狀態同步更新，你手工改過則跳過。
彈窗可勾選 「以後新條目自動同步到這裏」；開啓後面板按鈕前有綠點，並顯示上次同步時間與寫入條數。失敗時提示行會給出原因。
新建 skill 時 description 要寫清是什麼、何時用、症狀詞；可點「示例」按當前範圍生成一句可用的描述。
與宿主「改卡記憶」的分工¶
宿主改卡記憶（data/card-memory/，memon 引擎）強調 scope: shared 與帶 evidence 的驗證狀態，適合跨卡、可複用經驗。錯題庫強調 按卡歸因的具體故障、面板一覽與 MVU/原版互認，以及 迴流 skill 跨會話檢索。調試時兩處都應查：只查一處可能漏掉另一類存量。宿主 v2.3 說明裏默認不再爲錯誤經驗生成 Skill，錯題庫仍保留自動迴流，是刻意分工。
卡腳本與通用腳本¶
卡腳本頁籤（懶加載）列出每張卡 data.extensions.tavern_helper.scripts 中的腳本（掃描前會剝掉卡文件外層可能的 raw），標出啓用狀態、import、控制器與含 update / json_patch 的條目，並單獨列 data/tools/ 下待裝腳本。
通用腳本庫位於 data/tools/wrongbook/common-scripts/，跨卡共用。面板列「可裝腳本的卡」（… MVU版本、卡型標記 dsh_card_marker.kind = hand-tuned-mvu、或已裝庫內腳本）。支持分類篩選、按腳本名篩卡、批量裝卸；每個腳本提供「檢測適合的卡」「生成建議」「後臺分析」等入口（技術層匹配，不替代人工讀卡判斷題材）。
備份、自檢與其它¶
每次寫盤前自動備份；備份目錄可選。獨立頁籤支持按份清理、刪單份、還原、導入導出。面板右上角顯示版本號，可 檢測更新（比對插件文件指紋與版本）。
安裝與啓用¶
已抓取資料與 GitHub README 中未給出統一的 dsh plugin add … 安裝命令行。安裝方式請以 SkillHub 目錄頁 與倉庫 README 的當前說明爲準。
啓用前建議自行查看源碼與 MIT 許可證：插件以當前 DSH 進程權限運行，會讀寫錯題數據、skill 迴流目標、備份目錄及通用腳本庫路徑等。
環境要求（來自 package.json）：
dsh >= 0.1.0-rc.8
Node >= 18
典型用法¶
1. 從面板記一條本卡故障¶
打開 設置 → 錯題庫 或側欄底部入口，在 人物卡錯題 中選對應卡，新增條目，填寫現象、根因、修法與證據，並設置狀態（未解決 / 觀察中 / 已修復）。
2. 遊玩時快速抓取（需 Tavern）¶
在助手消息下點 記進錯題庫，歸類按卡文件位置；前兩輪正文自動進證據。若之後回退或重生成來源輪次，留意 來源已失效 角標並按需 確認仍有效。
3. 調試時的查詢順序¶
在 人物卡錯題 內先搜當前卡；未命中再看 其它錯題 與同頁的跨卡查詢。若使用卡片 Agent，它會調用插件註冊的工具，順序與面板一致。
4. 把成熟結論迴流到 skill¶
選中條目 → 迴流到 Skill → 選自建 skill 與目標文件（默認 references/錯題庫迴流.md）→ 可選開啓自動同步。需要長期可檢索的「診療手冊」時用這條鏈路；專屬預設等卡片屬性不必寫進錯題本。
5. 排查前看卡腳本與通用腳本¶
切到 卡腳本 確認該卡裝了哪些腳本與控制器；在 通用腳本 裏批量給 MVU 卡裝卸共用腳本，或用「檢測適合的卡」做快速匹配。
適用場景與注意¶
適合誰： 長期在 DSH Tavern 裏維護多張人物卡、反覆調試 MVU/正則/腳本鉤子的開發者；需要和卡片 Agent 共用同一錯題索引的場景；希望把已驗證結論沉澱到自建 skill 的人。
注意：
- 插件依賴社區維護，SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。
- 只查錯題庫或只查宿主改卡記憶都可能漏信息；檢索時兩處對照更穩妥。
- 「記進錯題庫」與來源失效標記依賴 Tavern 插件接口 v2；舊版 Tavern 可能缺少側欄與消息下入口，但不影響其它頁籤。
- 迴流與自動同步只改帶 wrongbook 標記且未被手工編輯的段落；改 skill 裏某段後該段不再被同步覆蓋。
- 安裝前請審查 GitHub 倉庫 源碼與權限影響，勿在未覈對的情況下在生產環境盲目啓用。
結尾¶
dsh-tavern-wrongbook 把「哪張卡、什麼現象、怎麼修」留在卡名下的錯題本里，並用固定檢索順序和 Skill 迴流把結論帶到下一次調試。目錄與文檔：
