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)

markdown
Searching Database…

What is this?Pickoo! is a local-first AI favorites workbench where a connected agent automatically ingests links you paste or share (from Xiaohongshu, Douyin, Bilibili, WeChat, Xiaoyuzhou podcasts, web pages, NetEase Music) and files them into editable Markdown with a preserved evidence package.
Is this a browser extension or a standalone local app?It is a standalone local service with its own full browser UI (a desktop-style card view), not a browser extension; the data layer is just editable Markdown plus an evidence package, not tied to any single platform.
How do I get it running?Double-click start.command on macOS or start-windows.cmd on Windows after installing the prerequisites, which opens the local service and browser UI together.
Which AI agents can connect to Pickoo?Codex, WorkBuddy, Hermes, Claude and Claudian can all connect and share the same library and task state, so you can keep searching, organizing or writing from any of them instead of re-uploading material between tools.
Does it bypass platform logins, DRM, or region locks to grab content?No. Platform login walls, memberships, DRM, region and access restrictions still apply, and anything that cannot be fully captured is explicitly shown as pending review, partially completed, or failed.
Does the local OCR/ASR setup work on Windows and Linux too, or just macOS?Yes: Apple Silicon Macs get MLX Whisper, Intel Macs and Windows x64 get Faster-Whisper CPU int8, and Windows/Linux get RapidOCR with ONNX Runtime for OCR, all written to the same evidence format.
Where does my saved content and login data actually live?Everything is written to a local library on your machine (default ~/Documents/Pickoo Library), settings live in ~/.config/pickoo/settings.json, and the NetEase Music login session is stored in a private local file that never enters shared settings or API responses; the backend only listens on 127.0.0.1.
What content sources does Pickoo support?Xiaohongshu posts, videos and public collections, WeChat official-account articles, Douyin, Bilibili, generic web pages, Xiaoyuzhou podcasts, and NetEase Music track metadata (with optional authenticated audio when you log in through the settings page).
What are the six asset types it extracts from a source?Each saved item can be broken down into six reusable asset categories: quotes, viewpoints, hooks, structure notes, images, and video shots, but only candidates that pass an evidence-review quality gate are admitted into the asset library.
Why does it keep the raw transcript instead of just an AI summary?Pickoo stores the original text, images, audio/video, source metadata and derived OCR/ASR/chapter/asset data in separate layers linked back to the exact passage, image, timestamp or shot, so an agent can verify a conclusion against its original evidence instead of trusting a summary.
What is the RED Skill package mentioned in the README?It is a trimmed, platform-compliant distribution of the frontend, local service and three Agent Skills, generated by npm run release:redskill, that drops large custom fonts and GitHub branding assets to stay under the 10MB-per-file and 30MB-total size limits required by that platform.
Creator
KristenPan
Size
21.3 MB
Stars
920
Updated
CommitAug 30
Age
1mo
Commits · 90 Days