Knote

A modern, Feishu-style WYSIWYG Markdown editor with a built-in AI agent.
类飞书体验的所见即所得 Markdown 编辑器，内置可审改的 AI 助手。

Cross-platform · Local-first · Bring-your-own-AI-key
跨平台 · 本地优先 · 自带 AI 密钥

官网 / Website: knote.work

English · 中文

中文

Knote 是一款本地优先的 Markdown 编辑器，拥有现代块编辑器（飞书 / Notion 风格）的顺滑体验，同时可配置辅助 Agent，他可以帮助你维护、修改、重构文档，你可以审改他的修改，不满意的内容可以拒绝修改。可作为网页应用（部分功能受限）、Windows 桌面应用（推荐）和 Android 应用（正在测试）运行。

演示：拖入 PDF → 生成论文总结并自动配图

https://github.com/user-attachments/assets/f9992311-e33d-4753-a1ff-96be1ba3cadf

✨ 基础功能

• 所见即所得的编辑体验 —— 输入 Markdown 语法即时转换，一键可切到源码/预览双栏模式。
• 丰富的 Markdown —— 标题、列表、任务、表格、带语法高亮的代码块、KaTeX 公式、脚注、Emoji、高亮/下划线等。
• Callout 提示块 —— > [!tip]、> [!warning] 等渲染为彩色卡片。
• Mermaid 图表 —— 写 mermaid 代码块即可实时渲染流程图/时序图。
• 标签页与文件夹工作区 —— 像浏览器一样同时打开多个文档/文件夹，可拖拽排序，重启自动恢复。浏览文件夹树、新建/重命名/删除/移动文件与文件夹，并跨文件全文搜索。
• 查找替换（Ctrl+F / Ctrl+H）、快速打开（Ctrl+P）、标题折叠、版本历史（一键回滚）、图片查看器（双击放大/拖拽）、界面缩放（Ctrl+滚轮）。
• 导出 PDF、Word（.doc）、HTML、Markdown。
• 中英双语界面。

🤖 AI 助手

Knote 内置 AI 助手，直接驻守在编辑器中，目标是帮你把"写、改、审、理"文档这件事变得更顺手。他不会直接修改原文，而是先把改动暂存成 diff，用户逐块或一键接受后才会生效。

能做什么：

• 读写当前文档（带审核）：读取带行号的全文后生成修改——替换、插入、续写长内容、图文一次成型；改动先以红/绿 diff 暂存。“编辑文档时人工审核”开启时可逐块或一键接受/拒绝，关闭时仅在 exact CAS 校验通过后自动应用，绝不盲目覆盖原文。
• 管理整个工作区：打开文件夹后，列目录、读其他 Markdown、按内容全库检索、看文档大纲快速定位；新建 / 精确编辑 / 重命名 / 移动 / 删除（进回收站）文件；还能把同一任务并发批处理到多个文件。
• 读 PDF 与图片：拖入附件，或直接读工作区里的 PDF / 图片。桌面版把整份 PDF 在本地结构化——正文转文字、图和表格连同图注提取成可引用的元素，随消息发给助手；需要时查看某图高清原图，并把图/表精确插进文档。网页版退化为按页读取文字和整页截图。
• 多引擎搜索、论文检索与读网页：可同时启用 Bing、DuckDuckGo、Mojeek；桌面版和 Android 通过你自己的网络并行查询、去重并融合结果，桌面版还能抓取网页正文。论文检索固定使用 OpenAlex + Crossref，支持 DOI、年份、预印本与撤稿标记。网页版通用搜索需配置 Jina Key，且仅通过 Jina 查询 DuckDuckGo。
• 规划与自我追踪：面对多步任务，先列一份计划清单、边做边打勾，进度实时显示在右侧工作区面板（见下）。
• 实用工具：知道当前的本地日期 / 时间（"三天后""本周"都能算），需要精确算数时用内置沙箱计算器（支持科学计数、常用函数）。
• 以 diff 形式审稿：所有对当前文档的修改都以红/绿 diff 暂存，你逐块接受/拒绝或一键全接，避免误改原文；改动前会先看现有格式，公式、代码块、列表层级尽量沿用你的风格。

助手会用哪些工具，取决于你的模型是否支持"工具调用"以及当前是否打开了文件夹——点"检测"后会亮起对应能力徽章。所有联网/文件/图片来源的内容都被当作不可信外部数据，其中的指令不会被执行。

工作区面板 —— 让 agent 的工作全程可见：

助手工作时，聊天窗口右侧会展开一块工作区面板，把它正在做的事实时摊开给你看，不再是黑箱：

• 计划：多步任务的每一步——未开始 ○ / 进行中 ◍ / 已完成 ✓，实时打勾，附完成进度。
• 动态：它调用了哪些工具、搜索/抓取了哪些网址、读写了哪些文件，按栈自上而下逐条显示，成功 / 出错一目了然。
• 子任务：用多智能体并发处理多个文件时，每个子任务的进度也在这里实时显示。

面板只展示当前这一次任务的进展，任务结束自动归位；不需要时可一键收起。

示例截图，可能因版本更新稍有不同

参考场景：

• 生成复习资料：把 PDF 教材或课堂笔记拖拽给助手，让他生成复习资料、思维导图式提纲、Anki 卡片或 Markdown 表格，随后一边看资料一边用"问助手"追问概念。

示例截图，可能因版本更新稍有不同

• 边学边问：阅读技术文档时遇到不懂的术语或公式，直接选中让助手解释、举例或补充推导过程，无需跳出编辑器去搜索。
• 论文/报告润色：写好初稿后让助手检查逻辑断层、语法和排版，生成 diff 后逐条接受，保留自己想要的表达。
• 会议纪要整理：把会议录音转录或手写速记丢给助手，让他提炼决议项、待办清单和责任人表格。
• 代码文档化：选中代码块，让助手补充参数说明、示例用法，并自动生成对应 API 说明段落。
• 多文件知识库问答：打开整个项目文件夹，让助手跨文件检索并总结某个模块的实现或历史变更。
• 写作陪跑：卡壳时给出大纲建议、续写段落或反向提问，帮你把思路理顺。

配置：

点击右下角绿色圆球打开助手，进入设置：

1. 选择协议 —— 多数服务选 OpenAI 兼容，Claude 官方接口选 Anthropic。
2. 填写 API 地址、API Key、模型名称。
3. 点击检测 —— Knote 会探测模型能力并亮起徽章（对话 / 工具 / 图片 / PDF）。

密钥仅存于浏览器本地存储；Knote 没有中转服务器。模型请求会直接发送到你配置的模型服务；学术检索会把查询发送到 OpenAlex/Crossref；使用 Jina 通道时，DuckDuckGo 搜索词会发送到 r.jina.ai。Android 的模型 JSON POST 从第一跳就走原生 HTTP，不先发送或失败后重放渲染器请求；该原生通道使用有界缓冲并强制非流式响应。关闭“联网搜索”会同时停用通用与学术联网检索。

PDF 版面分析（可选增强）：桌面版设置里提供 PaddleOCR 环境的一键安装——没有安装过 Python 也没关系，Knote 会自动下载内置版 Python 并完成全部配置（全程国内镜像）。装好后，PDF 的图表提取与精确定位能力自动启用；不装也能正常使用文字读取和整页截图。

📖 三分钟上手

1. 写：新建文档，直接输入 # 标题、- 列表、**粗体** 等语法，即时变成排版效果；Ctrl+P 快速打开文件，Ctrl+F/H 查找替换。
2. 配助手：右下角绿色圆球 → ⚙ 设置 → 填 API 地址/Key/模型 → 点检测。
3. 喂材料：把 PDF 或图片拖进聊天框（PDF 芯片显示"解析 x/N"，✓ 后发送），或选中文档里的一段文字点"问助手"。
4. 审改动：助手的修改以红/绿 diff 出现在文档里——绿色块右上角 ✓ 接受、✕ 拒绝，或用底部胶囊条一键处理全部。
5. 存与导出：Ctrl+S 保存；顶栏"导出"可出 PDF / Word / HTML / Markdown。

🛠 技术栈

Vue 3 · Vite · TipTap / ProseMirror · markdown-it · Tailwind CSS · daisyUI · KaTeX · Mermaid · highlight.js · Electron · Capacitor

🚀 快速开始

下载 Windows 安装包后一键安装（推荐）：

前往 Releases 下载 Knote-Setup-x.x.x.exe，双击安装即可。

下载 Android apk 安装包（测试中）：

前往 Releases 下载 .apk（如当前版本未提供，可按下方开发方式自行构建）。

Android 签名迁移（首次安装 v1.1.38 或更高版本前必读）： v1.1.37 及更早的 APK 使用 debug 签名，不能原位升级到新的稳定签名。请先备份需要保留的应用本地数据和设置（包括 API Key、设置与会话），卸载旧 Android 应用，再重新安装新 APK。卸载会清除这些应用本地数据。

本地浏览器部署（开发者）：

git clone https://github.com/1661169091kiwi/Knote.git
cd Knote
npm install
npm run dev        # 打开 http://localhost:5173

# 打包 Windows 安装包
npm run dist:win   # -> release/Knote-Setup-<版本>.exe

# Windows 本地打包 Android APK（原生工程未纳入版本库，首次需生成）
npx cap add android
npm run dist:apk:debug  # 无需签名变量 -> android/app/build/outputs/apk/debug/app-debug.apk

# 签名 release APK：先在仓库外配置以下环境变量，切勿写入文件或提交
# ANDROID_RELEASE_KEYSTORE_PATH / ANDROID_RELEASE_KEYSTORE_PASSWORD
# ANDROID_RELEASE_KEY_ALIAS / ANDROID_RELEASE_KEY_PASSWORD
npm run dist:apk        # -> android/app/build/outputs/apk/release/app-release.apk

📄 许可证与致谢

基于 MIT 许可证 发布。构建于诸多优秀开源项目之上（Vue、TipTap/ProseMirror、markdown-it、KaTeX、Mermaid、highlight.js、Electron、Capacitor —— 均为宽松协议）。像素字体 Press Start 2P 以 SIL 开放字体许可（OFL）使用。

"飞书"及其他产品名称为各自所有者的商标；Knote 为独立项目，与之无关联、亦未获其背书。

English

Knote is a local-first Markdown editor that feels like a modern block editor (Feishu / Notion style) while keeping plain Markdown as the single source of truth — plus a configurable AI agent that helps maintain, edit and restructure your documents. Every change it proposes is staged as a red/green diff you review and can reject. Runs as a web app, a Windows desktop app (recommended), and an Android app (in testing).

✨ Features

• True WYSIWYG editing — type Markdown syntax and it converts live (TipTap / ProseMirror); a split source/preview mode is one click away.
• Rich Markdown — headings, lists, tasks, tables, code blocks with syntax highlighting, KaTeX math, footnotes, emoji, highlight/underline, and more.
• Callout blocks — > [!tip], > [!warning], etc. render as colored cards.
• Mermaid diagrams — write mermaid code blocks and see the diagram render live.
• Built-in AI agent — connect any OpenAI-compatible or Anthropic API (DeepSeek, SiliconFlow, OpenAI, Kimi, Claude…). It reads and edits the current document with every change staged as a red/green diff you accept per-block or all at once. Beyond that it manages your whole folder workspace (full-text search, document outline, create / precise-edit / rename / move / delete files, batch-process many at once), queries any enabled combination of Bing, DuckDuckGo, and Mojeek over your network with deterministic result fusion, searches papers through fixed OpenAlex + Crossref endpoints, and reads pages on desktop. It also reads workspace PDFs & images, keeps a live plan, and ships utilities like a sandboxed calculator and current-date awareness. On desktop, whole PDFs are structured locally (text extracted, figures/tables cropped with captions) so the agent reads the full document and inserts exact figures. Your API key is stored only in local browser storage; Knote has no relay server. Model requests go directly to your configured provider, academic queries go to OpenAlex/Crossref, and the optional Jina DuckDuckGo channel sends its query to r.jina.ai.
• Agent workspace panel — while the agent works, a right-side panel shows its live plan (each step checked off), activity (which tools it called, which URLs it searched/fetched, which files it read/wrote), and sub-agent batch progress, so its reasoning and progress are never a black box.
• Tabs & folder workspaces — open multiple documents/folders like a browser; drag to reorder; the session restores on restart. Browse a folder tree, create/rename/delete/move files, and search full-text across the whole folder.
• Find & replace (Ctrl+F / Ctrl+H), quick open (Ctrl+P), heading fold, version history with one-click rollback, image viewer, and UI zoom (Ctrl+Wheel).
• Export to PDF, Word (.doc), HTML, and Markdown.
• Bilingual UI (中文 / English).

🚀 Getting started

Windows (recommended): grab Knote-Setup-x.x.x.exe from Releases.

Android (testing): grab the .apk from Releases.

Android signing transition (required before first installing v1.1.38 or later): APKs from v1.1.37 and earlier were debug-signed and cannot be upgraded in place to the new stable signer. Back up any app-local data and settings you need, including API keys, settings, and sessions; uninstall the old Android app; then reinstall the new APK. Uninstalling clears that app-local data.

Develop / run from source:

git clone https://github.com/1661169091kiwi/Knote.git
cd Knote
npm install
npm run dev        # web dev server at http://localhost:5173

npm run dist:win   # Windows installer -> release/

# Local Android builds currently use the Windows Gradle wrapper.
npx cap add android       # first build only; the generated project is ignored
npm run dist:apk:debug    # debug-signed APK -> android/app/build/outputs/apk/debug/app-debug.apk

# Signed release build. Set these variables outside the repository first:
# ANDROID_RELEASE_KEYSTORE_PATH / ANDROID_RELEASE_KEYSTORE_PASSWORD
# ANDROID_RELEASE_KEY_ALIAS / ANDROID_RELEASE_KEY_PASSWORD
npm run dist:apk          # -> android/app/build/outputs/apk/release/app-release.apk

🤖 Configuring the AI agent

Click the green floating ball (bottom-right) to open the assistant, then open settings:

1. Choose the protocol — OpenAI-compatible for most providers, or Anthropic for Claude's native API.
2. Fill in API URL, API Key, and model name.
3. Click Detect — Knote probes the model and lights up capability badges (chat / tools / vision / PDF).

Keys live in your browser's local storage only. On Android, provider JSON POSTs use native HTTP from the first attempt; Knote neither sends a renderer request first nor replays a failed native request through the renderer. The native transport is bounded and non-streaming. Turning off web search disables both general and academic network search. On desktop, the optional PaddleOCR layout-analysis environment installs with one click — Knote even downloads an embedded Python automatically if none is installed.

📄 License & attributions

Released under the MIT License. Built on excellent open-source projects (Vue, TipTap/ProseMirror, markdown-it, KaTeX, Mermaid, highlight.js, Electron, Capacitor — all permissively licensed). The Press Start 2P pixel font is used under the SIL Open Font License.

"Feishu" and other product names are trademarks of their respective owners; Knote is an independent project and is not affiliated with or endorsed by them.