常见问题

本章节帮助你解决使用 OpenCode Agent Skills 插件时遇到的问题，并了解插件的安全机制。无论是技能加载失败、脚本执行错误，还是想了解插件如何保护你的系统，这里都有答案。

本章内容

🔧 常见问题排查

解决技能加载失败、脚本执行错误、路径安全问题、模型加载失败等 9 类常见问题的排查方法和解决方案。

🔒 安全性说明

了解插件的路径安全检查、YAML 解析安全、输入验证、脚本执行保护等核心安全机制和最佳实践。

学习路径

建议按以下顺序学习本章内容：

常见问题排查 → 安全性说明

1. 先学排查：遇到问题时，先查阅「常见问题排查」快速定位和解决
2. 再学安全：了解插件的安全机制，养成安全使用习惯

遇到问题怎么办

如果你正在使用插件时遇到了具体问题，直接跳到「常见问题排查」查找对应症状。如果想系统了解插件的安全设计，再阅读「安全性说明」。

前置条件

建议先完成以下章节

• 上手指南：了解插件的基本概念和安装方法
• 平台与集成：熟悉技能发现、加载、执行等核心功能

本章内容假设你已经对插件有基本了解。如果你是第一次使用，建议先完成上述章节的学习。

下一步

完成本章学习后，你可以继续探索：

• 附录：查阅技能开发最佳实践和 API 工具参考
• 更新日志：了解插件的版本演进和新功能