Craft Agents 深度链接完整指南用 craftagents:// 协议让外部应用一键直达指定会话【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-ossCraft Agents 是一款开源的 Agent 原生桌面应用让你高效管理与多路 AI 会话并行协作。而Craft Agents 深度链接Deep Link功能正是它的隐藏利器通过craftagents://自定义协议任何外部应用、网页链接或命令行脚本都能一键唤起 Craft Agents 并直达指定会话——无论是打开某条聊天记录、新建一个带提示词的聊天还是跳转到设置页与数据源页面全部一条链接搞定。为什么需要深度链接日常使用中我们常遇到这样的场景在 Slack、脚本或 CI 流水线里看到去 Craft Agents 查看这个任务结果还要手动切窗口、翻找会话列表。深度链接把这一切压缩成一次点击外部应用直达会话链接携带会话 ID打开即定位自动化创建任务不仅跳转还能直接创建新聊天并自动发送提示词多工作区精准路由可以明确指定目标工作区不怕开错窗口。核心实现位于主进程的协议解析模块 deep-link.ts它在应用启动时通过 index.ts 中的setAsDefaultProtocolClient注册为craftagents://的默认协议客户端系统层点击链接时即被唤醒处理。深度链接 URL 格式速查协议设计采用主机段即路由前缀的风格格式直观、易记。以下是全部支持的路由导航类链接跳转到指定页面或会话链接格式作用craftagents://allSessions打开全部会话列表craftagents://allSessions/session/abc123直达指定会话最常用craftagents://flagged/session/abc123在已标记筛选下定位会话craftagents://state/done/session/abc123按状态筛选后定位会话craftagents://sources/source/github打开某个数据源Source详情页craftagents://settings打开设置页craftagents://settings/shortcuts直达设置子页如快捷键动作类链接不只是跳转还能执行操作action路由让深度链接具备执行力这是自动化场景的核心链接格式作用craftagents://action/new-chat新建一个聊天craftagents://action/new-chat?inputhelloname任务Asendtrue新建聊天并自动发送提示词craftagents://action/resume-sdk-session/{sdkId}通过 SDK 会话 ID 恢复 Claude Code 会话craftagents://action/flag-session/{id}/unflag-session/{id}标记 / 取消标记会话craftagents://action/delete-session/{id}删除会话指定工作区与窗口行为若链接未指定工作区默认作用于当前聚焦窗口也可显式指定craftagents://workspace/ws123/allSessions/session/abc123 craftagents://workspace/ws123/action/new-chat?inputhisendtrue两个实用查询参数?windowfocused在新窗口中打开并聚焦应用内部新窗口打开菜单即基于它见 SidebarMenu.tsx?sidebarfiles/path/to/file打开右侧边栏并定位到指定文件或历史记录。如何触发深度链接无需编写代码三种最常见方式命令行macOS / Linuxopen craftagents://allSessions/session/abc123或xdg-open craftagents://...Windows 下双击一个包含该链接的.url文件即可。网页超链接把链接写成a或 Markdown 链接点击后系统会询问是否用 Craft Agents 打开。自动化脚本 / 消息推送在 CI、Slack 机器人、个人脚本里生成带会话 ID 的链接实现消息里的按钮 → 直接跳到会话。一个值得注意的细节如果链接到达时应用尚未完全启动冷启动主进程会把链接暂存为pendingDeepLink并在就绪后自动补发不会丢失。开发者须知多实例调试开发模式下同时运行多个 Craft Agents 实例时可通过环境变量CRAFT_DEEPLINK_SCHEME将协议替换为craftagents1、craftagents2等避免互相抢占见 index.ts。协议解析的单元测试位于 deep-link-routing.test.ts可参考其中按客户端 → 按工作区的路由回退逻辑。小结导航直达craftagents://allSessions/session/{sessionId}是最常用的一条动作自动化action/new-chat?input...sendtrue让外部工具直接替你开工精准路由workspace/{id}前缀 window/sidebar参数覆盖多窗口场景完整路由清单可在 deep-link.ts 头部注释中查阅应用架构文档见 apps/electron/README.md。掌握craftagents://深度链接协议后Craft Agents 就不再是一个封闭的桌面应用而是可以嵌入你工作流任意环节的智能入口。【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考