快速开始
这一页帮你完成从安装、启动、创建工作区到写下第一篇笔记的最短路径。
准备环境
本地开发和桌面运行需要以下环境:
| 工具 | 用途 |
|---|---|
| Node.js | 运行 Next.js 前端和构建脚本。 |
| pnpm | 安装前端依赖。 |
| Rust / Cargo | 构建 Tauri 桌面端。 |
| Tauri 系统依赖 | 提供原生窗口、文件系统、数据库等能力。 |
安装依赖
pnpm install启动桌面开发模式
pnpm tauri dev完整功能依赖 Tauri 桌面运行时。只运行 pnpm dev 时,浏览器里只能看到受限预览。
为什么不是直接打开网页?
LingMo 需要本地文件系统、SQLite 数据库、全局快捷键、原生窗口和本地模型工具调用能力。这些能力由 Tauri 提供,普通浏览器没有完整权限。
创建或选择工作区
- 首次进入后,在文件区选择一个本地文件夹作为工作区。
- 工作区内的 Markdown、图片、PDF、图表等文件会显示在文件树中。
- 建议为不同用途建立独立文件夹,例如
Inbox、Projects、Reading、Archive。
写第一篇笔记
- 在文件树中新建 Markdown 文件。
- 在编辑器中输入正文,使用标题、列表、表格、代码块组织内容。
- 需要 AI 辅助时,可在右侧聊天区提问,或在编辑器中使用
/命令。 - 需要导出时,可以从编辑器导出菜单选择 Markdown、HTML 或 PDF。
建议优先配置的功能
| 配置项 | 位置 | 配置建议 |
|---|---|---|
| AI 模型 | 设置 → AI | 配置 OpenAI 兼容服务,解锁聊天、整理、转写总结等能力。 |
| 记录工具栏 | 设置 → 记录 | 保留自己常用的文本、链接、截图、录音、待办按钮。 |
| 知识库 | 设置 → 知识库 | 配置 Embedding 和 Rerank 模型后再建立索引。 |
| 同步 | 设置 → 同步 | 如果要跨设备使用,先配置私有同步仓库或对象存储。 |
新人首发推荐工作流
- 创建工作区,并新建一篇 Markdown 笔记。
- 配置 Chat 模型,确认右侧聊天能正常回答。
- 打开记录页,分别试一次文本、链接、截图、录音和待办。
- 把几条记录合并成一篇笔记,理解“收集 → 整理 → 写作”的流程。
- 配置知识库 Embedding,给常用文件夹建立索引。
- 用
/生成闪卡从当前笔记生成卡片,再打开闪卡工作台复习。 - 打开活跃度中心,查看今日活动和同步页签。
- 配置同步平台,先上传所有文件,再上传记录和配置。
哪些功能需要额外配置
| 功能 | 需要配置 | 不配置时会怎样 |
|---|---|---|
| AI 对话、整理、总结 | Chat 模型 | 只能使用非 AI 的基础编辑和记录功能。 |
| 知识库 RAG | Embedding,可选 Rerank | AI 不能稳定引用你的本地笔记。 |
| 录音 / 视频转写 | STT 模型,视频兜底需要 yt-dlp 和 ffmpeg | 只能保存音频或读取公开视频字幕。 |
| 截图总结 | OCR 或视觉模型 | 只能保存原图,无法自动识别内容。 |
| GitHub 项目整理 | GitHub Token 可选 | 没有 Token 时 API 限额更低,会走普通网页解析兜底。 |
| 同步备份 | GitHub、Gitee、GitLab、Gitea、S3 或 WebDAV | 数据只保存在本地。 |
| Agent 外部工具 | MCP 服务和 Skills | Agent 只能使用内置能力。 |