Uoink

Uoink

保存你学习的视频、播客和文章。你的 AI 可以搜索它们并引用时间戳。

在 Windows 上免费、开源且本地运行：文字稿、画面和评论会以 Markdown 和 JSON 格式保存到你的磁盘，供 Claude、Cursor、Codex 或任何 MCP 客户端使用。

免费、开源（MIT）且以本地运行为先：无需账户，不使用 Uoink 云端；只有在你主动启用匿名使用量统计时才会发送数据。Uoink 会将支持的来源保存为结构化 Markdown 文件到你的设备，然后通过剪贴板、本地 MCP 服务和 OpenAPI 桥接，让你的 AI 使用这些内容。YouTube 采集内容包括文字稿、带时间戳的截图、评论和元数据；其他来源类型则保留发布方提供的内容。

• 网站： https://uoink.app · 安装： https://uoink.app/install · 开发者： https://uoink.app/developers
• 状态： 支持 Windows 10/11，另有 Mac 预览版（Apple Silicon，macOS 15 或更高版本），已通过 Apple 公证。该扩展需从发行版侧载，目前尚未上架 Chrome 网上应用店。Windows 安装程序未签名，因此首次运行时 SmartScreen 会发出警告。

为什么选择 Uoink

你看到一个显然效果不错的视频，想知道原因。于是你把 YouTube 链接贴进 Claude，希望它能“看”视频。但它做不到——它会捏造引述、编造标题，读过第一段后就无能为力。最后你只能用 2 倍速看完整个视频，手动做笔记。

Uoink 解决这个问题。点击任意视频下方的 Uoink 按钮（也可以右键点击链接，或按 Alt+U），即可获取完整文字稿、带时间戳的截图、热门评论、频道背景信息和元数据——这些内容会复制到剪贴板并保存到磁盘，可供 Claude、ChatGPT 或笔记应用使用。或者告诉你的 AI Agent “uoink 那个视频并解析它的吸引点”，它就会完成这两项操作，无需经过剪贴板。

你的资料库会不断积累。你保存的每个来源都会进入一个本地资料库，你的 AI 可以搜索、引用并以你的风格进行创作。

可以采集的内容

来源	采集内容
YouTube（主打功能）	带时间戳的文字稿、截图、热门评论、频道背景信息、完整元数据、JSON 附属文件
X / Twitter 视频 + 文本	视频文字稿和帖子文本、作者署名、串文上下文
播客	自动监控 RSS/Atom 元数据；可选择按订阅源启用自动导入，下载本地 MP3、使用 WhisperX 转录并发布到资料库
网页 / 文章	提取可读文本并以相同的资料库格式保存
Reddit	将帖子串和热门评论保存为 Markdown

已发布的来源会编入同一个本地资料库索引。播客音频和文字稿保存在 Uoink 的本地数据文件夹中；发布节目后，其 Markdown 文件和附属文件也会加入同一可搜索索引。

AI 读取语料库的三种方式

1. 剪贴板（创作者路径） — 点击 Uoink，然后粘贴到 Claude / ChatGPT。转录文本加上适合粘贴的部分截图（以内嵌图像形式呈现），让模型在一次粘贴中同时看到文本和画面。

2. MCP 服务（Agent 路径）：一个通过 stdio 暴露 91 个工具、五个库资源模板和九个提示词的本地 MCP 服务。Claude Desktop（.mcpb）、Claude Code 和 Cursor 通过标准连接即可使用完整的采集、研究、写作和 Library 工具集。用户同意门控保持不变。

stdio 传输已通过 Claude Desktop 和 Cursor 测试。Cline 和 Continue 是标准 stdio 兼容路径，但未逐一进行冒烟测试。

• stdio 默认启用全部 91 个注册工具。在客户端环境中设置 UOINK_MCP_TOOLSET=core，即可使用之前的 35 个工具。Cursor 和其他有工具数量上限的客户端可能需要此设置。更改后请重启连接。
• /mcp/v1 上的 HTTP JSON-RPC 通过经过令牌身份验证的本地辅助程序暴露同一组 91 个注册工具。两种 MCP 传输共用处理程序，并将相同的三个顶层 oneOf 输入架构扁平化，以兼容客户端。服务器仍会验证精确的冻结架构。

3. OpenAPI 桥接（适用于不支持 MCP 的本地 Agent） — 支持本地 OpenAPI 的 Agent 和脚本可以通过 /openapi/v1/spec.json + POST /tools/<name>，使用 OpenAPI 3.1 接口调用同一组工具。

在任何 AI Agent 中使用 Uoink

安装后，打开新终端并运行 uoink status 或 uoink search "working memory" --limit 5。安装程序中勾选的 PATH 选项 会让本地 Shell 中的 Agent 可以使用 uoink。uoink connect <client> 会 输出 MCP 客户端的连接说明。

便携式技能通过 MCP 或 CLI 支持 Claude Code、Codex、pi、 Hermes Agent 和 OpenClaw。与此版本一同发布的 Claude Code marketplace ryanbiddy/uoink-agent-kit 包含该技能和 MCP 配置。有关命令和客户端限制，请参阅 连接你的 Agent；有关通过 Shell 安装，请参阅 Agent 安装步骤。

MCP 设置（Claude Desktop、Cursor、Cline）

安装 Uoink 后，从扩展弹出窗口的 Settings 链接打开设置页面，并复制生成的代码片段——或者将以下内容粘贴到客户端的 MCP 配置中。stdio 服务会运行随附的 Python，并调用已安装的 uoink_mcp.py（C-01 修复会将应用目录固定添加到 sys.path，因此此命令在每种安装方式下都有效）：

{
  "mcpServers": {
    "uoink": {
      "command": "%LOCALAPPDATA%\\Uoink\\python\\python.exe",
      "args": ["%LOCALAPPDATA%\\Uoink\\uoink_mcp.py"]
    }
  }
}

Claude Desktop 不会展开 %LOCALAPPDATA%——请使用完整的绝对路径（例如 C:\\Users\\<you>\\AppData\\Local\\Uoink\\python\\python.exe）。保存后重启客户端；Uoink 的工具会自动显示。

一键安装： Claude Desktop .mcpb bundle 无需手动编辑配置即可安装 stdio 服务。请参阅 docs/mcpb-bundle.md。

HTTP 传输： 将 HTTP MCP 客户端指向 http://127.0.0.1:5179/mcp/v1，并发送请求头 X-Uoink-Token（从 %LOCALAPPDATA%\Uoink\token.txt 读取令牌）。

Uoink 操作员技能

Uoink 附带便携式 Skill skills/uoink/SKILL.md（安装到 %LOCALAPPDATA%\Uoink\skills\uoink\），用于查找已保存的证据、引用时间戳、采集 URL、保存笔记，以及依据用户的来源和表达风格进行写作。支持 Agent Skills 的客户端可以将同一文件与 Uoink 的 MCP 工具一同加载，也可以使用其中完全一致的 CLI 命令。有关安装路径和精简版 Claude Code 插件套件，请参阅连接你的 Agent。

安装

1. 下载安装程序。 从 v3.11.2 release 下载 Uoink-Setup-3.11.2.exe。适用于 Windows 10/11；Mac 的步骤见下文。安装程序未经签名：如果 SmartScreen 显示“Windows 已保护你的电脑”，请选择 更多信息 -> 仍要运行，并核对文件是否与发布页面列出的 SHA-256 一致。

2. 运行安装程序。 默认安装到 %LOCALAPPDATA%\Uoink\（无需管理员权限）。完成页面可立即启动辅助程序，且自动启动项会在每次登录时运行它。

3. 加载捆绑的扩展程序。 首次启动时，Uoink 会显示一次性设置页面。使用该页面打开浏览器的扩展程序页面，并复制已安装扩展程序的路径；然后启用开发者模式，点击 加载已解压的扩展程序，并选择该文件夹。

Mac 用户（Apple Silicon、macOS 15 或更高版本；预览版）：从同一发布页面下载 Uoink-3.11.2-macos-arm64.dmg，将 Uoink 拖到“应用程序”，推出磁盘，然后从“应用程序”打开 Uoink。该应用已签名并经过公证，因此 macOS 只会像往常一样询问是否打开从互联网下载的应用。然后按照上述步骤，通过设置页面加载扩展程序。参见 docs/mac/INSTALL.md。

商店安装链接由 store-config.json 控制。商品页面上线后，设置页面和这些步骤会提供 添加到 Chrome，并将侧载选项放在 高级 下。发布维护人员：请遵循 SUBMIT-NOW.md。

从源码运行的开发者请参见 REQUIREMENTS.md。使用 ./build.ps1 在本地构建安装程序（参见 docs/build-installer.md）。

静默桌面通知

桌面通知默认处于开启状态。若要让后台信息流监控和捕获保持不可见，请打开 仪表板 → 设置 → 本地应用，并关闭 显示桌面通知。Uoink 会在仪表板的 活动 视图中保留被隐藏的更新，因此静默不会丢弃事件。当前台应用覆盖其监视器时，Uoink 也会自动采取相同的处理方式，包括无边框和独占全屏游戏。

该设置保存在 settings.json 的 notifications_enabled 中。本地客户端可通过 GET /settings 读取，也可使用经过身份验证的 POST /settings 请求更新，例如请求体为 {"notifications_enabled": false}。无需重启。

工作原理

扩展程序流程： 点击视频下方的 Uoink → Uoink 提取字幕稿、截图、评论和元数据 → Markdown 语料库写入剪贴板（内嵌截图），完整内容集保存到磁盘 → 粘贴、运行提示词、获取分析结果。

Agent 流程（MCP）： 设置完成后，Agent 即可使用 Uoink 工具 → 提问 “对这个视频使用 uoink 并解读其钩子” → Agent 调用 uoink_video → classify_hook → 获取分析结果，无需经过剪贴板。

五种研究操作手册可对已保存的捕获内容进行处理：outlier-posts、transcript-intel、comment-mining、creator-teardown 和 repurpose-pack。可通过任一传输方式使用其 stdio 提示词或 get_playbook_input。Uoink 计算指标并提供带引用的证据；客户端负责撰写报告。这些读取操作无需 API 密钥，也不会发起网络请求。参见参数和示例。

可选的 ScrapeCreators 发现功能会在两种传输方式下添加 discover_candidates 和 queue_discovered。该功能默认关闭，需要使用你自己的密钥、明确确认额度消耗，并设置每日额度上限（默认 25）。已连接的 Agent 需要单独选择启用；仪表板调用会使用每次点击生成的短时有效意图。最多选择十条结果，发送至常规捕获队列。 保存的指标快照可补充本地操作手册，无需再次付费调用。不会加载 ScrapeCreators 缩略图。仪表板控件尚待推出；参见发现工具契约。

隐私

您保存的语料库、截图、播客音频、转录文本、资料库索引和诊断日志都保留在您的计算机上。Uoink 无需账号，也没有云端资料库。

默认情况下，Uoink 不会发送使用数据。如果您开启“Share anonymous usage counts”，它会向 usage.uoink.app 发送每日计数：按工具名称统计的调用次数、已知 MCP 客户端、stdio 或 HTTP 调用、按来源和结果统计的捕获次数，以及资料库搜索次数。报告包含随机安装 ID、应用版本、操作系统及其主版本、处理器类型、安装类型和统计时长。报告绝不包含内容、URL、标题、路径、搜索文本、用户名、IP 地址或账号详情。

默认情况下，数据共享处于关闭状态。在 Dashboard > Settings > App > Usage sharing 中，“See what is sent”会显示下一份报告，以及最近发送的十份报告及其日期。关闭数据共享后，随机 ID、本地计数和发送记录都会被删除。UOINK_USAGE_SHARING=0 会强制关闭数据共享。

请参阅使用数据负载和计数设计。

捕获功能会获取您指定的来源内容。播客监视器会轮询您启用的订阅源；自动摄取功能也可以下载新节目。对于被截断的 X 帖子，可能会使用 FxTwitter 备用方案来获取完整文本。经您同意后，转录功能可以下载模型；Check now 会联系 GitHub 获取版本信息。

可选的 AI 功能仅会在您使用自己的 API 密钥时，向 Anthropic 发送相关来源文本。评论智能、Hook Type 分类和实体提取默认处于关闭状态；由 Agent 请求的分析也需要使用您的密钥。密钥存储在操作系统的凭据存储中。您传递给 AI 客户端的内容将按照该客户端的政策处理。

请阅读 Uoink 隐私政策。

免责声明与使用条款

Uoink 专为个人研究、学习和原创创作者草稿设计和构建。用户须自行负责确保其对捕获媒体（转录文本、截图和评论）的使用符合 YouTube、Reddit、X（Twitter）及任何其他来源平台的服务条款、版权政策和 API 指南。Uoink 不托管、分享第三方媒体，也不声称拥有其所有权。

许可证

MIT。请参阅 LICENSE。第三方组件及其许可证列于 THIRD-PARTY-NOTICES.md。

更新日志与路线图

请参阅 CHANGELOG.md 了解版本历史，并参阅 ROADMAP.md 了解后续计划。

---

由 Ryan Biddy 构建。