者指南:Node.js+Python混合架構(gòu)、Skill擴展與本地內(nèi)容管線實現(xiàn)原理)
【免費下載鏈接】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是一個本地優(yōu)先的 AI 收藏夾工作臺粘貼鏈接后由本地 Agent 自動抓取原文、圖片與音視頻用 ASR/OCR 轉(zhuǎn)寫、分章最終沉淀為可人工編輯的 Markdown 證據(jù)包。本指南以它的 Node.js Python 混合架構(gòu)為主線拆解 Skill 擴展機制與本地內(nèi)容管線的實現(xiàn)原理幫助新手快速建立讀代碼與二次開發(fā)的認知框架。? 認識 Pickoo本地優(yōu)先的 AI 收藏夾工作臺Pickoo 把收藏鏈接變成沉淀可復(fù)用內(nèi)容數(shù)據(jù)不離開本機原文、媒體、逐字稿與拆解結(jié)果都保存在本地資料庫默認~/Documents/Pickoo Library瀏覽器界面只是這些文件的只讀投影而不是第二套數(shù)據(jù)庫。每條內(nèi)容最終都會變成一份系統(tǒng)命名的 Markdown 文檔命名規(guī)則內(nèi)容形態(tài)-來源渠道-標題-作者-日期.md由manifest.document.path指認文檔內(nèi)分四層原始資料 → 標準內(nèi)容 → 內(nèi)容拆解 → 素材卡片拆解結(jié)論隨時可以回溯到原文、時間段或頁碼。 Node.js Python 混合架構(gòu)全景docs/ARCHITECTURE.md 用一頁說明了模塊關(guān)系核心分工可以概括為Node.js 管狀態(tài)與編排Python 管計算與證據(jù)。Node.js 端本地服務(wù)如何劃分server.mjs一萬行以上是本地服務(wù)唯一入口只監(jiān)聽127.0.0.1:4324server.mjs#L30提供本地 API、任務(wù)日志、設(shè)置、媒體流與 Agent 編排。public/ 是完整的瀏覽器 UI純前端靜態(tài)資源配合 app.js 等模塊化腳本。server-lib.mjs 收納章節(jié)解析、Markdown 投影、manifest 校驗等共享純邏輯。任務(wù)隊列與界面偏好放在外部狀態(tài)目錄macOS 為~/Library/Application Support/Pickoo不進源碼倉庫。Python 端內(nèi)容管線如何組織skill-source/下有三個 Skill各自攜帶一套可執(zhí)行的參考實現(xiàn)腳本save-to-favorites/新鏈接入口負責(zé)查重與共享任務(wù)提交creator-content-ingest/證據(jù)保留式抓取、OCR、ASR、分章與校驗asset-review-agent/獨立評審金句 / 觀點 / 鉤子 / 結(jié)構(gòu)四類資產(chǎn)。為什么用兩種語言協(xié)作Node 適合長期運行的 HTTP 服務(wù)、并發(fā)調(diào)度與前端狀態(tài)而 AI 處理鏈Whisper 語音識別、ONNX 視覺識別、媒體處理在 Python 生態(tài)中依賴更成熟。兩者邊界固定Node 以固定參數(shù)啟動 Python 腳本再讀取其產(chǎn)出的 JSON/Markdown 文件不跨語言共享內(nèi)存對象——這也是混合架構(gòu)最容易踩坑、Pickoo 處理得最規(guī)范的地方。?? 混合架構(gòu)落地Node 如何驅(qū)動 Python 管線服務(wù)端把每個 Python 入口解析為常量再統(tǒng)一用execFile調(diào)用CAPTURE_SOURCE_SCRIPT指向 capture_source.pySAVE_SCRIPT指向 save_link.py見 server.mjs#L259-L263。還有兩個值得借鑒的工程細節(jié)AI 運行時復(fù)用優(yōu)先。Pickoo 先校驗本機已有能力——ASR 復(fù)用 MLX Whisper 或 Faster-WhisperOCR 在 macOS 優(yōu)先 Apple Vision、其他平臺復(fù)用 RapidOCR ONNX全部失敗才在~/.cache/creator-content-ingest/安裝隔離運行時任務(wù)執(zhí)行期間絕不做臨時pip install。雙語言一套測試命令。npm test同時跑 Node 與 Python 兩側(cè)測試node --test tests/*.test.mjspython3 -m unittest discover testspackage.json#L10tests/ 目錄里的管線回歸測試成對覆蓋兩種語言。 Skill 擴展機制一條管線服務(wù)多個 AI AgentSkill 是 Pickoo 的擴展單元每個 Skill SKILL.md契約文件 references/文檔集 scripts/參考實現(xiàn)Skill職責(zé)save-to-favorites唯一的新鏈接入口負責(zé)查重并提交共享任務(wù)中心creator-content-ingest下游內(nèi)容管線抓取 → ASR/OCR → 章節(jié) → 資產(chǎn)asset-review-agent獨立評審員判斷資產(chǎn)是否拿得走契約文件 SKILL.md 用 frontmatter 聲明name與description正文寫清路由邊界、必讀文檔清單與可執(zhí)行基線命令。例如抓取命令被固定為python scripts/capture_source.py --url source --raw-input 原始分享文字 --instruction 請求 --output-root packages --mode full安裝器 tools/install-skills.mjs 以復(fù)制到臨時目錄 → 校驗 frontmatter → 備份舊版 → 原子改名四步完成安裝install-skills.mjs#L54-L80agent-targets.mjs 負責(zé)解析 Codex、WorkBuddy、Hermes、Claude、Claudian 各自的 Skill 目錄。五個 Agent 共用同一份資料庫與~/.config/pickoo/settings.json不會各自保存一套配置README.md#L84-L93。想寫自己的擴展 Skill 時參照save-to-favorites的結(jié)構(gòu)順序先定義路由邊界什么請求歸我管再定義共享契約讀哪份設(shè)置、產(chǎn)物寫到哪里最后給出可執(zhí)行基線可直接運行的命令。 本地內(nèi)容管線從鏈接到證據(jù)包的 6 個階段完整管線可以拆成 6 步每一步都有對應(yīng)腳本與質(zhì)量門入口與查重—save_link.py的submit提交到共享任務(wù)日志按來源 ID 去重前端據(jù)此顯示隊列、階段與心跳SKILL.md#L43。證據(jù)保留式抓取— capture_source.py 歸檔原文、圖片與音視頻不歸檔 Cookie、簽名 URL 或賬號狀態(tài)。語音轉(zhuǎn)寫— transcribe_package.py 執(zhí)行 ASR 與質(zhì)量檢查原始稿與校正版嚴格分離糾錯寫入transcript-review.json而非覆蓋原始輸出。圖片 OCR— 每張圖片執(zhí)行一次基線 OCR記錄原始/校正文本、坐標與置信度。語義章節(jié)構(gòu)建— 視頻/音頻生成語義章節(jié) 連續(xù)逐字稿 起止時間文章生成語義章節(jié) 原文段落章節(jié)只做導(dǎo)航絕不冒充摘要。資產(chǎn)拆解與校驗— 產(chǎn)出金句 / 觀點 / 鉤子 / 結(jié)構(gòu) / 圖像 / 鏡頭六類資產(chǎn)經(jīng) asset-review-agent 獨立評審后才入庫評審只問四個問題抓住人、帶著走、留下來、拿得走SKILL.md#L44-L58。貫穿管線的設(shè)計原則只有兩條但很關(guān)鍵證據(jù)先行、解讀在后任何結(jié)論必須能回溯到時間戳、段落或頁碼過不了質(zhì)量門就標review/partial絕不虛報完成。質(zhì)量門臺賬可續(xù)跑已通過的門按指紋復(fù)用斷點恢復(fù)時只重跑變化或缺失的門長任務(wù)不必從頭再來。 開發(fā)者快速上手運行、測試與擴展環(huán)境要求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是版本號的唯一事實來源修改路徑請優(yōu)先用環(huán)境變量而不是改源碼PICKOO_PORT、PICKOO_DATA_DIR、PICKOO_SETTINGS_FILE、PICKOO_LIBRARY_ROOTdocs/DEVELOPMENT.md#L24-L33。驗證建議按 docs/DEVELOPMENT.md#L49-L54 的清單執(zhí)行npm test跑雙語言測試用quick_validate.py校驗 Skill 結(jié)構(gòu)發(fā)布前再跑npm run release:check檢查包體限制。 延伸閱讀路徑架構(gòu)總覽docs/ARCHITECTURE.md開發(fā)環(huán)境與驗證docs/DEVELOPMENT.md文件、網(wǎng)絡(luò)與 Agent 權(quán)限docs/PERMISSIONS.md前端 UI 源碼public/雙語言回歸測試tests/一句話總結(jié) Pickoo 的混合架構(gòu)Node.js 搭本地服務(wù)與任務(wù)編排Python 搭證據(jù)保留的內(nèi)容管線Skill 契約讓任何 Agent 都能復(fù)用這條管線。理解了這套分工代碼的閱讀順序也就自然清晰了。贊分享【免費下載鏈接】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點擊查看免費下載相關(guān)推薦終極Authenticator開發(fā)者指南從零構(gòu)建瀏覽器端雙因素認證擴展終極Authenticator開發(fā)者指南從零構(gòu)建瀏覽器端雙因素認證擴展 Authenticator是一款能夠在瀏覽器中生成兩步驗證2 Step Verifi認證鑒權(quán)應(yīng)用安全前端Cats Blender Plugin開發(fā)者指南插件架構(gòu)與擴展功能實現(xiàn)原理Cats Blender Plugin開發(fā)者指南插件架構(gòu)與擴展功能實現(xiàn)原理 Cats Blender Plugin是一款強大的Blender插件專為3D模型3D建模游戲開發(fā)FreqTrade FreqAI 開發(fā)者指南模型架構(gòu)、數(shù)據(jù)管線與擴展實踐FreqTrade FreqAI 開發(fā)者指南模型架構(gòu)、數(shù)據(jù)管線與擴展實踐 本指南以 FreqTrade 官方文檔 freqai developers.md h金融科技后端機器學(xué)習(xí)強化學(xué)習(xí)上一篇Windows防休眠終極指南為什么NoSleep是你電腦的虛擬咖啡師下一篇思源黑體TTF打造完美多語言字體體驗的終極指南創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考