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