硬幣收藏規劃方法論
使用時機
- 使用者上傳 Numista CSV 匯出檔案，並要求進行缺口分析
- 使用者問「我的 [系列] 還缺哪些」
- 使用者想開始一個新系列，需要完整清單
- 使用者要求硬幣展購物清單或購買優先順序
- 使用者希望根據現有收藏模式獲得系列建議
步驟 1：解析 Numista 匯出檔
相關的 CSV 欄位：
Country, Issuer, Ruling authority, Title, Type, Face value,
Reference, N# number, Gregorian year, Mintmark, Composition,
Grade, Collection, Comment
關鍵解析模式：
設計名稱提取 — 名稱位於肖像資訊後的括號內：
import re
m = re.search(r'（(.*?)）', title)
design_name = m.group(1) if m else title
多肖像系列（英國） — 移除肖像前綴：
m = re.search(r'portrait;\s*(.+?）', title)
過濾非流通幣（若收藏者排除銀/金精鑄幣）：
if 'silver' in comp.lower() and 'clad' not in comp.lower():
continue # 跳過純銀幣
去重 (設計, 年份, 鑄造廠) — 相同設計+年份+鑄造廠視為同一枚，記錄數量。
步驟 2：建立系列主清單
研究來源（按可靠性排序）：
- Numista 目錄頁面 — 具權威性的 KM 編號、日期、材質
- 網路搜尋系列概述（PCGS、NGC 文章，中國百度百科）
- 交叉比對使用者 Numista 匯出檔的 N# 號碼與已知系列
從收藏模式識別系列：
- 查看
Type欄位：「流通紀念幣」 vs 「標準流通幣」 - 依面額 + 材質分組以識別系列
- 檢查年份範圍是否為連續序列（缺口 = 缺少的硬幣）
常見系列結構：
| 國家 | 系列 | 面額 | 格式 | 年份 |
|---|---|---|---|---|
| US | 50 州 25 美分 | 25c | Cu-Ni 包覆 | 1999-2008 |
| US | DC 及領地 | 25c | Cu-Ni 包覆 | 2009 |
| US | 美麗美國 | 25c | Cu-Ni 包覆 | 2010-2021 |
| US | 美國女性 | 25c | Cu-Ni 包覆 | 2022-2025 |
| UK | 圓形英鎊徽章 | £1 | Ni-Brass | 1983-2015 |
| UK | 十二邊形英鎊 | £1 | 雙金屬 | 2016-至今 |
| China | 生肖紀念幣 | 10 元 | 雙金屬 | 2015-2026 |
| China | 世界文化遺產 | 5 元 | 黃銅 | 2002-2006 |
| China | 世界遺產名山 | 5 元 | 黃銅（方形） | 2019-至今 |
| China | 京劇 | 5 元 | 黃銅 | 2023-2027 |
| China | 國家公園 | 10 元 | 雙金屬 | 2023-至今 |
| China | 書法「和」字 | 5 元 | 黃銅 | 2013-2022 |
| China | 台灣名勝 | 5 元 | 黃銅 | 2003-2005 |
| China | 紅皮書動物 | 5 元 | 銅 | 1995-1998 |
| India | 土邦國 | 多種 | 多種 | 多種 |
步驟 3：缺口分析
建立已收集集合：
collected = {} # (設計名稱, 年份) -> 鑄造廠集合或數量
與主清單交叉比對：
for year, name in master_list:
if (name, year) in collected:
status = "HAVE"
else:
status = "NEED"
鑄造廠變異系列（美國 25 美分）：
分別追蹤 P 與 D。以兩欄顯示 — 已收集者加粗，未收集者淺灰。
單一變異系列（英國英鎊、中國紀念幣）：
簡單勾選框。
步驟 4：建議新系列
當使用者問「我還應該收藏什麼」時，套用以下篩選條件：
相容性標準：
- 相同面額/格式作為現有收藏（若使用者收集 5 元黃銅幣，建議其他 5 元黃銅系列）
- 相同價格範圍 — 流通紀念幣，非精鑄/金條幣
- 可完成 — 有限系列且已知總數
- 可取得 — 硬幣仍可從經銷商以合理價格購得
- 主題匹配 — 收藏者陳述的興趣（見下方收藏者檔案）
建議的優先排序：
- 高：相同格式、相同國家、少於 20 枚、便宜、易取得
- 中：相同國家、不同格式但可負擔
- 低：不同國家但主題匹配
步驟 5：購物清單
針對硬幣展：
- 依地理性優先排序（當地幣展最適合當地與區域硬幣，例如南印度的幣展是南印土邦國的最佳尋寶地）
- 依優先級分組：高（可能出現）、中（詢問經銷商）、專業（僅限專業經銷商）
- 包含經銷商會辨識的特定面額名稱
- 加入空白勾選框，以便在幣展現場打勾確認
針對線上購買：
- 標記哪些是常見流通幣（便宜）vs 紀念幣（較高溢價）
- 標示任何稀有或收藏者需求高的硬幣
步驟 6：輸出
使用 a5-coin 技能產生適合活頁夾的 PDF，或使用 openpyxl 產生 Excel 以供數位追蹤。
Excel 輸出欄位：
序號, 官方名稱, 年份, 面額, 目前州/國家, 地區, 英國時期（印度）, 已收藏？, 擁有數量, 優先級
PDF 輸出：
使用 a5-coin 技能 — Carlito 字型、灰階、6 孔打洞、連續排版。
收藏者檔案（請自行填寫）
保持此區塊簡短，並隨著收藏變更而更新。技能會用它來產生建議與購物清單。
- Numista 使用者名稱：<您的帳號>
- 收藏大約數量：<數字>
- 活躍子收藏：<例如 British Round Pounds, Chinese Lunar Zodiac, US Quarters>
- 列印：<彩色 / 灰階>，活頁夾：<A5 Filofax / 其他>
- 居住城市（供硬幣展清單使用）：<城市>
- 排除項目：<例如無銀/金精鑄幣>
已知缺口（日期）
- <系列>：<已有>/<總數>，缺少 <清單>