Zilan

知澜 Zilan v1.2.0

知识汇聚成澜，让每一份文档活起来。

知澜（Zilan）是一款基于大语言模型的知识管理与智能问答平台，将 RAG 快速问答、ReAct Agent 智能推理与自动 Wiki 知识沉淀融于一体，以极简的产品体验与企业级的工程能力，打造完全私有化、自主可控的智能知识中枢。

✨ 核心特色

1. 🧠 完整记忆体系 —— 更懂你的个人知识助理

三层记忆架构（L1 工作记忆 / L2 短期记忆 / L3 长期记忆）+ 四模块结构化组织（灵魂 / 用户档案 / 记忆流 / 经验技巧）：

• 常驻注入：用户画像、偏好与风格指令无条件注入每一次对话，无需反复自我介绍；事实与待办按 语义相似度 × 时间衰减 × 访问频次 智能评分召回
• 反馈 → 技巧升级：你的批评（"太啰嗦"）会被自动提炼为可复用的方法论（"回答保持要点式"），反馈墙关联展示两者演化
• 「我的记忆」管理页：分类筛选、关键词搜索、卡片编辑、单条删除与 GDPR 级清空确认、全局记忆开关——AI 记住的每一项内容都透明可控

2. 🎯 五层上下文智能管理 · 对标 IMA 级架构

告别简单滑动窗口：精确 Token 预算按 L0-L4 五层分配（系统 / 记忆 / 检索 / 历史 / 查询），根据提问意图动态调剂——技术问题侧重检索层、闲聊创意侧重历史层；Map-Reduce 增量摘要、关键对话永久保留、长实体名自动别名压缩，把每一分预算都花在刀刃上。

3. 🧭 三栏模式化导航 · 全新布局语言 🆕

参考腾讯 ima 的设计理念，从两栏侧边栏重构为极窄导航栏 + 模式化列表栏 + 主工作画布的三栏结构：

• 60px 一级导航 Rail：问答 / 知识库 / 文档 / 智能体 / 记忆五大工作模式，线框图标 + 黑底白字选中态，一键切换工作场景
• 264px 模式化列表栏：内容随模式智能联动——问答模式展示时间线归档的历史会话（今天 / 昨天 / 近 7 天…），知识库模式展示库列表与启用状态，每模式一个专属主操作按钮
• ⌘/Ctrl + B 折叠列表栏、⌘/Ctrl + K 命令面板，小屏断点自动收纳
• 全站视觉同步打磨：知识库详情与设置页卡片化重构（灰画布 + 白卡片 + 虚线拖拽上传区），组织管理入口优雅收入头像菜单「我的空间」

4. 📄 全新「文档」模式 —— 跨知识库文档资产总览 🆕

不再需要逐个知识库翻找文档：

• 全局聚合：汇总所有知识库中的文档，按时间线归档展示，支持解析状态一键筛选（全部 / 解析中 / 已完成 / 失败）
• 概览仪表：文档总数、解析中、已完成、失败四张统计卡片实时掌握入库全景
• 文档详情页：解析进度时间线（docreader → chunking → embedding → multimodal → postprocess 五阶段）、所属知识库一键跳转、重新解析与删除操作

5. 💬 新对话中央输入区 · 对标 ima copilot 🆕

• 中央悬浮输入框：大圆角、聚焦时阴影微升；集成模型切换、@ 知识库联想引用、附件上传
• 「知澜 Copilot」激励标识：品牌涟漪标识 + 状态胶囊，每一次对话都有仪式感
• 四个圆形快捷入口：文档解读（选文件即问）、智能写作（续写 / 润色 / 摘要 / 翻译模板）、网页摘要、新建知识库
• 会话阅读体验：768px 黄金阅读宽度、AI 回答无气泡纯排版、贴底输入框上缘渐隐过渡

6. 🛡️ 双通道认证体系 —— 手机 / 邮箱注册登录与全链路验证码

完整的账户安全闭环，从注册到登录每一环都可验证、可防控：

• 双通道注册：手机号 / 邮箱两种注册方式，格式自动校验（大陆手机号、标准邮箱格式），验证通过后自动生成用户名
• 验证码发送：邮箱注册发送邮箱验证码、手机注册发送短信验证码，带频率限制防滥用；QQ / 163 / 126 / Gmail / 腾讯企业邮 / 阿里企业邮 / Microsoft 365 一行预设配置即真实发信，自建企业邮箱直接填写 SMTP 服务器即可
• 人机验证：注册与登录前需通过图形验证码，支持两种形式——滑块拼图（拖动滑块将图片移到缺口位置）与数字图形（按图片数字填入），服务端一次性 token 防重放
• 密码强度策略：8-32 位，必须同时包含大写字母、小写字母与数字，前后端双重校验
• 防重复注册：手机号 / 邮箱 / 用户名任一已被注册即拒绝，杜绝账号冲突
• 智能登录：登录框自动识别输入的是手机号还是邮箱，同一入口无感切换
• 零配置友好：未配置任何通道时自动降级为日志开发模式，验证码写入服务端日志，开箱即可跑通完整流程

7. 🎨 极简品牌语言 —— 从标识到界面的统一设计

全新「知澜」品牌视觉：以水波涟漪为意象的极简标识 + 知澜 Zilan 双语字标，标识与字标严格等高、共用中线；横版组合 Logo、SVG Favicon 与产品界面一脉相承的极简设计语言。

8. 📚 深度 RAG 知识引擎

多格式文档解析（PDF / Word / PPT / Excel / 图片 / 网页 / Markdown），自研 docreader 解析服务与逐阶段解析进度时间线；混合检索与多知识库管理；知识图谱（Neo4j）将文档转化为语义关联网络，为索引与检索提供结构化支撑。

9. 🤖 ReAct Agent 与开放生态

ReAct 循环推理与任务流水线、Agent 技能沙箱隔离；原生 MCP 协议支持（MCP Server + OAuth 按身份隔离）、权限范围 API Key（能力级授权 + 按 KB 限制 + 节流追踪）；zilan-widget.js 一行代码将智能体嵌入任意网站，支持域名白名单与限流。

10. 🔒 企业级安全与权限治理

空间 RBAC 四级角色矩阵（Owner / Admin / Contributor / Viewer）、invite-only 准入与受控自助创建、每空间审计日志、跨空间超级管理员；API Key 与数据源凭据 AES-256-GCM 静态加密并支持平滑密钥轮换；防 SSRF HTTP 客户端全链路覆盖、gRPC TLS + Token 传输加密、密钥响应脱敏。

11. 🌐 全渠道集成与云原生部署

17+ 模型厂商（OpenAI / Claude / DeepSeek / Qwen / 智谱 / 混元 / 豆包 / Gemini / Ollama…）、8 种向量数据库、7 类对象存储、10 个 IM 渠道（企业微信 / 飞书 / Slack / Telegram / 钉钉…）；Langfuse 全链路可观测（ReAct 循环、Token 消耗、工具调用）；Docker Compose / Kubernetes (Helm) 一键部署，版本升级自动数据库迁移。

📦 升级说明

• 老版本升级：docker compose pull && docker compose up -d，启动时自动完成数据库迁移
• 全新三栏布局：原侧边栏升级为「导航栏 + 列表栏」，五大模式一键切换；共享空间管理入口移至右上角头像菜单「我的空间」，待审批提醒并入右上角铃铛
• 新增快捷键：⌘/Ctrl + B 折叠列表栏，让画布全屏专注
• 首次启动若出现新手引导，可随时从头像菜单旁的帮助按钮重新打开

Zilan

知澜 Zilan v1.1.0

知识汇聚成澜，让每一份文档活起来。

知澜（Zilan）是一款基于大语言模型的知识管理与智能问答平台，将 RAG 快速问答、ReAct Agent 智能推理与自动 Wiki 知识沉淀融于一体，以极简的产品体验与企业级的工程能力，打造完全私有化、自主可控的智能知识中枢。

✨ 核心特色

1. 🧠 完整记忆体系 —— 更懂你的个人知识助理

三层记忆架构（L1 工作记忆 / L2 短期记忆 / L3 长期记忆）+ 四模块结构化组织（灵魂 / 用户档案 / 记忆流 / 经验技巧）：

• 常驻注入：用户画像、偏好与风格指令无条件注入每一次对话，无需反复自我介绍；事实与待办按 语义相似度 × 时间衰减 × 访问频次 智能评分召回
• 反馈 → 技巧升级：你的批评（"太啰嗦"）会被自动提炼为可复用的方法论（"回答保持要点式"），反馈墙关联展示两者演化
• 「我的记忆」管理页：分类筛选、关键词搜索、卡片编辑、单条删除与 GDPR 级清空确认、全局记忆开关——AI 记住的每一项内容都透明可控

2. 🎯 五层上下文智能管理 · 对标 IMA 级架构

告别简单滑动窗口：精确 Token 预算按 L0-L4 五层分配（系统 / 记忆 / 检索 / 历史 / 查询），根据提问意图动态调剂——技术问题侧重检索层、闲聊创意侧重历史层；Map-Reduce 增量摘要、关键对话永久保留、长实体名自动别名压缩，把每一分预算都花在刀刃上。

3. 🛡️ 双通道认证体系 —— 手机 / 邮箱注册登录与全链路验证码 🆕

完整的账户安全闭环，从注册到登录每一环都可验证、可防控：

• 双通道注册：手机号 / 邮箱两种注册方式，格式自动校验（大陆手机号、标准邮箱格式），验证通过后自动生成用户名
• 验证码发送：邮箱注册发送邮箱验证码、手机注册发送短信验证码，带频率限制防滥用；QQ / 163 / 126 / Gmail / 腾讯企业邮 / 阿里企业邮 / Microsoft 365 一行预设配置即真实发信，自建企业邮箱直接填写 SMTP 服务器即可
• 人机验证：注册与登录前需通过图形验证码，支持两种形式——滑块拼图（拖动滑块将图片移到缺口位置）与数字图形（按图片数字填入），服务端一次性 token 防重放
• 密码强度策略：8-32 位，必须同时包含大写字母、小写字母与数字，前后端双重校验
• 防重复注册：手机号 / 邮箱 / 用户名任一已被注册即拒绝，杜绝账号冲突
• 智能登录：登录框自动识别输入的是手机号还是邮箱，同一入口无感切换
• 零配置友好：未配置任何通道时自动降级为日志开发模式，验证码写入服务端日志，开箱即可跑通完整流程

4. 🎨 极简品牌语言 —— 从标识到界面的统一设计 🆕

全新「知澜」品牌视觉：以水波涟漪为意象的极简标识 + 知澜 Zilan 双语字标，标识与字标严格等高、共用中线；横版组合 Logo、SVG Favicon 与产品界面一脉相承的极简设计语言。

5. 📚 深度 RAG 知识引擎

多格式文档解析（PDF / Word / PPT / Excel / 图片 / 网页 / Markdown），自研 docreader 解析服务与逐阶段解析进度时间线；混合检索与多知识库管理；知识图谱（Neo4j）将文档转化为语义关联网络，为索引与检索提供结构化支撑。

6. 🤖 ReAct Agent 与开放生态

ReAct 循环推理与任务流水线、Agent 技能沙箱隔离；原生 MCP 协议支持（MCP Server + OAuth 按身份隔离）、权限范围 API Key（能力级授权 + 按 KB 限制 + 节流追踪）；zilan-widget.js 一行代码将智能体嵌入任意网站，支持域名白名单与限流。

7. 🔒 企业级安全与权限治理

空间 RBAC 四级角色矩阵（Owner / Admin / Contributor / Viewer）、invite-only 准入与受控自助创建、每空间审计日志、跨空间超级管理员；API Key 与数据源凭据 AES-256-GCM 静态加密并支持平滑密钥轮换；防 SSRF HTTP 客户端全链路覆盖、gRPC TLS + Token 传输加密、密钥响应脱敏。

8. 🌐 全渠道集成与云原生部署

17+ 模型厂商（OpenAI / Claude / DeepSeek / Qwen / 智谱 / 混元 / 豆包 / Gemini / Ollama…）、8 种向量数据库、7 类对象存储、10 个 IM 渠道（企业微信 / 飞书 / Slack / Telegram / 钉钉…）；Langfuse 全链路可观测（ReAct 循环、Token 消耗、工具调用）；Docker Compose / Kubernetes (Helm) 一键部署，版本升级自动数据库迁移。

📦 升级说明

• 老版本升级：docker compose pull && docker compose up -d，启动时自动完成数据库迁移
• 启用邮箱验证码真实发信：参考 README「⚙️ 初次运行配置」一节，配置 SMTP 后重启即可；不配置则自动走日志开发模式
• .env.example 自本版本起随仓库分发，cp .env.example .env 即获全部配置项说明

Zilan

知澜 Zilan v1.0.0

知识汇聚成澜，让每一份文档活起来。

知澜（Zilan）是一款基于大语言模型的知识管理与智能问答平台，将 RAG 快速问答、ReAct Agent 智能推理与自动 Wiki 知识沉淀融于一体，以极简的产品体验与企业级的工程能力，打造完全私有化、自主可控的智能知识中枢。

✨ 核心特色

1. 🧠 完整记忆体系 —— 更懂你的个人知识助理

三层记忆架构（L1 工作记忆 / L2 短期记忆 / L3 长期记忆）+ 四模块结构化组织（灵魂 / 用户档案 / 记忆流 / 经验技巧）：

• 常驻注入：用户画像、偏好与风格指令无条件注入每一次对话，无需反复自我介绍；事实与待办按 语义相似度 × 时间衰减 × 访问频次 智能评分召回
• 反馈 → 技巧升级：你的批评（"太啰嗦"）会被自动提炼为可复用的方法论（"回答保持要点式"），反馈墙关联展示两者演化
• 「我的记忆」管理页：分类筛选、关键词搜索、卡片编辑、单条删除与 GDPR 级清空确认、全局记忆开关——AI 记住的每一项内容都透明可控

2. 🎯 五层上下文智能管理 · 对标 IMA 级架构

告别简单滑动窗口：精确 Token 预算按 L0-L4 五层分配（系统 / 记忆 / 检索 / 历史 / 查询），根据提问意图动态调剂——技术问题侧重检索层、闲聊创意侧重历史层；Map-Reduce 增量摘要、关键对话永久保留、长实体名自动别名压缩，把每一分预算都花在刀刃上。

3. 📄 深度文档解析管线 · 把每一种 PDF 都读透

PDF 表格结构化抽取还原为 Markdown、数学公式转 LaTeX、双栏排版感知阅读顺序；按文档特征自动路由解析引擎强度，质量评分不过关自动换用更重引擎重试，疑难文档进入人工复核队列闭环处理。

4. 🕸️ GraphRAG 图谱增强检索

基于 Neo4j 构建知识图谱，社区摘要提供全局视野、局部子图检索提供邻域细节，与 BM25 / 稠密向量多路召回经 RRF 融合，显著提升多跳推理与跨文档汇总类问题的回答质量与可解释性。

5. 🤖 ReAct Agent 智能推理与工具生态

渐进式多步推理自主编排知识检索、MCP 工具（含 OAuth2 远程授权）、网络搜索与内置技能；支持 @Skill / @MCP 按轮次范围化运行时；高价值对话自动沉淀为结构化 Wiki 知识页并与源会话互链。

6. 🎨 全链路极简设计语言

深色单色品牌（#333 系）、大圆角、轻阴影、纯色背景，从登录页、对话流到设置中心视觉完全一致，安静克制，让内容成为主角；深色模式跟随系统，桌面 / 平板 / 移动端响应式适配。

7. 🔌 开放集成生态

• 模型：OpenAI / Claude / DeepSeek / Qwen / 智谱 / Gemini / Ollama 等 20+ 厂商，集中配置、交互式调试
• 数据源：飞书 / Notion / 语雀 / RSS 自动同步，增量与全量皆可
• 渠道：企业微信、飞书、钉钉、Slack、Telegram 等 10+ IM 直连问答；zilan-widget.js 一行代码嵌入任意网站
• 基础设施：8 种向量数据库、8 种对象存储后端自由替换

8. 🔐 企业级安全与私有化部署

四级 RBAC 角色矩阵 + 空间审计日志 + invite-only 准入；API Key 与凭据 AES-256-GCM 静态加密支持平滑轮换；防 SSRF HTTP 客户端与 Agent 技能沙箱隔离；Langfuse 全链路可观测；Docker / Kubernetes (Helm) 私有化离线部署，数据完全自主可控。