资讯详情

Pickoo 开发者指南:Node.js+Python混合架构、Skill扩展与本地内容管线实现原理

📅 2026/10/23 2:30:26 | 华诺云谱 👁 阅读
Pickoo 开发者指南:Node.js+Python混合架构、Skill扩展与本地内容管线实现原理
【免费下载链接】pickoo-your-favoritesLocal-first creator favorites workbench with evidence-preserving Markdown capture and a complete browser UI.项目地址https://gitcode.com/gh_mirrors/pi/pickoo-your-favorites点击查看免费下载Pickoopickoo-your-favorites是一个本地优先的 AI 收藏夹工作台粘贴链接后由本地 Agent 自动抓取原文、图片与音视频用 ASR/OCR 转写、分章最终沉淀为可人工编辑的 Markdown 证据包。本指南以它的 Node.js Python 混合架构为主线拆解 Skill 扩展机制与本地内容管线的实现原理帮助新手快速建立读代码与二次开发的认知框架。️ 认识 Pickoo本地优先的 AI 收藏夹工作台Pickoo 把收藏链接变成沉淀可复用内容数据不离开本机原文、媒体、逐字稿与拆解结果都保存在本地资料库默认~/Documents/Pickoo Library浏览器界面只是这些文件的只读投影而不是第二套数据库。每条内容最终都会变成一份系统命名的 Markdown 文档命名规则内容形态-来源渠道-标题-作者-日期.md由manifest.document.path指认文档内分四层原始资料 → 标准内容 → 内容拆解 → 素材卡片拆解结论随时可以回溯到原文、时间段或页码。 Node.js Python 混合架构全景docs/ARCHITECTURE.md 用一页说明了模块关系核心分工可以概括为Node.js 管状态与编排Python 管计算与证据。Node.js 端本地服务如何划分server.mjs一万行以上是本地服务唯一入口只监听127.0.0.1:4324server.mjs#L30提供本地 API、任务日志、设置、媒体流与 Agent 编排。public/ 是完整的浏览器 UI纯前端静态资源配合 app.js 等模块化脚本。server-lib.mjs 收纳章节解析、Markdown 投影、manifest 校验等共享纯逻辑。任务队列与界面偏好放在外部状态目录macOS 为~/Library/Application Support/Pickoo不进源码仓库。Python 端内容管线如何组织skill-source/下有三个 Skill各自携带一套可执行的参考实现脚本save-to-favorites/新链接入口负责查重与共享任务提交creator-content-ingest/证据保留式抓取、OCR、ASR、分章与校验asset-review-agent/独立评审金句 / 观点 / 钩子 / 结构四类资产。为什么用两种语言协作Node 适合长期运行的 HTTP 服务、并发调度与前端状态而 AI 处理链Whisper 语音识别、ONNX 视觉识别、媒体处理在 Python 生态中依赖更成熟。两者边界固定Node 以固定参数启动 Python 脚本再读取其产出的 JSON/Markdown 文件不跨语言共享内存对象——这也是混合架构最容易踩坑、Pickoo 处理得最规范的地方。⚙️ 混合架构落地Node 如何驱动 Python 管线服务端把每个 Python 入口解析为常量再统一用execFile调用CAPTURE_SOURCE_SCRIPT指向 capture_source.pySAVE_SCRIPT指向 save_link.py见 server.mjs#L259-L263。还有两个值得借鉴的工程细节AI 运行时复用优先。Pickoo 先校验本机已有能力——ASR 复用 MLX Whisper 或 Faster-WhisperOCR 在 macOS 优先 Apple Vision、其他平台复用 RapidOCR ONNX全部失败才在~/.cache/creator-content-ingest/安装隔离运行时任务执行期间绝不做临时pip install。双语言一套测试命令。npm test同时跑 Node 与 Python 两侧测试node --test tests/*.test.mjspython3 -m unittest discover testspackage.json#L10tests/ 目录里的管线回归测试成对覆盖两种语言。 Skill 扩展机制一条管线服务多个 AI AgentSkill 是 Pickoo 的扩展单元每个 Skill SKILL.md契约文件 references/文档集 scripts/参考实现Skill职责save-to-favorites唯一的新链接入口负责查重并提交共享任务中心creator-content-ingest下游内容管线抓取 → ASR/OCR → 章节 → 资产asset-review-agent独立评审员判断资产是否拿得走契约文件 SKILL.md 用 frontmatter 声明name与description正文写清路由边界、必读文档清单与可执行基线命令。例如抓取命令被固定为python scripts/capture_source.py --url source --raw-input 原始分享文字 --instruction 请求 --output-root packages --mode full安装器 tools/install-skills.mjs 以复制到临时目录 → 校验 frontmatter → 备份旧版 → 原子改名四步完成安装install-skills.mjs#L54-L80agent-targets.mjs 负责解析 Codex、WorkBuddy、Hermes、Claude、Claudian 各自的 Skill 目录。五个 Agent 共用同一份资料库与~/.config/pickoo/settings.json不会各自保存一套配置README.md#L84-L93。想写自己的扩展 Skill 时参照save-to-favorites的结构顺序先定义路由边界什么请求归我管再定义共享契约读哪份设置、产物写到哪里最后给出可执行基线可直接运行的命令。 本地内容管线从链接到证据包的 6 个阶段完整管线可以拆成 6 步每一步都有对应脚本与质量门入口与查重—save_link.py的submit提交到共享任务日志按来源 ID 去重前端据此显示队列、阶段与心跳SKILL.md#L43。证据保留式抓取— capture_source.py 归档原文、图片与音视频不归档 Cookie、签名 URL 或账号状态。语音转写— transcribe_package.py 执行 ASR 与质量检查原始稿与校正版严格分离纠错写入transcript-review.json而非覆盖原始输出。图片 OCR— 每张图片执行一次基线 OCR记录原始/校正文本、坐标与置信度。语义章节构建— 视频/音频生成语义章节 连续逐字稿 起止时间文章生成语义章节 原文段落章节只做导航绝不冒充摘要。资产拆解与校验— 产出金句 / 观点 / 钩子 / 结构 / 图像 / 镜头六类资产经 asset-review-agent 独立评审后才入库评审只问四个问题抓住人、带着走、留下来、拿得走SKILL.md#L44-L58。贯穿管线的设计原则只有两条但很关键证据先行、解读在后任何结论必须能回溯到时间戳、段落或页码过不了质量门就标review/partial绝不虚报完成。质量门台账可续跑已通过的门按指纹复用断点恢复时只重跑变化或缺失的门长任务不必从头再来。 开发者快速上手运行、测试与扩展环境要求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然后打开http://127.0.0.1:4324即可。package.json是版本号的唯一事实来源修改路径请优先用环境变量而不是改源码PICKOO_PORT、PICKOO_DATA_DIR、PICKOO_SETTINGS_FILE、PICKOO_LIBRARY_ROOTdocs/DEVELOPMENT.md#L24-L33。验证建议按 docs/DEVELOPMENT.md#L49-L54 的清单执行npm test跑双语言测试用quick_validate.py校验 Skill 结构发布前再跑npm run release:check检查包体限制。 延伸阅读路径架构总览docs/ARCHITECTURE.md开发环境与验证docs/DEVELOPMENT.md文件、网络与 Agent 权限docs/PERMISSIONS.md前端 UI 源码public/双语言回归测试tests/一句话总结 Pickoo 的混合架构Node.js 搭本地服务与任务编排Python 搭证据保留的内容管线Skill 契约让任何 Agent 都能复用这条管线。理解了这套分工代码的阅读顺序也就自然清晰了。赞分享【免费下载链接】pickoo-your-favoritesLocal-first creator favorites workbench with evidence-preserving Markdown capture and a complete browser UI.项目地址https://gitcode.com/gh_mirrors/pi/pickoo-your-favorites点击查看免费下载相关推荐终极Authenticator开发者指南从零构建浏览器端双因素认证扩展终极Authenticator开发者指南从零构建浏览器端双因素认证扩展 Authenticator是一款能够在浏览器中生成两步验证2 Step Verifi认证鉴权应用安全前端Cats Blender Plugin开发者指南插件架构与扩展功能实现原理Cats Blender Plugin开发者指南插件架构与扩展功能实现原理 Cats Blender Plugin是一款强大的Blender插件专为3D模型3D建模游戏开发FreqTrade FreqAI 开发者指南模型架构、数据管线与扩展实践FreqTrade FreqAI 开发者指南模型架构、数据管线与扩展实践 本指南以 FreqTrade 官方文档 freqai developers.md h金融科技后端机器学习强化学习上一篇Windows防休眠终极指南为什么NoSleep是你电脑的虚拟咖啡师下一篇思源黑体TTF打造完美多语言字体体验的终极指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑