OhoDevelopers
开始构建

本地开发与调试

理解目录注册、刷新行为以及如何判断一次 Plugin 修改真的生效。

目录就是开发版本

oho plugin dev 保存的是 Manifest 路径。修改以下文件后,Oho 会在下一次刷新或 Run 重新读取:

  • oho.plugin.json
  • src/index.mjs
  • skills/**/SKILL.md
  • commands/*.md

不需要把代码复制到 Oho 仓库,也不需要每次修改都重新安装。

查看和移除注册

oho plugin list
oho plugin remove text-inspector

plugin remove 只删除本地注册,不删除你的项目目录。

调试顺序

  1. 先确认 oho plugin list 指向预期绝对路径;
  2. 在 Plugin Center 的“开发中”确认 Manifest 能被解析;
  3. 为一个测试 Agent 启用;
  4. 新建 Run,检查 Skill 是否加载、Tool 名称和参数是否正确;
  5. 最后检查 Tool 输出是否通过输出 Schema。

不要只测试函数

直接执行 src/index.mjs 只能说明 JavaScript 函数能运行,不能证明 Agent 绑定、能力编译、输入验证、运行隔离和 UI 展示都正常。

常见问题

Plugin 没出现在“开发中”

确认桌面端和 CLI 使用同一用户,并检查 oho.plugin.json 是否能通过 Manifest Schema。

修改没有反映到 Run

结束旧 Run 后重新发起。Run 使用启动时冻结的能力快照,不应在中途因为文件变化而改变权限。

Tool 被拒绝

当前本地 Node Runtime 只允许无网络工具。非低风险 Tool 也不能默认直接执行;详见运行与安全