Fabric 桌面通知Desktop Notifications完整指南配置、跨平台支持与安全实践【免费下载链接】FabricFabric is an open-source framework for augmenting humans using AI. It provides a modular system for solving specific problems using a crowdsourced set of AI prompts that can be used anywhere.项目地址: https://gitcode.com/GitHub_Trending/fa/FabricFabric 是开源的 AI 增强人类工作流框架其桌面通知功能可以在命令执行完成后弹出系统级提醒特别适合长时间运行的任务或多任务并行场景。本文以 docs/Desktop-Notifications.md 为骨架结合 internal/tools/notifications/notifications.go、internal/cli/chat.go 等源码实现系统讲解通知的启用方式、跨平台 Provider 机制、自定义通知命令的安全模型以及完整的故障排查方法。读完本文你将能够为任意 Fabric 命令一键开启通知、编写带自定义参数的自定义通知脚本并理解其防止命令注入的底层设计。快速开始Quick Start启用桌面通知只需在 Fabric 命令后追加--notification标志命令完成后系统会自动弹出通知fabric --pattern summarize --notification article.txt该命令会对article.txt执行summarizepattern处理结束后在桌面弹出Fabric Command Complete通知。通知的发送时机位于命令执行管线的最末端——从 internal/cli/chat.go#L138-L144 可以看到通知在输出写入与剪贴板复制完成后触发且通知发送失败不会导致主命令失败只会记录一条 debug 日志// Send notification if requested if chatOptions.Notification { if err sendNotification(chatOptions, chatReq.PatternName, result); err ! nil { // Log notification error but dont fail the main command debuglog.Log(Failed to send notification: %v\n, err) } }这意味着即使系统缺少通知工具你的 AI 处理结果依然完整保留通知只是一个尽力而为的辅助层。配置方式命令行选项选项说明--notification命令完成时发送桌面通知布尔开关--notification-command使用自定义通知命令覆盖内置通知系统这两个标志在 internal/cli/flags.go#L109-L110 中定义注意它们的 YAML tag 分别是notification和notificationCommand这决定了它们在配置文件中的键名Notification bool long:notification yaml:notification description:Send desktop notification when command completes NotificationCommand string long:notification-command yaml:notificationCommand description:Custom command to run for notifications (overrides built-in notifications)值得注意的细节在 internal/cli/flags.go#L475 中只要设置了NotificationCommandNotification标志也会被隐式置为 true即自定义命令本身就会触发通知流程无需同时显式传--notificationNotification: o.Notification || o.NotificationCommand ! , NotificationCommand: o.NotificationCommand,YAML 配置将以下内容写入~/.config/fabric/config.yaml即可让所有命令默认开启通知免去每次追加标志的麻烦# Enable notifications by default notification: true # Optional: Custom notification command notificationCommand: notify-send --urgencynormal $1 $2仓库提供了完整的参考配置文件 docs/notification-config.yaml其中包含带注释的多种平台示例以及配套的常用模型设置如model: gpt-5.2、temperature: 0.7、stream: true可直接复制为默认配置的基础模板。命令行标志与 YAML 配置的优先级遵循一般惯例显式传入的命令行参数会覆盖配置文件中的同名设置。平台支持与内置 Provider 机制Fabric 的桌面通知采用策略模式设计通过NotificationProvider接口抽象不同平台的实现接口定义在 internal/tools/notifications/notifications.go#L13-L16type NotificationProvider interface { Send(title, message string) error IsAvailable() bool }NewNotificationManager()根据runtime.GOOS自动选择最优的可用 Providernotifications.go#L24-L43switch runtime.GOOS { case darwin: // Try terminal-notifier first, then fall back to osascript provider TerminalNotifierProvider{} if !provider.IsAvailable() { provider OSAScriptProvider{} } case linux: provider NotifySendProvider{} case windows: provider PowerShellProvider{} default: provider NoopProvider{} }各平台的对应关系与依赖要求如下macOS默认使用osascriptmacOS 系统自带无需额外安装。实现上通过osascript执行 AppleScript 脚本并借助FABRIC_TITLE/FABRIC_MESSAGE环境变量传递内容notifications.go#L72-L87。增强安装terminal-notifier可获得更原生、更美观的通知brew install terminal-notifier安装后 Fabric 会优先使用terminal-notifier自带Glass提示音不可用时自动回退到osascript。Linux依赖需要notify-send命令属于libnotify工具集# Ubuntu/Debian sudo apt install libnotify-bin # Fedora sudo dnf install libnotifyNotifySendProvider通过exec.Command(notify-send, title, message)以独立参数方式传值从根本上避免拼接注入notifications.go#L90-L100。Windows默认使用 PowerShell 消息框系统内置。实现中通过Add-Type -AssemblyName System.Windows.Forms加载 WinForms 并弹出MessageBox同样通过环境变量$env:FABRIC_MESSAGE/$env:FABRIC_TITLE传递内容避免 PowerShell 注入notifications.go#L103-L118。其他平台不支持的平台如 BSD 等会使用NoopProviderSend静默成功、IsAvailable恒为 false保证程序行为稳定不报错notifications.go#L120-L130。每个 Provider 的可达性判断都基于exec.LookPath探测对应命令是否存在测试文件 internal/tools/notifications/notifications_test.go 中的TestProviderIsAvailable会交叉校验 Provider 报告与真实命令可用性的一致性。自定义通知命令--notification-command允许你使用任意脚本或命令替代内置通知。自定义命令接收两个 shell 位置参数$1为标题title$2为消息message。fabric --pattern summarize --notification-command /path/to/my-notification-script.sh $1 $2 report.pdf安全模型防注入设计安全提示标题和消息内容会被正确转义防止 AI 生成的输出中包含 shell 元字符时发生命令注入攻击。其底层实现位于 internal/cli/chat.go#L174-L185// SECURITY: Pass title and message as proper shell positional arguments $1 and $2 cmd : exec.Command(sh, -c, options.NotificationCommand \$1\ \$2\, --, title, message)关键点在于你的自定义命令字符串被作为sh -c的脚本体而标题与消息是通过exec.Command的独立 argv 参数--之后的title、message传入的Go 的os/exec会自动完成 shell 元字符转义。也就是说即使 AI 输出的文本包含;、$(...)、反引号等危险字符它们也只会被当作普通文本赋值给$1/$2绝不会被当作新命令执行。测试用例 internal/cli/chat_test.go#L11-L90 的TestSendNotification_SecurityEscaping专门覆盖了这一场景验证了含引号、分号、反引号等恶意载荷的消息不会逃逸出参数边界。此外内置 Provider 同样贯彻防注入原则OSAScriptProvider和PowerShellProvider都改用环境变量FABRIC_TITLE/FABRIC_MESSAGE传递动态内容源码注释明确标注了SECURITY字样。实用示例macOS 带自定义提示音fabric --pattern analyze_claims --notification-command osascript -e display notification \$2\ with title \$1\ sound name \Ping\ document.txtLinux 指定紧急级别fabric --pattern extract_wisdom --notification-command notify-send --urgencycritical $1 $2 video-transcript.txt自定义脚本fabric --pattern summarize --notification-command /path/to/my-notification-script.sh $1 $2 report.pdf测试自定义命令是否工作# Test that $1 and $2 are passed correctly fabric --pattern raw_query --notification-command echo Title: $1, Message: $2 test input最后一条命令会直接在终端打印Title: ...与Message: ...是验证参数传递最快捷的方式。通知内容与消息截断通知包含两部分标题Title默认文案为Fabric Command Complete当指定了 pattern 时变为Fabric: [pattern] Complete如Fabric: summarize Complete。文案经由 i18n 系统本地化在 internal/i18n/locales/en.json#L250-L251 中可看到fabric_command_complete与fabric_command_complete_with_pattern两个键已支持德、西、波斯等多语言。消息Message结果的简要摘要默认取前 100 个字符结果为空时显示Command completed successfully。长输出会被截断并追加...以适配系统通知的显示长度限制internal/cli/chat.go#L160-L172maxLength : 100 runes : []rune(result) if len(runes) maxLength { message fmt.Sprintf(i18n.T(output_truncated), string(runes[:maxLength])) } else { message fmt.Sprintf(i18n.T(output_full), result) } // Clean up newlines for notification display message strings.ReplaceAll(message, \n, )两个值得了解的实现细节其一截断按Unicode 码点rune计数而非字素簇grapheme cluster因此复杂的 emoji 或多重组合字符的变音符可能在边界处被截断源码注释中明确标注了这一已知限制其二消息中的换行符会被统一替换为空格避免多行文本在单行通知框中显示异常。测试用例TestSendNotification_MessageTruncationinternal/cli/chat_test.go#L135验证了截断与完整输出的两种分支。典型使用场景长时任务Long-Running Tasks处理大文档或提取长视频智慧时不必一直盯着终端# Process large document with notifications fabric --pattern analyze_paper --notification research-paper.pdf # Extract wisdom from long video with alerts fabric -y https://youtube.com/watch?v... --pattern extract_wisdom --notification第二条命令利用-y直接输入 YouTube 链接extract_wisdom需要先完成视频转录再分析耗时较长通知能让你放心切走做别的事。后台批处理Background Processing批量处理多个文件每个完成时逐个提醒# Process multiple files and get notified when each completes for file in *.txt; do fabric --pattern summarize --notification $file done由于每个子任务独立触发通知你可以随时知道当前处理进度适合边处理边安排下一步工作。与其他工具集成与其他命令组合处理完管道数据后收到完成提醒# Combine with other commands curl -s https://api.example.com/data | \ fabric --pattern analyze_data --notification --output results.md故障排查Troubleshooting没有出现通知按以下顺序排查检查系统通知是否开启确保终端应用Terminal/iTerm2/终端模拟器的系统通知权限未被关闭。确认通知工具已安装macOSwhich osascript应存在Linuxwhich notify-sendWindowswhere.exe powershell用简单命令测试echo test | fabric --pattern raw_query --notification --dry-run使用--dry-run可以快速验证通知链路而不消耗模型调用。通知权限问题部分系统需要为终端应用单独授予通知权限macOS系统设置 → 通知与专注模式 → 应用通知 → 为你的终端应用启用通知Linux取决于桌面环境GNOME/KDE 等通常安装libnotify后自动可用Windows通常默认即可工作。自定义命令不生效确认自定义通知命令具有可执行权限先用示例参数手动执行该命令排除脚本自身问题检查脚本依赖的全部程序是否已安装。从源码层面确认若仍无法定位可开启 debug 日志。通知发送失败时会通过debuglog.Log记录internal/cli/chat.go#L141-L142配合--debug标志运行可看到具体的失败原因如 no notification system available。该错误文案同样由 i18n 管理见 internal/i18n/locales/en.json#L348。高级配置按环境拆分配置不同机器可以使用不同的配置文件通过--config指定# Work computer (quieter notifications) fabric --config ~/.config/fabric/work-config.yaml --notification # Personal computer (with sound) fabric --config ~/.config/fabric/personal-config.yaml --notification例如工作机配置使用普通紧急度的notify-send个人机配置使用带提示音的osascript版本实现安静办公、有声居家的环境差异化。与任务管理集成自定义通知命令可以作为工作流的钩子把完成事件同步到外部系统# Custom script that also logs to task management system notificationCommand: /usr/local/bin/fabric-notify-and-log.sh $1 $2脚本内部既可以调用系统通知也可以把$1、$2写入任务看板、发送到聊天工具或追加到日志文件将 Fabric 的完成事件无缝纳入既有工作流。完整参考配置仓库中的 docs/notification-config.yaml 提供了带注释的完整示例涵盖 macOS 自定义提示音、Linux 紧急级别、自定义脚本三种notificationCommand写法并附带常用模型参数可直接作为~/.config/fabric/config.yaml的起点。结合本文源码分析你可以根据实际平台与安全需求选择内置 Provider 或自定义命令构建一套稳定、安全、贴合个人习惯的 Fabric 桌面通知方案。【免费下载链接】FabricFabric is an open-source framework for augmenting humans using AI. It provides a modular system for solving specific problems using a crowdsourced set of AI prompts that can be used anywhere.项目地址: https://gitcode.com/GitHub_Trending/fa/Fabric创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Fabric 桌面通知（Desktop Notifications）完整指南：配置、跨平台支持与安全实践
Fabric 桌面通知Desktop Notifications完整指南配置、跨平台支持与安全实践【免费下载链接】FabricFabric is an open-source framework for augmenting humans using AI. It provides a modular system for solving specific problems using a crowdsourced set of AI prompts that can be used anywhere.项目地址: https://gitcode.com/GitHub_Trending/fa/FabricFabric 是开源的 AI 增强人类工作流框架其桌面通知功能可以在命令执行完成后弹出系统级提醒特别适合长时间运行的任务或多任务并行场景。本文以 docs/Desktop-Notifications.md 为骨架结合 internal/tools/notifications/notifications.go、internal/cli/chat.go 等源码实现系统讲解通知的启用方式、跨平台 Provider 机制、自定义通知命令的安全模型以及完整的故障排查方法。读完本文你将能够为任意 Fabric 命令一键开启通知、编写带自定义参数的自定义通知脚本并理解其防止命令注入的底层设计。快速开始Quick Start启用桌面通知只需在 Fabric 命令后追加--notification标志命令完成后系统会自动弹出通知fabric --pattern summarize --notification article.txt该命令会对article.txt执行summarizepattern处理结束后在桌面弹出Fabric Command Complete通知。通知的发送时机位于命令执行管线的最末端——从 internal/cli/chat.go#L138-L144 可以看到通知在输出写入与剪贴板复制完成后触发且通知发送失败不会导致主命令失败只会记录一条 debug 日志// Send notification if requested if chatOptions.Notification { if err sendNotification(chatOptions, chatReq.PatternName, result); err ! nil { // Log notification error but dont fail the main command debuglog.Log(Failed to send notification: %v\n, err) } }这意味着即使系统缺少通知工具你的 AI 处理结果依然完整保留通知只是一个尽力而为的辅助层。配置方式命令行选项选项说明--notification命令完成时发送桌面通知布尔开关--notification-command使用自定义通知命令覆盖内置通知系统这两个标志在 internal/cli/flags.go#L109-L110 中定义注意它们的 YAML tag 分别是notification和notificationCommand这决定了它们在配置文件中的键名Notification bool long:notification yaml:notification description:Send desktop notification when command completes NotificationCommand string long:notification-command yaml:notificationCommand description:Custom command to run for notifications (overrides built-in notifications)值得注意的细节在 internal/cli/flags.go#L475 中只要设置了NotificationCommandNotification标志也会被隐式置为 true即自定义命令本身就会触发通知流程无需同时显式传--notificationNotification: o.Notification || o.NotificationCommand ! , NotificationCommand: o.NotificationCommand,YAML 配置将以下内容写入~/.config/fabric/config.yaml即可让所有命令默认开启通知免去每次追加标志的麻烦# Enable notifications by default notification: true # Optional: Custom notification command notificationCommand: notify-send --urgencynormal $1 $2仓库提供了完整的参考配置文件 docs/notification-config.yaml其中包含带注释的多种平台示例以及配套的常用模型设置如model: gpt-5.2、temperature: 0.7、stream: true可直接复制为默认配置的基础模板。命令行标志与 YAML 配置的优先级遵循一般惯例显式传入的命令行参数会覆盖配置文件中的同名设置。平台支持与内置 Provider 机制Fabric 的桌面通知采用策略模式设计通过NotificationProvider接口抽象不同平台的实现接口定义在 internal/tools/notifications/notifications.go#L13-L16type NotificationProvider interface { Send(title, message string) error IsAvailable() bool }NewNotificationManager()根据runtime.GOOS自动选择最优的可用 Providernotifications.go#L24-L43switch runtime.GOOS { case darwin: // Try terminal-notifier first, then fall back to osascript provider TerminalNotifierProvider{} if !provider.IsAvailable() { provider OSAScriptProvider{} } case linux: provider NotifySendProvider{} case windows: provider PowerShellProvider{} default: provider NoopProvider{} }各平台的对应关系与依赖要求如下macOS默认使用osascriptmacOS 系统自带无需额外安装。实现上通过osascript执行 AppleScript 脚本并借助FABRIC_TITLE/FABRIC_MESSAGE环境变量传递内容notifications.go#L72-L87。增强安装terminal-notifier可获得更原生、更美观的通知brew install terminal-notifier安装后 Fabric 会优先使用terminal-notifier自带Glass提示音不可用时自动回退到osascript。Linux依赖需要notify-send命令属于libnotify工具集# Ubuntu/Debian sudo apt install libnotify-bin # Fedora sudo dnf install libnotifyNotifySendProvider通过exec.Command(notify-send, title, message)以独立参数方式传值从根本上避免拼接注入notifications.go#L90-L100。Windows默认使用 PowerShell 消息框系统内置。实现中通过Add-Type -AssemblyName System.Windows.Forms加载 WinForms 并弹出MessageBox同样通过环境变量$env:FABRIC_MESSAGE/$env:FABRIC_TITLE传递内容避免 PowerShell 注入notifications.go#L103-L118。其他平台不支持的平台如 BSD 等会使用NoopProviderSend静默成功、IsAvailable恒为 false保证程序行为稳定不报错notifications.go#L120-L130。每个 Provider 的可达性判断都基于exec.LookPath探测对应命令是否存在测试文件 internal/tools/notifications/notifications_test.go 中的TestProviderIsAvailable会交叉校验 Provider 报告与真实命令可用性的一致性。自定义通知命令--notification-command允许你使用任意脚本或命令替代内置通知。自定义命令接收两个 shell 位置参数$1为标题title$2为消息message。fabric --pattern summarize --notification-command /path/to/my-notification-script.sh $1 $2 report.pdf安全模型防注入设计安全提示标题和消息内容会被正确转义防止 AI 生成的输出中包含 shell 元字符时发生命令注入攻击。其底层实现位于 internal/cli/chat.go#L174-L185// SECURITY: Pass title and message as proper shell positional arguments $1 and $2 cmd : exec.Command(sh, -c, options.NotificationCommand \$1\ \$2\, --, title, message)关键点在于你的自定义命令字符串被作为sh -c的脚本体而标题与消息是通过exec.Command的独立 argv 参数--之后的title、message传入的Go 的os/exec会自动完成 shell 元字符转义。也就是说即使 AI 输出的文本包含;、$(...)、反引号等危险字符它们也只会被当作普通文本赋值给$1/$2绝不会被当作新命令执行。测试用例 internal/cli/chat_test.go#L11-L90 的TestSendNotification_SecurityEscaping专门覆盖了这一场景验证了含引号、分号、反引号等恶意载荷的消息不会逃逸出参数边界。此外内置 Provider 同样贯彻防注入原则OSAScriptProvider和PowerShellProvider都改用环境变量FABRIC_TITLE/FABRIC_MESSAGE传递动态内容源码注释明确标注了SECURITY字样。实用示例macOS 带自定义提示音fabric --pattern analyze_claims --notification-command osascript -e display notification \$2\ with title \$1\ sound name \Ping\ document.txtLinux 指定紧急级别fabric --pattern extract_wisdom --notification-command notify-send --urgencycritical $1 $2 video-transcript.txt自定义脚本fabric --pattern summarize --notification-command /path/to/my-notification-script.sh $1 $2 report.pdf测试自定义命令是否工作# Test that $1 and $2 are passed correctly fabric --pattern raw_query --notification-command echo Title: $1, Message: $2 test input最后一条命令会直接在终端打印Title: ...与Message: ...是验证参数传递最快捷的方式。通知内容与消息截断通知包含两部分标题Title默认文案为Fabric Command Complete当指定了 pattern 时变为Fabric: [pattern] Complete如Fabric: summarize Complete。文案经由 i18n 系统本地化在 internal/i18n/locales/en.json#L250-L251 中可看到fabric_command_complete与fabric_command_complete_with_pattern两个键已支持德、西、波斯等多语言。消息Message结果的简要摘要默认取前 100 个字符结果为空时显示Command completed successfully。长输出会被截断并追加...以适配系统通知的显示长度限制internal/cli/chat.go#L160-L172maxLength : 100 runes : []rune(result) if len(runes) maxLength { message fmt.Sprintf(i18n.T(output_truncated), string(runes[:maxLength])) } else { message fmt.Sprintf(i18n.T(output_full), result) } // Clean up newlines for notification display message strings.ReplaceAll(message, \n, )两个值得了解的实现细节其一截断按Unicode 码点rune计数而非字素簇grapheme cluster因此复杂的 emoji 或多重组合字符的变音符可能在边界处被截断源码注释中明确标注了这一已知限制其二消息中的换行符会被统一替换为空格避免多行文本在单行通知框中显示异常。测试用例TestSendNotification_MessageTruncationinternal/cli/chat_test.go#L135验证了截断与完整输出的两种分支。典型使用场景长时任务Long-Running Tasks处理大文档或提取长视频智慧时不必一直盯着终端# Process large document with notifications fabric --pattern analyze_paper --notification research-paper.pdf # Extract wisdom from long video with alerts fabric -y https://youtube.com/watch?v... --pattern extract_wisdom --notification第二条命令利用-y直接输入 YouTube 链接extract_wisdom需要先完成视频转录再分析耗时较长通知能让你放心切走做别的事。后台批处理Background Processing批量处理多个文件每个完成时逐个提醒# Process multiple files and get notified when each completes for file in *.txt; do fabric --pattern summarize --notification $file done由于每个子任务独立触发通知你可以随时知道当前处理进度适合边处理边安排下一步工作。与其他工具集成与其他命令组合处理完管道数据后收到完成提醒# Combine with other commands curl -s https://api.example.com/data | \ fabric --pattern analyze_data --notification --output results.md故障排查Troubleshooting没有出现通知按以下顺序排查检查系统通知是否开启确保终端应用Terminal/iTerm2/终端模拟器的系统通知权限未被关闭。确认通知工具已安装macOSwhich osascript应存在Linuxwhich notify-sendWindowswhere.exe powershell用简单命令测试echo test | fabric --pattern raw_query --notification --dry-run使用--dry-run可以快速验证通知链路而不消耗模型调用。通知权限问题部分系统需要为终端应用单独授予通知权限macOS系统设置 → 通知与专注模式 → 应用通知 → 为你的终端应用启用通知Linux取决于桌面环境GNOME/KDE 等通常安装libnotify后自动可用Windows通常默认即可工作。自定义命令不生效确认自定义通知命令具有可执行权限先用示例参数手动执行该命令排除脚本自身问题检查脚本依赖的全部程序是否已安装。从源码层面确认若仍无法定位可开启 debug 日志。通知发送失败时会通过debuglog.Log记录internal/cli/chat.go#L141-L142配合--debug标志运行可看到具体的失败原因如 no notification system available。该错误文案同样由 i18n 管理见 internal/i18n/locales/en.json#L348。高级配置按环境拆分配置不同机器可以使用不同的配置文件通过--config指定# Work computer (quieter notifications) fabric --config ~/.config/fabric/work-config.yaml --notification # Personal computer (with sound) fabric --config ~/.config/fabric/personal-config.yaml --notification例如工作机配置使用普通紧急度的notify-send个人机配置使用带提示音的osascript版本实现安静办公、有声居家的环境差异化。与任务管理集成自定义通知命令可以作为工作流的钩子把完成事件同步到外部系统# Custom script that also logs to task management system notificationCommand: /usr/local/bin/fabric-notify-and-log.sh $1 $2脚本内部既可以调用系统通知也可以把$1、$2写入任务看板、发送到聊天工具或追加到日志文件将 Fabric 的完成事件无缝纳入既有工作流。完整参考配置仓库中的 docs/notification-config.yaml 提供了带注释的完整示例涵盖 macOS 自定义提示音、Linux 紧急级别、自定义脚本三种notificationCommand写法并附带常用模型参数可直接作为~/.config/fabric/config.yaml的起点。结合本文源码分析你可以根据实际平台与安全需求选择内置 Provider 或自定义命令构建一套稳定、安全、贴合个人习惯的 Fabric 桌面通知方案。【免费下载链接】FabricFabric is an open-source framework for augmenting humans using AI. It provides a modular system for solving specific problems using a crowdsourced set of AI prompts that can be used anywhere.项目地址: https://gitcode.com/GitHub_Trending/fa/Fabric创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考