Kuku是什么？
Kuku是一款AI原生的Markdown编辑器，其核心定位是帮助用户“更智能地写作并连接想法”。它并非一个简单的“聊天机器人+编辑器”的拼接，而是将人工智能作为底层能力深度融入写作、检索和知识组织的全流程。其最根本的哲学是 “无锁定、本地优先” ：所有用户文件都以纯文本 .md 格式保存在本地磁盘，用户可以随时使用Vim、Git或其他任何Markdown工具打开和编辑，确保了数据的完全自主权和控制力。
从技术架构看，Kuku是一款为macOS打造的原生桌面应用，采用Tauri v2（Rust后端）和React 19构建，旨在提供比基于Electron框架的应用（如Obsidian）更轻量、更高效的系统性能体验。简而言之，Kuku试图在Obsidian的“本地、无锁定”哲学与Notion/Cursor的“智能、一体化”体验之间架起一座桥梁，为用户提供一个既尊重数据隐私、又具备前沿AI生产力的现代化工具。
产品功能
Kuku的功能体系围绕“智能写作”与“知识连接”两大核心构建，具体可分为以下几个模块：
智能AI代理：这是Kuku区别于传统编辑器的核心功能。它基于Gemini模型，并具备工具调用能力。这意味着AI不仅能对话，还能根据指令主动执行操作，例如：
搜索知识库：根据问题在用户的全部笔记中查找相关信息。
读取文件：分析特定文件的内容。
创建新文档：根据指令生成并保存新的笔记。
其交互模式类似于Cursor编辑器，但专为个人知识库设计。例如，用户输入“总结上周的会议”，AI会先搜索相关会议笔记，读取内容后，再生成结构化摘要。
双向链接与知识图谱：
快速链接：输入
[[即可触发自动补全，快速创建笔记间的内部链接。反向链接面板：在编辑时，可实时查看当前文档被哪些其他笔记引用，便于理解知识脉络。
图谱视图：提供力导向图，可视化展示所有文档之间的连接关系，支持点击导航和拖拽探索，是进行知识梳理和发现隐性关联的利器。
Cursor风格的AI编辑预览：当AI对文本提出修改建议时，更改会以差异对比的形式清晰呈现，用户可以逐条审阅、接受或拒绝，确保用户对最终内容的完全控制权，避免了AI“黑箱”操作带来的不确定性。
本地语音转文字：集成 Whisper.cpp 实现完全离线的语音识别功能。用户可以在无需任何网络连接、不调用任何API的情况下，将语音实时转换为文本，极大提升了记录想法的便捷性，并彻底保障了隐私安全。
全文搜索：基于 SQLite FTS5 引擎构建，使用 BM25 算法进行相关性排序，搜索速度快且结果准确。一个特色是支持韩语分词，体现了其对多语言用户群体的考量。
纯文本兼容性：所有笔记均存储为标准的Markdown文件，存放于用户指定的本地文件夹（如
~/Documents/kuku/）。用户可以无缝使用任何外部工具（如Vim, VS Code, Obsidian）进行管理或版本控制（Git）。
产品特色亮点
| 特色 | 描述 |
|---|---|
| AI原生，工具调用 | 深度集成具备工具调用能力的Gemini AI，可主动搜索、读取、创建文档，实现“智能助理”级操作，而非被动聊天。 |
| 绝对的数据主权 |
所有数据以纯 .md 格式存储于本地，无云端锁定风险，用户拥有完全控制权，可与现有工作流（Git, Obsidian等）无缝衔接。 |
| 高性能原生体验 | 基于Tauri v2（Rust）开发，是真正的macOS原生应用。安装包仅约15MB，内存占用约80MB，相比Electron应用更轻量、响应更迅速。 |
| 透明可控的AI编辑 | 采用Cursor风格的差异对比预览，所有AI建议的修改均需用户显式批准，确保内容主导权始终在用户手中。 |
| 离线隐私安全 | 核心的语音转文字功能基于本地Whisper模型，无需联网；所有AI处理（若使用本地模型）和文件操作均在设备端完成，隐私保护级别高。 |
| 可视化知识连接 | 提供双向链接和动态图谱视图，帮助用户构建和探索笔记间的网络关系，强化知识的结构化与创造性连接。 |
使用指南
以下是从零开始使用Kuku的完整步骤：
第一步：下载与安装
访问Kuku官方网站。
点击“Download for macOS”按钮，下载安装包。
或者，对于熟悉命令行的用户，直接在终端执行：
brew install --cask kuku-mom/kuku/kuku。将应用拖入“应用程序”文件夹完成安装。
第二步：初始化与仓库设置
首次打开Kuku，应用会引导你创建一个“知识库”文件夹。你可以选择新建一个空文件夹，或指定一个已有的包含Markdown文件的文件夹（例如你现有的Obsidian仓库）。
Kuku会将该文件夹作为工作区，并自动索引其中的所有
.md文件。
第三步：核心操作流程
创建与编辑笔记：点击新建按钮，即可开始编辑。编辑器支持标准Markdown语法、实时预览。
使用双向链接：在编辑器中，输入
[[并开始键入已有笔记标题，系统会提供自动补全，选择后即创建链接。召唤AI代理：
通过快捷键或侧边栏按钮激活AI代理输入框。
输入自然语言指令，如：“基于
项目规划.md和上周的会议记录.md，起草一份下周的任务清单。”AI会显示其执行步骤（搜索、读取），并最终给出结果或编辑建议。
审阅AI编辑：当AI对现有文本提出修改时，界面会以绿色（新增）/红色（删除）高亮显示差异。使用
⌘Y接受单条更改，⌘N拒绝。使用图谱视图：点击侧边栏的图谱图标，即可进入全局关系图。点击节点跳转到对应笔记，拖拽布局以理清思路。
进行语音输入：点击编辑器工具栏上的麦克风图标，开始说话，语音将实时转为文字插入光标处。此功能全程离线。
全文搜索：使用顶部搜索栏，输入关键词，结果会按相关性排序展示。
第四步：高级管理与同步 由于文件全部本地存储，用户可以通过任何自己喜欢的云同步服务（如iCloud Drive, Dropbox, Syncthing）在不同设备间同步“知识库”文件夹。但需注意，Kuku目前暂无官方移动端应用。
适合人群
Kuku并非适合所有人，其设计理念针对特定需求的用户群体具有显著吸引力。
| 用户类型 | 应用场景 | 推荐功能 |
|---|---|---|
| 研究者与学者 | 管理文献笔记、构建理论框架、撰写论文草稿。 | 双向链接与图谱视图（连接概念）、AI代理（总结文献、启发思路）、全文搜索（快速定位）。 |
| 技术开发者与工程师 | 记录技术方案、项目日志、搭建个人知识库（PKM）。 | 纯文本本地存储（可用Git管理）、AI代理（解释代码片段、生成文档）、Cursor风格编辑（重构笔记）。 |
| 内容创作者与作家 | 构思文章大纲、整理素材、进行沉浸式写作。 | 本地语音转文字（速记灵感）、AI编辑预览（优化文稿）、无干扰写作环境。 |
| 重度笔记与知识管理爱好者 | 追求第二大脑（Second Brain）构建，重视数据长期保存与自由。 | 无锁定架构（避免平台风险）、图谱视图（可视化知识网络）、与Obsidian等工具兼容。 |
| 隐私敏感型用户 | 对数据云端存储有顾虑，希望核心工作数据完全掌控在自己手中。 | 全本地化操作（文件、语音识别）、离线可用、透明化的AI交互。 |
收费价格
常见问题解答（FAQ）
Q: 我能直接使用我现有的Obsidian仓库吗？
A: 完全可以。Kuku使用标准的Markdown文件，并且支持双向链接语法。你只需在Kuku中打开你的Obsidian仓库文件夹，即可立即开始工作，原有的链接和笔记结构都将被保留。
Q: Kuku的AI会学习或上传我的私人文档吗？
A: 根据其设计理念，Kuku强调本地优先和隐私。AI代理的“工具调用”功能（如搜索、读取文件）是在你的本地设备上执行的。如果使用的是云端AI模型（如Gemini），你的提示词和必要的文件内容可能会被发送至AI服务提供商进行处理。但本地语音转文字（Whisper） 功能是100%离线的。建议仔细阅读其隐私政策以了解具体的数据处理细节。
Q: 我可以在完全离线的环境下使用Kuku吗？
A: 基础编辑、文件管理、图谱视图和本地搜索可以完全离线使用。本地语音转文字功能也完全离线。然而，AI代理功能如果依赖于云端大模型（如Gemini），则需要网络连接。未来若支持完全本地运行的大模型，则可实现全功能离线。
Q: 为什么Kuku选择Tauri而不是Electron？ A: 为了追求更好的性能和原生体验。Tauri使用Rust编写核心，并利用操作系统的原生Web视图，使得应用安装包更小（~15MB）、内存占用更低（~80MB）、启动更快，且对系统资源的消耗远低于典型的Electron应用。这带来了更流畅的macOS原生应用感受。
Q: Kuku有移动版（iOS/Android）吗？
A: 目前没有。Kuku现阶段专注于macOS桌面端体验的开发。用户可以通过同步本地仓库到云盘，并在移动端使用其他Markdown编辑器查看文件，但无法获得Kuku特有的AI和图谱等功能。
Q: 它的全文搜索支持中文吗？
A: 官方文档明确指出其全文搜索基于SQLite FTS5并支持韩语分词。虽然没有明确提及中文分词，但标准的FTS5通常能对中文进行基础的词语匹配。对于复杂的中文搜索需求，其效果可能不如专门优化的引擎，但基础搜索功能可用。
Q: 如何保证我的数据安全？
A: 数据安全的根本在于本地存储。你的所有笔记文件都在自己电脑上，由你控制备份和加密（如使用加密磁盘或文件系统）。只要保管好本地设备，数据就是安全的。这是与云端笔记工具最根本的安全逻辑差异。
Q: 与Notion和Obsidian相比，Kuku的主要区别是什么？
A: 与Notion相比，Kuku放弃了实时协作和强大的数据库功能，换来了数据本地化、无锁定和原生性能。与Obsidian相比，Kuku提供了深度原生集成、开箱即用的AI能力，而非依赖社区插件，且在性能架构上更现代化。
总结
综上所述，Kuku是一款理念鲜明、设计精巧的细分市场产品。它的核心优势在于成功地将前沿的、具备工具调用能力的AI与坚如磐石的本地优先、无锁定架构相结合，并通过高性能的原生应用形式交付。它不适合追求强大协作、丰富插件生态或移动端优先的用户。然而，对于那些将数据主权、隐私安全置于首位，同时又渴望利用AI提升个人知识管理效率与写作智能度的macOS用户——尤其是研究者、开发者、写作者和知识管理极客——Kuku提供了一个当前市场上几乎独一无二的解决方案。它代表了一种未来方向：生产力工具在变得日益智能的同时，也应将选择权和控制权更彻底地交还给用户。
