Community寫作與編輯github.com

msageha/skills

用於 Claude Code / Codex / Antigravity 的 Agent Skills 集

skills 是什麼?

本技能集提供一個完整封裝的 TP-Link Deco BE85 路由器本地 API 端點,透過 FastAPI 包裝器(Base URL: `https://deco.msageha.net/api`)來操作。無需額外認證,伺服器會以儲存的憑證自動登入路由器。技能涵蓋儀表板總覽、Deco 節點、已連線/被封鎖客戶端、Wi-Fi 設定(所有頻段與主/來賓網路)、WAN/LAN/IPv6 狀態、CPU/記憶體使用率,以及重啟路由器等破壞性操作。支援平台包括 Claude Code、Codex 與 Antigravity。使用時需注意:請求會因伺服端鎖而序列化(不應並行發送)、寫入操作(如 Wi-Fi 開關、重啟)需先取得使用者確認,因為會短暫中斷連線或造成數分鐘的網路中斷。

相容平台✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add msageha/skills

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Deco BE85

Base URL: https://deco.msageha.net/api(為 TP-Link Deco BE85 本地 API 建立的 FastAPI 包裝器)。對這個實例的請求不需要任何認證標頭/Cookie——伺服器會以儲存的憑證自行登入路由器。

關鍵資訊

  • 登入路由器是懶載入的:啟動或閒置後的第一個請求會觸發登入,速度較慢。過期的連線會自動重新登入並重試。
  • 請求會透過伺服端鎖(單一路由器連線)序列化。請依序呼叫端點;不要分散發出並行請求。
  • band 為 band2_4 / band5_1 / band6;network 為 host 或 guest。
  • GET /wireless 傳回 base64 編碼的 ssid/password;寫入端點接受純文字(伺服器會自行編碼)。
  • 在任何寫入操作前需先徵得使用者同意:Wi-Fi 開關/設定變更會短暫中斷該頻段的客戶端連線,POST /reboot(需要 confirm: true)會使整個網路下線數分鐘,而 POST /raw 搭配非唯讀的 operation 可以更改任意路由器設定。
  • 錯誤:401 路由器身分驗證失敗,502 路由器端錯誤(附有 detail + error_code),504 路由器無法連線,400/422 請求驗證失敗。

核心操作

任務端點
總覽(WAN/CPU/記憶體/節點及客戶端數量)GET /dashboard
Deco 單元(Mesh 節點)GET /devices
已連線客戶端GET /clients?online_only=true
被封鎖客戶端GET /clients/blocked
Wi-Fi 設定(所有頻段,主/來賓網路)GET /wireless
Wi-Fi 開/關(依頻段)POST /wireless
變更 SSID/密碼/頻道等POST /wireless/config
WAN / 網際網路 / LAN / IPv6 狀態GET /network/wan, /network/internet, /network/lan, /network/ipv6
CPU / 記憶體使用率GET /network/performance
重啟 Deco 單元(具破壞性)POST /reboot
其他任何 Deco 端點(逸脫處理)POST /raw
伺服器健康狀態 / 明確登入GET /health, POST /login, POST /logout

完整的請求/回應結構描述與可直接執行的 curl 範例,請參閱 references/api-reference.md 與 references/commands.md。

相關技能