项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4809
使用教程
环境要求
- Node.js 24 或更高版本(Web 应用方式必需)
- 已安装 git(Web 应用方式必需)
- 桌面端需 macOS(Apple Silicon)、Windows 10+(x64/Arm64)或 Linux(x64/arm64)
- 系统中已安装 AI 编辑器可被自动检测配置(如 Claude Code、Claude Desktop、Cursor、Codex 等)
安装与启动步骤
-
1准备运行环境
Web 应用方式需要 Node.js 24+ 和 git,请先在系统上安装并确认二者可用;桌面端则无需 Node.js。
-
2全局安装 CLI
通过 npm 全局安装 @inkeep/open-knowledge,安装后即可使用 ok 命令。
npm install -g @inkeep/open-knowledge -
3进入笔记目录
切换到你要打开的项目或笔记文件夹,目录内应包含 markdown 或 mdx 文件。
cd your-project -
4初始化项目
ok init 会生成项目脚手架,并自动接线检测到的 AI 编辑器(Claude Code、Claude Desktop、Cursor、Codex、OpenCode、OpenClaw)。
ok init -
5启动 Web 编辑器
ok start --open 会启动本地 Web 编辑器并自动在浏览器中打开,之后即可开始编辑与使用 AI 能力。
ok start --open -
6或安装桌面端(可选)
不使用 CLI 时,可从官网或 latest release 下载安装包:macOS 拖入 Applications,Windows 运行 Setup,Linux 装 deb/rpm。
如何确认成功
执行 ok start --open 后浏览器自动打开本地 Web 编辑器界面,即可看到文件导航、搜索与标签页。
常见问题
Q:必须安装 Node.js 吗?
A:只有 Web 应用(CLI)方式需要 Node.js 24+ 和 git;使用桌面应用安装包则不需要。
Q:能打开已有的 Obsidian 库或代码仓库吗?
A:可以。直接打开任何包含 markdown 或 mdx 文件的现有文件夹,包括已有代码库、wiki 和 Obsidian vault。
Q:ok init 会改动我的 AI 编辑器配置吗?
A:ok init 会为检测到的编辑器(如 Claude Code、Claude Desktop、Cursor、Codex 等)接线,并引导你安装 MCP 和 skills。
Q:Intel Mac 怎么用?
A:Web 应用方式可在任意平台运行,包括 Intel Mac 和服务器,通过 CLI 启动编辑器即可。
Q:数据会上传到云端吗?
A:不会,项目强调私有、本地、免费,基于本地文件存储;Git/GitHub 同步与分享为可选项。
注意事项
- Web 应用方式硬性要求 Node.js 24+ 与 git,版本不足会导致安装或启动失败。
- ok init 会自动检测本机已安装的 AI 编辑器并写入相应配置,操作前建议了解其改动范围。
- 桌面端与 Web 端使用同一套编辑器,按平台选择安装包即可。
- Git/GitHub 同步与共享默认关闭,需要时手动开启。
核心亮点
- 原生集成 LLM,支持对话式编辑、自动补全和内容摘要,显著提升写作效率
- 基于本地 Markdown 文件,数据完全自主可控,支持 Git 版本管理
- 界面设计现代美观,交互流畅,提供图谱视图和双向链接,知识组织直观
不足之处
- 项目仍处于早期阶段,功能稳定性和插件生态有待完善
- AI 功能依赖外部 LLM API,可能产生额外成本或隐私顾虑
适用场景
- 个人知识库管理,将零散笔记自动关联成知识网络
- 技术团队编写和协作维护项目文档
- 利用 AI 辅助进行长文写作和内容创作
替代项目
Obsidian、Logseq、Foam
上一篇:md
下一篇:WritingTools
同类项目推荐
ResuLLMe
开源
用大模型一键优化简历,让HR眼前一亮
Enhance your résumé with Large Language Models
socialpostgpt
开源
输入主题,一键生成带图社交媒体帖子
Uses magic to generate social media posts using Wasp, ChatGPT and stock photos APIs
tagore
开源
把 AI 的机械腔调,一键调成人类文笔
Make AI-generated prose sound human. 29-pattern catalog + 8-rule operating system + ···
book-genesis-studio
开源
让 AI 代理按流程帮你写完一本书并导出 EPUB
Open-source writing skills for Claude Code, Codex, OpenCode, Antigravity, Gemini, Op···
MagicPrompt
开源
输入关键词,自动生成高质量绘画提示词,提升出图效果
Prompt Generator for Stable Diffusion/Midjourney on GPT-2 models
oh-story-claudecode
开源
扫榜选题拆文到成稿,全流程一条龙
AI 写网文全流程 skill 包:扫榜选材、拆解爆款、大纲细纲、长篇设定与伏笔追踪、短篇反转···
goink
开源
和 AI 对话写小说,自动记设定,本地搜素材
Goink 桌面 AI 小说创作助手,对话式写作 + 自动状态追踪 + 本地语义搜索。跨平台开箱即用···
shanyin-screenwriting-master
开源
用Claude当编剧,从点子到成片剧本一条龙。
山音超级编剧大师——由 @山音 设计的全格式影视编剧技能。 覆盖从1-3分钟概念超短片到90分···
claude-reviews-claude
开源
让 AI 读自己的源码,一键生成架构深度解析文档
Claude reads its own source code — 17-chapter architectural deep-dive into Claude ···
