fknotion

Notion 风格的 Markdown 编辑器，集成 Pi AI 助手，支持文档优化、分析与修改确认。

使用

需要 Node.js 22.19.0 或更高版本。在希望保存文档的目录执行：

npx fknotion

打开 http://localhost:3210。文档默认保存在运行目录下的 docs/ 文件夹。

也可以点击顶部的“打开本地文档”，选择任意位置的 .md、.markdown 或 .txt 文件并授予写入权限。编辑后约 300 毫秒自动保存到原文件，接受 AI 修改后也会写回原文件，不会另存到 docs/。直接写回需要支持 File System Access API 的桌面浏览器（如 Chrome / Edge），并通过 localhost 或 HTTPS 访问；重新打开页面后需要重新选择文件。若检测到原文件被其他程序修改，会停止自动保存并提示，避免覆盖外部修改。

也可以全局安装：

npm install -g fknotion
fknotion

通过 PORT 和 DOCS_DIR 环境变量配置端口和文档目录：

PORT=3211 DOCS_DIR=/path/to/documents fknotion

AI 功能使用 Pi 的模型与登录配置。运行 pi 并使用 /login，或在 ~/.pi/agent/auth.json 配置 API 密钥。没有模型凭据时仍可编辑文档。

服务适合在可信的本地环境运行，目前没有用户认证。

开发

npm install
npm run dev

npm run check 检查类型，npm run build 构建前端，npm start 启动服务。