常見問題

本章節幫助你解決使用 OpenCode Agent Skills 外掛時遇到的問題，並了解外掛的安全機制。無論是技能載入失敗、指令碼執行錯誤，還是想了解外掛如何保護你的系統，這裡都有答案。

本章內容

🔧 常見問題排查

解決技能載入失敗、指令碼執行錯誤、路徑安全問題、模型載入失敗等 9 類常見問題的排查方法和解決方案。

🔒 安全性說明

了解外掛的路徑安全檢查、YAML 解析安全、輸入驗證、指令碼執行保護等核心安全機制和最佳實踐。

學習路徑

建議按以下順序學習本章內容：

常見問題排查 → 安全性說明

1. 先學排查：遇到問題時，先查閱「常見問題排查」快速定位和解決
2. 再學安全：了解外掛的安全機制，養成安全使用習慣

遇到問題怎麼辦

如果你正在使用外掛時遇到了具體問題，直接跳到「常見問題排查」查詢對應症狀。如果想系統了解外掛的安全設計，再閱讀「安全性說明」。

前置條件

建議先完成以下章節

• 上手指南：了解外掛的基本概念和安裝方法
• 平台與整合：熟悉技能發現、載入、執行等核心功能

本章內容假設你已經對外掛有基本了解。如果你是第一次使用，建議先完成上述章節的學習。

下一步

完成本章學習後，你可以繼續探索：

• 附錄：查閱技能開發最佳實踐和 API 工具參考
• 更新日誌：了解外掛的版本演進和新功能