商店

OntoSkills 使用简单的分发模型：

• OntoStore — 默认内置
• 第三方商店 — 显式添加
• 源导入 — 本地克隆并编译

---

商店类型

OntoStore（内置）

OntoStore 随产品提供。无需配置。

ontoskills search hello
ontoskills install mareasw/greeting/hello

技能安装后自动启用。

包 ID 格式： owner/repo/skill

示例：mareasw/office/xlsx

第三方商店

由其他团队或社区维护的可选商店。

# 添加商店
ontoskills store add-source acme https://example.com/index.json

# 列出已配置的商店
ontoskills store list

第三方包使用相同的 ID 格式和安装流程。

源导入

包含 SKILL.md 文件的原始仓库，本地编译。

ontoskills import-source https://github.com/user/skill-repo

• 克隆到 ~/.ontoskills/skills/vendor/
• 编译到 ~/.ontoskills/ontologies/vendor/
• 需要安装 OntoCore 编译器

---

包生命周期

安装

ontoskills install mareasw/office/xlsx

从商店下载已编译的 .ttl 并放入 ~/.ontoskills/ontologies/。

启用 / 禁用

ontoskills disable mareasw/office/xlsx
ontoskills enable mareasw/office/xlsx

技能安装后默认启用。使用 disable 可以从 OntoMCP 隐藏技能而不删除它。使用 enable 重新启用。

更新

ontoskills update mareasw/office/xlsx

从商店获取最新版本。

移除

ontoskills remove mareasw/office/xlsx

从本地存储删除包。

重建索引

ontoskills rebuild-index

从所有已启用的技能重新生成 ~/.ontoskills/ontologies/system/index.enabled.ttl。如果手动修改了 .ttl 文件，运行此命令。

---

CLI 命令参考

命令	描述
search <query>	跨所有商店搜索技能
install <package-id>	安装已编译的包
enable <package-id>	为 MCP 运行时启用
disable <package-id>	从 MCP 运行时禁用
remove <package-id>	卸载包
update <package-id>	更新到最新版本
list-installed	列出所有已安装的包
store list	列出已配置的商店
store add-source <name> <url>	添加第三方商店
import-source <url>	导入并编译源仓库
rebuild-index	重新生成已启用索引
uninstall --all	删除整个托管主目录

---

本地布局

~/.ontoskills/
├── bin/                    # 托管二进制文件
│   └── ontomcp
├── core/                   # 编译器运行时（可选）
├── ontologies/             # 已编译的本体
│   ├── core.ttl
│   ├── index.ttl
│   ├── system/             # 系统级文件
│   │   └── index.enabled.ttl  # 已启用技能清单
│   └── */ontoskill.ttl
├── skills/                 # 源技能
│   └── vendor/             # 导入的仓库
└── state/                  # 元数据和锁
    ├── registry.sources.json
    └── registry.lock.json

---

故障排除

”找不到包”

• 检查包 ID 拼写
• 运行 ontoskills search <query> 发现可用包
• 如果使用第三方商店，验证已配置：ontoskills store list

”技能在 MCP 中不可见”

如果技能被禁用了，重新启用它：

ontoskills enable mareasw/office/xlsx
ontoskills rebuild-index

“源导入失败”

确保已安装 OntoCore：

ontoskills install core

然后重试导入。

“索引损坏”

从头重建：

ontoskills rebuild-index

---

实用规则

命令	作用
install mcp	安装 MCP 运行时
install core	安装编译器
install <id>	安装已编译的包
import-source <url>	克隆并编译源
enable / disable	控制 MCP 可见性
OntoStore	内置，永远不需要 store add-source