人工智能AI Agent代碼智能體Agent 編排CLIAI 應(yīng)用【免費(fèi)下載鏈接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture項(xiàng)目地址https://gitcode.com/gh_mirrors/gs/gsd-2點(diǎn)擊查看免費(fèi)下載GSDGet Shit Done是一款面向長(zhǎng)時(shí)自主運(yùn)行的 meta-prompting 與 spec-driven 開發(fā)系統(tǒng)其 Auto Mode 可以在無人盯守的情況下持續(xù)推進(jìn) Milestone、Slice 與 Task。本文圍繞 GSD 的桌面通知Notifications功能展開如何通過 YAML 配置啟用/關(guān)閉五類通知事件如何在 macOS 上正確安裝terminal-notifier以保障通知穩(wěn)定送達(dá)以及在通知不出現(xiàn)時(shí)如何系統(tǒng)化排查。讀完本文你將掌握 GSD 通知配置的完整參數(shù)語義、跨平臺(tái)發(fā)送原理macOS / Linux / Windows并理解通知在預(yù)算告警、上下文窗口暫停、里程碑完成等關(guān)鍵節(jié)點(diǎn)上的實(shí)際觸發(fā)路徑。通知機(jī)制概述Auto Mode 的遠(yuǎn)程儀表盤GSD 的 Auto Mode 允許 Agent 長(zhǎng)時(shí)間自主運(yùn)行但用戶不可能一直盯著終端。桌面通知正是為此設(shè)計(jì)當(dāng) Agent 完成單元、遇到錯(cuò)誤、觸及預(yù)算閾值、完成里程碑或需要人工介入時(shí)系統(tǒng)會(huì)彈出系統(tǒng)級(jí)通知讓你無需盯著屏幕也能掌握進(jìn)度。從源碼結(jié)構(gòu)看這一能力由 GSD 擴(kuò)展的通知助手模塊 統(tǒng)一提供。其入口函數(shù)sendDesktopNotification的設(shè)計(jì)目標(biāo)是非阻塞、非致命non-blocking, non-fatal即使通知發(fā)送失敗也絕不會(huì)影響 Auto Mode 主流程的執(zhí)行。它支持五種通知事件類型源碼中以NotificationKind聯(lián)合類型定義notifications.tsexport type NotifyLevel info | success | warning | error; export type NotificationKind complete | error | budget | milestone | attention;這五個(gè)kind與配置項(xiàng)一一對(duì)應(yīng)構(gòu)成了通知系統(tǒng)的開關(guān)矩陣。配置參數(shù)與完整示例在 GSD 的項(xiàng)目配置文件中通知通過notifications塊控制。原文檔給出的完整配置如下notifications: enabled: true on_complete: true # notify on unit completion on_error: true # notify on errors on_budget: true # notify on budget thresholds on_milestone: true # notify when milestone finishes on_attention: true # notify when manual attention needed各參數(shù)語義與源碼默認(rèn)值types.ts 中NotificationPreferences接口定義匯總?cè)缦聟?shù)含義源碼默認(rèn)值enabled總開關(guān)設(shè)為false時(shí)所有類別全部靜默trueon_complete每個(gè)單元Task/Slice完成時(shí)通知trueon_error運(yùn)行出錯(cuò)時(shí)通知trueon_budget觸發(fā)預(yù)算閾值時(shí)通知trueon_milestone里程碑Milestone完成時(shí)通知trueon_attention需要人工介入如被阻塞恢復(fù)、上下文窗口暫停時(shí)通知true值得注意的是各開關(guān)的生效邏輯并非簡(jiǎn)單非黑即白。在 notifications.ts 的shouldSendDesktopNotification中判斷順序是若enabled false直接返回false所有類別一律不發(fā)送否則按kind分別讀取對(duì)應(yīng)開關(guān)未顯式配置的類別默認(rèn)視為開啟?? true。這意味著你可以只關(guān)閉個(gè)別不關(guān)心的類別例如在長(zhǎng)跑預(yù)算類任務(wù)時(shí)僅保留錯(cuò)誤通知notifications: enabled: true on_complete: false on_budget: false on_milestone: false配置的合并邏輯位于 preferences.tsnotifications采用淺合并shallow mergebase 與 override 逐字段覆蓋因此全局偏好與項(xiàng)目級(jí)偏好可以分層組合未覆蓋的字段自動(dòng)繼承。跨平臺(tái)支持macOS / Linux / Windows雖然原文檔聚焦 macOS但 GSD 的通知實(shí)現(xiàn)是跨平臺(tái)的。從 notifications.ts 的buildDesktopNotificationCommand可以看到按process.platform分發(fā)的三條路徑平臺(tái)發(fā)送命令說明macOS (darwin)優(yōu)先terminal-notifier缺失時(shí)回退osascript聲音按級(jí)別區(qū)分error用Basso其余用GlassLinuxnotify-sendurgency 按級(jí)別映射error→criticalwarning→normal其余 →lowWindows (win32)無直接返回null桌面通知被跳過不報(bào)錯(cuò)、不影響流程此外通知文本在發(fā)送前會(huì)經(jīng)過 規(guī)范化處理換行符被替換為空格保證系統(tǒng)通知單行顯示AppleScript 路徑還會(huì)對(duì)反斜杠與雙引號(hào)做轉(zhuǎn)義避免腳本注入或語法錯(cuò)誤。測(cè)試用例也驗(yàn)證了這一點(diǎn)Linux 下line 1\nline 2會(huì)被規(guī)范化為line 1 line 2且$PATH等字面字符被原樣保留notifications.test.ts。macOS 設(shè)置詳解為什么推薦 terminal-notifierGSD 在 macOS 上優(yōu)先使用terminal-notifier找不到時(shí)才回退到系統(tǒng)自帶的osascript。推薦做法安裝 terminal-notifierbrew install terminal-notifier為什么這是原文檔與源碼注釋共同強(qiáng)調(diào)的關(guān)鍵點(diǎn)osascript的通知?dú)w屬于調(diào)用它的終端應(yīng)用Ghostty、iTerm2、Terminal.app 等。如果該終端應(yīng)用本身沒有在系統(tǒng)設(shè)置 → 通知中獲取通知權(quán)限osascript的通知會(huì)被系統(tǒng)靜默吞掉——而且進(jìn)程仍以退出碼 0 結(jié)束不會(huì)有任何報(bào)錯(cuò)排查起來非常隱蔽。源碼注釋明確記載了這一場(chǎng)景notifications.ts。而terminal-notifier會(huì)以獨(dú)立的 App 身份注冊(cè)到通知中心首次使用時(shí)系統(tǒng)會(huì)彈出權(quán)限請(qǐng)求授予后即可穩(wěn)定送達(dá)不依賴終端應(yīng)用的權(quán)限狀態(tài)。安裝后的自測(cè)命令原文檔提供terminal-notifier -title GSD -message working! -sound Glass執(zhí)行后若能在屏幕右上角看到通知并聽到提示音說明鏈路正常。通知不出現(xiàn)三步排查法原文檔給出了系統(tǒng)的排查順序檢查系統(tǒng)設(shè)置打開系統(tǒng)設(shè)置 → 通知確認(rèn)你的終端應(yīng)用或已安裝的terminal-notifier在列表中且允許通知安裝 terminal-notifier如上所述這是最可靠的一步可繞開終端應(yīng)用的權(quán)限黑洞命令行自測(cè)運(yùn)行terminal-notifier -title GSD -message working! -sound Glass確認(rèn)工具本身可用。若終端應(yīng)用未出現(xiàn)在通知列表中可能是它尚未發(fā)送過任何通知、未完成注冊(cè)——讓它先主動(dòng)發(fā)送一次通知即可觸發(fā)注冊(cè)。更完整的疑難排查可參考 Troubleshooting其中亦指引回看本文的 Notifications 配置說明。源碼縱深通知發(fā)送鏈路與觸發(fā)節(jié)點(diǎn)sendDesktopNotification的完整鏈路notifications.ts遠(yuǎn)比彈一個(gè)系統(tǒng)通知復(fù)雜按優(yōu)先級(jí)依次為標(biāo)題項(xiàng)目化當(dāng)調(diào)用方傳入projectName且默認(rèn)標(biāo)題為GSD時(shí)標(biāo)題會(huì)被改寫為GSD — 項(xiàng)目名formatNotificationTitle在多項(xiàng)目并行工作區(qū)中一眼區(qū)分通知來自哪個(gè)項(xiàng)目遠(yuǎn)程通知sendRemoteNotification獨(dú)立觸發(fā)且不受桌面通知偏好的約束——它處理未配置場(chǎng)景時(shí)優(yōu)雅返回也就是說遠(yuǎn)程推送與桌面通知是兩條并行通道notifications.tscmux 通道若啟用了 cmux 集成cmux.notifications優(yōu)先經(jīng)CmuxClient.notify投遞投遞失敗則回退到 OSC 777 終端通知notifications.ts桌面通知僅當(dāng) cmux 未投遞成功時(shí)才構(gòu)造系統(tǒng)命令terminal-notifier / osascript / notify-send執(zhí)行帶 3 秒超時(shí)任何異常都靜默吞掉notifications.ts。在 Auto Mode 的調(diào)用端各kind的典型觸發(fā)節(jié)點(diǎn)清晰可查milestone里程碑完成在里程碑推進(jìn)邏輯中Milestone id complete!以success級(jí)別、milestone類型發(fā)送auto/phases.tsbudget預(yù)算閾值預(yù)算閾值采用數(shù)據(jù)驅(qū)動(dòng)定義auto/types.ts四檔閾值依次為100%error / 強(qiáng)制處理、90%warning、80%warning、75%info。其中 100% 閾值根據(jù)enforcement策略halt / pause / warn分別觸發(fā)停止 Auto Mode暫停待用戶/gsd auto繼續(xù)僅警告繼續(xù)運(yùn)行三種行為且都會(huì)伴隨桌面通知auto/phases.tsattention人工介入包括被阻塞后的恢復(fù)提示blocked resumewarning級(jí)別以及上下文窗口達(dá)到context_pause_threshold而自動(dòng)暫停的場(chǎng)景——Context percent% — pausedauto/phases.tscomplete單元完成例如執(zhí)行/gsd undo撤銷單元后發(fā)送Undone: unitType (unitId)undo.ts。測(cè)試保障偏好開關(guān)與命令構(gòu)造均被覆蓋通知模塊有專門的單元測(cè)試 notifications.test.ts驗(yàn)證了以下關(guān)鍵行為細(xì)粒度開關(guān)enabled: true時(shí)on_complete: false關(guān)閉完成通知、on_error: true保留錯(cuò)誤通知各 kind 互不干擾L11-L26總開關(guān)enabled: false時(shí)即使個(gè)別類別為true也全部靜默L28-L33macOS 回退無terminal-notifier時(shí)回退osascript并對(duì)Bobs Milestone、C:\temp等特殊字符做正確轉(zhuǎn)義L35-L61聲音分級(jí)非 error 級(jí)別使用GlassL63-L71平臺(tái)邊界win32返回null不做無謂報(bào)錯(cuò)L88-L90項(xiàng)目標(biāo)題formatNotificationTitle對(duì)空值、空白、真實(shí)項(xiàng)目名的處理以及 macOS / Linux 命令中均攜帶GSD — 項(xiàng)目名標(biāo)題L94-L134。小結(jié)與最佳實(shí)踐GSD 的桌面通知是 Auto Mode 無人值守體驗(yàn)的關(guān)鍵一環(huán)配置輕量、實(shí)現(xiàn)穩(wěn)健。實(shí)踐建議macOS 用戶務(wù)必安裝terminal-notifier這是規(guī)避終端應(yīng)用通知權(quán)限問題的根本手段按工作負(fù)載裁剪通知類別預(yù)算敏感的里程碑跑批可只保留on_error與on_attention減少打擾首次接入時(shí)用terminal-notifier -title GSD -message working! -sound Glass自測(cè)再進(jìn)入真實(shí)任務(wù)若通知仍不出現(xiàn)按系統(tǒng)設(shè)置 → 安裝工具 → 命令行自測(cè)的順序排查并留意通知中心對(duì)終端應(yīng)用的注冊(cè)狀態(tài)。整體來看通知系統(tǒng)將Agent 自主推進(jìn)與人類保持感知無縫銜接——你只管離開終端GSD 會(huì)在需要你的時(shí)候叫醒你。贊分享人工智能AI Agent代碼智能體Agent 編排CLIAI 應(yīng)用【免費(fèi)下載鏈接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture項(xiàng)目地址https://gitcode.com/gh_mirrors/gs/gsd-2點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Deep-Live-Cam 實(shí)時(shí)換臉部署教程沒有顯卡一張照片也能快速跑通Deep Live Cam 實(shí)時(shí)換臉部署教程沒有顯卡一張照片也能快速跑通 Deep Live Cam 是開源實(shí)時(shí)換臉工具一張正臉照片就能把視頻或攝像頭畫人工智能AI Agent代碼智能體Agent 編排CLIAI 應(yīng)用UnattendGeneratorWindows無人值守安裝配置終極指南UnattendGeneratorWindows無人值守安裝配置終極指南 在現(xiàn)代IT運(yùn)維中自動(dòng)化部署是提高效率、減少人工干預(yù)的重要手段。UnattendGeCodeBurn Windows 桌面開發(fā) VM基于 cloud-init 的 Ubuntu 24.04 無人值守安裝與一鍵配置指南CodeBurn Windows 桌面開發(fā) VM基于 cloud init 的 Ubuntu 24.04 無人值守安裝與一鍵配置指南 本指南講解 CodeBu上一篇Qwen3-Coder-30B-A3B-Instruct終極代碼生成AI模型完全指南下一篇探索Kubicorn打造和管理Kubernetes基礎(chǔ)設(shè)施的新紀(jì)元?jiǎng)?chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考