Skip to content

Host 运行时栈

Zhin Hostpackages/impackages/console 并列,提供 HTTP 监听、管理面 REST、Console 协议与可选 MCP Server。UI 不在 Host 内嵌,官方 Remote Console 见 console-remote.md

组件

npm职责
host-router@zhin.js/host-routerKoa 监听、Router/WebSocket、Bearer、CORS
host-api@zhin.js/host-api管理面 REST、Console 协议、PageManager / entries
host-mcp@zhin.js/mcpMCP 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 快速路径

  1. 启动应用(如 minimal-botpnpm dev)。
  2. 浏览器打开 console.zhin.dev(或本地 zhin-console/ 开发服)。
  3. 登录页填写 API Base(日志中的 Host,如 http://127.0.0.1:8086)与 Bearer Token.envHTTP_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 模式

相关文档

基于 MIT 许可发布