SpringNote 是一款专为“懒人”设计的笔记工具。你只需随时随地记录碎片化想法，AI 会自动将它们整理成每日、每周和每月报告，将散落的片段编织成完整的记录。它还提供了“记忆”功能，让你可以通过对话搜索和回顾过去的笔记。

本教程将指导你完成 SpringNote 的安装、配置和核心功能的使用。

📦 第一步：下载与安装

SpringNote 提供预编译的桌面应用安装包，支持 Windows 平台。

  1. 获取安装包：
    • 访问项目的 GitHub Releases 页面。
    • 下载最新版本的安装包（例如 SpringNote-Setup-x.x.x.exe）。
  2. 安装应用：
    • 运行下载的 .exe 安装文件。
    • 按照安装向导的提示完成安装。你可以选择安装路径和是否创建桌面快捷方式。
  3. 首次启动：
    • 安装完成后，启动 SpringNote。系统会提示你确认数据存储目录。所有笔记、图片和配置文件都将保存在此目录下（例如 我的文档/SpringNote/）。请选择一个你方便备份和访问的位置。

⚙️ 第二步：配置 AI 模型（以 DeepSeek 为例）

SpringNote 的核心 AI 能力需要连接一个大语言模型（LLM）API。目前主要支持 OpenAI 兼容的接口。DeepSeek 是一个推荐选项，配置步骤如下：

  1. 获取 API Key：
  2. 在 SpringNote 中添加提供商：
    • 打开 SpringNote 主界面，进入 “设置” 或 “偏好设置”。
    • 找到 “AI 配置” 或 “模型” 部分。
    • 点击 “添加提供商”，填入以下信息：
      • 名称：填写 DeepSeek (或任意便于识别的名称)。
      • Base URL：必须填写 https://api.deepseek.com/beta (注意路径中的 /beta，这是 DeepSeek FIM API 的要求)。
      • API Key：粘贴你从 DeepSeek 平台获取的 API Key。
  3. 手动添加模型：
    • 由于 DeepSeek 的 /beta 端点不支持自动列出模型，你需要手动添加。
    • 在提供商配置页面，点击 “添加模型”。
    • 输入模型名称，例如 deepseek-v4-flash (或其他你拥有的 DeepSeek 模型)。
  4. 启用补全功能：
    • 在已添加的模型列表中，编辑该模型的配置。
    • 务必手动勾选支持 “补全 (Completion)” 功能的选项。这是 AI 生成报告和整理笔记所必需的。
  5. 设为默认：
    • 在模型列表中，将刚刚配置好的模型设为默认模型。只有支持补全功能的模型才会出现在补全模型列表中。

对于其他 OpenAI 兼容 API：步骤类似，只需根据提供商的文档填写正确的 Base URL 和 API Key，并确认模型支持补全功能。

🚀 第三步：核心功能速览与使用

配置好 AI 后，你就可以开始使用 SpringNote 的核心功能了。

3.1 主页与快速记录

  • 主页仪表盘：显示你的“工作马等级”、收入、活动热力图、快速输入框和今日摘要。
  • 快速记录：在主页的输入框中，随时记录你的想法、待办或任何碎片化文字。AI 会在后台自动尝试将其组织成更结构化的内容。

3.2 创建与管理笔记

  • 笔记编辑器：你可以在笔记本中按每日、每周、每月的维度创建和编辑笔记。编辑器支持 Markdown 格式，提供实时预览、代码高亮，甚至 AI 补全建议。
  • 自动报告生成：应用启动时会自动检查，如果发现缺失的周报或月报，会根据已有的日/周笔记内容自动生成。这大大减少了整理工作量。

3.3 “记忆”聊天 (Memories)

这是 SpringNote 的亮点功能。

  1. 在侧边栏点击 “记忆” (Memories)。
  2. 你可以像聊天一样，用自然语言提问，例如 “我上周主要做了哪些事？” 或 “关于项目 X，我记录过什么？”。
  3. AI 会搜索你的历史笔记，并在对话中展示思考过程和工具调用，最终用 Markdown 格式清晰呈现检索到的记忆。

3.4 “工作马时钟” (Workhorse Clock)

这是一个桌面小工具，用于追踪你的工作时间和收入。

  • 设置时薪：在设置中配置你的预期日薪和工作时长，系统会自动计算你的时薪。
  • 使用小工具：
    • 左键单击：开始或暂停计时。
    • 右键单击：打开主窗口并跳转到主页。
    • 左键拖拽：移动小工具在屏幕上的位置。
    • 小工具会实时显示当前计时、今日工作时长和估算收入。

🔧 第四步：探索更多设置

完成基础配置后，你可以在 “设置” 中探索更多个性化选项：

  • 数据目录：更改或确认笔记、图片等数据的存储位置。
  • 全局快捷键：配置方便快速唤出主窗口或小工具的键盘快捷键。
  • 系统托盘与开机自启：设置应用最小化到系统托盘，或随系统启动。
  • 桌面状态小工具：除了工作马时钟，你还可以添加其他显示状态信息的小工具。
  • 界面定制：切换系统字体，或调整应用的外观主题。

🩺 常见问题与排障

  • AI 功能无响应或报错：
    1. 检查 API Key 是否正确，以及账户是否有足够余额。
    2. 确认填写的 Base URL 是否正确 (DeepSeek 需要 /beta)。
    3. 检查添加的模型是否已勾选“补全能力”。
    4. 查看网络连接是否允许访问配置的 API 端点。
  • 笔记或报告未自动生成：
    1. 确认 AI 模型配置正确并已设为默认。
    2. 检查软件是否有足够的权限读写你设置的数据目录。
    3. 在设置中查看“自动生成报告”功能是否被意外关闭。
  • 应用无法启动或崩溃：
    1. 尝试以管理员身份运行。
    2. 检查 Windows 系统是否满足运行要求。
    3. 在 GitHub Issues 中搜索类似问题，或提交新的 Issue，并附上版本号、重现步骤和错误截图。

💬 社区与支持

  • QQ 群：463423961 - 加入官方社区，分享经验、反馈问题。
  • GitHub Issues：提交 Bug 报告或功能请求。

现在，你已经完成了 SpringNote 的部署和配置。开始用它轻松记录生活和工作，让 AI 帮你把碎片信息编织成有序的回忆吧。