@dabit3: 发布了一个新的 iOS 快捷指令 - 使用 iOS 上的操作按钮，或从主屏幕一键启动 Devin Cloud Agents…

发布了新的 iOS 快捷指令 —— 通过 iOS 上的操作按钮或者主屏幕一键点击即可启动 Devin Cloud Agents。你还可以用自然语言为任何已连接的仓库创建复杂的自动化操作。试试看！https://github.com/dabit3/devin-ios-shortcut/tree/main… — # dabit3/devin-ios-shortcut 来源：https://github.com/dabit3/devin-ios-shortcut # 新建 Devin Cloud Agent 会话（iOS/macOS 快捷指令） 一个适用于 Apple 内置“快捷指令” App（https://support.apple.com/guide/shortcuts/welcome/ios）（iPhone、iPad 和 Mac 预装，无需额外安装）的快捷指令，用于创建 Devin（https://devin.ai）会话：运行它（或向其分享文本），输入 Devin 要处理的任务，Devin 便会开始工作。随后会弹出一个菜单，让你在浏览器中打开会话、复制链接，或者直接继续。 ## 安装 下载 New Devin Session.shortcut（https://github.com/dabit3/devin-ios-shortcut/raw/main/dist/New%20Devin%20Session.shortcut） 1. 打开下载的文件（在 iOS 上从 Safari 的下载列表或“文件” App 中打开；在 macOS 上双击）。快捷指令 App 会显示该快捷指令的操作预览。点击屏幕底部的 添加快捷指令 将其添加到你的资料库。该文件已通过 Apple 签名和公证，可在任何设备（iOS 15+ / macOS 12+）上导入。 2. 在 app.devin.ai/settings/api-keys（https://app.devin.ai/settings/api-keys）创建一个 个人 API 密钥（样式为 apk_user_...）。 3. 编辑该快捷指令，将密钥粘贴到 文本 操作中，替换掉 PASTE_YOUR_DEVIN_API_KEY_HERE。 使用哪种密钥类型？ Devin 有两代 API，只有一种密钥可在此使用。本快捷指令使用 v1 API（https://docs.devin.ai/api-reference/v1/sessions/create-a-new-devin-session），该 API 通过上述个人 API 密钥（apk_user_...）进行身份验证。密钥标识你及你的组织，因此无需组织 ID，并且会话会显示在你自己的会话列表中。用于较新 v3 API（https://docs.devin.ai/api-reference/overview）的密钥（服务用户密钥，以 cog_ 开头，在“设置 > 服务用户”下创建）不适用于此快捷指令，且 v3 还需要在 URL 中包含组织 ID。Devin 文档将 v1 密钥标记为旧版：它们在弃用期间继续有效，如果 v1 被淘汰，本快捷指令可以迁移到 v3。 然后，你可以从快捷指令 App、Siri（“新建 Devin 会话”）、共享菜单、小组件或操作按钮运行它。快捷指令通过 iCloud 同步，所以在任一设备上安装后即可在所有设备上使用。你的 API 密钥仅保存在你的设备上，且仅发送至 api.devin.ai。 ## 示例提示词 从快捷指令启动的会话是“发起即忘”的，因此最有效的提示词是那种自包含、指明了仓库并最终创建一个 PR 的提示。将下面的 your-org/your-repo 替换为你自己的组织/仓库： - “修复 your-org/your-repo 中的 issue #123，添加回归测试，并创建一个 PR。” - “为 your-org/your-repo 中的支付模块添加单元测试，并创建一个 PR。” - “查找 your-org/your-repo 中过时的依赖，升级安全的那些，运行测试，并创建一个 PR。” - “调查 your-org/your-repo 中 PR #42 的 CI 失败原因，并推送修复。” - “端到端追踪 your-org/your-repo 中的结账流程，写出工作方式，附带文件引用。” - “将本周合并到 your-org/your-repo 中的 PR 总结为分类更新日志。” - “使用多阶段 Dockerfile 和 docker-compose 容器化 your-org/your-repo，并验证整个栈能运行。” - “构建一个追踪团队 PTO 的简单 Web 应用，编写测试，并端到端验证。” 提示：在手机上，共享菜单是最快的路径。将 Bug 报告、问题链接或规范分享给该快捷指令，文本就会出现在提示词中，随时可以发送。浏览 Devin 用例库（https://docs.devin.ai/use-cases/gallery）获取更多想法，包括定时和 Webhook 驱动的会话。 ## 工作原理 本快捷指令调用 Devin API（https://docs.devin.ai/api-reference/v1/sessions/create-a-new-devin-session）： POST https://api.devin.ai/v1/sessions Authorization: Bearer {"prompt": ""} 然后展示响应中的 url。具体操作顺序： 1. 注释：设置说明 2. 文本：你的 Devin API 密钥占位符 3. 要求输入：“Devin 应该处理什么？”（从共享菜单运行时预填充） 4. 获取 URL 内容：上述 POST 请求 5. 获取字典值：提取 url 6. 如果 / 否则：成功时显示菜单（在浏览器中打开 / 复制链接 / 完成），这样当未登录时你不会被强制打开浏览器；失败时显示原始 API 响应 ## 构建 该快捷指令通过代码生成：build_shortcut.py 编写快捷指令 App 可读取的 WFWorkflow plist 文件，使用 plutil 进行验证，并通过 Apple 的 shortcuts CLI 进行签名。需要安装 Xcode 命令行工具（python3）和快捷指令 App（macOS 12+）的 macOS。使用 --mode anyone 签名会通过 Apple 进行公证，需要网络连接以及登录了 iCloud 的 Mac。 bash python3 build_shortcut.py # 构建 + 签名 -> dist/New Devin Session.shortcut python3 build_shortcut.py --no-sign # 仅生成未签名的 plist -> build/ 修改快捷指令后，重新构建并提交更新后的 dist/ 产物，以便上述 Install 链接始终提供最新已签名版本。 ## 发布 dist/ 中的已签名文件可供任何人导入。选项： - 本 README 的 Install 链接：一个绝对的 /raw/ URL，重定向到原始文件下载。如果你复刻此仓库，请更新 URL 指向你的复刻。（建议链接到仓库内的文件而非发布资产：GitHub 会将发布资产名称中的空格替换为点，从而改变导入快捷指令的名称。） - iCloud 链接：将快捷指令导入你自己的快捷指令 App，然后点击共享 → 复制 iCloud 链接。对于用户来说少一次点击（无需下载文件），但每次更新快捷指令时你都需重新共享一个新链接。 - RoutineHub（https://routinehub.co）：一个社区快捷指令库。创建一个条目指向你的 iCloud 链接，并在每次发布时更新。 切勿发布包含真实 API 密钥的构建版本：保持 build_shortcut.py 中的占位符不变，每位用户导入后自行粘贴自己的密钥。