PilotDeck Always-on 源碼解析發(fā)現(xiàn)調(diào)度、信號監(jiān)聽與后臺任務如何協(xié)同工作的完整指南【免費下載鏈接】PilotDeckTask-oriented AI Agent productivity platform項目地址: https://gitcode.com/OpenBMB/PilotDeck如果你用過PilotDeck的 Always-on 功能會發(fā)現(xiàn)它能在你不在場時自動發(fā)現(xiàn)改進點、開工執(zhí)行并產(chǎn)出報告。本文帶你深入 PilotDeck 后臺任務Always-on源碼一次講清「發(fā)現(xiàn)調(diào)度、信號監(jiān)聽與后臺任務」三者如何協(xié)同工作幫助你快速讀懂這套「項目自動駕駛」機制。在 PilotDeck 的 Web 界面里左側(cè)文件面板與右側(cè)助手面板共同構成你與項目交互的主界面而 Always-on 正是依托這套運行時在后臺默默運轉(zhuǎn)Always-on 是什么一條自動運轉(zhuǎn)的后臺任務循環(huán)Always-on常駐是 PilotDeck 的「任務導向 AI Agent」能力的一部分它按固定節(jié)奏審視一個項目發(fā)現(xiàn)值得改進的點生成Plan準備一個隔離的工作區(qū)Workspace讓 Agent 自動執(zhí)行Execution最后產(chǎn)出報告Report并可申請落地Apply。整個過程無需人工盯著且?guī)в幸徽组l門、冷卻與預算保護避免失控。一句話概括這條后臺任務流水線定時 tick → 過閘門 → 搶鎖 → 發(fā)現(xiàn)計劃 → 隔離工作區(qū) → 自動執(zhí)行 → 寫報告 → 可選落地模塊目錄結(jié)構快速定位關鍵源碼Always-on 的源碼集中在src/always-on/按職責分層非常清晰src/always-on/runtime/DiscoveryScheduler.ts —— 發(fā)現(xiàn)調(diào)度器定時觸發(fā) 休眠恢復src/always-on/runtime/SignalWatcher.ts —— 信號監(jiān)聽器感知項目文件變化src/always-on/runtime/DiscoveryGates.ts —— 閘門判定邏輯src/always-on/runtime/DiscoveryFire.ts —— 發(fā)現(xiàn)執(zhí)行引擎五階段流水線的核心src/always-on/runtime/AlwaysOnRuntime.ts —— 單項目運行時生命周期 Ownersrc/always-on/runtime/AlwaysOnManager.ts —— 多項目協(xié)調(diào)器src/always-on/config/parseAlwaysOnConfig.ts —— 配置解析與默認值src/always-on/workspace/GitWorktreeProvider.ts / SnapshotCopyProvider.ts —— 兩種工作區(qū)隔離策略src/always-on/storage/ —— 狀態(tài)、計劃、周期、報告、事件存儲多項目時由AlwaysOnManager統(tǒng)一協(xié)調(diào)它為每個啟用的項目各建一個AlwaysOnRuntime同時共享同一套運行上下文注冊表、會話配置覆蓋和工具集保證工具按會話鍵跨項目可查、Gateway 只看到一組工具定義。參見 AlwaysOnManager 構造邏輯。發(fā)現(xiàn)調(diào)度DiscoveryScheduler 如何定時觸發(fā)調(diào)度器是整個后臺任務的「心跳」。它維護一個定時器按配置的tickIntervalMinutes默認 5 分鐘反復tick()每次 tick 先讀取狀態(tài)、列出新鮮的通道租約、檢查鎖然后交給閘門判定。閘門通過則搶鎖并觸發(fā)DiscoveryFire.run()。一次 tick 執(zhí)行完才會排下一次避免重疊。關鍵方法是scheduleNextTick與tick。啟動時還會調(diào)用maybeRestoreDormancy若上次處于「休眠」狀態(tài)就直接掛起信號監(jiān)聽等待喚醒。信號監(jiān)聽SignalWatcher 如何感知項目變化當項目「安靜無變化」時調(diào)度器會進入休眠避免空轉(zhuǎn)。此時SignalWatcher登場它用fs.watch({ recursive: true })遞歸監(jiān)聽項目目錄配合2 秒去抖等文件活動平息后只觸發(fā)一次信號從而把調(diào)度器「叫醒」。它有兩個精巧細節(jié)忽略無關路徑內(nèi)置 ignore-glob 會過濾掉.git/、node_modules/、.pilotdeck/以及 Always-on 自身的狀態(tài)目錄防止自我觸發(fā)自我激勵。輕量 glob 轉(zhuǎn)正則內(nèi)置compileGlob支持**/、*、?等 gitignore 風格語法。收到信號后的處理見handleSignal清除休眠標記、停掉監(jiān)聽器、重置定時器讓下一次 tick 盡快到來。信號監(jiān)聽的入口是ensureDormancyWatcher。平臺差異提示macOS/Windows 原生支持遞歸監(jiān)聽Linux 僅掛載根目錄深層變更可能被漏掉后續(xù)可疊加輪詢兜底。五道閘門DiscoveryGates 攔截邏輯每次 tick 都會調(diào)用純函數(shù)evaluateAlwaysOnDiscoveryGates按固定順序判定第一個不通過的閘門勝出順序閘門原因含義1project_disabled該項目未啟用 Always-on2project_missing項目目錄不存在3dormant_no_signal處于休眠且無信號喚醒4agent_busy用戶會話正在跑或存在忙碌租約5recent_user_msg最近幾分鐘內(nèi)有用戶消息先讓位6cooldown距上次完成尚在冷卻期7daily_budget今日執(zhí)行次數(shù)已達預算上限8lock_busy已有實例持有發(fā)現(xiàn)鎖全部通過后才放行另外在調(diào)度器里還會檢查cycle_full當前工作周期計劃數(shù)已達上限作為補充攔截見 tick 內(nèi) cycle_full 判定。這套「反向信號」設計讓租約列表只在「存在忙碌/近期租約」時阻擋空列表永遠不阻擋。五階段流水線從發(fā)現(xiàn)到落地的 DiscoveryFire真正干活的是DiscoveryFire每個階段都通過 Gateway 的submitTurn/closeSession與 Agent 會話交互行為等同于普通通道適配器。五個階段各有獨立會話鍵見 通道定義發(fā)現(xiàn)Discovery匯總最近聊天記錄摘要 已有計劃讓 Agent 調(diào)用計劃工具產(chǎn)出至多一個新計劃。入口見run。工作區(qū)Workspace通過ensureActiveWorkCycle準備/復用隔離工作區(qū)。執(zhí)行Execution在工作區(qū)里讓 Agent 按計劃自動改代碼并注入deny 規(guī)則禁止git push/git remote見ALWAYS_ON_EXECUTION_DENY_RULES。報告Report產(chǎn)出 Markdown 報告失敗時自動降級寫兜底報告。落地Apply可選階段生成 diff 并申請把改動應用到真實項目。每個階段都會emitEvent寫入事件存儲并上報遙測保證全程可追溯。無人值守會話還會統(tǒng)一排除交互類工具canPrompt: false。工作區(qū)隔離Git Worktree 與快照兩種策略后臺任務絕不能直接污染你的工作目錄。WorkspaceProviderRegistry注冊了兩套策略Git WorktreeGitWorktreeProvider在獨立 worktree/分支上改代碼天然隔離?？煺諒椭芐napshotCopyProvider復制一份項目快照上限默認 1 GiB后操作。ensureActiveWorkCycle是「單活動周期 單工作區(qū)」的唯一事實來源已有活動周期且工作區(qū)還在磁盤上就復用否則新建。見 ensureActiveWorkCycle。存儲層與事件追蹤如何保證可追溯所有狀態(tài)都以文件形式落盤在項目下便于審查DiscoveryStateStore —— 休眠/上次完成時間/當日次數(shù)DiscoveryPlanStore —— 計劃索引與 MarkdownWorkCycleStore —— 工作周期DiscoveryReportStore —— 報告AlwaysOnEventStore —— 階段事件流左側(cè)文件面板里這些狀態(tài)目錄清晰可見配合右側(cè)助手即可核對后臺任務每一步配置項速查關鍵默認值一覽默認配置由defaultAlwaysOnConfig給出trigger各字段含義如下字段默認值作用tickIntervalMinutes5定時觸發(fā)間隔分鐘最小 1 分鐘cooldownMinutes60兩次執(zhí)行間冷卻dailyBudget4每日執(zhí)行次數(shù)預算heartbeatStaleSeconds90租約心跳過期秒數(shù)recentUserMsgMinutes5近期用戶消息讓位窗口preferChannelweb優(yōu)先使用的通道其他常量DEFAULT_MAX_PLANS_PER_CYCLE 3每周期最多計劃數(shù)、DEFAULT_SNAPSHOT_MAX_BYTES 1 GiB快照上限、DEFAULT_IGNORE_GLOBS監(jiān)聽忽略目錄。小結(jié)三者如何協(xié)同發(fā)現(xiàn)調(diào)度DiscoveryScheduler負責「什么時候干」——定時 tick、休眠、搶鎖。信號監(jiān)聽SignalWatcher負責「要不要提前干」——項目一變就把調(diào)度器喚醒。后臺任務DiscoveryFire 閘門 工作區(qū)負責「怎么干、干多少」——五階段流水線 多道保護。三者層層配合讓 PilotDeck 的 Always-on 既能主動發(fā)現(xiàn)改進點又始終受預算、冷卻與鎖的約束真正做到「無人值守也安全」。想動手驗證可從 src/always-on/runtime/DiscoveryScheduler.ts 的tick()單步執(zhí)行入手是最直觀的入口。【免費下載鏈接】PilotDeckTask-oriented AI Agent productivity platform項目地址: https://gitcode.com/OpenBMB/PilotDeck創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考