pickoo-your-favorites README

The project's README from github.com/KristenPan/pickoo-your-favorites. As one markdown file: README.md.

Pickoo!

当前版本:1.0.1

把有趣的,都扔进来。

一个让本地 Agent 帮你自动整理内容、留住灵感的 AI 收藏夹。

Pickoo 是一个本地优先的 AI 收藏夹与灵感整理工作台。界面采用“卡片堆 → 分组展开 → 单条阅读”的桌面式浏览,数据层使用可编辑 Markdown 与证据包,不绑定内容平台。它适合内容创作者,也适合任何习惯通过收藏、整理和回看获取灵感的人。

产品特色

本地优先,Agent 原生

原文、媒体、逐字稿和拆解结果保存在用户自己的本地资料库中,以可编辑 Markdown 与证据包作为长期入口。Codex、WorkBuddy、Hermes、Claude 和 Claudian 共用同一份资料与任务状态,可以直接继续检索、整理、回看、分析或创作,不必在不同 AI 工具之间反复上传材料。

Pickoo 会优先复用用户已有的 Agent、本机 OCR 和 ASR 能力,不强制绑定 Pickoo 自有的云端 AI 服务。实际成本仍取决于用户选择的 Agent、模型和本机运行环境;“本地优先”也不代表抓取公开链接时完全离线。

收藏动作足够随手

在 Pickoo 中粘贴链接,或把公开可访问的链接和平台分享文字直接交给已经接入的 Agent。通过 Hermes 等消息入口,还可以从微信或飞书提交内容;不同入口最终进入同一个任务中心和本地资料库。

Pickoo 负责识别来源、查重、抓取和后续处理。平台登录、会员、DRM、地区与访问限制仍然有效;无法完整取得的内容会明确显示为待复核、部分完成或失败。

把内容拆清楚,而不只做摘要

视频和播客可以生成带时间戳的逐字稿与语义章节,图片可以执行 OCR。每条来源还可以继续提炼 金句 / 观点 / 钩子 / 结构 / 图像 / 镜头 六类可复用内容资产;无论用来整理兴趣、学习资料还是创作灵感,只有经过证据复核、达到质量门槛的候选才进入资产库。

可选的说话人分离可以区分访谈中谁在什么时候发言,并支持人工改名与跨集记忆。它不等同于无依据地自动确认真实身份,结果仍受质量门约束。

保留原始证据,方便继续调用

Pickoo 不用一段 AI 总结替代原内容。原始正文、图片、音视频、作者与来源和后续 OCR、ASR、章节、资产拆解分层保存;拆解结果可以回到对应原文、图像、时间段或镜头。Agent 因此既能调用结论,也能核对结论从哪里来。

收藏也可以是一场探索游戏

用户可以标记喜欢、随手记下 idea,也可以收藏单张图片、视频单帧和镜头片段,补充标签、批注和自己的偏好。成就系统会根据收藏、整理、互动和探索行为解锁徽章,让资料库逐渐长成一张个人兴趣地图,而不只是另一份等待清理的收藏列表。

完整功能与用户使用见本页;开发环境见 开发说明,模块关系见 架构说明,文件、网络、浏览器及 Agent 权限见 权限与隐私,安全报告方式见 SECURITY.md。

已支持

启动

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

npm ci
python3 -m pip install -r skill-source/creator-content-ingest/requirements.txt
npm start

这一步只安装基础抓取依赖。设置页会先复用通过验证的本机 ASR/OCR;只有缺失时,才分别安装 requirements-asr.txt 或 requirements-ocr.txt 到仓库外的隔离环境。

macOS 可双击 start.command,Windows 可双击 start-windows.cmd。也可以运行:

npm start

然后打开 http://127.0.0.1:4324。

Agent Skill

同一份抓取 Skill 和资产处理 Skill 已安装到:

save-to-favorites、creator-content-ingest 与独立的 asset-review-agent 可在设置页直接接入 Codex、WorkBuddy、Claude,或通过 PICKOO_OBSIDIAN_VAULT 指定的 Claudian Skill 目录。Hermes 只暴露完整入口 save-to-favorites,另外两个执行组件封装在它的内部运行目录中,不会被 Hermes 当成可竞争路由的独立 Skill。点击 Agent 卡片即安装或断开;所有入口共用 ~/.config/pickoo/settings.json,不会各自保存一套路径配置。

断开 Agent 时,Pickoo 会把自己管理的 Skill 包移到 ~/.config/pickoo/disconnected-skills/;Hermes 的内部组件随完整入口一起移动。跨 iCloud Drive 边界无法原子移动时,会先复制并逐文件校验哈希,确认备份完整后才删除原目录。

连接或更新 Agent 时,安装器会将旧的 capture-social-content 和 creator-link-intake 移出 Skill 发现目录,并保留在 ~/.config/pickoo/retired-skills/。它们不再作为入口、下游能力或失败回退;平台抓取、OCR、ASR、拆解和归档均由 Pickoo 管理的三个 Skill 完成。

ASR 与 OCR 都先验证本机已有能力,包括显式配置、Pickoo/项目/Agent 环境和系统 Python。ASR 复用可用的 MLX Whisper 或 Faster-Whisper;OCR 在 macOS 优先复用 Apple Vision,在其他兼容系统复用已有 RapidOCR + ONNX Runtime。只有找不到通过运行检查的后端时,设置页才创建 Pickoo 隔离环境:Apple 芯片 Mac 安装 MLX Whisper,Intel Mac 和 Windows x64 安装 Faster-Whisper CPU int8;Windows/Linux OCR 安装 RapidOCR ONNX。不同后端写入相同的证据、置信度与复核结构。任务处理中不会临时安装依赖;Pickoo 管理的组件位于 ~/.cache/creator-content-ingest/asr-runtime/ 与 ~/.cache/creator-content-ingest/ocr-runtime/。

RED Skill 可移植包由 npm run release:redskill 生成。完整包包含前端、本地服务和三个 Agent Skill;为满足平台只接收代码与配置文件、单文件 10MB、总包 30MB 的限制,RED Skill 版本不携带 27MB 手写字体和 GitHub 品牌素材,动态卡片映射系统宋体,品牌圆体映射保持不变。方形 Logo 原图保留在 GitHub 完整版的 public/brand/。所有 Agent 入口都应调用 save-to-favorites/scripts/save_link.py,不要绕过重复检查直接调用底层抓取器。

ASR 词典

数据边界

可选的播客说话人分离不影响基础抓取和逐字稿。需要时一次性运行:

bash skill-source/save-to-favorites/scripts/install_speaker_runtime.sh

安装器会在 ~/.cache/creator-content-ingest/speaker-diarization/ 创建独立 Python 环境,并下载 sherpa-onnx 官方分段模型与中文说话人 embedding 模型。普通用户不安装时,播客仍正常生成章节和语义/停顿段落,只是不显示 A/B/C、改名和跨集声纹记忆。自动增强需显式设置 CREATOR_INGEST_ENABLE_DIARIZATION=1,避免长音频声纹计算阻塞默认流程。说话人层默认只接受 1–5 人;访谈有明确双人证据时可固定为 2 人,超过 5 个聚类会被隔离为待复核结果,不进入正文。

验证

npm test

项目使用内置本地内容管线完成链接解析、媒体归档、语义分章和六类资产提炼。

本地数据与权限

完整声明见 docs/PERMISSIONS.md。

发布

package.json 是唯一版本号来源。GitHub 发布保留完整前端、字体、测试和开发工具;RED Skill 发布由脚本生成,并自动检查 SKILL.md、本地硬编码、10MB 单文件限制与 30MB 总包限制。

pickoo-your-favorites (KristenPan/pickoo-your-favorites)

Searching Database…

这是干什么的?Pickoo! 是一款本地优先的 AI 收藏工作台。接入的智能体可以自动处理你粘贴或分享的链接(来自小红书、抖音、哔哩哔哩、微信公众号、小宇宙播客、网页、网易云音乐),把它们整理成可编辑的 Markdown,并保留完整的证据包。
它是浏览器插件,还是一个独立的本地应用?它是一个独立的本地服务,自带完整的浏览器界面(桌面风格的卡片视图),不是浏览器插件;数据层就是可编辑的 Markdown 加上证据包,不绑定任何单一平台。
我怎么把它跑起来?装好所需的依赖后,在 macOS 上双击 start.command 或在 Windows 上双击 start-windows.cmd,本地服务和浏览器界面就会一起启动。
哪些 AI 智能体可以连接到 Pickoo?Codex、WorkBuddy、Hermes、Claude 和 Claudian 都可以连接,并共享同一个素材库和任务状态,所以你可以在其中任意一个工具里继续搜索、整理或写作,不用在各个工具之间来回上传素材。
它会绕过平台登录、DRM 或地区限制来抓取内容吗?不会。平台的登录墙、会员、DRM、地区和访问限制依然有效;凡是无法完整抓取的内容,都会明确标注为待审核、部分完成或失败。
本地 OCR/ASR 的配置在 Windows 和 Linux 上也能用吗,还是只支持 macOS?都能用:Apple Silicon 的 Mac 使用 MLX Whisper,Intel 的 Mac 和 Windows x64 使用 Faster-Whisper 的 CPU int8 模式,Windows/Linux 的 OCR 使用基于 ONNX Runtime 的 RapidOCR,所有结果都写入同一套证据格式。
我保存的内容和登录数据实际存在哪里?所有内容都写入你本机的一个本地素材库(默认路径为 ~/Documents/Pickoo Library),设置保存在 ~/.config/pickoo/settings.json;网易云音乐的登录会话存放在一个私密的本地文件里,不会进入共享设置或 API 响应;后端只监听 127.0.0.1。
Pickoo 支持哪些内容来源?小红书的笔记、视频和公开合集,微信公众号文章,抖音、哔哩哔哩、普通网页、小宇宙播客,以及网易云音乐的歌曲元数据(在设置页登录后,还可以选择性地获取带授权的音频)。
它从一个来源里能提取哪六种素材?每条保存的内容都可以拆分成六类可复用的素材:金句、观点、开头钩子、结构笔记、图片和视频镜头,但只有通过证据审核质量关卡的候选素材才会进入素材库。
为什么它要保留原始文字记录,而不是只留一份 AI 摘要?Pickoo 把原始文字、图片、音视频、来源元数据,以及派生的 OCR/ASR/章节/素材数据分层存储,并关联到确切的段落、图片、时间点或镜头,这样智能体可以对照原始证据来核实结论,而不是轻信一份摘要。
README 里提到的 RED Skill 包是什么?它是前端、本地服务和三个 Agent Skills 的精简、符合平台规范的分发包,由 npm run release:redskill 生成;为了满足该平台单个文件不超过 10MB、总体积不超过 30MB 的限制,它去掉了大体积的自定义字体和 GitHub 品牌素材。
Creator
KristenPan
Size
21.3 MB
Stars
920
Updated
CommitAug 30
Age
1mo
Commits · 90 Days