Host 运行时栈
Zhin Host 与 packages/im、packages/console 并列,提供 HTTP 监听、管理面 REST、Console 协议与可选 MCP Server。UI 不在 Host 内嵌,官方 Remote Console 见 console-remote.md。
组件
| 包 | npm | 职责 |
|---|---|---|
| host-router | @zhin.js/host-router | Koa 监听、Router/WebSocket、Bearer、CORS |
| host-api | @zhin.js/host-api | 管理面 REST、Console 协议、PageManager / entries |
| host-mcp | @zhin.js/mcp | MCP Server(向外暴露 Zhin 工具) |
Console 前端栈(contract → pagemanager → client → zhin-console)见仓库 packages/console。
配置
yaml
# zhin.config.yml(Stable 最小集)
http:
port: 8086
token: ${HTTP_TOKEN} # 或 .env HTTP_TOKEN
hostApi:
enabled: true
plugins:
- "@zhin.js/host-router"
- "@zhin.js/host-api"
# 可选:向外暴露 MCP
# - "@zhin.js/mcp"http:— 传输层(端口、Token、CORS)hostApi:— 管理面开关与 Console 相关选项
Remote Console 快速路径
- 启动应用(如 minimal-bot 的
pnpm dev)。 - 浏览器打开 console.zhin.dev(或本地
zhin-console/开发服)。 - 登录页填写 API Base(日志中的 Host,如
http://127.0.0.1:8086)与 Bearer Token(.env的HTTP_TOKEN)。
协议:POST /api/console/request + SSE GET /api/events;插件扩展经 GET /entries 动态加载。详见 Remote Console。
MCP Server
在 Host 上启用 @zhin.js/mcp 后,IDE 等 MCP Client 可通过 Streamable HTTP 调用 Zhin 内置工具。配置与工具列表见 MCP 集成 — Server 模式。