知识库与笔记系统
纯净 Markdown 物理映射、Milkdown 所见即所得编辑、AI 助手与对话整理笔记
本地优先、纯净双栏的知识库架构
ReinAgent 提供了完全本地自治的笔记本与 Markdown 知识库系统，位于左侧常驻导航栏「笔记」（BookOpen 图标）。所有笔记与目录均真实映射到本地文件系统，拒绝私有格式绑架。
核心特性概览
| 特性 | 实现与细节 |
|---|---|
| 物理文件落盘 | 数据持久化于 ~/.ReinAgent/notebooks/，每个笔记本对应真实物理文件夹，每篇笔记对应独立 .md 文件，与 Obsidian / Typora 等外部工具 100% 互通 |
| 多层目录层级 | 支持无限级嵌套子文件夹与即时搜索过滤；支持笔记本悬停重命名、新建子文件夹、新建笔记与安全删除 |
| 所见即所得编辑器 | 基于 Milkdown / ProseMirror 与 Nord 优雅主题，无缝打字、支持块级与行级格式即时渲染 |
| 三态视图切换 | 顶部滑动胶囊无缝切换 预览 (Eye) / 编辑 (Edit) / 分栏 (Split) 三态，兼顾沉浸阅读与精细源码调整 |
| 快捷格式工具栏 | 常驻快捷语法按键：H2、H3、粗体、斜体、删除线、行内代码、引用块、无序/有序列表、任务待办、分割线、代码块 |
| AI 写作助手侧弹窗 | 右上角 Sparkles 唤出抽屉弹窗（覆盖式设计，保持编辑区稳定不抖动），支持全文重构、段落润色、代码解释、要点总结与自定义提示词 |
| 任务对话一键整理笔记 | 在任务对话中点击顶栏 [📄 整理笔记 ⌄]，AI 自动提炼对话脉络与技术结论并沉淀为 Markdown 笔记，支持一键跳转查看 |
物理路径与存储规范
| 层级 | 物理位置与机制 |
|---|---|
| 根目录 | ~/.ReinAgent/notebooks/ |
| 默认笔记本 | ~/.ReinAgent/notebooks/default/（首次启动自动创建，中文展示为“默认笔记本”） |
| 笔记文件 | ~/.ReinAgent/notebooks/<notebook>/<subfolder>/<title>.md |
| 文件安全与防抖 | 编辑器内置防抖自动落盘机制，同时严格对标系统安全边界，防止跨目录路径穿越 |
笔记本数据绝不经过任何中心化云服务，所有读写均由 Rust 后端
notes_fs.rs 原生接管，并带 Web Mock 兼容层保障无头环境调试。AI 写作助手指令体系
| 指令 | 适用场景 |
|---|---|
| 全文重构 | 重新梳理文章结构与逻辑，提升文档专业度与可读性 |
| 润色语言 | 优化文笔与标点，使表述更流畅优雅、语法严谨 |
| 解释代码 | 对选中文档中的代码块或技术概念生成详尽的原理解读 |
| 提取总结 | 提炼核心要点为清晰有序的待办项或摘要 |
| 替换全文 / 文末追加 | 生成完毕后一键应用，精准触达编辑器文档模型并自动保存 |
RAG 语义检索（v0.2.9 新增）
笔记与导入的外部会话会自动分块并向量化，进入本地知识库索引；模型可通过语义检索利用这些内容回答问题，而不只是关键词匹配。
| 环节 | 机制与用法 |
|---|---|
| 绑定 embedding 服务商 | 设置 ▸ 知识库 ▸ 绑定任意 OpenAI 兼容 /embeddings 服务商（Qwen3-Embedding、本地 Ollama 等均实测可用），「测试 embeddings」即发真实请求验证并学习向量维度 |
| 索引与增量 | 「扫描并索引」按内容指纹增量向量化（未变内容不重复计费）；笔记保存与外部会话导入后 1.5s 自动重索引；换 embedding 模型会提示清空重建，严禁混维检索 |
| 每轮自动注入 | 输入胶囊左侧 Library 图标开启（任务级开关，全局默认兜底）：发送前以你的消息为查询做语义检索，命中块以 <knowledge-source> 并入上下文，请求预览的「用户上下文」节可查看命中明细 |
| 模型主动检索 | search_knowledge 工具始终挂载：对话里直接让模型「查一下知识库」，它会自主检索并引用来源标题与相关度 |
| 存储与安全 | 索引存于本地 ~/.ReinAgent/knowledge/knowledge-index.sqlite3（可随时清空重建，原文零损失、不进备份）；注意对话类内容纳入索引时会发往所选 embedding 服务商做向量化 |