【免費(fèi)下載鏈接】optioWorkflow orchestration for AI agent swarms.項(xiàng)目地址https://gitcode.com/gh_mirrors/opt/optio點(diǎn)擊查看免費(fèi)下載Optio 是一個(gè)自托管的 AI Agent 編排平臺(tái)讓 Claude Code、Codex、Copilot 等編碼智能體像 CI/CD 流水線一樣在你的 Kubernetes 集群上運(yùn)行。本文面向首次參與開發(fā)的貢獻(xiàn)者帶你快速搭好 Monorepo 開發(fā)環(huán)境并掌握它引以為傲的五層測(cè)試體系——從毫秒級(jí)的單元測(cè)試到真實(shí) LLM 運(yùn)行的冒煙測(cè)試層層遞進(jìn)、互不干擾。 Monorepo 結(jié)構(gòu)一覽先看懂代碼怎么組織Optio 采用Turborepo pnpm 10管理的 Monorepo所有子包通過 pnpm-workspace.yaml 聲明分為apps/*應(yīng)用和packages/*共享庫兩大區(qū)目錄職責(zé)技術(shù)棧apps/apiFastify API 服務(wù)器 14 個(gè) BullMQ 后臺(tái) workerFastify 5、Drizzle ORM、Redisapps/webNext.js 15 Web UITailwind CSS v4、Zustand、Playwrightapps/ios原生 iOS 客戶端SwiftUIapps/android原生 Android 客戶端Kotlin Jetpack Composeapps/clioptio命令行工具含 Optio Local 守護(hù)進(jìn)程TypeScriptpackages/shared類型定義、狀態(tài)機(jī)、工作規(guī)范等共享代碼被所有應(yīng)用依賴packages/container-runtime容器運(yùn)行時(shí)抽象K8s / Docker /fake測(cè)試的關(guān)鍵拼圖packages/agent-adapters六種 Agent 運(yùn)行時(shí)的協(xié)議適配—理解這個(gè)布局的好處是當(dāng)你改動(dòng)某個(gè)包時(shí)能立刻知道該跑哪一層測(cè)試。 開發(fā)環(huán)境搭建三步跑起全套前置依賴安裝清單按 CONTRIBUTING.md 的要求你需要準(zhǔn)備Node.js 22pnpm 10npm install -g pnpmDocker Desktop并啟用 Kubernetes一鍵部署本地集群git clone https://gitcode.com/gh_mirrors/opt/optio cd optio pnpm install ./scripts/setup-local.shsetup-local.sh會(huì)構(gòu)建全部鏡像并通過 Helm 部署到本地 K8s 集群配置文件見 helm/optio/values.local.yaml。完成后打開http://localhost:30310即可完成首次設(shè)置API 監(jiān)聽在http://localhost:30400。之后日常開發(fā)只需熱重載模式pnpm dev # 啟動(dòng) API Web 雙服務(wù) pnpm turbo typecheck # 對(duì)全部 6 個(gè)包做類型檢查 pnpm turbo test # 跑所有單元測(cè)試Vitest全 mock、無基礎(chǔ)設(shè)施 五層測(cè)試體系Optio 的質(zhì)量護(hù)城河這是理解 Optio 工程文化的核心。官方規(guī)則寫得很直白一個(gè)改動(dòng)在覆蓋它的測(cè)試層全部通過之前就不算完成。前四層是確定性的——無集群、無 LLM 調(diào)用、零成本全部跑在 CI 里第五層只在本地執(zhí)行。層級(jí)命令覆蓋內(nèi)容何時(shí)運(yùn)行1. 單元測(cè)試pnpm turbo test純邏輯、mock 掉服務(wù)的 API 路由任何改動(dòng)必跑2. 集成測(cè)試pnpm --filter optio/api test:integration服務(wù)層 真實(shí) Postgres Redis狀態(tài)機(jī)、協(xié)調(diào)器 CAS、觸發(fā)器、密鑰加密改了 DB schema / 服務(wù) / worker3. 流水線 e2epnpm --filter optio/api test:e2e真實(shí) API 服務(wù)器全部 14 個(gè) worker經(jīng) HTTP 驅(qū)動(dòng)容器運(yùn)行時(shí)換成 fake改了 worker / 路由 / 啟動(dòng)流程4. Web e2epnpm --filter optio/web test:e2ePlaywright 驅(qū)動(dòng)瀏覽器遍歷所有頂層頁面改了 Web UI5. Live 冒煙bash scripts/smoke-e2e.sh真實(shí) K8s Pod 真實(shí) Agent 認(rèn)證 一次真實(shí) LLM 運(yùn)行約 $0.01改了 Pod 生命周期 / 鏡像 / Helm僅本地絕不進(jìn) CI下面逐層拆解每層的機(jī)制與文件位置。第一層單元測(cè)試——全 mock、毫秒級(jí)反饋單元測(cè)試文件命名為*.test.ts散布在packages/shared和apps/api/src各處。Vitest 配置見 apps/api/vitest.config.ts注意它顯式排除了*.int.test.ts和e2e/**防止有人在單測(cè)層意外拉起真實(shí)基礎(chǔ)設(shè)施。CI 環(huán)境下會(huì)自動(dòng)開啟 v8 覆蓋率并強(qiáng)制執(zhí)行閾值行 50%、分支 65%。pnpm turbo test第二層集成測(cè)試——真實(shí)數(shù)據(jù)庫隔離到文件粒度集成測(cè)試命名*.int.test.ts獨(dú)立配置在 apps/api/vitest.integration.config.ts。它的精妙之處在于隔離模型通過 scripts/test-infra.sh 自動(dòng)拉起一次性容器optio-test-postgres端口 54329和optio-test-redis端口 63790外加一個(gè)三節(jié)點(diǎn) Redis Cluster 供集群模式測(cè)試使用每個(gè)測(cè)試文件都獲得一個(gè)從已遷移模板克隆的私有數(shù)據(jù)庫 一個(gè)租用的 Redis 邏輯庫——因此并發(fā)運(yùn)行互不干擾globalSetup還會(huì)清掃崩潰殘留pool: forks讓每個(gè)文件跑在獨(dú)立進(jìn)程中模塊級(jí)單例數(shù)據(jù)庫池、Redis 連接天然綁定到該文件自己的私有庫。典型范例是 apps/api/src/db/harness.int.test.ts行工廠在 apps/api/src/test-utils/integration/fixtures.ts。第三層流水線 e2e——真實(shí)服務(wù)器 假 Pod這一層是性價(jià)比最高的設(shè)計(jì)。e2e/*.e2e.test.ts會(huì)完整啟動(dòng)真實(shí) API 服務(wù)器vitest.e2e.config.ts 將maxWorkers限制為 2避免 4 核 CI 跑機(jī)資源饑餓覆蓋 HTTP API → BullMQ → worker → 日志流 → 協(xié)調(diào)器 → 終態(tài)的整條流水線但容器運(yùn)行時(shí)被替換為 fake 實(shí)現(xiàn)packages/container-runtime/src/fake.ts。Fake runtime 通過提示詞指令扮演智能體你可以在測(cè)試提示詞里寫入[[mock:pr]]—— 輸出 PR URL推進(jìn)到pr_opened[[mock:fail]]/[[mock:silent]]/[[mock:hang]]/[[mock:sleep:MS]][[mock:cost:X]]—— 模擬費(fèi)用這讓任務(wù)/Job/持久智能體的完整生命周期測(cè)試既免費(fèi)又確定。29 個(gè) e2e 用例覆蓋啟動(dòng)遷移、WebSocket 日志流、RBAC、預(yù)算等入口在 apps/api/e2e/。第四層Web e2e——Playwright 驅(qū)動(dòng)真實(shí) UIpnpm --filter optio/web test:e2e會(huì)調(diào)用 apps/web/e2e/launch-stack.ts它先拉起測(cè)試 Postgres/Redis 容器、克隆私有數(shù)據(jù)庫再以 hermetic 模式啟動(dòng)真實(shí) APIAPI 4931 端口、Web 3131 端口避開開發(fā)默認(rèn)端口同時(shí)next dev代理到它并預(yù)置好倉庫、任務(wù)、Job 運(yùn)行等數(shù)據(jù)讓每個(gè)頁面都有非空狀態(tài)可斷言。27 個(gè) Playwright 用例覆蓋終端渲染、工作表單、側(cè)邊欄等全部頂層頁面。首次運(yùn)行記得cd apps/web npx playwright install chromium第五層Live 冒煙——真實(shí)集群 真實(shí) LLMbash scripts/smoke-e2e.sh對(duì)已部署的棧做最終驗(yàn)證scripts/smoke-e2e.shAPI 健康檢查 → Web 頁面可達(dá) → 創(chuàng)建一個(gè)一行提示詞的真實(shí) Job → 走完 K8s Pod 流水線 → 等待完成并刪除。真實(shí) LLM 運(yùn)行只花大約一美分可用--no-llm跳過。改了 Pod 生命周期、鏡像或 Helm 配置后這是提交前的最后關(guān)。 開發(fā)工作流約定提交之前必過四關(guān)項(xiàng)目用Husky lint-staged commitlint把質(zhì)量門禁自動(dòng)化提交前l(fā)int-staged對(duì)暫存的.ts/.tsx跑 ESLint Prettier隨后全局執(zhí)行pnpm format:check和pnpm turbo typecheck見 package.json 的lint-staged字段提交信息強(qiáng)制 Conventional Commitsfeat:/fix:/refactor:等由 commitlint 校驗(yàn)數(shù)據(jù)庫改動(dòng)修改 apps/api/src/db/schema.ts 后手寫新遷移 SQLUnix 時(shí)間戳前綴用bash scripts/check-migration-prefixes.sh檢查前綴重復(fù)移動(dòng)端模型生成iOS / Android 的類型文件由pnpm gen:swift/pnpm gen:kotlin從packages/shared生成禁止手改CI 會(huì)校驗(yàn)同步。 產(chǎn)品全貌測(cè)試守護(hù)的是什么五層測(cè)試守護(hù)的對(duì)象就是這套覆蓋 Web、iOS、Android 的完整工作臺(tái)任務(wù)生命周期、觸發(fā)器派發(fā)、日志實(shí)時(shí)流、持久智能體、本地終端……測(cè)試體系與功能矩陣一一對(duì)應(yīng)這正是改動(dòng)什么就跑哪層能夠成立的原因。? 上手檢查清單pnpm install完成./scripts/setup-local.sh部署成功pnpm turbo test全部通過第一層pnpm --filter optio/api test:integration通過第二層Docker 需在運(yùn)行pnpm --filter optio/api test:e2e通過第三層改 UI 時(shí)pnpm --filter optio/web test:e2e通過第四層后端改動(dòng)后重建鏡像、重部署本地集群并跑bash scripts/smoke-e2e.sh第五層按這個(gè)清單走一遍你就已經(jīng)具備了向 Optio 提交高質(zhì)量 PR 的全部能力。贊分享【免費(fèi)下載鏈接】optioWorkflow orchestration for AI agent swarms.項(xiàng)目地址https://gitcode.com/gh_mirrors/opt/optio點(diǎn)擊查看免費(fèi)下載相關(guān)推薦AlterSend 開發(fā)者入門從零搭建 monorepo 開發(fā)環(huán)境完整教程AlterSend 開發(fā)者入門從零搭建 monorepo 開發(fā)環(huán)境完整教程 AlterSend 是一個(gè)開源的 P2P 文件傳輸應(yīng)用——文件直接在設(shè)備之間點(diǎn)對(duì)點(diǎn)Black 貢獻(xiàn)者上手指南開發(fā)環(huán)境搭建、測(cè)試體系與風(fēng)格變更規(guī)范Black 貢獻(xiàn)者上手指南開發(fā)環(huán)境搭建、測(cè)試體系與風(fēng)格變更規(guī)范 本文基于 Black 倉庫官方貢獻(xiàn)文檔 docs/contributing/the_basic開發(fā)工具格式化代碼質(zhì)量CLILlamaIndex 開發(fā)者貢獻(xiàn)指南基于 uv 的 Monorepo 開發(fā)環(huán)境、測(cè)試與 Lint 工具鏈LlamaIndex 開發(fā)者貢獻(xiàn)指南基于 uv 的 Monorepo 開發(fā)環(huán)境、測(cè)試與 Lint 工具鏈 本篇指南基于 LlamaIndex 倉庫根目錄的 C人工智能大模型AI 應(yīng)用RAGAI Agent創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考