KDP Hub 使用指南

Hub 0.24.41 · 原文查核 2026-10-28 · 15 章節,60 張圖片

KDP Hub 使用指南

Cortex 來源版本 2 · 更新 2026-10-28 15:16

第一次使用 Hub,從安裝手冊開始;已經裝好,直接依操作手冊找要做的事。

我現在要做什麼 從這裡開始
下載、安裝、登入或換電腦 安裝手冊
安裝工具、管理版本與日常使用 操作手冊
找不到功能、更新或連線出錯 常見問題與排查流程

圖 1:Hub 工具列表與右側詳情;點選工具後確認授權、平台與版本。

圖 1|Hub 工具列表與右側詳情;點選工具後確認授權、平台與版本。

先完成這五步

  1. 從官方下載頁選平台與版本,完成安裝。
  2. 開啟 Hub,從左下角登入自己的 KopherBit 帳號。
  3. 核對目前工作區與授權,再安裝要使用的工具。
  4. 平常從「工具」安裝/開啟,從獨立的「更新」頁處理更新。
  5. 遇到問題,先看健康狀態與診斷;需要回報時附上步驟、版本及圖片。

三個狀態分開看

狀態 代表什麼
已安裝 這台電腦的 Hub 已安裝該工具
已授權 目前帳號有對應使用權;不等於工具已經安裝
MCP 已連線 目前工具連線可用;保存的工具清單不能代替連線結果

依任務找章節

版本與畫面說明

本手冊查核日期為 2026-10-28,主要畫面取自 Windows x64 的 Hub 0.24.41 原版程式,在獨立 E2E 電腦使用既有 LAB 測試帳號擷取。下載頁另以正式網站核對。畫面中的帳號、點數、專案與工具版本是測試示例,請以自己的帳號與當前下載頁為準。

Code/工作區須先開啟 Beta,預設不顯示;Linux 安裝包依實際發布版本選擇,沒有用 Windows 畫面代替 Linux 原生驗收。配色可在「設定 → 一般」切換,故首次啟動畫面與後續藍色示範可能略有不同。

返回目錄 · 線上閱讀

KDP Hub 安裝手冊

Cortex 來源版本 2 · 更新 2026-10-28 15:09

本冊帶你完成下載、安裝、首次登入與維護。主要示範平台是 Windows x64;Linux 與無桌面登入另列一章。

圖 1:正式下載頁的 Windows x64 MSI;版本以下載當時頁面為準。

圖 1|正式下載頁的 Windows x64 MSI;版本以下載當時頁面為準。

依序操作

章節 完成後應看到
01 Windows 下載與安裝 能從開始功能表開啟 Hub
02 登入、授權與首次啟用 左下角顯示帳號,授權頁可確認使用權
03 Hub 更新、重裝與解除安裝 知道如何查版本、更新與移除程式
04 Linux 與無桌面 CLI 登入 能選擇實際可用的 Linux 包,理解跨電腦授權流程

安裝前準備

  • 確認作業系統與處理器架構,預留安裝及工具下載空間。
  • 準備自己的 KopherBit 登入方式;公司網路若需 Proxy,先取得正確設定。
  • 已有舊版時,先保存工作並正常退出 Hub;安裝包與更新包不要自行混用。

下載頁的最新版本不代表每個平台都有同一版本。 2026-10-28 核對時,Windows 提供 0.24.41;該版沒有 Linux 包,Linux 可在其他已發布版本選擇,macOS 顯示 Coming soon。以頁面當下的實際狀態為準。

安裝後,接續工具管理;遇到問題可直接查排查流程。


返回KDP Hub 使用指南 · 使用指南首頁

返回目錄 · 線上閱讀

Windows 下載與安裝

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:KDP Hub 0.24.41、Windows x64。安裝前先準備可連網的電腦、足夠磁碟空間,以及可完成安裝提示的 Windows 權限。請從官方下載頁取得安裝包;不要使用聊天附件或來路不明的轉存檔。

下載正確的安裝包

  1. 開啟 KDP 下載頁。
  2. 選擇 Windows 與 x64,核對版本後下載 MSI。
  3. 等候下載完成,再開啟檔案。檔名中的版本應與下載頁一致;若頁面未提供該平台,請勿改下載其他平台的檔案。

圖 1:先核對版本、Windows、x64 與 MSI,再下載。

圖 1|先核對版本、Windows、x64 與 MSI,再下載。

要確認的項目 正確判斷方式
平台 選 Windows x64;MSI 是 Windows 安裝包
版本 依下載頁目前提供的版本,不以舊截圖判定最新
安裝來源 使用官方 HTTPS 下載頁

執行安裝精靈

  1. 關閉正在執行的 Hub。只按視窗右上角關閉可能仍留在系統匣,必要時從系統匣退出。
  2. 開啟 MSI,在 Welcome 頁按 Next。
  3. 在目的地頁核對安裝位置;一般使用者保留預設即可。
  4. 依序按 Next/Install,閱讀系統顯示的發布者與權限要求。安裝完成後按 Finish。
  5. 從開始功能表啟動 KDP Hub。先確認工具列表能載入,再進行帳號登入。

圖 2:MSI 歡迎頁:按 Next 開始。

圖 2|MSI 歡迎頁:按 Next 開始。

圖 3:安裝目的地:核對路徑後按 Next。

圖 3|安裝目的地:核對路徑後按 Next。

圖 4:準備安裝:確認後按 Install,依系統提示完成。

圖 4|準備安裝:確認後按 Install,依系統提示完成。

圖 5:啟動後的工具列表;此時尚未登入,接著完成帳號與授權確認。

圖 5|啟動後的工具列表;此時尚未登入,接著完成帳號與授權確認。

可依下列流程確認自己停在哪一步。

圖 6:操作流程:Windows 下載與安裝

圖 6|操作流程:Windows 下載與安裝

完成後依 登入、授權與首次啟用 操作。若找不到程式、安裝中斷或畫面停住,參考 常見問題,不要自行刪除 Hub 資料目錄。


返回KDP Hub|安裝手冊 · 使用指南首頁

返回目錄 · 線上閱讀

登入、授權與首次啟用

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:KDP Hub 0.24.41。準備可使用的 KopherBit/KDP 帳號與瀏覽器。Hub 登入與其他公司系統的登入不一定相同;不要因為能登入另一個系統,就判定這個帳號已有 Store 授權。

第一次啟動的使用資料說明

首次啟動可能先顯示使用資料說明。閱讀後依自己的選擇操作;若不希望分享使用資料,選 Turn off usage data。本輪示範採此選項,後續也可在「設定 → 隱私」查看。

圖 1:首次啟動的使用資料說明;可選擇不分享使用資料。

圖 1|首次啟動的使用資料說明;可選擇不分享使用資料。

在瀏覽器完成登入

  1. 啟動 Hub,按左下角 登入。
  2. 在登入頁按 使用瀏覽器登入。Hub 會顯示 在瀏覽器完成登入,此時保留 Hub 開啟。
  3. 在瀏覽器依當下提供的登入方式完成驗證。驗證碼、密碼只輸入正式登入頁,不要貼到對話或支援訊息。
  4. 完成後回到 Hub,確認左下角已顯示自己的帳號。若想取消這次登入,回到 Hub 按 取消登入,再重新開始。

圖 2:按「使用瀏覽器登入」。

圖 2|按「使用瀏覽器登入」。

圖 3:保留 Hub 開啟,在瀏覽器完成驗證;需要重來時可取消登入。

圖 3|保留 Hub 開啟,在瀏覽器完成驗證;需要重來時可取消登入。

圖 4:回到 Hub,左下角已顯示測試帳號的工作區。

圖 4|回到 Hub,左下角已顯示測試帳號的工作區。

確認方案與可用工具

  1. 點左下角帳號選單,開啟 授權。
  2. 查看 方案、授權權杖與離線、已安裝的工具。以工具實際顯示的已授權/未授權為準。
  3. 剛調整方案或授權時,按帳號選單的 重新同步授權,等候結果,再回到工具頁。
畫面顯示 下一步
已授權 可依工具頁提供的操作安裝或開啟
未授權/需要方案 核對帳號與方案,必要時聯絡管理員
需要更新 更新至最低支援版本以上再開啟
離線可用到 注意到期時間,盡快恢復連線同步

圖 5:授權頁分別列出方案、效期與工具狀態;示例是既有 FREE 測試帳號。

圖 5|授權頁分別列出方案、效期與工具狀態;示例是既有 FREE 測試帳號。

登入與工具授權分成兩步確認。

圖 6:操作流程:登入、授權與首次啟用

圖 6|操作流程:登入、授權與首次啟用

登入成功不代表每項付費功能都已開通。接著可閱讀 工具管理。本手冊畫面使用驗收帳號;你的方案、組織與工具清單可能不同。


返回KDP Hub|安裝手冊 · 使用指南首頁

返回目錄 · 線上閱讀

Hub 更新、重裝與解除安裝

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:KDP Hub 0.24.41。更新前先保存工具中的工作,關閉正在安裝或更新的工具。Hub 更新會更新管理程式本身;工具更新另見 工具更新與版本切換。

檢查並安裝 Hub 更新

  1. 在左側按 更新,再按 檢查更新。
  2. 查看上方 Hub 更新區域,核對目前版本與目標版本,可展開 更新內容。
  3. 有新版且條件允許時,按 更新並重新啟動。等候下載與安裝完成,不要同時啟動另一個安裝精靈。
  4. Hub 重新開啟後,由帳號選單進入 關於,核對新版本與建置編號。

圖 1:獨立更新頁。此示範已是目前版本,沒有可用的 Hub 更新。

圖 1|獨立更新頁。此示範已是目前版本,沒有可用的 Hub 更新。

圖 2:「關於」顯示 Hub 版本 0.24.41 與建置資訊。

圖 2|「關於」顯示 Hub 版本 0.24.41 與建置資訊。

狀態 處理方式
目前沒有 Hub 更新 本次檢查未找到適用新版
目前離線/檢查失敗 恢復網路後重新檢查,不能據此判定最新版
工具正在安裝或更新 等該操作完成,再更新 Hub

需要重裝或移除時

若自動更新失敗,先保留錯誤文字與版本資訊,再從官方下載頁取得適用平台的 MSI,依 安裝手冊 執行。不要把刪除資料夾當作重裝步驟。

需要解除安裝時,先由系統匣退出 Hub,再到 Windows 設定 → 應用程式 → 已安裝的應用程式,找到 KDP Hub 並選擇解除安裝。Windows 名稱可能依版本略有不同。移除 Hub 不等於取消雲端訂閱;帳號與方案請到官方帳號頁管理。個人資料是否保留,應以解除安裝提示及實際結果確認。

圖 3:Windows 11「已安裝的應用程式」:找到 KDP Hub,再開啟該列更多動作。

圖 3|Windows 11「已安裝的應用程式」:找到 KDP Hub,再開啟該列更多動作。

一般更新可按下列流程完成。

圖 4:操作流程:Hub 更新、重裝與解除安裝

圖 4|操作流程:Hub 更新、重裝與解除安裝

遇到無法確認的安裝問題,先收集 診斷資訊,再聯絡支援。

本輪核對了更新入口、About 版本及 Windows 移除入口;沒有可用新版,因此未執行自動更新或解除安裝。


返回KDP Hub|安裝手冊 · 使用指南首頁

返回目錄 · 線上閱讀

Linux 與無桌面 CLI 登入

Cortex 來源版本 2 · 更新 2026-10-28 15:09

本章於 2026-10-28 核對正式下載頁與 CLI 規範。Windows 最新版為 0.24.41;該版沒有 Linux 包,下載頁另有 0.24.38 的 Linux x64 AppImage/DEB。macOS 當時顯示 Coming soon。請選擇實際提供該平台的版本,不以跨平台共用版號推定有安裝包。

本輪只核對 Linux 下載入口與 CLI 原始規範,沒有改動 Linux E2E 機或宣稱 Linux 原生安裝、Device Code 流程已在本輪重測。

Linux 安裝入口

  1. 開啟 官方下載頁,先選擇有 Linux 包的版本(例如 0.24.38),再選 Linux、x64 與格式。
  2. 有 DEBIAN 安裝包時,可複製頁面提供的一行安裝命令;先閱讀命令中的網址與版本再執行。
  3. 依提示完成驗章、相依項目與套件安裝。需要提升權限的是套件安裝步驟,日常啟動 Hub 不要使用 root。

來源規範適用 Ubuntu 24.04+/Debian 12+;AppImage 與 DEB 是不同格式,不要任意互換更新方式。安裝包仍有作業系統與動態函式庫需求,沒有桌面並不代表沒有這些需求。

圖 1:選擇實際有 Linux 包的版本 0.24.38,再選 Linux 與 AppImage/DEB。

圖 1|選擇實際有 Linux 包的版本 0.24.38,再選 Linux 與 AppImage/DEB。

在另一台電腦完成登入

先將下方 kdp-hub 換成實際執行檔路徑。Windows PowerShell 需使用呼叫運算子與完整路徑,例如 & "C:\Program Files\KDP Hub\kdp-hub.exe" version --json。

kdp-hub version --json
kdp-hub auth login --device-code --no-browser --env prod
kdp-hub auth whoami --json --env prod
kdp-hub license sync --json --env prod
kdp-hub doctor --json --env prod
  1. 執行登入命令,保留終端機等待。
  2. 在可信任的另一台電腦開啟顯示的驗證網址,輸入這次短碼,核對帳號後確認。
  3. 回到原終端機,確認登入結束,再執行 whoami 與 license sync。
指令 用途
tools list --refresh --json 更新並讀取工具清單
tools info <id> --json 查看指定工具
auth logout --json 登出目前本機工作階段

無桌面登入的流程如下。

圖 2:操作流程:Linux 與無桌面 CLI 登入

圖 2|操作流程:Linux 與無桌面 CLI 登入

同一組操作須沿用同一個 OS 使用者與資料目錄。Linux serve 是有限的本機授權服務,不等於圖形工具或完整 AI 服務。若短碼過期,重新發起登入,不要重用舊碼。


返回KDP Hub|安裝手冊 · 使用指南首頁

返回目錄 · 線上閱讀

KDP Hub 操作手冊

Cortex 來源版本 2 · 更新 2026-10-28 15:09

Hub 管理工具、授權、更新與連線;日常使用先從左側「工具」開始。Code 是另外開啟的 Beta 工作介面。

圖 1:安裝完成後,列表與詳情均提供「開啟」入口。

圖 1|安裝完成後,列表與詳情均提供「開啟」入口。

按任務閱讀

你要處理的事 章節
找工具、安裝、開啟與移除 01 介面導覽與工具管理
查看可更新項目、版本紀錄或切換版本 02 工具更新與版本切換
建專案、選資料夾、切 Pro/Smart、看工程指引 03 Code、工作區與 AI 對話(Beta)
接外部 AI、Library 或自訂 MCP server 04 MCP 與外部 AI 連線
改外觀/語言/Proxy、確認帳號與授權 05 偏好設定、帳號與授權
找執行狀態、日誌與診斷資料 06 健康狀態、主控台與診斷
看紀錄、準備支援資料、貼圖回報問題 07 支援包、稽核與意見回饋
快速排除常見錯誤 08 常見問題與排查流程

快捷操作

操作 入口
搜尋與快速啟動 左上「搜尋」,或 Ctrl+K
帳號、授權、設定與登出 左下角帳號選單
檢查 Hub 與工具更新 左側「更新」
查 Hub 版本 狀態列版本或帳號選單「關於」
使用 Code 先開啟設定內的 Beta,再用左上產品切換選單

各章的畫面旁會說明「按哪裡、做什麼、完成後看什麼」。不需要按開發者設定,也不需要先設定 AI,才能使用基本工具管理。


返回KDP Hub 使用指南 · 使用指南首頁

返回目錄 · 線上閱讀

介面導覽與工具管理

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:Hub 0.24.41。左側是主要功能,中央是清單或內容,右側顯示選取工具的詳情。一般工具管理從 工具開始;不必先開啟 KDP Code。

找到並安裝工具

  1. 按左側 工具。上方可切換 全部、已安裝、可更新、未安裝,也可依工具分類縮小範圍。
  2. 點選工具列,查看右側 安裝狀態、授權、平台支援、版本紀錄。
  3. 確認有目前電腦的安裝包與所需授權,再按 安裝。等候下載、驗證及安裝完成。
  4. 按 開啟啟動工具,確認工具視窗確實出現。工具執行中會顯示對應狀態。

圖 1:點選未安裝的 Calibrator,右側顯示安裝、授權與平台資訊。

圖 1|點選未安裝的 Calibrator,右側顯示安裝、授權與平台資訊。

圖 2:實際安裝 Calibrator 的進度;請等候完成。

圖 2|實際安裝 Calibrator 的進度;請等候完成。

圖 3:安裝完成,版本與「開啟」按鈕出現。本輪沒有啟動硬體操作。

圖 3|安裝完成,版本與「開啟」按鈕出現。本輪沒有啟動硬體操作。

想做什麼 從哪裡操作
安裝/開啟工具 工具列表或右側詳情
查看更新 左側「更新」,或「可更新」入口
查版本與切換 右側「版本紀錄」
解除安裝/更多動作 右側工具的更多動作選單
查看已安裝的核心依賴 左側「核心元件」

管理已安裝工具

先保存工具內的檔案並正常關閉工具,再執行解除安裝或版本調整。右側的 平台支援依該版本實際發布的安裝包顯示「已提供/未提供/未確認」;不是每個工具、每個版本都有相同平台。

核心元件頁另外顯示 Hub 內附檔案、內建 MCP 伺服器與執行期函式庫。檔案存在只代表找得到它,不等於功能已驗收通過。一般使用者不需要手動改動這些檔案。

圖 4:右側更多動作選單;操作前先保存並關閉工具。

圖 4|右側更多動作選單;操作前先保存並關閉工具。

圖 5:核心元件頁提供內附元件、檔案與狀態資訊。

圖 5|核心元件頁提供內附元件、檔案與狀態資訊。

工具的基本使用順序如下。

圖 6:操作流程:介面導覽與工具管理

圖 6|操作流程:介面導覽與工具管理

若安裝後按鈕仍停用,先查看提示,再依 授權說明 或 排查流程 處理。

本輪已用 Hub 安裝 Calibrator 並確認「開啟」入口出現;未啟動工具、連接硬體或解除安裝其他工具。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀

工具更新與版本切換

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:Hub 0.24.41。更新頁只處理已安裝工具的更新;新工具安裝仍在 工具頁。開始前保存工具中的工作,並正常關閉要更新的工具。

更新已安裝工具

  1. 按左側 更新 → 檢查更新。
  2. 在 工具更新核對工具名稱、目前版本、更新版本、狀態。需要知道改了什麼,可展開 更新內容。
  3. 按該列 更新,等候下載、驗證、解壓及註冊完成。失敗時先讀錯誤原因,處理後再按 重試。
  4. 完成後重新開啟工具,核對實際版本。完成列約顯示 5 秒後移除;移除不代表工具被解除安裝。

圖 1:沒有待更新項目時的更新頁;此圖不是下載或更新進度示範。

圖 1|沒有待更新項目時的更新頁;此圖不是下載或更新進度示範。

圖 2:工具安裝完成的版本資訊;更新後也應重新核對版本。

圖 2|工具安裝完成的版本資訊;更新後也應重新核對版本。

狀態 要做的事
等待工具關閉 保存並關閉該工具後重試
需要授權 核對帳號、方案與同步結果
此平台尚未提供更新 等待該版本的平台安裝包,不換用其他平台檔案
目前離線/檢查失敗 恢復連線後再次檢查,不能判定已是最新

選擇指定版本

  1. 回到 工具,點選目標工具,查看右側 版本紀錄。
  2. 切換 正式版/測試版,展開需要的版本並閱讀內容。
  3. 核對平台包與最低支援版本,再按 切換到 v…。按鈕停用時,閱讀旁邊的原因。
  4. 切換完成後重新開啟並核對版本。正式工作優先選正式版;測試版須自行評估適用情境。

圖 3:展開版本紀錄查看舊版內容與切換入口;本輪只檢視,沒有執行降版。

圖 3|展開版本紀錄查看舊版內容與切換入口;本輪只檢視,沒有執行降版。

可先判斷自己需要一般更新,還是指定版本。

圖 4:操作流程:工具更新與版本切換

圖 4|操作流程:工具更新與版本切換

Hub 本身更新會重新啟動管理程式,另見 Hub 更新與重裝。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀

Code、工作區與 AI 對話(Beta)

Cortex 來源版本 3 · 更新 2026-10-28 15:13

適用:Hub 0.24.41 的 Beta 功能。這些功能尚在開發,預設隱藏;不要把本章當成正式工作流程的保證。本輪畫面介紹入口與操作方式,未據此宣稱付費 AI 回應、工具寫入或業務成果已驗收。

開啟 Code 並選擇工作資料夾

  1. 從帳號選單進入 設定 → Beta 功能,閱讀說明後開啟 顯示 Beta 功能。
  2. 由左上角應用程式選單切到 KDP Code。
  3. 按左側專案旁的 建立專案(+),選 本地資料夾 → 選擇…,指定這次要工作的資料夾,填入專案名稱或留白沿用資料夾名稱,核對位置後按 建立專案。不要為了方便而選整個磁碟。
  4. 在工作區清單中可釘選、重新命名或 從清單移除。移除登錄不會刪除磁碟上的資料夾。

圖 1:設定中開啟「顯示 Beta 功能」。

圖 1|設定中開啟「顯示 Beta 功能」。

圖 2:左上角應用程式選單新增 KDP Code。

圖 2|左上角應用程式選單新增 KDP Code。

圖 3:建立專案:選本地資料夾並核對專案名稱。

圖 3|建立專案:選本地資料夾並核對專案名稱。

圖 4:回到建立專案表單,確認選取路徑。

圖 4|回到建立專案表單,確認選取路徑。

圖 5:專案 DemoProject 已登錄在左側,接著可建立對話。

圖 5|專案 DemoProject 已登錄在左側,接著可建立對話。

建立與管理對話

  1. 按 新對話,確認目前選取的專案,再輸入明確的工作目標。
  2. 在輸入區的 Pro/Smart 選單選擇模型等級;旁邊的 Normal 是執行模式,並非模型等級。等對話執行結束後再切換;切換失敗時重新選擇並查看提示。
  3. 有附件時先核對檔名;送出後查看串流訊息與工具進度。需要中止時使用對話的停止操作,已完成的寫入不會因此自動復原。
  4. 從左側選回既有對話。查看成果面板與工程指引時,核對實際檔案/紀錄,不只閱讀 AI 的完成敘述。
模型模式 用途與限制
進階 (Pro) 較複雜工作;實際模型與費率由服務端配置
快速 (Smart) 日常較快速的互動;仍須核對結果
自備模型 到「AI 供應商」設定,不使用兩級點數選項替代

圖 6:新對話與 Pro 選項;Normal 是執行模式,不是模型等級。

圖 6|新對話與 Pro 選項;Normal 是執行模式,不是模型等級。

圖 7:實際將模型等級選為 Smart;此圖僅驗證選擇介面,沒有送出 AI 請求。

圖 7|實際將模型等級選為 Smart;此圖僅驗證選擇介面,沒有送出 AI 請求。

圖 8:示範專案與工程指引面板;此工作區尚未綁定 Library 專案。

圖 8|示範專案與工程指引面板;此工作區尚未綁定 Library 專案。

Beta 對話建議採小步執行。

圖 9:操作流程:Code、工作區與 AI 對話(Beta)

圖 9|操作流程:Code、工作區與 AI 對話(Beta)

關閉 Beta 會隱藏相關入口,不會刪除既有登錄。工具連線設定另見 MCP 與外部 AI。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀

MCP 與外部 AI 連線

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:Hub 0.24.41。MCP 連線頁包含不同用途的入口:外部 AI 操作 Hub、讓 AI 使用工具,以及 Library 連線。先選目標,再設定對應入口;看得到保存的清單不代表當下已連線。

讓本機 AI 查詢或操作 Hub

  1. 開啟左側 MCP 連線,找到 外部 AI 連接 Hub。
  2. 在 Windows 開啟 允許本機 AI 操作 Hub,再展開 Codex 連線設定。
  3. 複製畫面產生的指令到本機 Codex 設定,重新載入 MCP 連線,再查詢 Hub/工具狀態。
  4. 不再使用時關閉開關。本次許可不跨 Hub 重啟保留。

圖 1:展開 Codex 連線設定查看指令;此示範的允許操作開關仍是關閉。

圖 1|展開 Codex 連線設定查看指令;此示範的允許操作開關仍是關閉。

入口 主要用途
外部 AI 連接 Hub 查狀態、開啟或停止已安裝工具;目前不提供安裝/更新
MCP 閘道 由單一設定提供已安裝工具的 MCP 功能
Library 連線 Library 的專案與文件功能,權限另行判斷

連接 Library 或其他工具

  1. 在 Library 區域按 設定連線,輸入正確的 HTTPS 網址。
  2. 依 Library 的 個人存取權杖流程建立具有效期與必要範圍的權杖,再於 Hub 填入。不要將權杖截圖或貼入支援對話。
  3. 按 連線,確認顯示 已連線。401 檢查權杖效期;403 檢查專案與權杖權限。
  4. 需要連接其他工具時,先確認工具已安裝,再在可用工具區建立連線。自訂 MCP 伺服器須使用可信任的執行檔與參數。

圖 2:Library 連線設定:此示範尚未連線,權杖欄為空。

圖 2|Library 連線設定:此示範尚未連線,權杖欄為空。

圖 3:MCP 概況:內建 DSL、外部 AI 與 Library 的連線狀態分開判讀。

圖 3|MCP 概況:內建 DSL、外部 AI 與 Library 的連線狀態分開判讀。

圖 4:自訂 MCP 伺服器表單;此示範未填憑證、未儲存或建立伺服器。

圖 4|自訂 MCP 伺服器表單;此示範未填憑證、未儲存或建立伺服器。

連線完成後仍需確認實際操作權限。

圖 5:操作流程:MCP 與外部 AI 連線

圖 5|操作流程:MCP 與外部 AI 連線

Hub 登入不會自動取得 Library 權限。本章未以連線畫面宣稱真實專案寫入已通過;更多失敗處理見 排查流程。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀

偏好設定、帳號與授權

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:Hub 0.24.41。從左下角帳號選單開啟 設定;不同帳號與 Beta 狀態會影響可見項目。更換外觀或語言不會替你改動工具本身的語言。

調整日常使用偏好

  1. 在 一般選擇外觀與語言。語言提供 跟隨系統、繁體中文、English。
  2. 需要處理通知時,進入 通知,依工作需求調整。
  3. 在 工具核對 工具安裝位置、磁碟使用量;不要直接搬動已安裝檔案。
  4. 公司網路需要代理時,到 網路 → 網路 Proxy填入管理員提供的 HTTPS Proxy 與例外清單。一般工作使用正式 Store,不任意切到測試環境。

圖 1:一般設定的語言與外觀。

圖 1|一般設定的語言與外觀。

圖 2:品牌配色選擇;後續圖片採 CI Blue。

圖 2|品牌配色選擇;後續圖片採 CI Blue。

圖 3:工具安裝位置與空間資訊。

圖 3|工具安裝位置與空間資訊。

設定分類 何時使用
AI 供應商 選 KDP 點數/自備金鑰與模型等級;不要把金鑰放進截圖
隱私 閱讀使用資料說明並選擇是否分享
Beta 功能 開啟仍在開發的 Code/工作區
Code Agent/技能 Beta 開啟後才顯示
開發者 僅具資格的帳號可見,不是一般設定必做項目

查看帳號與重新同步

  1. 點左下角帳號,確認登入的是自己要使用的身分。
  2. 若有多個工作區,可在選單查看並切換;個人帳號不一定有組織與團隊管理項目。
  3. 開啟 授權,核對方案、來源工作區、授權效期及工具狀態。
  4. 管理員剛調整授權時,使用 重新同步授權,等候結果後再查看工具。帳號選單的 登出用於結束本機登入。

圖 4:帳號選單提供設定、授權與重新同步等入口。

圖 4|帳號選單提供設定、授權與重新同步等入口。

圖 5:方案、授權效期及已安裝工具。

圖 5|方案、授權效期及已安裝工具。

偏好與授權可以分開確認。

圖 6:操作流程:偏好設定、帳號與授權

圖 6|操作流程:偏好設定、帳號與授權

離線可用時間依實際授權權杖顯示,不是無限期;接近期限請恢復連線。登入的詳細步驟見 首次啟用。

其他常用設定畫面

圖 7:AI 供應商:依目前帳號選擇服務與模型,勿分享金鑰。

圖 7|AI 供應商:依目前帳號選擇服務與模型,勿分享金鑰。

圖 8:網路:由管理員提供 Proxy 設定,不任意切換服務環境。

圖 8|網路:由管理員提供 Proxy 設定,不任意切換服務環境。

圖 9:隱私:檢視使用資料偏好。

圖 9|隱私:檢視使用資料偏好。

圖 10:Beta 預設關閉;開啟前先閱讀功能說明。

圖 10|Beta 預設關閉;開啟前先閱讀功能說明。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀

健康狀態、主控台與診斷

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:Hub 0.24.41。當啟動等待過久、工具開不起來或更新失敗時,先記下時間、Hub 版本與操作,再用本章三個入口收集資訊;不要先刪除設定或大量結束行程。

看正在執行的工具

  1. 開啟左側 健康狀態,查看 執行中的行程。
  2. 比對行程、PID、記憶體與已執行時間。畫面預設定期更新,也可按 暫停/繼續或 重新整理。
  3. 需要關閉工具時,先回到工具視窗保存工作並正常退出。清單中沒有行程不等於雲端服務全面正常。

圖 1:健康狀態:檢視目前執行中的行程與資源。

圖 1|健康狀態:檢視目前執行中的行程與資源。

找到問題發生時的日誌

  1. 開啟 主控台,用 篩選日誌…縮小範圍。
  2. 需要閱讀固定位置時,先關閉自動捲動;需要持續觀察時再開啟。
  3. 保留問題前後的必要訊息,按 複製。提交前檢查是否含不適合分享的個人或專案資料。

圖 2:主控台:篩選日誌、閱讀對應時間的訊息。

圖 2|主控台:篩選日誌、閱讀對應時間的訊息。

複製診斷報告

開啟 診斷,按 重新整理,核對版本、平台、授權快取、磁碟與工具清單,再按 複製報告。若某項顯示無法取得,請連同此狀態一起回報,不要自行補成「正常」。

要回答的問題 查看位置
工具是否仍在執行 健康狀態
剛才出現什麼錯誤 主控台
版本、授權與空間資訊 診斷
內附核心檔案在哪裡 核心元件;存在不等於功能正常

圖 3:診斷:核對環境資訊並複製報告。

圖 3|診斷:核對環境資訊並複製報告。

排查時先收集,再決定如何處理。

圖 4:操作流程:健康狀態、主控台與診斷

圖 4|操作流程:健康狀態、主控台與診斷

需要提交問題時參考 支援包與意見回饋。本機畫面與報告只是排查證據,不代替實際功能驗收。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀

支援包、稽核與意見回饋

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:Hub 0.24.41。回報問題時,優先附上可重現步驟、版本、發生時間及必要截圖。請勿提供密碼、驗證碼、API 金鑰或客戶未授權分享的檔案。本輪說明與畫面不代表已把支援包上傳到正式服務。

檢視支援包

  1. 在有提供支援包功能的工具內建立支援包,再回到 Hub 的 支援包頁。
  2. 找到對應項目,按 檢視細節,核對標題、工具版本、檔案清單、大小及已遮蔽資訊。
  3. 確定內容可分享且已登入,才按 檢視並上傳。閱讀同意視窗後,由你決定是否 同意並上傳。
  4. 上傳完成時保留回條。若需要重試,先處理錯誤原因,再使用 立即重試。

圖 1:支援包頁的空清單。建立支援包及同意上傳的流程依各工具入口操作;本輪未上傳。

圖 1|支援包頁的空清單。建立支援包及同意上傳的流程依各工具入口操作;本輪未上傳。

Hub 會遮蔽支援的文字型秘密,二進位客戶資料無法自動檢查,仍需人工確認。已上傳項目的 移除本機副本不會刪除公司端回條與保留的封存檔;未上傳項目的刪除無法復原。

查詢本機稽核紀錄

登入後開啟 稽核紀錄,選擇 登入、登出、安裝、解除安裝、啟動、更新、授權等分類,按 重新整理核對時間與內容。需要保存時按 匯出 CSV。這是該裝置的本機紀錄,不是所有電腦的集中稽核。

圖 2:本機稽核紀錄;畫面包含本輪登入與授權事件。

圖 2|本機稽核紀錄;畫面包含本輪登入與授權事件。

提交意見回饋

從底部 意見回饋開啟 Send Feedback 表單,選 Bug Report 或 Feature Request,在 Title/Description 填寫標題、具體操作與預期/實際結果。可依表單附圖,也可在表單內使用 Ctrl+V貼上剪貼簿圖片;先確認預覽內容,必要時用 Remove/Replace screenshot 移除或更換。向下捲檢查附帶資訊,確認後才按 Submit;Cancel 是取消。本輪已在 E2E 實際驗證 Ctrl+V 圖片預覽,未送出測試回饋。

圖 3:Send Feedback 表單:選回報類別並填寫內容。

圖 3|Send Feedback 表單:選回報類別並填寫內容。

圖 4:在 E2E 使用 Ctrl+V 後,實際出現圖片預覽。

圖 4|在 E2E 使用 Ctrl+V 後,實際出現圖片預覽。

圖 5:向下捲核對送出區域;本輪按取消,未送出回饋。

圖 5|向下捲核對送出區域;本輪按取消,未送出回饋。

附件 分享前確認
畫面 遮蔽私人帳號與不必要內容
日誌/診斷 保留相關時間範圍,不附秘密
支援包 逐項檢視;確認客戶資料分享許可

回報順序可依下圖進行。

圖 6:操作流程:支援包、稽核與意見回饋

圖 6|操作流程:支援包、稽核與意見回饋

若不知道先收集什麼,從 診斷章節 開始。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀

常見問題與排查流程

Cortex 來源版本 2 · 更新 2026-10-28 15:09

適用:Hub 0.24.41。先記下 何時、做了什麼、預期什麼、實際出現什麼,再依下表處理。保留完整可讀錯誤,避免在原因未明時反覆重試相同寫入或刪除本機資料。

遇到的狀況 先確認/下一步
看不到 KDP Code 或工作區 到設定查看「顯示 Beta 功能」;它們預設隱藏
登入後工具仍未授權 核對目前帳號、方案與授權頁,再重新同步授權
更新或切換版本按鈕停用 關閉工具,查看最低支援版本、授權與平台包提示
一直顯示等待背景服務 等待當次初始化;若持續不動,收集主控台與診斷後正常退出重開
關窗後還有 Hub 關窗會隱藏到系統匣,需要退出時從系統匣操作
顯示沒有更新但目前離線 恢復連線再檢查;離線資料不能證明最新
Library 顯示 401/403 401 查權杖效期,403 查帳號、專案與權杖範圍
有工具清單但不能呼叫 檢查目前連線狀態,不以保存清單判定已連線
AI 點數或請求錯誤 依實際錯誤檢查點數、登入及模型設定,勿一直重送

圖 1:先核對授權狀態,避免把沒有使用權誤判成安裝問題。

圖 1|先核對授權狀態,避免把沒有使用權誤判成安裝問題。

依順序排查

  1. 從 關於記錄 Hub 版本與建置編號;若是工具問題,也記錄工具版本。
  2. 確認目前使用正式環境或測試環境、網路是否可用,以及是否登入正確帳號。兩個環境的結果不要混用。
  3. 開啟 健康狀態看工具是否仍在執行,再到 主控台找對應時間的訊息。
  4. 到 診斷 → 複製報告,只保留與問題相關、可分享的內容。
  5. 依提示處理後做一次小範圍重試;仍失敗就回報,不要任意停用驗證、改連接埠或強制結束不明程序。

圖 2:主控台入口:對照問題發生時間;此圖不代表當時發生故障。

圖 2|主控台入口:對照問題發生時間;此圖不代表當時發生故障。

圖 3:診斷資訊與複製報告入口。

圖 3|診斷資訊與複製報告入口。

圖 4:回報問題時記錄版本與建置資訊。

圖 4|回報問題時記錄版本與建置資訊。

找到原因後再決定是否重試。

圖 5:操作流程:常見問題與排查流程

圖 5|操作流程:常見問題與排查流程

圖中的「成功」仍要核對實際結果,不能只看訊息文字。需要協助時使用 意見回饋與支援包;重新安裝前請先保留 診斷資料。


返回KDP Hub|操作手冊 · 使用指南首頁

返回目錄 · 線上閱讀