开始构建
构建第一个 Plugin
创建一个 Text Inspector，并通过真实 Agent Run 调用它的 Tool。
这个教程生成一个可以统计字符数、词数和 UTF-8 字节数的本地 Plugin。它不依赖外部网络和 API Key，适合验证基础链路。
创建空目录
mkdir text-inspector
cd text-inspector
oho plugin create --name "Text Inspector" --category utilities目录名会成为稳定 Plugin ID，因此必须使用小写 kebab-case，例如 text-inspector。日常开发直接在目标目录运行命令；路径参数只用于脚本或 monorepo。
查看生成内容
text-inspector/
├── assets/
│ ├── icon.svg
│ └── publisher-avatar.svg
├── commands/
│ └── count-text.md
├── src/
│ └── index.mjs
├── CHANGELOG.md
├── oho.plugin.json
├── package.json
└── README.mdoho.plugin.json 声明 text.stats Tool；src/index.mjs 实现它。发布者 ID、名称和初始头像来自 Oho Desktop 当前账号，不需要在项目里配置 Server。
注册开发版本
oho plugin devOho 注册当前原始目录，不会把源码复制进主仓库。打开 Plugin Center → 开发中，找到 Text Inspector，并为要测试的 Agent 启用。
发起真实 Run
在已启用的 Agent 中发送：
请使用统计文本工具，统计下面这段文本的字符数、词数和 UTF-8 字节数：
Oho plugins are local-first.展开运行过程，确认先显示 执行工具 · 统计文本，再看到结构化输入与输出。仅看到 Plugin 卡片或“已启用”标签不算完成。
完成标准
- Plugin 出现在“开发中”；
- 指定 Agent 已启用它；
- Run 加载了对应能力；
text.stats返回符合 Schema 的characters、words和utf8_bytes。
接下来可以修改 src/index.mjs，继续本地调试。