mirror of https://github.com/hanzoai/bot.git synced 2026-10-30 17:24:26 +00:00

Files

T

zeekayandHanzo Dev 84e4069c2c docs name the state dir and config file the bot reads: ~/.bot/bot.json

The docs said ~/.hanzo-bot/hanzo-bot.json (and ~/.hanzo-bot-<profile>, hanzo-bot.plugin.json), which nothing reads: src/config/paths.ts resolves ~/.bot, bot.json and ~/.bot-<profile>, and plugins ship bot.plugin.json. Every such path in docs/ now names what the code opens.

Co-authored-by: Hanzo Dev <[email protected]>

2026-09-24 21:12:09 -07:00

1.7 KiB

Raw Permalink Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

你想安装或管理进程内 Gateway 网关插件

你想调试插件加载失败问题

`hanzo-bot plugins` 的 CLI 参考（列出、安装、启用/禁用、诊断）

plugins

generated_at	model	provider	source_hash	source_path	workflow
2026-02-03T07:45:08Z	claude-opus-4-5	pi	c6bf76b1e766b912ec30a0101d455151c88f1a778bffa121cdd1d0b4fbe73e1c	cli/plugins.md	15

`hanzo-bot plugins`

管理 Gateway 网关插件/扩展（进程内加载）。

命令

hanzo-bot plugins list
hanzo-bot plugins info <id>
hanzo-bot plugins enable <id>
hanzo-bot plugins disable <id>
hanzo-bot plugins doctor
hanzo-bot plugins update <id>
hanzo-bot plugins update --all

内置插件随 HanzoBot 一起发布，但默认禁用。使用 plugins enable 来激活它们。

所有插件必须提供 bot.plugin.json 文件，其中包含内联 JSON Schema（configSchema，即使为空）。缺少或无效的清单或模式会阻止插件加载并导致配置验证失败。

安装

hanzo-bot plugins install <path-or-spec>

安全提示：将插件安装视为运行代码。优先使用固定版本。

支持的归档格式：.zip、.tgz、.tar.gz、.tar。

使用 --link 避免复制本地目录（添加到 plugins.load.paths）：

hanzo-bot plugins install -l ./my-plugin

更新

hanzo-bot plugins update <id>
hanzo-bot plugins update --all
hanzo-bot plugins update <id> --dry-run

更新仅适用于从 npm 安装的插件（在 plugins.installs 中跟踪）。

1.7 KiB Raw Permalink Blame History Unescape Escape

hanzo-bot plugins

命令

安装

更新

1.7 KiB

Raw Permalink Blame History

`hanzo-bot plugins`