Flue - Control Desktop Software

核心用法

Flue 是一个轻量级桥接框架，允许用户通过 shell 命令直接驱动专业桌面软件（如 Photoshop、Premiere、Blender、Unity、3ds Max、Houdini 等）。其工作流程为：agent 发送脚本 → 桥接命令 → 应用内置脚本运行时 → 返回 JSON 结果。支持 Windows、macOS 和 Linux 平台，适配器根据目标应用采用 Windows COM、macOS AppleScript 或本地应用内桥接技术。

主要功能

• 实时状态查询：flue.cli context <app> 获取应用当前状态
• 脚本执行：flue.cli run <app> --stdin 向应用推送并执行脚本
• 多应用适配：覆盖 Adobe 全家桶、Blender、Unity、Office 等 13+ 款专业软件
• 模态窗口处理：Windows 环境下可检测并尝试取消阻塞性对话框

显著优点

1. 统一接口：无论目标应用使用何种底层技术（COM/AppleScript/内建脚本），shell 交互方式保持一致
2. JSON 输出：所有操作返回结构化数据，便于程序化解析
3. 轻量无侵入：无需修改目标应用，通过外部桥接实现自动化
4. 开源透明：MIT 许可证，代码可审计

潜在局限与风险

• 版本敏感：开发测试基于特定应用和操作系统版本，存在版本不匹配导致的自动化路径失效风险
• 平台差异：Windows 与 macOS/Linux 的命令启动方式不同（py vs python3）
• 破坏性操作限制：框架明确禁止未经用户确认的保存、关闭、导出、渲染等操作
• 环境依赖：需要预先安装 Python 及 Flue 包，且 PATH 配置需正确
• 阻塞处理：应用模态对话框可能阻断自动化流程，需人工干预或专用 dismiss 命令

适合人群

• 需要批量处理设计素材的创意工作者
• 构建自动化影视/3D 制作流程的技术美术（TA）
• 希望通过脚本统一管控多软件协同的开发团队
• 熟悉 Python 且具备应用脚本 API 经验的自动化工程师

使用建议

建议采用小步迭代方式：先通过 context 探查应用状态，再编写针对性脚本；优先查阅对应应用的 APP.md 和 api-index.txt 而非依赖预训练知识；在隔离环境中使用固定版本，避免自动更新带来的兼容性风险。

核心用法

Flue 是一个 MIT 许可的开源 Python 框架，充当 AI 代理与专业桌面软件之间的"轻量级桥梁"。它不采用 MCP 协议，而是通过极简的工作流实现控制：Agent 发送脚本 → 桥接命令 → 应用内脚本运行时 → 返回 JSON 结果。

支持应用：覆盖 Adobe 全家桶（Photoshop、Illustrator、Premiere、After Effects 等）、3D 工具（Blender、Unity、Houdini、3ds Max）、办公软件（Excel、Word、PowerPoint）共 14 款专业软件。

典型工作流：
1. 验证安装：flue version 或 python3 -m flue.cli context <app>
2. 查阅适配器文档：adapters/<app>/APP.md
3. 搜索 API：rg 检索 adapters/<app>/docs/api-index.txt
4. 执行脚本：python3 -m flue.cli run <app> --stdin

显著优点

• 零侵入设计：无需修改目标应用，纯外部桥接
• 统一接口：无论底层是 Windows COM、macOS AppleScript 还是应用内桥，Shell 体验一致
• 实时内省：context 命令可 inspect 运行中的应用状态，避免"盲操"
• 纯文档型 Skill：本身无可执行代码，安全风险极低

潜在局限

• 版本敏感：明确声明"针对特定应用和 OS 版本开发"，存在兼容性碎裂风险
• T3 来源：个人开发者维护，长期支持稳定性存疑
• 阻塞风险：模态对话框可能阻断自动化，需人工介入
• 脚本边界：要求"小步快跑"，复杂长任务易失败

适合人群

• 创意工作者需要将 AI 融入 Adobe/Blender 工作流
• 开发者构建桌面自动化 pipeline
• 团队寻求跨软件批处理方案

常规风险

• 破坏性操作：文档明确禁止擅自保存、导出、渲染
• 环境隔离：必须在独立虚拟环境安装，禁止自动更新
• 权限控制：所有安装/配置需用户显式授权