技能
导入、更新与删除技能
在技能中心安全地导入技能包、查看错误并管理版本。
进入“设置 → 技能中心”。“官方技能”由 SoniBot 维护；“我的技能”用于管理你导入的技能。
支持的导入内容
- 一个包含
SKILL.md的技能目录； - 一个包含多个技能目录的父目录；
- 单独的
SKILL.md文件； - 包含一个或多个技能的 zip 压缩包。
点击“添加技能”或“导入技能”，选择来源。SoniBot 会复制并校验内容；同名技能再次导入会替换现有版本。
覆盖前先备份你直接修改过的技能目录。SoniBot 不会自动合并同名技能的差异。
校验规则
导入器会检查：
SKILL.md是否存在；- frontmatter 是否可解析并包含
description； - 技能名称是否可作为安全目录名；
- 单文件与单技能总大小是否超过服务端限制；
- zip 是否有效；
- 包内是否包含软链接。
界面会显示当前服务端的实际大小上限，不要把文档中的示例值当作固定限制。
常见错误
| 错误 | 修复 |
|---|---|
| 缺少有效 frontmatter | 在 SKILL.md 开头添加由 --- 包围的配置，并填写 description |
| 未找到技能 | 选择真正包含 SKILL.md 的目录或 zip |
| 来源不受支持 | 改为技能目录、父目录、SKILL.md 或 zip |
| 包含软链接 | 用真实文件替换链接后重新打包 |
| 文件或总大小超限 | 删除二进制、缓存和无关素材 |
| zip 无效 | 重新压缩，并确认压缩包可以正常解开 |
| 名称不合法 | 使用小写字母、数字和连字符组成目录名 |
在“最近导入”中可以查看成功、覆盖、部分成功或失败记录，以及具体文件、行列和修复建议。
更新技能
- 保持技能目录名不变；
- 更新源目录或 zip；
- 重新导入；
- 确认导入记录显示“覆盖”或“成功”；
- 新建一个会话验证新版本。
已经运行的会话可能继续使用创建时准备的版本，不应以历史会话判断更新失败。
删除技能
从技能详情或批量管理中删除自定义技能。删除后：
- 新助手配置和新会话不能再选择它；
- 使用该技能的助手需要重新检查能力组合；
- 历史会话中已经选用的技能仍可能继续工作；
- 官方技能只读，不能从技能中心删除。
删除前先查看技能详情中的“使用中的助手”，再决定是否解绑或替换。