> For the complete documentation index, see [llms.txt](https://ndw777.gitbook.io/manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ndw777.gitbook.io/manual/getting-started.md).

# 開始使用

從下載到查得到第一筆資料，大約十分鐘。

1. [下載與啟動](/manual/getting-started/install.md)——下載、放哪裡、第一次開啟會看到什麼
2. [準備查詢檔](/manual/getting-started/prepare-database.md)——下載開放資料並合併成查詢檔，**沒有查詢檔，各查詢分頁會抓不到資料，無法顯示**
3. [軟體更新](/manual/getting-started/updating.md)——程式內更新怎麼運作、失敗了怎麼辦

## 先認識三個名詞

手冊裡會一直出現這三個詞：

**資料集**：一份開放資料，例如「全部藥品許可證資料集」「健保用藥品項查詢項目檔」。來源清單放在 `data/opendata/opendata.xlsx`，目前 25 筆。

**查詢檔**：把所有資料集合併成的單一 SQLite 檔，檔名像 `allin1_20261022.db`，放在 `data/opendata/`。所有查詢分頁讀的都是它。檔名裡的日期是製作日期。

**成分查詢檔**：另一個檔 `ingredient_*.db`，只有「同成分查詢」分頁會用。它直接讀原始 CSV 製作，**不會跟著查詢檔一起更新**，要自己重做。

## 鍵盤

兩顆鍵在大部分分頁都有用，而且**游標不在輸入框裡也有效**——它們只對目前顯示中的那個分頁作用：

| 鍵         | 做什麼                   |
| --------- | --------------------- |
| **Enter** | 查詢／搜尋／計算，等於按下該分頁的主要按鈕 |
| **Esc**   | 清除，把該分頁的查詢條件**整排**清空  |

> **Esc 是整排清掉**，不是只清游標所在的那一格。條件填到一半突然全空，多半就是按到它了。

各分頁的差異：

<table><thead><tr><th width="325.26446533203125">分頁</th><th width="252.826171875">Enter</th><th>Esc</th></tr></thead><tbody><tr><td>查詢類分頁（藥品整合查詢、同成分、西藥許可證、醫療器材、藥品外觀、藥局、特約機構、健康食品、特殊營養、食品原料）</td><td>查詢</td><td>清除全部條件</td></tr><tr><td>產品回收</td><td>搜尋</td><td>重設條件</td></tr><tr><td>網站快搜</td><td>搜尋</td><td>清除</td></tr><tr><td>中藥基準方、藥品短缺查詢</td><td>查詢（游標要在關鍵字欄裡）</td><td>－</td></tr><tr><td>領藥日計算</td><td>重新計算</td><td>－</td></tr><tr><td>哺乳用藥安全</td><td>查詢；游標在結果清單上時開啟完整網頁</td><td>清除</td></tr><tr><td>查閱給付規定</td><td>跳到下一個符合處</td><td>關閉搜尋列</td></tr><tr><td>各種彈窗與對話框</td><td>確定</td><td>關閉／取消</td></tr></tbody></table>