purocean/yn

Yank Note (yn)

是什么 – Yank Note 是一个跨平台的 Electron 基础 Markdown 编辑器，旨在成为写作、编程和文档可视化的一站式工作空间。它将所有内容存储为普通的 Markdown 文件，因此数据具有可移植性，可使用任何其他工具进行编辑。

对关注 AI 的用户为何重要 – 该编辑器集成了 AI 助手，可调用大语言模型后端（OpenAI、Ollama、Gemini、Kimi、通义千问等）实现文本补全、生成，甚至图像生成（Flux 1 等）。它还内置了 OpenCode AI Agent，在编辑器内提供编程相关帮助。这使得 Yank Note 成为 LLM 如何嵌入日常生产力软件的实用范例。

核心功能

• AI 合作者 – 通过可配置的 LLM 提供商列表，实现基于提示的补全、生成和图像创建。
• OpenCode AI Agent – 上下文感知的编程辅助，适用于在编辑器支持的多个可运行代码块中编写脚本。
• 基于 Monaco 的编辑 – 提供与 VS Code 相同的编辑体验，支持语法感知自动补全、列表自动补全和 Markdown 专用快捷键。
• 实时预览与同步滚动 – 编辑器面板与渲染预览保持同步，支持独立滚动。
• 版本控制 – 内置历史追踪功能，可在不离开应用的情况下回滚文档更改。
• 丰富嵌入支持 – 可直接在 Markdown 中插入 PlantUML、Drawio、Mermaid、ECharts、Luckysheet 表格、思维导图、LaTeX 以及任意 HTML/Applet。
• 可执行代码块 – JavaScript、PHP、Node.js、Python、Bash 等可在文档内运行，使笔记变为交互式笔记本。
• 插件系统 – 用户可将 JavaScript 插件放入 ~/.yn/plugins 目录，以扩展 UI 或添加新行为。
• 加密 – 以 .c.md 结尾的文件在客户端加密；密码不会发送到服务器。
• 导出 – 内部使用 Pandoc 生成 PDF、HTML、Word 等多种格式。

如何开始

1. 下载 从 Release 页面下载适用于 Windows、macOS 或 Linux 的二进制文件（或尝试网页演示 https://demo.yank-note.com）。
2. 打开或创建一个 .md 文件。编辑器将自动在右侧渲染预览。
3. 要启用 AI 助手，请打开 Settings → AI 面板，选择一个提供商（例如 OpenAI），并粘贴您的 API 密钥。
4. 使用快捷键 Ctrl+Space（或配置的热键）在当前光标位置调用合作者。
5. 对于代码执行，编写类似 python … 的 fenced 块，然后点击块标题中出现的运行按钮。
6. 探索插件文件夹（~/.yn/plugins），并按照捆绑的 PLUGIN.md 指南编写自己的扩展。

注意事项

• 该应用会运行用户提供的代码，并可执行任意 shell 命令；打开不受信任的 Markdown 文件可能存在风险。
• 加密/解密完全在浏览器/Electron 前端完成——丢失密码意味着文件实际上无法恢复。

社区与支持

• 官方 WeChat 群组（仓库中显示二维码）用于实时帮助。
• GitHub 问题追踪器用于提交错误报告和功能请求。

总结 – Yank Note 是一个功能齐全的 Markdown 编辑器，展示了 LLM 如何融入桌面生产力工具，既提供通用写作辅助，又提供专业编程帮助，同时将核心数据保持在纯文本 Markdown 文件中。