简介
TerminalWidget 是一款 Mac、iPhone 和 iPad 应用，可将实时终端输出以小组件形式显示在桌面上。它可以显示由脚本、命令行工具或自动化推送的文本、进度条、图表和图片，让开发者一眼就能查看状态。
TerminalWidget 是什么？
TerminalWidget 是一款面向 Apple 平台的原生实用工具，可将纯命令行输出转换为易读的小组件。你无需打开终端窗口、翻阅日志或构建自定义 Web 仪表盘，只需将数据发送到指定的小组件目标，结果就会显示在桌面或主屏幕上。
它解决的问题是可见性。长时间运行的脚本、构建、下载和备份任务通常会在后台悄无声息地运行。终端小组件可为这些工作提供一个可见的展示界面——百分比、迷你折线图、状态消息——而无需额外基础设施。无需常驻 Web 服务器，也无需托管监控账户。
这款应用适合已经使用命令行、快捷指令或 AppleScript 的开发者、系统管理员和高级用户。它以通用 App Store 应用形式提供，一次性购买价格为 19.99 美元；启用 iCloud 后，相同的小组件目标可在 Mac、iPhone 和 iPad 之间同步。对于想要轻量级终端输出小组件而非完整监控栈的人来说，其价值在于占用小、设置流程短。
TerminalWidget 的核心功能
实时输出，一目了然
推送终端命令中的文本，即可在 macOS 上即时看到更新，并通过 iCloud 在 iOS 上快速同步。这让简单的终端输出小组件可用于构建消息、任务状态或错误提醒。
完整的 CLI 与自动化支持
使用随附的 terminal-widget 命令，支持 --target、--text、--progress、--chart 和 --fg 等参数。快捷指令、AppleScript 和 URL scheme 可在 Mac 和 iOS 上提供相同的自动化控制。
多个小组件目标
在脚本中按名称分别寻址各个小组件，并为不同任务保留独立显示。开启 iCloud 后，相同的小组件目标在 Mac、iPhone 和 iPad 上保持一致。
丰富的可视化载荷
可渲染进度条、图表、迷你折线图、矩阵风格整数显示、来自 CSV 或 JSON 的表格，以及本地或远程图片。支持边到边图片布局，以便制作更具品牌感或视觉化的小组件。
全面自定义
每次更新时都可调整颜色、字体、图标、标题和说明文字，因此每个载荷都可以带有自己的格式。当多个目标并排显示时，这能让小组件仪表盘保持可读性。
原生且轻量
TerminalWidget 以 Mac App Store 应用形式提供，使用 WidgetKit 小组件和一个小型 CLI。没有 Electron 外壳，也没有在后台运行的 Web 服务器，因此资源占用较低。
TerminalWidget 的使用场景
监控长时间运行的脚本
用实时进度条跟踪备份、编码任务或数据导出，而不必盯着终端窗口。任务推进时，只需一次 CLI 调用即可更新小组件。
构建与部署状态
直接在桌面上用图标和颜色显示“构建完成”或“测试失败”。团队和独立开发者都无需打开另一个应用，就能获得快速的视觉信号。
在 iPhone 和 iPad 上主屏幕速览
将相同目标同步到移动设备，无需回到 Mac 即可查看状态。当自动化在远程或后台运行时，这很有用。
个人指标与数据展示
将 CSV 或 JSON 输入表格或图表小组件，以显示计数、总计或每日数字。图表和迷你折线图选项可将普通数值转化为快速视觉摘要。
从小组件执行快速操作
为每个目标分配轻点或点按操作，以打开 URL、启动 Mac 应用、运行快捷指令、在 macOS 上运行 shell 命令，或从 URL 刷新。操作会随小组件载荷通过 iCloud 同步。
如何使用 TerminalWidget
- 从 App Store 安装 TerminalWidget 并打开一次；在 iPhone 和 iPad 上允许通知权限，以便后台刷新正常工作。
- 将小组件添加到桌面或主屏幕，然后打开“编辑小组件”并设置目标名称。
- 使用随附的 CLI 发送数据，例如
terminal-widget --target widget1 --text "Build complete" --icon "checkmark.seal.fill" --progress 100 --fg "#22c55e"。 - 或者，通过快捷指令、AppleScript 或 URL scheme 推送相同字段。
- 确认目标名称完全匹配，因为名称区分大小写，并按需调整小组件外观或轻点操作。
TerminalWidget 的目标用户
- 运行构建、测试和本地脚本的开发者
- 监控计划任务和备份的系统管理员
- 使用快捷指令、AppleScript 或 shell 脚本的自动化用户
- 想要无需服务器的小型桌面仪表盘的高级用户
- 希望在 Mac、iPhone 和 iPad 上使用相同小组件目标的多设备用户
TerminalWidget 免费吗？
TerminalWidget 是一款一次性购买的付费应用。参考信息中未列出免费层级或订阅。
| 方案 | 价格 | 功能 |
|---|---|---|
| App Store 通用应用购买 | 一次性 19.99 美元 | Mac、iPhone 和 iPad 应用，WidgetKit 小组件，完整 CLI，快捷指令，AppleScript，URL scheme，iCloud 目标同步 |
由于它是一次性购买而非订阅，费用不会随使用量或创建的小组件数量增加。
TerminalWidget 的优缺点
| 方面 | 优点 | 缺点 |
|---|---|---|
| 定价 | 一次性购买 19.99 美元，无订阅 | 未提及免费版或试用版 |
| 设置 | CLI 简单，目标命名清晰 | 小组件不会自动放置；目标名称区分大小写 |
| 平台 | 一个应用覆盖 Mac、iPhone 和 iPad，并支持 iCloud 同步 | iOS 刷新依赖 iCloud 和通知权限 |
| 性能 | 原生应用，小型 CLI，无 Web 服务器 | 在非“显示桌面”模式下，macOS 可能会使桌面小组件变暗 |
| 显示选项 | 文本、进度条、图表、表格和图片 | SVG 渲染并非完整 WebKit，因此文本元素可能需要转换为路径 |
关于 TerminalWidget 的常见问题
如何从脚本更新小组件？
先添加小组件，在“编辑小组件”中设置其目标名称，然后使用匹配的参数调用 CLI，例如 --target、--text 和 --progress。快捷指令、AppleScript 和 URL scheme 接受相同字段。Mac 更新会立即生效；iPhone 和 iPad 通过 iCloud 同步。
为什么我的 CLI 更新没有显示在小组件上？
TerminalWidget 不会替你放置小组件。你必须手动添加一个小组件，并将其目标名称设置为与命令中传入的值匹配。名称区分大小写，因此一个小小的拼写错误就会把数据发送到不存在的目标。
轻点小组件可以运行操作吗？
可以。可为每个小组件目标分配轻点或点按操作，包括打开 URL、启动 Mac 应用、运行快捷指令、在 macOS 上运行 shell 命令，或从 URL 刷新。在 iOS 上，支持 URL 和快捷指令操作。
小组件可以显示哪些内容？
小组件支持纯文本或格式化文本、0 到 100 的进度值、迷你折线图和其他图表样式、矩阵风格整数显示、来自 CSV、TSV 或 JSON 的表格，以及本地或远程图片。每次更新时都可设置颜色、字体、图标、标题和说明文字。
TerminalWidget 需要联网吗？
Mac 本地更新无需网络连接即可工作。跨设备同步依赖 iCloud，因此每台 Mac、iPhone 和 iPad 都应登录同一 Apple ID，并为该应用启用 iCloud。
为什么 Mac 上的桌面小组件看起来变暗了？
当“显示桌面”模式关闭时，macOS 可能会使桌面小组件变暗。在“系统设置”>“桌面与程序坞”中，将“桌面上的小组件调暗”设为“从不”，即可让它们保持完全可见。
TerminalWidget 标签
TerminalWidget，终端输出小组件，Mac 小组件应用，macOS 终端小组件，CLI 小组件，开发者仪表盘小组件，在桌面上监控脚本，进度条小组件，快捷指令自动化小组件，AppleScript 小组件，iCloud 小组件同步，iPhone 和 iPad 小组件应用
