ALong LLM Chat 使用指南

🚀 功能特点

• 多厂商聚合：支持 DeepSeek、OpenAI、Claude 等一键切换。
• 个人知识库 (RAG)：支持上传 PDF、Markdown、文本，自动切片并生成向量索引，实现精准的语义检索。
• 背景材料定制：支持对话背景资料录入，并具备超长自动摘要功能，精准引导 AI 回复。
• 隐私安全：数据存储在本地或个人坚果云，原始文档托管在腾讯云 COS，不经过第三方中转。
• 联网搜索：集成 Tavily 实时检索，支持显示网页来源和当前时间校准。
• 智能压缩：自动生成对话摘要，长聊不糊涂，Token 大节省。
• 极致渲染：支持代码块语法高亮、Emoji 表情、KaTeX 数学公式及多种 Markdown 复杂格式。
• 虚拟滚动：海量消息自动优化性能，浏览流畅不卡顿。
• 跨端同步：支持配置、对话记录以及知识库索引的云端双向同步。

📖 快速上手

1. 基础配置：点击侧边栏"设置"，在"API设置"中添加厂商并填入 API Key。
2. 配置知识库：点击侧边栏"知识库"，在"参数配置"中填入腾讯云 COS 信息和向量化接口。
3. 构建库：点击"新建知识库"创建分类，拖拽或点击上传文档，观察进度条完成解析。
4. 开启 RAG：返回对话，点击输入框工具栏的"书本"图标开启知识库，点击"选择知识库"勾选对应分类。
5. 开始对话：发送消息，AI 将优先参考您的知识库内容给出专业回答。
6. 云端同步：在"云同步"中配置 WebDAV，点击"下载"可恢复所有设置和文档列表。

⚙️ 详细配置说明

1. 知识库 (RAG) 配置

• 腾讯云 COS：用于持久化存储原始文件。需配置 SecretId、SecretKey、Bucket 和 Region。
• Embedding 向量化：需配置支持 /embeddings 接口的服务（如 OpenAI 或兼容接口）。
• 切片策略：建议 Chunk Size 设为 500-1000 字符，Overlap 设为 50-100 字符以保留上下文连续性。

2. 对话背景材料

• 点击对话窗口顶部标题栏右侧的 📝 图标进入。
• 自动摘要：开启后，超长背景将自动由 AI 压缩，在节省 Token 的同时保留核心逻辑。

3. 联网搜索配置

• 访问 tavily.com 注册账号获取 API Key。
• 在设置页粘贴 Key 即可开启输入框下方的"地球"图标。

4. WebDAV 云同步

• 坚果云：账户设置 → 安全选项 → 应用密码（推荐）。
• 本地代理：若遇到跨域问题，请务必勾选"使用本地 Node 代理"。

💡 使用技巧

知识库进阶

• 多库分类：利用多库管理功能，将“技术手册”与“生活笔记”分开，对话时按需勾选。
• 云端就绪：更换终端后，文档列表会自动显示“云端就绪”，点击刷新按钮 🔄 即可极速恢复本地向量索引。
• 实时进度：大文档上传时，列表会显示 (当前切片/总切片)，解析过程一目了然。

高效对话

• 组合技：同时开启联网搜索和知识库，AI 既能参考您的私有文档，也能获取最新时事。
• 强制刷新：遇到任何显示问题或配置不生效，使用 Ctrl + F5 是万能药。
• 多模态：直接在对话框粘贴截图或拖入文件，系统会自动识别并提示上传。

快捷键操作

• Ctrl + N：新建对话
• Ctrl + M：切换对话模型
• Ctrl + B：切换侧边栏显示/隐藏
• Ctrl + Enter：发送消息（可在设置中切换为 Enter 直接发送）
• Ctrl + /：查看完整键盘快捷键列表

🔧 常见问题解答

关于知识库

Q: 换了电脑后，上传过的文档还在吗？
A: 在。只要配置了相同的 COS 和 WebDAV，执行下载后列表会自动恢复。点击同步按钮即可拉取云端已有的向量索引，无需重新解析。

Q: 支持哪些文件格式？
A: 目前深度支持 .txt、.md 和 .pdf。PDF 采用流式解析，即使是长文档也能稳步处理。

Q: 检索效果不理想怎么办？
A: 尝试调整“切片大小”和“重叠长度”。另外，确保 Embedding 模型与知识库索引时使用的模型保持一致。

通用问题

Q: API Key 存储安全吗？
A: 所有敏感信息都本地加密存储。通过服务器代理转发上传，不会在前端暴露 SecretKey。

Q: WebDAV 同步失败？
A: 检查是否配置了应用密码，并确保服务器端 proxy.js 正常运行（用于跨域代理）。