Samsung Notes

随处使用 Samsung Notes

在任何设备上打开 Samsung Notes，随身携带，让 AI 阅读笔记。
免费且开源。你的笔记始终保存在自己的设备上。

在浏览器中打开 Inkport  ·  将笔记连接到 Claude

Inkport：在任何浏览器中查看你的笔记

Samsung Notes 文件（.sdocx）只能在 Samsung 设备上打开。Inkport 可在 iPhone、Mac、Windows、Linux、Chromebook 和 Android 上打开这些文件。

• 保留每一页的原样： 手写内容、绘图、键入的文本、表格、照片、PDF 和语音录音。
• 随身携带所有内容： 用一个 ZIP 文件打包每条笔记的 Markdown 文件和 PDF，保留原始日期，可直接导入 Obsidian、Notion 或任何文件夹。
• 一键发送给 AI： Claude、ChatGPT 或 Gemini 会收到作为文本文件的键入内容、作为图片的手写页面，以及所有附加的照片和 PDF。然后让它转录、总结或制作表格。在手机上会打开分享菜单；在电脑上则会保存文件，方便拖入聊天窗口。每条消息最多包含 10 个文件，因此批量处理大量内容时，页面图片会放在一个 PDF 中。
• 隐私且免费： 它在浏览器中运行，不会将你的文件发送到任何地方。其安全策略会阻止向其他网站发起后台请求。无需账号、没有使用限制、支持离线使用，提供 21 种语言。

从 Samsung Notes 导出笔记： 长按一条笔记并选择需要的笔记，然后点按 分享 → Samsung Notes 文件。在 Android 上，从 Chrome 菜单安装 Inkport，并在分享菜单中选择它；接着点按 发送给 AI，即可将笔记传给你的 AI 应用。在其他设备上，先保存文件（到 Google Drive、OneDrive、U 盘或发邮件给自己），再用 Inkport 打开。

将笔记连接到 Claude

此连接器可让 Claude 读取你电脑上的整个 Samsung Notes 笔记库：搜索笔记、读取页面图像中的手写内容、打开发票照片和 PDF，并将重命名后的副本保存到文件夹中。它绝不会修改笔记。

Claude Desktop 已包含所需的一切；其他客户端需要安装 Node.js 20.12 或更高版本。

笔记来源：

• Samsung Notes for Windows（可安装在任何 PC 上）：无需设置。打开应用一次，登录并等待笔记同步。
• **其他所有情况（Mac、Linux）：**按照上文所示，将手机中的笔记导出到一个文件夹。在 Claude Desktop 中，在扩展程序的设置中将该文件夹选为 导出的笔记文件夹。在其他客户端中，将 --exports "/path/to/folder" 添加到命令中。随时将新导出内容放入同一文件夹；Claude 会在下次提问时看到它们。

Install the Samsung Notes Reader extension in my Claude Desktop. Run the command for my system, then tell me to click Install twice in Claude:
Windows (PowerShell): curl.exe -fsSLo "$HOME\Downloads\samsung-notes-mcp.mcpb" https://github.com/Mhemd139/Samsung_Notes/releases/latest/download/samsung-notes-mcp.mcpb; claude-desktop.exe "$HOME\Downloads\samsung-notes-mcp.mcpb"
macOS: curl -fsSLo ~/Downloads/samsung-notes-mcp.mcpb https://github.com/Mhemd139/Samsung_Notes/releases/latest/download/samsung-notes-mcp.mcpb && open -a Claude ~/Downloads/samsung-notes-mcp.mcpb

• “概述一下我的笔记。”
• “找出今年的所有发票，并整理成表格，列出供应商、日期、总额和备注。”
• “读取我上周的手写笔记并总结。”
• “我那篇‘汽车保险’笔记所附的 PDF 里有什么？”
• “把‘收据’文件夹中的所有发票放进一个文件夹，并按日期、供应商和总额命名。”

Claude 可以做什么

隐私

• Inkport 在浏览器中运行。文件会在你的设备上读取，绝不会上传；页面不含分析工具或 Cookie。其内容安全策略会阻止向其他网站发出后台请求。GitHub Pages 会提供应用本身的文件，因此 GitHub 可能像其他网站一样记录页面访问情况（GitHub 隐私声明）。
• 连接器 会在你的电脑上读取笔记。它没有服务器、账号或分析工具，也不会发出网络请求。
• 两种工具都不会更改、移动或删除笔记。只有在你要求保存附件时，连接器才会写入文件：它会将文件复制到你的保存文件夹，绝不会覆盖已有文件。
• Claude 在聊天期间打开笔记、页面或附件时，这些内容会作为聊天的一部分发送给 Claude，就像你粘贴的任何内容一样，并受 Anthropic 隐私政策约束。你通过 Inkport 将笔记发送给任何 AI 时，也同样如此。
• 每个连接器发布包都由此代码库的 GitHub 工作流构建，并附有来源证明。使用 gh attestation verify samsung-notes-mcp.mcpb --repo Mhemd139/Samsung_Notes 验证下载文件。
• 有疑问？提交问题。

限制

• 手写内容通过页面图像读取，因此搜索只能找到键入文本和标题。
• Inkport 导出的 PDF 是每页的图像，因此无法选中其中的文本；每个 PDF 旁边的 Markdown 文件包含键入文本。
• Inkport 会在内存中生成导出文件。使用手机时，请每次导出几百篇笔记。
• 锁定的笔记仍会保持锁定状态。在 Samsung Notes 中解锁后才能将其纳入。
• 目前无法读取超长笔记（超过 250,000 个字符）。
• 页面图像会以常规字重显示粗体文本。
• Windows 来源会读取 Samsung Notes 自身的文件；Samsung Notes 更新可能会更改这些文件。如果发生这种情况，notes_overview 会说明。

故障排除

• “未找到 Samsung Notes”：请参阅“笔记来源”。
• “还没有笔记”或“未找到文件夹”：等待 Samsung Notes 完成同步，或创建该文件夹。无需重启；Claude 会在下次提问时看到笔记。
• 找不到某篇笔记：回收站中的笔记会被跳过。新笔记会在下次提问时显示，无需重启。
• 让 Claude 运行 notes_overview：它会列出发现的所有问题。
• 其他问题：报告问题。请勿附上真实笔记；问题对外公开。

工作原理

flowchart LR
  phone[Samsung Notes on your phone] -->|sync| cloud[Samsung Cloud]
  cloud -->|sync| app[Samsung Notes for Windows]
  app -->|note folders| server[samsung-notes-mcp]
  phone -.->|share .sdocx| folder[Exported notes]
  folder --> server
  folder --> inkport[Inkport in your browser]
  server <-->|stdio| claude[Claude Desktop / Claude Code / any MCP app]
  inkport -->|Send to AI, Markdown, PDF| anywhere[Any AI, Obsidian, Notion]

开发

npm install
npm test
npm run build
npm run web:dev     # Inkport on http://localhost:5173
npm run pack:mcpb   # one-click bundle for all platforms
npm run smoke       # local check against your own notes; prints counts only

翻译文件位于 web/src/locales；最欢迎母语人士提交修正。项目结构和规则请参阅 CONTRIBUTING.md，变更内容请参阅 CHANGELOG.md，如需私下报告安全漏洞，请参阅 SECURITY.md。

致谢与许可证

• 解析器：twangodev/sdocx（GPL-3.0）。若要检查文件的内部结构，可试试其自带的查看器：sdocx.twango.dev。
• PDF 引擎：通过 @hyzyla/pdfium 使用 PDFium。
• 测试说明：SDOCX Compatibility Corpus（CC BY 4.0）。
• 非官方项目：与 Samsung 无关联。Samsung Notes 是 Samsung Electronics 的商标。

仅限 GPL-3.0。请参阅 LICENSE。