NoteFast

配置

AI 模型、图床上传等运行时配置——全部在设置页完成，落盘在 data/ 目录，无需改环境变量。

NoteFast 的运行时配置都在 Web 设置页完成，落盘在 data/ 目录下的 JSON 文件，无需改环境变量。

AI 模型

设置 → AI。所有 AI 能力走 OpenAI 兼容接口，三个槽位独立配置：

槽位作用未配置时
对话（chat）RAG 问答、AI 写作、AutoLink 抽取相关 AI 功能不可用
向量（embedding）语义检索、向量索引语义召回降级为纯词法
重排序（reranker）混合检索精排按 RRF 融合分排序

内置预设一键填入：MiniMax、DeepSeek、SiliconFlow（硅基流动）、阿里云百炼（DashScope）、OpenAI、OpenRouter、Moonshot、Jina、Voyage、Ollama（本地）。也可以选「自定义」指向任意 OpenAI 兼容端点（vLLM / LM Studio 等）。

向量索引是可随时重建的二级索引：更换 embedding 供应商后重建一次索引即可，正文数据不受影响。

图床上传

设置 → 图床。图片默认本地存储（data/media/，内容寻址去重）；开启自动上传后，图片在本地保存的同时异步上传到图床，导出与分享时直接使用图床 URL。

配置是 Typora 式「命令契约」：command [args...] <image_path> → stdout 每行一个 URL。NoteFast 不内置任何图床 SDK，凭据由命令自己持有（PicGo / upgit / picfast CLI 等）：

{
  "mode": "auto",
  "command": "picfast",
  "args": ["upload"],
  "timeoutMs": 30000
}

上传失败静默降级本地——不阻塞编辑、不丢图。配置落盘在 data/image-upload.config.json。

Markdown 影子副本

设置 → 通用与外观。把文档实时投影为普通 .md 文件到 data/markdown/（按首标签分目录），供访达 / 资源管理器直接浏览。单向副本——改这些文件不会写回笔记。详见数据目录。

其他设置入口

设置页内容文档
通用与外观主题、语言、数据目录、影子副本数据目录
AI 能力与模型三槽位模型、向量重建、AutoLink 阈值AI 能力
实体词典标准名 ↔ 别名校准实体词典
备份与归档数据库备份、多端同步、Markdown 归档备份与恢复 / 同步
API 与外部接入可撤销 API 令牌（权限最小化）、MCP 配置示例MCP 集成
账户安全登录事件审计（设备 / IP / 时间）—
维护数据库健康、应用日志、手动维护 / VACUUM维护