Knote

Name: Knote
Author: 1661169091kiwi

Warning

本地优先的类飞书 Markdown 编辑器,内置可审改的 AI 助手 | Local-first WYSIWYG Markdown editor with a reviewable AI agent

134stars

2forks

JavaScript

Installation

# Add to your Claude Code skills
git clone https://github.com/1661169091kiwi/Knote

Getting Started

Guides for using ai agents skills like Knote.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportWarning

Last scanned: 7/17/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "esbuild: esbuild allows arbitrary file read when running the development server on Windows",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "linkify-it: LinkifyIt#match scan loop has quadratic algorithmic complexity",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "markdown-it: markdown-it: Quadratic complexity DoS in smartquotes rule via replaceAt string operations",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "picomatch: Picomatch: Method Injection in POSIX Character Classes causes incorrect Glob Matching",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "rollup: Rollup 4 has Arbitrary File Write via Path Traversal",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
      "severity": "high"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-07-17T06:14:58.754Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is Knote?

Knote is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by 1661169091kiwi. 本地优先的类飞书 Markdown 编辑器,内置可审改的 AI 助手 | Local-first WYSIWYG Markdown editor with a reviewable AI agent. It has 134 GitHub stars.

Is Knote safe to use?

Knote returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install Knote?

Clone the repository with "git clone https://github.com/1661169091kiwi/Knote" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is Knote written in?

Knote is primarily written in JavaScript. It is open-source under 1661169091kiwi on GitHub, so you can review or fork the full source.

Are there alternatives to Knote?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Knote against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

244,413

utah ai-auto-trading

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

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 编辑器

中文

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，用户逐块或一键接受后才会生效。

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 说明段落。
多文件知识库问答：打开整个项目文件夹，让助手跨文件检索并总结某个模块的实现或历史变更。
写作陪跑：卡壳时给出大纲建议、续写段落或反向提问，帮你把思路理顺。

配置：

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

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

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

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

📖 三分钟上手

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

Choose the protocol — **OpenAI-