注册账号
5 分钟完成注册并创建你的第一个客服工作台。
1. 创建账号
访问 /register 页面，使用企业邮箱注册。注册后会自动创建一个租户（tenant）。
2. 邮箱验证
登录邮箱查收验证邮件，点击验证链接完成激活。
3. 登录控制台
使用注册的邮箱和密码登录，进入管理控制台。
创建知识库
上传企业文档，让 AI 回答有据可依。
1. 进入知识库
在控制台左侧菜单点击「知识库」，然后点击「新建文档」。
2. 上传文档
支持 PDF、Word、Markdown、TXT 格式。单个文档最大 50MB。
3. 自动分块
系统自动将文档切分为 500-1000 字符的语义块，并生成向量索引。
4. 测试检索
在文档详情页可使用「检索测试」验证 RAG 召回效果。
# 检索测试 API
POST /api/knowledge/{docId}/search
{
"query": "如何申请退款",
"top_k": 5
}接入渠道
支持网页 Widget、微信公众号、企业微信、钉钉等多渠道接入。
网页 Widget
在「渠道管理」中创建 Widget 渠道，复制 Token 并嵌入 JS SDK 到网站。
<script>
window.zhixinConfig = { token: 'YOUR_TOKEN' };
</script>
<script src="https://cdn.askzhixin.com/widget.js" async></script>微信公众号
绑定公众号 AppID 和 AppSecret，配置消息回调 URL。
企业微信
在企业微信后台创建自建应用，配置回调地址并获取 corpid + secret。
钉钉
创建钉钉机器人，配置 outgoing webhook 指向系统提供的 URL。
邀请坐席
配置坐席账号、技能标签、并发上限，开始人机协同。
1. 创建坐席
在「坐席管理」中点击「新建坐席」，填写姓名、邮箱、技能标签。
2. 设置技能
为坐席设置技能标签（如「售前」「售后」「技术」），用于智能路由。
3. 配置并发
设置每个坐席的最大并发对话数（默认 5）。
4. 坐席登录
坐席通过 /agent/{agentId} 进入工作台，实时接收分配的会话。
文档格式支持
知心支持多种主流文档格式，覆盖企业常见知识载体。
支持文字版 PDF。扫描件建议先用 OCR 处理。
Word
支持 .docx 和 .doc 格式。
Markdown
支持 .md 和 .markdown 格式，最适合技术文档。
TXT
支持纯文本 .txt 格式。
HTML
支持 .html 格式，自动剥离标签保留正文。
分块策略
合理的分块是 RAG 召回质量的关键。
语义分块
默认按段落语义切分，每块 500-1000 字符，保留完整语义。
重叠窗口
相邻块保留 100 字符重叠，避免关键信息被切分到不同块。
标题保留
Markdown 文档会保留标题层级，每个块携带其所属标题路径。
混合检索
向量检索 + 关键词检索的融合方案。
向量检索
使用 Embedding 模型将查询向量化，与文档块向量计算余弦相似度。
关键词检索
基于 BM25 算法的关键词匹配，捕获精确词汇命中。
融合排序
使用 RRF（Reciprocal Rank Fusion）融合两路检索结果。
final_score = 0.6 * vector_score + 0.4 * bm25_score重排序
使用 Cross-Encoder 对候选块精排，提升 Top-K 准确率。
候选集
混合检索返回 Top-20 候选块。
Cross-Encoder
对 (query, chunk) 对进行打分，更精确的语义匹配。
Top-K
取重排后的 Top-5 作为最终上下文注入 LLM。
鉴权
所有 API 请求需携带 JWT Token。
获取 Token
通过 /api/auth/login 接口登录获取 JWT。
POST /api/auth/login
{
"email": "you@company.com",
"password": "******"
}
# 响应
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"expires_at": "2026-08-01T00:00:00Z"
}使用 Token
在请求头携带 Authorization: Bearer <token>。
curl -H "Authorization: Bearer eyJhbG..." \
https://api.askzhixin.com/api/chat/conversations对话 API
创建对话、发送消息、获取历史的完整接口。
创建对话
POST /api/chat/conversations 创建新会话。
POST /api/chat/conversations
{
"channel_type": "web",
"customer_name": "张三"
}发送消息
POST /api/chat/conversations/{id}/messages 发送消息并获取 AI 回复。
POST /api/chat/conversations/{id}/messages
{
"content": "如何申请退款？"
}获取历史
GET /api/chat/conversations/{id}/messages 获取会话历史。
WebSocket 事件
实时双向通信，支持消息、情感、转人工等事件。
连接
wss://api.askzhixin.com/ws/chat/{sessionId}?token=JWT
事件类型
message / typing / emotion_update / escalation / agent_assigned / conversation_closed
// 客户端示例
const ws = new WebSocket('wss://api.askzhixin.com/ws/chat/...?token=...');
ws.onmessage = (e) => {
const msg = JSON.parse(e.data);
if (msg.type === 'emotion_update') {
console.log('客户情感：', msg.data.emotion);
}
};Webhook
系统事件主动推送到你的服务，便于企业做二次集成。
配置 URL
在「设置 → Webhook」中配置接收 URL，系统会主动 POST 事件。
事件类型
conversation.created / message.received / escalation.triggered / ticket.created / conversation.closed
签名校验
每个请求携带 X-ZhiXin-Signature 头，值为 HMAC-SHA256(body, secret)。
// Node.js 校验示例
const crypto = require('crypto');
const sig = crypto.createHmac('sha256', WEBHOOK_SECRET)
.update(req.rawBody).digest('hex');
if (sig !== req.headers['x-zhixin-signature']) {
return res.status(401).send('invalid signature');
}数据安全
传输加密、存储加密、密钥管理全流程保障。
传输加密
全站 HTTPS + TLS 1.3，WebSocket 使用 WSS。
存储加密
D1 数据库静态加密，R2 存储启用 SSE-S3。
密钥管理
API Key、JWT Secret 使用 Cloudflare Secrets Store，永不落盘。
PII 脱敏
日志输出自动脱敏手机号、邮箱、身份证等敏感字段。
权限管理
基于角色的访问控制（RBAC），精细化权限分配。
角色
Owner / Admin / Agent / Viewer 四种内置角色。
资源权限
可对知识库、客户、工单等资源分别配置读写权限。
数据隔离
多租户严格隔离，租户间数据不可见。
审计日志
所有关键操作记录可追溯，满足企业合规要求。
操作记录
登录、配置变更、坐席操作、API 调用均记录日志。
保留期
审计日志默认保留 180 天，企业版可配置最长 3 年。
导出
支持通过 API 导出指定时间范围的审计日志。
SLA 保障
服务可用性、响应时间、故障赔付的明确承诺。
可用性
月度可用性 ≥ 99.9%，未达标按比例退款。
响应时间
API P95 响应 < 500ms，WebSocket 消息延迟 < 200ms。
故障响应
P0 故障 15 分钟内响应，P1 故障 1 小时内响应。
赔付
可用性低于 99.9% 按月费 10% 赔付，低于 99% 按 30% 赔付。
帮助中心
常见问题、使用指南、故障排查的统一入口。
常见问题 FAQ
访问 /faq 页面查看产品、价格、接入、技术等高频问答。
使用指南
本文档中心涵盖快速开始、知识库、API、安全等完整指南。
故障排查
查看下方「系统状态」确认服务可用性，或通过 /register 联系客服。
社区与反馈
欢迎在 GitHub 仓库提交 Issue 或参与 Discussions 讨论。
更新日志
知心 ZhiXin 版本迭代与功能更新记录。
v1.0.0 (2026-07)
正式发布：8 维情感识别、RAG 知识库、人机协同、多渠道接入。
v1.1.0
新增关键词触发转人工、智能路由策略、坐席负载均衡、等待超时升级。
v1.2.0
新增会话结束流程、AI 总结工单、满意度回访、溢出转接。
v1.3.0
新增博客、FAQ、文档中心、sitemap、JSON-LD 结构化数据等 SEO/GEO 优化。
系统状态
实时服务可用性、组件状态、历史故障记录。
API 服务
运行中，P95 响应 < 500ms。
WebSocket 服务
运行中，消息延迟 < 200ms。
知识库检索
运行中，向量检索 + BM25 混合检索正常。
多渠道接入
网页 Widget、公众号、企业微信、钉钉均运行正常。
API 文档
REST API 与 WebSocket 协议的完整参考索引。
鉴权
JWT Token 获取与使用，详见 #auth 章节。
对话 API
创建对话、发送消息、获取历史，详见 #conversation 章节。
WebSocket 事件
消息、情感、转人工等实时事件，详见 #ws 章节。
Webhook
系统事件主动推送与签名校验，详见 #webhook 章节。
关于我们
知心 ZhiXin 是面向企业的情感智能客服系统。
使命
让 AI 不只是回复，更是理解。每一次对话都懂你。
核心能力
8 维情感识别、RAG 知识库、人机无缝协同、多渠道接入。
技术栈
基于 Cloudflare Workers + D1 + R2 + Vectorize 构建，全球边缘加速。
开源
项目仓库：https://github.com/yyq2026/askzhixin
联系方式
商务合作、技术支持、客户服务的联系入口。
客服邮箱
3637097398@qq.com
商务合作
通过 /register 页面提交需求，团队会在 1 个工作日内联系。
技术支持
注册用户可通过控制台工单系统提交技术问题，平均响应 1.2 秒。
GitHub
https://github.com/yyq2026/askzhixin
加入我们
知心正在寻找志同道合的伙伴，一起重新定义智能客服。
AI 算法工程师
负责情感识别、RAG 检索、对话生成等核心算法迭代。
全栈工程师
Cloudflare Workers + Next.js 全栈开发，参与产品从 0 到 1。
产品经理
深入客服场景，定义下一代情感智能客服产品形态。
投递方式
将简历发送至 3637097398@qq.com，邮件标题注明「应聘 + 岗位」。
服务条款
使用知心 ZhiXin 服务须遵守的协议与规则。
接受条款
注册或使用本服务即视为您已阅读并接受本服务条款。
使用规范
不得用于违法、侵权、骚扰、垃圾信息等用途，违者将封禁账号。
数据归属
用户上传的知识库、对话数据归用户所有，知心仅提供服务处理。
服务变更
我们保留随时调整服务内容、功能、价格的权利，重大变更会提前通知。
责任限制
在法律允许范围内，知心对间接、附带损失不承担责任。
隐私政策
我们如何收集、使用、存储、保护您的个人信息。
信息收集
收集注册信息（邮箱）、使用数据（对话、知识库）和日志信息。
信息使用
仅用于提供客服服务、改进产品、保障安全，绝不出售给第三方。
信息存储
存储于 Cloudflare D1/R2，静态加密，传输 HTTPS + TLS 1.3。
信息共享
除法律法规要求或您明确同意外，不会向第三方共享您的信息。
用户权利
您可随时访问、更正、删除个人信息，注销账号后数据将不可恢复地清除。
联系方式
隐私问题请联系 3637097398@qq.com。
需要更多帮助？
我们的客服团队随时为你服务，平均响应时长 1.2 秒。