# MagiCart 快速入門手冊

歡迎！[MagiCart](https://magicart.io) 是一個專為卡牌收藏與交易設計的智慧管理工具。
本手冊將帶你快速上手，學會如何搜尋、新增、整理與下載你的卡片清單。
如有問題可寄信至：[[e-mail]](mailto:[e-mail])

> **Last Updated:** 10/11/25

---

## 註冊、登入與進入我的 Deck

### 1️⃣ 建立帳號
1. 進入 MagiCart 首頁後，點擊右上角的「Sign up」按鈕
2. 輸入Email 與密碼
3. 註冊成功後系統會寄送驗證信，點擊連結後自動導向登入頁面

---

### 2️⃣ 登入帳號
1. 在登入頁面輸入註冊時的 Email 與密碼
2. 點擊「Login」後即可進入My Deck頁面

---

### 3️⃣ 進入「My Decks」
1. 登入後，會自動導入到「My Deck」
2. 預設會自動新增一個「My Collection」
3. 點擊「Open Deck」，可開始新增或整理卡片


> 📁 **提示：** 每個帳號預設可建立3個 Deck，方便依系列或用途分類。

---
## 管理我的 Deck (新增/刪除/重新命名)

除了預設的「My Collection」，您還可以建立、命名或刪除不同的 Deck，方便管理不同主題的收藏。

### 🗂️ 新增 Deck
1. 在「My Decks」頁面，點擊「Create New Deck」按鈕。
2. 在彈出的視窗中輸入新的 Deck 名稱，然後點擊「Create Deck」。
3. 新的 Deck 將會出現在您的清單中。


### 重新命名 Deck
1. 在「My Decks」頁面，找到您想重新命名的 Deck。
2. 點擊 Deck 名稱旁邊的「⋮」圖示，選擇「Edit Deck」。
3. 輸入新名稱後儲存，即可完成。

### 刪除 Deck
1. 同樣在「⋮」選單中，選擇「Delete Deck」。
2. 系統會要求您再次確認，點擊「Delete」後即可永久刪除該 Deck 及其包含的所有卡片。

> 💡 **提示：** 刪除 Deck 是無法復原的動作，請謹慎操作！

---

## Deck總覽

每個Deck預設都有四個清單：Owned, Wishlist, Considering, For Trade

- 可搜尋卡片名稱或直接從Scryfall拖曳卡片到想存放的清單
- 可依收藏狀態建立不同清單，方便分類管理


---

### 🔢 重新排列清單順序

你可以自由調整清單的顯示順序，讓最常用的清單排在前面。

1. 在 Deck 看板頁面，點擊右上角的「Reorder Lists」按鈕
2. 在彈出的視窗中：
- 使用拖曳方式重新排列列表順序
- 或使用上下箭頭按鈕調整順序
3. 點擊「Save Order」儲存新的順序
4. 看板會立即反映新的列表排序

> 💡 **提示：** 建議將最常使用的列表（如 Wishlist）排在前面，提升使用效率！

---

## 清單管理

除了預設的四個清單（Owned、Wishlist、Considering、For Trade），你可以建立自己的自定義列表，更靈活地管理卡片。

### 📋 新增自定義清單
1. 在 Deck 看板頁面，點擊右上角的「Add List」按鈕
2. 在彈出的視窗中：
- 輸入清單名稱（例如：「主牌組」、「備牌」、「待售高價卡」等）
- 清單圖示
- 清單描述 (可選填)
3. 點擊「Create List」完成建立

### 📦 編輯自定義清單
1. 點擊列表標題旁的「✏」圖示
2. 修改名稱、描述或圖示
3. 點擊「Update List」儲存變更

### 刪除自定義清單
1. 點擊列表標題旁的「🗑」圖示
2. 會出現確認刪除視窗
3. 點選「Delete List」即刪除

> ⚠️ **重要提示：** 刪除清單會將其中包含的所有卡片**永久移除**，此操作無法復原。

> ⚠️ **注意：** 預設的四個清單（Owned、Wishlist、Considering、For Trade）無法刪除或重新命名

---

## 新增卡片
MagiCart支援以下兩種方式將卡片新增到Deck中

### 🔍 搜尋
1. 在上方搜尋欄輸入卡牌名稱（建議使用英文）
2. 按下搜尋按鈕，會先顯示前10筆搜尋結果
3. 點擊「➕ 」即可將該卡加入清單
- 預設將會把卡片加入Wishlist清單，可以在搜尋前調整


### 🎴 從 Scryfall 直接拖曳卡片
MagiCart 支援直接從 Scryfall 拖曳卡片圖片到看板，無需手動搜尋！
操作步驟：
1. 開啟你想新增的卡片的Scryfall頁面

2. 拖曳卡片圖片
將 Scryfall 上的卡片圖片拖曳到 MagiCart 看板視窗，會出現4個彩色 Drop Zone將卡片拖曳到想要的清單上方

3. 將卡片拖曳到想要的清單上方，放開滑鼠後，卡片會自動新增到該清單

> 🚀 使用此功能可大幅加快建立清單的速度，不必來回切換搜尋！

---

## 🖼️ 卡片圖片顯示切換

你可以根據使用習慣隨時切換是否在看板上顯示卡牌的圖片。

### 切換顯示模式
1. 在 Deck 看板頁面，右上角有「Show Card Images」切換開關
2. 點擊開關會切換開啟/關閉卡片圖片顯示：
- **開啟**：顯示卡片縮圖，視覺化瀏覽收藏
- **關閉**：只顯示卡片資訊（名稱、稀有度、價格等），節省空間並加快載入速度

### 使用建議
- **顯示圖片**：適合瀏覽收藏、挑選卡片時使用
- **隱藏圖片**：適合管理大量卡片、專注於數量與價格統計時使用

> 🚀 **效能提示：** 如果清單中有大量卡片，關閉圖片顯示可以提升頁面載入速度

---

## 🔄 在清單之間移動卡片

MagiCart 提供多種方式讓你靈活管理卡片的狀態，輕鬆在不同清單之間移動卡片。

### 方式一：拖曳移動（推薦）
1. 將滑鼠移到想移動的卡片上
2. 按住滑鼠左鍵並拖曳卡片
3. 拖曳到目標清單的任意位置
4. 放開滑鼠，卡片會自動移動到新清單

> 💡 **提示：** 拖曳時可以調整卡片在清單中的順序位置！

### 方式二：使用移動按鈕
1. 點擊卡片右上角的「⋮」開啟選單
2. 選擇「Move Left」或是「Move Right」
3. 卡片會立即移動到其左邊或右邊相鄰的清單

> 🚀 **應用範例：**
> - 將 Wishlist 中已購買的卡片拖曳到 Owned 清單
> - 將 Considering 中確定想要的卡片移動到 Wishlist
> - 將 Owned 中想出售的卡片移動到 For Trade

---

## 💵 卡片價格顯示
MagiCart 會從 Scryfall 取得每張卡牌的單價，顯示在卡牌右下方


> 💡 卡片單價來自TCGPlayer，幣值USD
> 💵 價格旁若有 ★ 表示閃卡/蝕刻版的價格

### 💰 列表統計資訊
每個清單的標題下方會自動顯示該清單的總價值統計，幫助你快速了解收藏價值
- **總價值**：列表中所有卡片的總價值（卡片單價 × 數量）
- 顯示位置：列表名稱下方，以綠色的美元符號 $ 顯示
- 自動更新：當你新增、移除或調整卡片數量時，總價值會即時更新

---

## 🔢 調整卡片張數

1. 在清單中找到已新增的卡牌
2. 點擊「－」或「＋」按鈕可快速調整卡牌數量
3. 調整後系統會自動儲存變更

> 💡 當數量變為 0 時，卡片會自動從清單中移除

---

## 🗑️ 刪除卡牌
當你不再需要某張卡牌時，可以將它從清單中移除。MagiCart 提供兩種刪除方式：
### 方式一：透過「⋮」選單刪除
1. 在卡片右上角點擊「⋮」開啟選單
2. 在選單中點擊「Remove Card」選項
3. 確認刪除
系統會彈出確認對話框，點擊「Remove」確認刪除，點擊「Cancel」取消


### 方式二：將數量調整為 0
點擊卡牌的「－」按鈕，當數量變為 0 時，卡牌會自動從清單中移除


> 💡 如果卡片數量不多（1-3 張），直接將數量減為 0 是最快的刪除方式！
> 💡 如果你只是暫時不需要追蹤某張卡，考慮將卡片拖曳到「Considering」清單保留
---

## 🔄 切換卡牌版本
同一張卡牌可能有多個不同的印刷版本（例如不同系列、閃卡等），以下說明如何切換卡牌版本：

1. 在卡牌右上角點擊「⋮」（三個點）開啟選單

2. 在選單中點擊「Change Version」選項

3. 系統會彈出對話框，顯示該卡牌的所有可用版本，如版本過多也可用搜尋功能

4. 點擊選擇想要的版本後，對話框會自動關閉，完成切換新版本

5. 完成切換，卡牌價格、系列資訊會更新為新版本，數量與備註不受影響



---
## 📝 為卡片新增備註

您可以為每一張卡片新增個人備註，例如卡片來源、交易對象、或特殊標記。

1. 在卡片右上角點擊「⋮」開啟選單。
2. 選擇「Edit Note」選項。
3. 在彈出的視窗中輸入您的備註文字，點擊「Save」。
4. 儲存後，備註會顯示在卡片資訊的底部。


> 🚀 **應用範例：** 可標註「Foil（閃卡）」、「From TCGPlayer」、「Trade with John」等資訊。

---
## 📋 複製卡牌名稱

在卡牌上點擊「📄 」，系統會自動將卡牌名稱複製到剪貼簿。方便貼上至其他網站或應用程式中。


> 💡 **應用範例：** 可貼到 EDHREC、記事本或瀏覽器搜尋列。

---

## 💾 下載整個清單 (TXT)

1. 點擊右上角「📥」按鈕
2. 系統會自動產生一份 `.txt` 檔案 (MTGO用格式)
3. 檔案內容包含每張卡的名稱與數量，方便列印、分享、或上傳至其他平台


> 📑 **檔案格式範例：**

4 Lightning Bolt
2 Counterspell
1 Sol Ring

---
## 🔗 快速搜尋與購買連結

每張卡牌下方提供多個快速連結，方便你在不同平台上搜尋、購買或查詢卡牌資訊。

### 🛒 露天拍賣
點擊「露天拍賣」按鈕會自動開啟 [露天拍賣](https://www.ruten.com.tw) 並帶入該卡名稱搜尋，方便從台灣店家購入單卡。

### 🎮 GameSquare
點擊「GameSquare」按鈕會開啟 [GameSquare](https://www.gamesquare.tw) 並搜尋該卡牌，可查詢遊戲平方的庫存與價格。

### 🧙‍♂️ Scryfall
點擊「Scryfall」按鈕會開啟該卡在 [Scryfall](https://scryfall.com) 的官方頁面，查看完整的卡牌資訊、裁示、不同版本等詳細資料。


> 🌍 **提示：** Scryfall建議使用英文搜尋最準確也最快，可搭配複製卡名功能來快速複製卡名

---

## 🔗 公開清單（分享公開網址）
MagiCart 讓你輕鬆產生公開清單的分享連結，與其他玩家分享你的 Wishlist 和 For Trade 卡片清單，方便進行卡牌交易與交流。

### 功能特色
* ✨ 一鍵產生公開連結 - 無需註冊或登入即可查看
* 🔒 隱私控制 - 可隨時設為私密，停止分享
* 📝 自訂標題 - 自由命名你的交易清單
* 💬 聯絡資訊 - 可選填聯絡方式，方便買家聯繫
* 📋 快速複製連結 - 一鍵複製，分享到社群媒體或論壇

### 操作步驟
1. 在 Deck 看板右上角點擊「Share」按鈕

2. 會開啟公開清單設定視窗，包含以下設定：

- 清單標題 (Title)
- 預設格式：Trade List 2510101932（時間戳記）
> 💡 清單標題可自訂任意名稱，例如：John's Wishlist、急徵！EDH 缺卡清單 等
- 公開網址切換（Public/Private）
- 開啟：任何人只要有連結就能查看
- 關閉：停止分享，連結失效（原連結無法訪問）
- 聯絡資訊（Contact Info - 選填）
- 可填寫你的聯絡方式，方便交易對象聯繫

3. 點擊「Copy 」按鈕，系統會自動複製連結到剪貼簿


### 公開清單顯示內容
當訪客開啟你的公開清單時，會看到以下資訊：
* 📌 清單標題
* 📞 聯絡資訊（如有）
* 🕐 最後更新時間：清單的最新修改時間
* 🎴 清單會顯示兩個區塊：
* 💙 Wishlist：你想收購或交換的卡牌
* 🧡 For Trade：你願意出售或交換的卡牌
* 清單都會顯示卡片名稱、數量、備註、卡圖預覽 (來自Scryfall)

> 💡 分享頁面是唯讀模式，訪客無法修改你的清單內容

### Grid View (視圖模式)

### List View (清單模式)

### 管理分享設定
* 修改標題、聯絡資訊或公開狀態，系統會自動儲存變更
* 連結不會改變，訪客開啟時會看到最新內容

### 如何停止分享公開清單
* 點擊「Share」按鈕後開啟設定視窗，將「Public」的On切換為Off，原分享連結會立即失效
* 切換回「Public」即可恢復分享

---

## 🎨 主題切換（深色/淺色模式）

MagiCart 支援深色模式與淺色模式切換，讓你依照個人喜好或環境光線選擇最舒適的顯示模式。

### 切換主題
1. 在 Deck 看板頁面，點擊右上角的「⚙️」設定按鈕
2. 點擊「Theme」選項會開啟主題選單
3. 選擇你想要的模式：
- **Light**：淺色模式，適合明亮環境
- **Dark**：深色模式，適合低光環境或夜間使用
- **System**：自動跟隨系統設定

### 主題特色
- 即時切換，無需重新載入頁面
- 設定會自動儲存，下次登入時保持你的偏好
- 深色模式採用護眼配色，減少眼睛疲勞

> 💡 **提示：** 選擇「System」模式，MagiCart 會自動配合你的作業系統或瀏覽器的主題設定

---

## ✅ 結語

透過以上功能，MagiCart 讓你的卡牌管理更加輕鬆、高效。
無論你是收藏家、新手玩家或店家管理者，都能快速掌握所有卡片資訊。

本手冊可於MagiCart內的Quick Guide按鈕點擊開啟

---
© 2025 MagiCart