chat/README.zh.md

Hanzo Chat

Hanzo AI 云的对话入口：多模型对话，内置智能体、工具与检索增强，全部运行在 Hanzo 的后端之上。已上线：hanzo.chat。

Hanzo Chat 与 hanzo.app（应用构建器）和 Hanzo 控制台（管理端）互为姊妹产品。所有推理、代码执行与网页搜索都经由统一的 Hanzo API（api.hanzo.ai/v1）完成，登录则联合到 Hanzo IAM（hanzo.id）。

功能

• 多模型对话 — Zen 系列模型及其他前沿模型，通过 api.hanzo.ai 提供服务。
• 智能体 — 在对话中直接构建智能体，或用 /agent 命令或 @提及 运行你的 Hanzo Cloud 智能体（/v1/agents）。
• MCP 工具 — 接入 Model Context Protocol（模型上下文协议）服务器以调用工具。
• 检索增强（RAG） — 基于你自己的文件和文档进行对话。
• 网页搜索 — 通过 Hanzo 网页搜索获得有据可循的回答。
• 代码解释器 — 在沙箱运行时中执行代码。
• 图像生成 — 在对话中直接生成图像。
• 访客对话 — 无需注册即可试用免费的 Zen 模型（可选，默认关闭）。

环境要求

• Node.js 24（见 .nvmrc）
• pnpm 10
• Hanzo API 密钥 — 在 hanzo.ai/dashboard 获取

快速开始（Docker）

git clone https://github.com/hanzoai/chat.git
cd chat
cp .env.example .env        # 填入 HANZO_API_KEY
make up

打开 http://localhost:3080。make up 会从 compose.yml 启动完整技术栈（应用、MongoDB、Meilisearch）；make down 停止。

开发

pnpm install               # 安装工作区依赖
pnpm build:packages        # 构建共享的工作区包
pnpm backend:dev           # API 服务，端口 :3080（nodemon）
pnpm frontend:dev          # Vite 客户端开发服务器（另开一个终端）

测试与检查：

pnpm test:all              # 全部工作区测试
pnpm e2e                   # Playwright 端到端测试
pnpm lint                  # ESLint
pnpm format                # Prettier

配置

密钥存放在 .env 中；模型目录与端点配置位于 chat.yaml（复制 chat.example.yaml）。主要变量：

HANZO_API_KEY=             # Hanzo API 密钥 — 推理、工具、搜索
MONGO_URI=                 # MongoDB 连接 — 对话历史、用户
JWT_SECRET=                # 会话令牌签名
CREDS_KEY=                 # 凭据加密
CREDS_IV=

登录通过 OpenID Connect 联合到 Hanzo IAM（OPENID_ISSUER=https://hanzo.id，客户端 hanzo-chat）。

工作区结构

api/           Express 后端（:3080）— 路由、控制器、Mongoose 模型
client/        React 前端（Vite）
packages/      data-provider · data-schemas · api · client · agents · mcp

文档

• 文档：https://hanzo.ai/docs/chat
• 部署、IAM 与平台说明：docs/
• 问题反馈：https://github.com/hanzoai/chat/issues

许可证

MIT 许可证。MIT 许可证。见 LICENSE 获取完整署名。