Folyn — 本地优先 AI 原生知识工作空间

产品简介

Folyn 是一款本地优先（Local-First）的 AI 原生知识管理桌面应用，基于 Tauri 2 和 React 构建，支持 Markdown、白板、思维导图、ER 图等多种格式的本地编辑，并以 Vault 机制隔离每份数据，确保所有内容始终存储在用户自有设备上，无需云端账号。应用深度集成 Claude Code、Codex CLI、Gemini CLI 等主流 CLI AI 代理，用户可在编辑器内直接调用 AI 辅助写作和编程，打通知识管理与 AI 工作流的完整闭环。Folyn 目前提供 macOS 与 Windows 安装包下载，适合个人知识工作者、开发者以及需要在本地安全管理大量笔记和项目文档的用户群体。

核心功能

Vault 多 Vault 隔离机制

每个 Vault 代表一个独立的数据空间，可按项目或主题分类管理笔记、附件和扩展配置。切换 Vault 等同于切换整个工作区，数据完全存储在本地设备，无需注册云端账户，支持同时打开多个 Vault 并随时切换，数据始终以设备为唯一真实数据源。

多格式编辑器

Folyn 在单一编辑器内支持多种内容格式：标准 Markdown（含容器扩展：按钮、标注、卡片、折叠、代码高亮等）；富文本（所见即所得排版）；结构化数据（CSV、JSON 直接编辑）；思维导图（markmap 自动渲染大纲为可视化结构）；ER 图（dbml）；架构与流程图（drawio、graphviz DOT、PlantUML、Mermaid）；手绘白板（Excalidraw）。此外还支持在应用内直接预览 Office 文档、音频视频、压缩包、电子书和演示文稿，无需安装额外软件。

深度 AI 代理集成

Folyn 内置六大主流 CLI AI 代理适配器：Claude Code、Codex CLI、Gemini CLI、Opencode、Pi Code Agent、Qoder。用户在设置中配置各代理的 CLI 路径后，即可按任务需求自由切换不同模型供应商，不被单一供应商锁定。代理可直接读取和修改当前文档，AI 编辑内容实时呈现在编辑器中，实现编辑、调用、回写的一体化流程。

桌面宠物助手

Folyn 提供常驻桌面的宠物助手模块，主动推送日程提醒和任务变更通知，点击即可弹出 LLM 对话窗口，用户无需切换应用即可随时向 AI 提问。外部脚本和 CI 系统可通过本地 HTTP API（默认 127.0.0.1:17382）触发宠物通知气泡，支持导航、启动 URL 或应用等交互操作。

内嵌终端

Folyn 内置终端面板，与编辑器并排显示，文件路径与当前文档自动同步。Claude Code、Codex CLI 等代理可直接在终端内修改当前文档，AI 修改内容即时反映到编辑器；终端输出内容可一键粘贴回文档光标处，实现编辑、调用、回写无缝衔接，减少窗口切换成本。

扩展系统与插件商店

Folyn 采用微内核加扩展 SDK 架构，核心保持精简，功能按需加载。内置扩展包括：多语言翻译（Multilingual）、日程管理（Schedule，支持任务提醒、专注番茄钟和看板）、Wiki 知识库（链接和组织知识条目构建可导航的知识网络）。官方扩展以 GitHub Release 作为分发商店，用户可在扩展设置页直接下载安装。社区可依据扩展 SDK 自行开发第三方扩展。

语音输入

支持语音实时转文字并自动润色（去除语气词和停顿），直接粘贴到光标位置，大幅提升文字录入效率（目前支持 macOS，Windows 暂未支持）。

技术实现

Folyn 的技术栈选型兼顾性能、安全与开发效率：核心采用 Tauri 2（Rust 后端）提供原生桌面体验，前端使用 React 18 + Vite 6 + TypeScript 构建响应式界面，编辑器基于 CodeMirror 6 实现，支持复杂文档结构的代码高亮和实时预览。Markdown 处理管线采用 unified/remark/rehype 生态，保证渲染一致性。状态管理使用 Zustand 5，配合 pnpm workspaces 单仓管理 apps（桌面应用）和 packages（共享包）两大部分。packages 下包含 cli-adapter（AI 代理抽象层）、container-extensions（Markdown 容器扩展）等可复用模块，便于扩展开发。整体架构遵循核心最小化、功能插件化原则，各功能模块通过标准接口与核心通信，保证系统稳定性的同时支持灵活扩展。

快速上手

第一步：下载安装

访问 GitHub Release 页面（https://github.com/linyimin0812/folyn/releases）下载对应操作系统的安装包。macOS 用户下载 .dmg 文件，Windows 用户下载 .exe 安装程序。初次启动时系统可能弹出安全警告，macOS 用户需在终端执行 xattr -cr /Applications/Folyn.app 后重新打开，Windows 用户点击更多info、仍要运行即可。

第二步：创建或导入 Vault

启动 Folyn 后，点击侧边栏新建 Vault 创建一个独立数据空间。可选择导入已有文件夹作为 Vault 起点，或从空目录开始。每次打开 Folyn 即进入上次最后活跃的 Vault，无需手动选择。

第三步：配置 AI 代理

点击左下角设置图标，进入 AI 配置页面，填写本地已安装的 CLI 代理路径（支持 Claude Code、Codex CLI、Gemini CLI、Opencode、Pi Code Agent、Qoder）。配置完成后，在编辑器内选中文本或使用快捷键即可唤起 AI 辅助，输入需求后 AI 将直接在当前文档中生成或修改内容。

第四步：开始多格式创作

在当前 Vault 中新建 Markdown 文档，可通过 Markdown 语法插入思维导图（markmap）、ER 图（dbml）、流程图（Mermaid、PlantUML）等丰富元素。利用扩展商店安装翻译、日程、Wiki 等扩展，打造个人知识管理工作流。所有内容默认存储在本 Vault 目录，关闭应用后数据完整保留，不依赖任何云端同步服务。

适用人群

Folyn 主要面向以下用户群体：需要本地安全管理大量笔记、项目文档和技术资料的开发者；希望在同一应用内完成知识整理与 AI 辅助编程的产品经理和技术写作者；对数据隐私有较高要求、不希望将笔记上传至云端的个人知识工作者；需要管理多项目上下文、频繁在笔记与代码之间切换的独立创作者。

官方链接

• 产品官网：https://linyimin0812.github.io/folyn/
• GitHub 仓库：https://github.com/linyimin0812/folyn
• 安装包下载：https://github.com/linyimin0812/folyn/releases