寶塔 API 與 skill：讓 AI 辦事，你能在面板核對

API 是軟體辦事的入口，skill 是可重複使用的操作說明; 先驗證唯讀連線，再安排修改。

API 與面板網頁是什麼關係

你在面板裡點「網站」，可以看到網站列表。 API（供軟體讀取資訊、提交操作的入口）讓 AI 的工具用程式向面板提出類似請求。 它不是自動擁有權限，也不是一個“萬能聊天網址”。 必須配置正確位址、金鑰和存取限制，AI 才能呼叫。 API 的具體設定名稱、支援的操作和認證辦法，按你實際安裝的寶塔版本核對。 不要因為 AI 能讀取網站列表，就預設它能安全執行所有安裝、刪除和恢復操作。

配置時先分清三個東西

• 面板地址：AI 到哪裡找這個面板，應保留需要的協議、端口和入口資訊。
• API 密鑰：讓面板識別調用者的秘密，和瀏覽器登入密碼不是同一種東西。
• 訪問白名單：允許哪些網路地址來調用。 好比門衛只讓名單上的來源進入。

白名單通常需要填寫實際執行 API 呼叫那台機器的出口 IP（對方看到的來源地址）。 AI 在另一台機器執行時，這個 IP 可能與你自己電腦的不同。 讓 AI 先確認來源，不要為了連接方便填成允許所有人。

第一次先做只讀測試

請從私密配置讀取寶塔 API 連接，先只讀取網站列表和系統狀態。 不要新建、刪除、重啟。 把讀到的網站名稱、域名和運行狀態列出來，讓我與面板核對。 不要在回覆中顯示金鑰。

在面板網站列表裡逐項核對。 確認返回的是這台機器現有的真實網站，才說明接入初步可用。 連接失敗時，讓 AI 分別檢查地址、網路、認證和白名單，保留有用的報錯資訊，不把鑰匙公開出來。

Skill 到底是一份什麼東西

skill（給 AI 重複使用的操作說明）像操作手冊。 裡面可以說明：用哪個工具、怎樣找到私密配置、先檢查什麼、允許做哪些事、怎樣核對結果、失敗時怎麼處理。 它不是保存所有密碼的地方，也不是寫一句「你現在會運維了」就能起作用。 本課的 skill 可以先有五段：連接配置的位置、唯讀檢查方法、建立網站的流程、重要操作的邊界、檢查和恢復辦法。 先把老師實際走通的步驟保存下來，再逐項複用。

可以給 AI 的整理要求

把我們已驗證的寶塔操作整理成 skill。 正文不要寫 IP 密鑰原文或密碼; 只說明私密配置位置。 預設先讀狀態，修改前說清目標網站、影響範圍和恢復辦法。 把每個操作之後在面板和瀏覽器的檢查步驟寫上。 不要聲明尚未測試的介面已經可用。

保存以後，在新一次使用中讓 AI 先按這份說明讀取網站列表，看是否真的複用了已驗證的方法。

可視化控制能看見哪些結果

新增網站會出現在列表; 上傳文件能在目錄裡找到; 資料庫建立後有對應記錄; 軟體運行狀態可在面板查看。 面板並不會展示 AI 編寫的每一個業務細節，所以按鈕、郵箱表單和購買流程還需要打開網站實際試用。 把“面板核對”和“訪客試用”結合起來，才知道改動有沒有生效。

官方資料：需要進一步核對時看這裡

寶塔官方面板使用與管理入口。 本文的生活類比、練習和 AI 示例為課程原創說明。 軟體選單與版本會變化，請讓 AI 對照你實際看到的介面核對。