Pickoo 是一个本地优先的 AI 收藏夹与灵感整理工作台。它让 Codex、WorkBuddy、Hermes、Claude、Claudian 五个 Agent 把收集的内容全部写入同一份本地资料库——你随手粘贴一个链接，Agent 就会自动完成查重、抓取、OCR、逐字稿、语义章节，并把内容拆解成金句、观点、钩子等可复用素材，把"收藏"真正变成"能用的灵感"。

📌 Pickoo 是什么：收藏即入库的灵感工作台

Pickoo 的界面采用"卡片堆 → 分组展开 → 单条阅读"的桌面式浏览方式，支持小红书图文/视频、公众号、抖音、B站、小宇宙、网易云音乐和普通网页。

它和传统收藏夹最大的区别在于数据层：

• 可编辑 Markdown + 证据包：每条内容对应一个系统命名的 Markdown 文档，原文、媒体、逐字稿、OCR 结果分层保存在证据目录里
• 前端只是"阅读器"：界面是资料库的投影，不是第二套数据库，所以任何一个 Agent 写进去的东西，其他 Agent 和界面都能直接看到
• 保留原始证据：不用一段 AI 摘要替代原文，拆解出的每张卡片都能回溯到具体段落、时间段或镜头

更完整的介绍见 README.md，模块关系见 docs/ARCHITECTURE.md。

🧩 为什么"共享资料库"对多 Agent 用户很重要

如果你同时用 Codex 写分析、用 Claude 读长文、用 WorkBuddy 做日常任务，大概率遇到过这些痛点：

• 同一个链接要在不同工具里反复上传、反复解释背景
• 各 Agent 的整理结果散落在各自目录，互相无法引用
• 换个 Agent 继续工作，等于从零开始

Pickoo 的答案是"一份资料、一套设置、三个 Skill"：五个 Agent 入口共用同一个本地收藏库目录和同一份运行时设置，任务状态在同一个任务中心排队，谁收藏、谁处理、处理到哪一步，界面上一目了然。

🚀 三步接入：Codex、Claude、WorkBuddy 一键连接教程

第 1 步：本地安装并启动 Pickoo

需要 Node.js 20+；完整媒体处理还需要 Python 3.10+、ffmpeg/ffprobe 和 yt-dlp。

git clone https://gitcode.com/gh_mirrors/pi/pickoo-your-favorites cd pickoo-your-favorites npm ci python3 -m pip install -r skill-source/creator-content-ingest/requirements.txt npm start

启动后打开http://127.0.0.1:4324即可。macOS 也可以直接双击 start.command，Windows 双击 start-windows.cmd。

第 2 步：在设置页一键接入 Agent

进入设置页，你会看到 Codex、WorkBuddy、Hermes、Claude、Claudian 的 Agent 卡片。点击卡片即安装 Skill，再点一次即断开，不需要手动复制文件。

也可以在终端显式安装到指定 Agent（例如 WorkBuddy）：

node tools/install-skills.mjs workbuddy

安装器逻辑见 tools/install-skills.mjs，各 Agent 的目录解析规则在 agent-targets.mjs。所有入口共用~/.config/pickoo/settings.json，在设置页改一次配置，下次从任何 Agent 调用时全部生效，不用在多个 Skill 目录里各改一份。

第 3 步：粘贴链接，让 Agent 自动整理

三种方式任选：

1. 在 Pickoo 右下角浮动＋里粘贴链接或平台分享文字
2. 把分享文字直接发给已接入的 Codex / Claude / WorkBuddy，说一句"收藏"
3. 通过 Hermes 从微信或飞书提交内容

任务卡会实时显示 Agent 身份、入口、阶段、心跳和最终的 Markdown 位置。已抓过的链接会明确提示"已收藏过"，不会重复入库。

📚 5 个 Agent 如何共享同一份资料库

五个入口背后是同三个 Skill：

• save-to-favorites：唯一的新链接入口，负责查重、抓取与完整流水线，见 skill-source/save-to-favorites/SKILL.md
• creator-content-ingest：负责证据保留式抓取、OCR、ASR 分章与校验
• asset-review-agent：独立审查金句、观点、钩子、结构四类素材，宁可拒收也不凑数，规则见 skill-source/asset-review-agent/SKILL.md

所有 Agent 的结果统一写入同一个资料库（默认~/Documents/Pickoo Library/），每个来源对应一个稳定目录：

S-{平台}-{稳定ID}/ ├── 图文-小红书-短标题-短作者-日期.md ← 唯一可编辑文档 ├── evidence/ │ ├── images|cover/ 下载的图片 │ ├── media/ 原始音视频 │ ├── transcript|article/ 章节化内容 │ └── assets/assets.json 六类素材事实源 └── manifest.json 路径、质量门与机器状态

由于媒体链接是相对路径，Obsidian、前端、Codex、WorkBuddy 和 Claude 解析到的是同一批文件，这就是"共享"能成立的底层原因。

⚙️ 链接进来之后，Pickoo 自动做了什么

• 查重归一：按平台稳定 ID / song ID 归一化，重复提交直接指向已有文档
• 媒体处理：视频和播客生成带时间戳逐字稿 + 语义章节；图片逐张 OCR；本地 ASR/OCR 优先复用，缺失才装隔离运行时
• 素材拆解：产出金句 / 观点 / 钩子 / 结构 / 图像 / 镜头六类卡片，只有经过证据复核、达到质量门槛的候选才会入资产库
• 诚实的状态：每条内容显示完整 / 待复核 / 部分完成 / 失败，无法完整获取的内容不会假装成功

💡 多 Agent 协作的 5 个实用建议

1. 配置只改一处：资料库根目录、Markdown 视图模式、ASR/OCR 开关都在~/.config/pickoo/settings.json，界面改一次全局生效
2. 换资料库根目录很安全：有任务运行时 Pickoo 会先拒绝移动，迁移失败会自动回滚，不会丢数据
3. 人机同改不打架：前端编辑走原子写回 + 版本哈希，Agent 提交走包级锁，两边同时修改时旧版本会先备份到.pickoo-conflicts/
4. Obsidian 用户：把资料库指向 Obsidian 库即可双向同步，修改会在详情页自动刷新
5. 断开不影响数据：断开 Agent 时 Pickoo 只把 Skill 包移到~/.config/pickoo/disconnected-skills/，收藏内容和设置原封不动

WorkBuddy 用户可以直接使用 packaging/workbuddy/ 下的朋友安装包，解压后把提示词发给 WorkBuddy 即可完成安装与验证。文件、网络与 Agent 权限的完整边界见 docs/PERMISSIONS.md。

❓ 常见问题

资料会上传到云端吗？不会。Pickoo 本地优先，本地服务只监听127.0.0.1，收藏、设置和登录态都留在本机；实际成本取决于你自己选择的 Agent 和模型。

Pickoo 没开的时候，Agent 还能收藏吗？可以。Agent 会回退到同样的本地直存流程，只是没有实时界面进度，下次启动 Pickoo 会自动对账。

能只接一个 Agent 吗？可以。五个入口相互独立，点哪张卡片就装哪个，资料库始终共享。

写在最后

Pickoo 的核心思路一句话就能说清：让每个 Agent 都成为资料库的"写入者"，而不是各自囤货的孤岛。接入成本只有"点一下卡片"，收获是所有 AI 工具共用一份可检索、可回溯、可继续加工的个人灵感地图。