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! — это локальная рабочая среда для работы с избранным на базе ИИ: подключённый агент автоматически забирает ссылки, которые вы вставляете или делитесь (из Xiaohongshu, Douyin, Bilibili, WeChat, подкастов Xiaoyuzhou, веб-страниц, NetEase Music), и раскладывает их в редактируемые Markdown-файлы с сохранением пакета доказательств.
Это расширение для браузера или отдельное локальное приложение?Это отдельный локальный сервис со своим полноценным интерфейсом в браузере (просмотр карточками в стиле десктопного приложения), а не расширение для браузера; слой данных — это просто редактируемый Markdown плюс пакет доказательств, без привязки к какой-либо одной платформе.
Как его запустить?Установите все необходимое, затем дважды щёлкните файл start.command на macOS или start-windows.cmd на Windows — вместе откроются локальный сервис и интерфейс в браузере.
Какие ИИ-агенты можно подключить к Pickoo?Подключиться и работать с общей библиотекой и состоянием задач могут Codex, WorkBuddy, Hermes, Claude и Claudian, так что искать, разбирать материалы или писать можно из любого из них, не перекладывая файлы между инструментами.
Обходит ли он входы на платформы, DRM или региональные ограничения, чтобы вытянуть контент?Нет. Страницы входа на платформах, платные подписки, DRM, региональные и прочие ограничения доступа сохраняются, а всё, что не удаётся полностью захватить, честно помечается как «ожидает проверки», «выполнено частично» или «не удалось».
Локальное распознавание через OCR/ASR работает тоже на Windows и Linux или только на macOS?Да: на Mac с Apple Silicon используется MLX Whisper, на Mac с Intel и Windows x64 — Faster-Whisper в режиме CPU int8, а на Windows и Linux для OCR — RapidOCR с ONNX Runtime; всё записывается в один и тот же формат доказательств.
Где на самом деле хранятся мои сохранённые материалы и данные входа?Всё записывается в локальную библиотеку на вашем компьютере (по умолчанию ~/Documents/Pickoo Library), настройки лежат в ~/.config/pickoo/settings.json, а сессия входа в NetEase Music хранится в отдельном локальном файле, который никогда не попадает в общие настройки или ответы API; бэкенд слушает только адрес 127.0.0.1.
Какие источники контента поддерживает Pickoo?Посты, видео и публичные подборки Xiaohongshu, статьи в официальных аккаунтах WeChat, Douyin, Bilibili, обычные веб-страницы, подкасты Xiaoyuzhou и метаданные треков NetEase Music (с опциональным прослушиванием аудио после входа в аккаунт через страницу настроек).
Какие шесть типов материалов он извлекает из источника?Каждый сохранённый элемент можно разложить на шесть повторно используемых категорий: цитаты, тезисы, цепляющие зачины, заметки о структуре, картинки и видеокадры; но в библиотеку попадают только те кандидаты, что прошли проверку качества на основе доказательств.
Зачем хранить исходную расшифровку, а не только пересказ от ИИ?Pickoo хранит исходный текст, изображения, аудио/видео, метаданные источника и производные данные (OCR/ASR, главы, материалы) отдельными слоями, связанными с конкретным фрагментом, картинкой, меткой времени или кадром — так агент может проверить вывод по исходным доказательствам, а не верить пересказу.
Что за пакет RED Skill, упомянутый в README?Это урезанный, соответствующий правилам платформы вариант сборки фронтенда, локального сервиса и трёх Agent Skills, который создаётся командой npm run release:redskill; из него убраны крупные пользовательские шрифты и брендовые материалы GitHub, чтобы уложиться в ограничения этой платформы — не более 10МБ на файл и 30МБ в сумме.
Creator
KristenPan
Size
21.3 MB
Stars
834
Updated
CommitAug 30
Age
1mo
Commits · 90 Days