如何從源碼克隆并在本地開發(fā)模式啟動 Paperclippnpm install pnpm dev【免費下載鏈接】paperclipThe open-source app everyone uses to manage agents at work項目地址: https://gitcode.com/GitHub_Trending/papercl/paperclip如果你的目標(biāo)是把 Paperclip 克隆到本地、裝上依賴、用開發(fā)模式把它跑起來——而不是通過 npm 安裝成品——那么主路徑只有兩條命令pnpm install和pnpm dev。啟動成功后API server 運行在http://localhost:3100UI 由同一個 server 以 dev middleware 模式同源提供數(shù)據(jù)庫是自動創(chuàng)建的 embedded PostgreSQL不需要 Docker也不需要你自己裝 Postgres。本文的操作路徑來自 快速開始、本地開發(fā)文檔、DEVELOPING.md 和 README.md。環(huán)境準(zhǔn)備三篇文檔對前置環(huán)境的要求一致Node.js 24.11pnpm 9README.md 中寫的是 pnpm 9.15倉庫根目錄的 package.json 里packageManager字段固定為pnpm9.15.4按 pnpm 9 大版本任一滿足要求的版本安裝即可若你使用 corepack 或 pnpm 版本管理器建議直接對齊 9.15.x。克隆倉庫并安裝依賴git clone https://gitcode.com/GitHub_Trending/papercl/paperclip cd paperclip pnpm installpnpm install會在倉庫根目錄解析整個 workspace 的依賴monoreposerver、ui、cli 等包都在其中。安裝完成即可啟動不需要執(zhí)行任何數(shù)據(jù)庫初始化步驟。有一點需要在后面記住pnpm paperclipai ...這種寫法只在克隆下來的倉庫副本內(nèi)部有效如果你是在沒有倉庫的情況下安裝則一律用npx paperclipai。本文所有pnpm paperclipai命令都以「你在克隆的倉庫目錄中」為前提。用 pnpm dev 啟動開發(fā)服務(wù)器pnpm dev啟動后得到兩個入口都在同一 originAPI serverhttp://localhost:3100UI由 API server 在 dev middleware 模式下提供與 API 同源幾個影響日常開發(fā)行為的事實pnpm dev以 watch 模式運行workspace 包包括 adapter 包的代碼變更會觸發(fā)重啟不想被文件監(jiān)聽打擾時用pnpm dev:once它在啟動 dev server 前默認(rèn)會先自動應(yīng)用待執(zhí)行的本地遷移。pnpm dev與pnpm dev:once對當(dāng)前倉庫和實例是冪等的如果對應(yīng)的 dev runner 已經(jīng)存活Paperclip 會報告已存在的進程而不是再起一個重復(fù)實例。檢查或停止當(dāng)前倉庫的受管 dev runnerpnpm dev:list pnpm dev:stopREADME.md 的 Development 小節(jié)還列出了其他變體按需選用pnpm dev:server # 僅啟動 server pnpm dev:mobile # 構(gòu)建一次 UI在 :3101 提供生產(chǎn) bundle/api 代理到 :3100適合手機/平板 pnpm dev:both # 同時運行 pnpm dev 和 pnpm dev:mobiledev:mobile屬于可選分支它構(gòu)建的是打包后的 UIUI 源碼改動需要手動重新構(gòu)建才會生效本地開發(fā)主路徑仍然是pnpm dev。驗證啟動結(jié)果在另一個終端里執(zhí)行文檔給出的健康檢查curl http://localhost:3100/api/health curl http://localhost:3100/api/companies文檔給出的預(yù)期輸出/api/health返回{status:ok}/api/companies返回 JSON 數(shù)組全新實例上是[]/api/health返回{status:ok}即說明 server 已就緒瀏覽器打開http://localhost:3100應(yīng)能看到 UI。備選一條命令引導(dǎo)啟動在克隆的倉庫里除了pnpm dev文檔還給出了一條引導(dǎo)式啟動命令pnpm paperclipai run它依次做三件事配置缺失時自動 onboard運行啟用修復(fù)的paperclipai doctor檢查通過后啟動 server適合首次本地安裝時一步到位。如果希望把狀態(tài)寫到非默認(rèn)位置同一文檔給出的寫法是PAPERCLIP_HOME/custom/path PAPERCLIP_INSTANCE_IDdev pnpm paperclipai run這里PAPERCLIP_HOME替換成你想要的 home 目錄PAPERCLIP_INSTANCE_ID替換成實例 id。也可以只隔離數(shù)據(jù)目錄而不改 homepnpm dev --data-dir ./tmp/paperclip-dev pnpm dev:list --data-dir ./tmp/paperclip-dev pnpm dev:stop --data-dir ./tmp/paperclip-devdev runner 會在遷移檢查或啟動 server 之前把--data-dir翻譯成隔離的PAPERCLIP_HOMEembedded PostgreSQL 等默認(rèn)實例狀態(tài)都落在這個目錄下管理命令要帶上同樣的--data-dir才能作用到同一份隔離狀態(tài)。開發(fā)數(shù)據(jù)落在哪里默認(rèn)情況下所有運行狀態(tài)位于實例根~/.paperclip/instances/default/下數(shù)據(jù)路徑Config~/.paperclip/instances/default/config.jsonDatabase~/.paperclip/instances/default/dbStorage~/.paperclip/instances/default/data/storageSecrets key~/.paperclip/instances/default/secrets/master.keyLogs~/.paperclip/instances/default/logs開發(fā)模式下保持DATABASE_URL不設(shè)置server 會自動使用 embedded PostgreSQL 并持久化到上表db目錄一旦設(shè)置了DATABASE_URLserver 改用該外部 Postgres。上傳存儲默認(rèn)是local_disk落在data/storage。如果本地數(shù)據(jù)被改亂了想重來本地開發(fā)文檔 給出的做法是rm -rf ~/.paperclip/instances/default/db pnpm dev注意第一條命令是破壞性操作會直接刪除默認(rèn)實例的整個本地開發(fā)數(shù)據(jù)庫目錄之后再pnpm dev重建。執(zhí)行前確認(rèn)你要清空的就是這個默認(rèn)實例的數(shù)據(jù)用--data-dir或自定義PAPERCLIP_HOME的實例對應(yīng)各自自己的目錄。需要知道的限制與分支默認(rèn)只綁 loopback。默認(rèn)pnpm dev停留在local_trusted且僅綁定 loopback。要開放到私有網(wǎng)絡(luò)并啟用登錄用pnpm dev --bind lan只在 Tailscale 可達的用pnpm dev --bind tailnet。這兩個是可選分支本地自測不需要。linked git worktree 會快速失敗。在關(guān)聯(lián)的 git worktree 里如果缺少倉庫本地的.paperclip/.envpnpm dev會直接報錯而不是靜默連到默認(rèn)實例/端口此時先在該 worktree 里執(zhí)行paperclipai worktree init再跑pnpm dev。worktree 與主檢出共用數(shù)據(jù)庫目錄是不安全的多個 git worktree 并行開發(fā)時不要指向同一個 embedded PostgreSQL 數(shù)據(jù)目錄用上面的 worktree 初始化或--data-dir隔離。下一步server 跑起來后快速開始 給出的后續(xù)操作是在 Web UI 里創(chuàng)建第一個 company定義公司目標(biāo)創(chuàng)建 CEO agent 并配置其 adapter然后逐步擴充 org chart、設(shè)置預(yù)算并分配初始任務(wù)。更完整的開發(fā)指南測試命令、Storybook、worktree 實例等見 doc/DEVELOPING.md?！久赓M下載鏈接】paperclipThe open-source app everyone uses to manage agents at work項目地址: https://gitcode.com/GitHub_Trending/papercl/paperclip創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考