Orca Doctor Card × Vibe 擴充讓你透過已連線的 AI 客戶端查詢、建立及維護醫師卡資料。本篇專門說明醫師卡的草稿、欄位與發布流程，適用於已安裝 Orca Doctor Card 的網站。
一、先完成 Vibe 連線與醫師卡外掛設定
請先依虎鯨網站助理 Vibe 基礎教學完成 MCP 連線、帳號權限及 IP 白名單設定，並啟用相容版本的 Orca Doctor Card 與支援醫師卡工具的 Vibe。若找不到工具，請網站管理者更新外掛並重新整理客戶端工具清單。
在 Vibe 後台依工作需要開啟醫師卡工具。發布醫師資料預設關閉，需另外開啟；連線帳號仍須具備對應的編輯或發布權限。本文說明操作方式，不代表你的網站已完成安裝或設定。
二、認識 Vibe 的五個醫師卡工具
啟用相容版本的 Orca Doctor Card 後，Vibe 會提供五個醫師工具。這些工具維護的是 orca_doctor 醫事人員資料，包括卡片與個人頁所用欄位。
| 工具名稱 | 用途 |
|---|---|
search-doctors | 先搜尋姓名，避免重複建立醫師。 |
get-doctor | 讀取完整欄位、院所科別，以及可插入文章的區塊與短代碼。 |
create-doctor-draft | 建立草稿，必填姓名與英文 slug。 |
update-doctor | 更新指定 doctor_id 的資料，不更改發布狀態。 |
publish-doctor | 確認後發布；需先在 Vibe 後台開啟此功能。 |
三、查詢既有資料並建立醫師草稿
先搜尋是否已有醫師資料。院所與科別使用既有分類 ID，請讓 AI 用 list-taxonomies 查詢 orca_doctor_org 與 orca_doctor_department，不要猜 ID。若缺少分類，可先在醫師卡後台新增，再回來指派。
預覽並建立醫師草稿
以下內容為示範，請替換成已確認的醫師資料。沒有圖片時先省略圖片欄位即可，不需要為了建立草稿臨時抓取替代照片。
{
"name": "示範醫師",
"slug": "sample-doctor",
"job_title": "專科醫師",
"bio": "<p>請填入經確認的醫師簡介。</p>",
"specialties": [
"專長一",
"專長二"
],
"enable_schema": true,
"dry_run": true
}這段輸入交給 create-doctor-draft。先確認預覽的 planned，再以相同資料改為 dry_run:false 執行；成功會回傳 doctor.id，狀態固定為草稿。之後更新時，請使用這個實際 ID。
四、更新圖片、連結與院所科別
| 欄位 | 填寫方式 |
|---|---|
featured_image_id | 醫師大頭照的媒體庫圖片 ID。 |
card_image_id／card_image_alt | RSS 卡片圖片 ID 與替代文字。 |
organization_ids／department_ids | 查詢所得的院所／科別 ID 陣列，可複選。 |
facebook_url／instagram_url／profile_url | Facebook、Instagram 與個人官網網址。 |
profile_label／search_text／social_label | 卡片小標、搜尋框文字與社群稱呼。 |
enable_schema | true 開啟、false 關閉 Physician Schema；新增省略時預設開啟。 |
更新時，省略欄位代表保留原值。文字填空字串可清除，專長或分類填 [] 可清除，圖片 ID 填 0 可清除；卡片小標留空時使用醫師卡的全站預設。姓名、專長與學經歷應使用你提供並確認的內容。
五、確認後發布，再插入文章
先用 get-doctor 回讀資料，再用 publish-doctor 預覽。下例的 123 只是示範，務必替換成剛才取得的醫師 ID：
{
"doctor_id": 123,
"dry_run": true
}確認無誤後，正式發布輸入為：
{
"doctor_id": 123,
"confirm": true
}更新或發布時也可附帶最新讀回的 expected_modified_gmt，避免覆蓋已變動的資料。若回報修改時間衝突，先重新讀取；若回報「可能已部分寫入」，先查回傳的醫師 ID，不要直接再新增一份。
發布後開啟回傳的個人頁網址確認內容。get-doctor 會提供文章用的 block_markup、shortcode，以及個人頁與 RSS 模式短代碼；複製回傳內容放入文章即可，工具不會自行插入其他文章。使用一般短代碼時，可在 WordPress 編輯器新增「短代碼」區塊再貼上。
六、常見問題 FAQ
為什麼找不到醫師卡工具，或無法發布醫師？
請先確認 Orca Doctor Card 已啟用，且版本提供院所、科別與完整個人頁所需功能，再重新整理工具清單。發布醫師資料預設關閉，需在 Vibe 後台啟用，連線帳號也須具備發布權限；真正發布時另需 confirm=true。
醫師沒有照片或 RSS 卡片圖，可以先建立資料嗎？
可以。先以姓名與英文 slug 建立草稿，圖片欄位可以省略，之後再補上媒體庫圖片 ID。發布時若缺少大頭照、RSS 圖片、院所或科別會提供提醒，但不會因此阻擋；未設定 RSS 圖片時，沿用醫師卡外掛的文字備援輸出。
發布醫師資料後，會自動出現在指定文章內嗎？
不會。發布是讓醫師資料進入公開狀態；若要放進指定文章，請用 get-doctor 取得 block_markup 或 shortcode，再由編輯者插入文章。完成後開啟醫師個人頁與該篇文章，分別確認資料及卡片顯示。
若尚未完成 AI 連線，請先回到Vibe 基礎設定教學；其他外掛操作可到虎鯨 WordPress 外掛教學分類查閱。
