尧图网站建设 
开发工具桌面应用【免费下载链接】script-commandsScript Commands let you tailor Raycast to your needs. Think of them as little productivity boosts throughout your day.项目地址https://gitcode.com/gh_mirrors/sc/script-commands点击查看免费下载本文以 commands/apps/agenda 目录下的三支脚本命令为完整示例讲解如何通过 Raycast Script Commands 与 Agenda 的 x-callback-url 机制实现「On the Agenda 概览」「今日笔记概览」「创建并加入 On the Agenda 的新笔记」三个高频操作。读完本文你将掌握 Agenda 脚本命令的元数据写法、URL Scheme 调用参数、百分号编码percent-encoding的正确使用方式并能直接套用或改造这三支脚本。一、三支命令能做什么Agenda 是 macOS 上一款融合了日历与笔记的 App。本仓库用三个 Bash 脚本将其高频动作封装为 Raycast 命令官方 READMEcommands/apps/agenda/README.md给出的能力清单如下命令脚本文件作用On the Agenda Overviewagenda-on-the-agenda.sh打开 Agenda 的 On the Agenda 概览Agenda Today Overviewagenda-today.sh打开 Agenda 的今日概览Create New On the Agenda Noteagenda-new-note.sh新建一条笔记并自动加入 On the Agenda所有命令的前提是系统已安装 AgendaMac App Store 安装脚本通过open命令唤起 Agenda 的 x-callback-url 来完成跳转或写入。二、三个概览类命令一行 URL 打开视图On the Agenda 概览与今日概览的实现非常简洁两者结构几乎一致核心都是一条open语句# agenda-on-the-agenda.sh完整源码见 commands/apps/agenda/agenda-on-the-agenda.sh open agenda://x-callback-url/on-the-agenda echo Opened On the Agenda Notes.# agenda-today.sh完整源码见 commands/apps/agenda/agenda-today.sh open agenda://x-callback-url/today echo Opened Todays Notes.这里值得注意的细节有两点x-callback-url 是这套命令的灵魂。同一仓库中 bearbear://x-callback-url/search?term...、goodlinksgoodlinks://x-callback-url/open?url...等命令也采用相同的scheme://x-callback-url/action调用模式可见这是 macOS 应用间互操作的通用约定。输出模式选择silent。两支脚本都以# raycast.mode silent声明运行模式。按 documentation/OUTPUTMODES.md 的说明silent模式下脚本输出的最后一行会在 Raycast 窗口关闭后以 HUD toast 浮层展示因此脚本结尾的echo Opened ...就是给用户的一次性成功反馈适合这类「打开即走」的动作型命令。三、创建笔记命令三个参数 百分号编码三支命令中最有技术含量的是 agenda-new-note.sh它在脚本头部声明了最多三个用户输入参数并把它们拼进 x-callback-url# raycast.argument1 { type: text, placeholder: Project Title, percentEncoded: true} # raycast.argument2 { type: text, placeholder: Title, percentEncoded: true } # raycast.argument3 { type: text, placeholder: Note Text, percentEncoded: true, optional: true } open agenda://x-callback-url/create-note?project-title$1title$2text$3on-the-agendatruedatetoday调用链拆解如下参数$1项目标题、$2笔记标题、$3笔记正文可选分别注入 URL 的project-title、title、text三个查询字段固定字段on-the-agendatrue让新笔记直接进入 On the Agendadatetoday将其日期设为今天脚本结尾的echo Created On the Agenda Note.同样作为silent模式下的 HUD 反馈。3.1 percentEncoded 为什么必不可少三条参数声明都带上了percentEncoded: true这一点直接决定脚本能否正确工作。文档 documentation/ARGUMENTS.md 的参数表说明字段说明是否必需适用版本type参数类型支持text、password、dropdown✅1.64.0placeholder输入框占位提示✅1.2.0optional是否可选缺省视为必填Raycast 会阻止空输入执行-1.3.0percentEncoded设为true时 Raycast 会先把参数值做百分号编码再传给脚本适合直接拼进 URL query 的场景-1.4.0用户输入的笔记标题或正文可能包含中文、空格、、?等字符若不做编码直接拼进open agenda://x-callback-url/create-note?...会破坏 URL 的查询串结构导致参数错位甚至命令失败。开启percentEncoded后 Raycast 在传参前完成转义脚本拿到的$1/$2/$3即可安全拼接。这一点从仓库实现可以得到印证凡是把用户输入直接拼进 URL 的脚本如 bear-add-note.sh、goodlinks-open-link.sh都无一例外地声明了percentEncoded: true。3.2 可选参数的传参约定第三个参数text标记为optional: true。按 ARGUMENTS.md 的说明optional缺省时参数视为必填Raycast 会在输入为空时阻止执行显式标记后用户可留空。需要注意脚本中$3仍会出现在 URL 里——当可选参数未填时它会变成空字符串text后面为空Agenda 侧会按空正文处理这属于可以接受的边界行为也正说明「参数拼接 百分号编码」的组合需要使用者自己权衡。四、元数据骨架从模板到三支命令的共性对比仓库根目录下的官方模板 templates/script-command.template.sh可以清晰看到三支 Agenda 脚本沿用了完全一致的元数据骨架# Required parameters: # raycast.schemaVersion 1 # raycast.title On the Agenda Overview # raycast.mode silent # Optional parameters: # raycast.icon images/agenda.png # raycast.packageName Agenda # Documentation: # raycast.description Opens Agenda - On the Agenda Overview # raycast.author Michael Ellis # raycast.authorURL https://github.com/mtellis2三支脚本共有的关键元数据及作用raycast.schemaVersion 1脚本格式版本声明所有命令必填raycast.mode silent运行后不弹完整输出窗口仅以 HUD toast 提示成功符合快速动作类命令的交互预期raycast.icon images/agenda.png为命令指定应用图标指向本目录下 images/agenda.pngraycast.packageName Agenda把三支命令归入同一个「Agenda」分组便于在 Raycast 中统一管理raycast.description搜索结果中展示的说明文字raycast.author/raycast.authorURL作者署名与主页便于其他用户回溯来源。从截图也可以看到三支命令在 Raycast 中归属于 Agenda 应用分组并且自动获得了agc、agt等别名缩写输入agenda即可一键唤起整套命令。五、使用方法与扩展思路安装与使用将commands/apps/agenda目录下的三支.sh脚本加入 Raycast 的 Script Commands 目录具体目录位置以 Raycast 设置为准确保 macOS 已安装 Agenda。之后在 Raycast 输入agenda即可看到三支命令输入别名如截图中的agc/agt可更快触发选中创建笔记命令后按空格即可依次输入三个参数。扩展思路这支create-note命令展示了一个可直接复用的模式——「Raycast 参数 percentEncoded x-callback-url」。若想新增能力例如创建后不加入 On the Agenda、或使用具体日期只需调整 URL 中的on-the-agenda、date查询字段即可若想增加更多输入注意 Raycast 单个脚本最多支持 3 个参数见 documentation/ARGUMENTS.md 的限制说明超出后需要把参数编码进单一字段或用配置文件传入。六、小结三支 Agenda 脚本虽然代码量极小却完整覆盖了 Raycast Script Commands 的核心工程要点元数据声明标题、模式、图标、分组、参数系统text类型、optional、percentEncoded、输出模式silent HUD 反馈以及 macOS 应用互操作的 x-callback-url 调用方式。它们既是可直接安装使用的实用命令也是理解整个 script-commands 仓库写作范式的入门级样本——类似的模式在同一仓库的 Bear、GoodLinks、BusyCal 等命令中反复出现可互为参照。赞分享开发工具桌面应用【免费下载链接】script-commandsScript Commands let you tailor Raycast to your needs. Think of them as little productivity boosts throughout your day.项目地址https://gitcode.com/gh_mirrors/sc/script-commands点击查看免费下载相关推荐Raycast Script Commands 使用指南Raycast Script Commands 使用指南 1. 项目介绍 Raycast 是一款允许用户通过几个键盘快捷键控制桌面工具的应用程序。通过安装 Sc开发工具桌面应用Raycast Script Commands 项目使用教程Raycast Script Commands 项目使用教程 1. 项目目录结构及介绍 Raycast Script Commands 项目是一个开源项目它允开发工具桌面应用猫抓 cat-catch网页视频下载与资源嗅探浏览器扩展猫抓 cat catch网页视频下载与资源嗅探浏览器扩展 你肯定遇到过想存下一段教程视频网页上却只有播放按钮右键也拿不到完整文件。更麻烦的是很多课程把音视频上一篇Sentence Transformers 安全策略与信任边界漏洞报告流程、威胁模型与加载安全实践下一篇TanStack Table React 参考索引全解析从 useTable 到 createTableHook 的响应式表格 API 体系创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 使用 Raycast Script Commands 快速操作 Agenda：On the Agenda 概览、今日视图与快速建笔记实战
开发工具桌面应用【免费下载链接】script-commandsScript Commands let you tailor Raycast to your needs. Think of them as little productivity boosts throughout your day.项目地址https://gitcode.com/gh_mirrors/sc/script-commands点击查看免费下载本文以 commands/apps/agenda 目录下的三支脚本命令为完整示例讲解如何通过 Raycast Script Commands 与 Agenda 的 x-callback-url 机制实现「On the Agenda 概览」「今日笔记概览」「创建并加入 On the Agenda 的新笔记」三个高频操作。读完本文你将掌握 Agenda 脚本命令的元数据写法、URL Scheme 调用参数、百分号编码percent-encoding的正确使用方式并能直接套用或改造这三支脚本。一、三支命令能做什么Agenda 是 macOS 上一款融合了日历与笔记的 App。本仓库用三个 Bash 脚本将其高频动作封装为 Raycast 命令官方 READMEcommands/apps/agenda/README.md给出的能力清单如下命令脚本文件作用On the Agenda Overviewagenda-on-the-agenda.sh打开 Agenda 的 On the Agenda 概览Agenda Today Overviewagenda-today.sh打开 Agenda 的今日概览Create New On the Agenda Noteagenda-new-note.sh新建一条笔记并自动加入 On the Agenda所有命令的前提是系统已安装 AgendaMac App Store 安装脚本通过open命令唤起 Agenda 的 x-callback-url 来完成跳转或写入。二、三个概览类命令一行 URL 打开视图On the Agenda 概览与今日概览的实现非常简洁两者结构几乎一致核心都是一条open语句# agenda-on-the-agenda.sh完整源码见 commands/apps/agenda/agenda-on-the-agenda.sh open agenda://x-callback-url/on-the-agenda echo Opened On the Agenda Notes.# agenda-today.sh完整源码见 commands/apps/agenda/agenda-today.sh open agenda://x-callback-url/today echo Opened Todays Notes.这里值得注意的细节有两点x-callback-url 是这套命令的灵魂。同一仓库中 bearbear://x-callback-url/search?term...、goodlinksgoodlinks://x-callback-url/open?url...等命令也采用相同的scheme://x-callback-url/action调用模式可见这是 macOS 应用间互操作的通用约定。输出模式选择silent。两支脚本都以# raycast.mode silent声明运行模式。按 documentation/OUTPUTMODES.md 的说明silent模式下脚本输出的最后一行会在 Raycast 窗口关闭后以 HUD toast 浮层展示因此脚本结尾的echo Opened ...就是给用户的一次性成功反馈适合这类「打开即走」的动作型命令。三、创建笔记命令三个参数 百分号编码三支命令中最有技术含量的是 agenda-new-note.sh它在脚本头部声明了最多三个用户输入参数并把它们拼进 x-callback-url# raycast.argument1 { type: text, placeholder: Project Title, percentEncoded: true} # raycast.argument2 { type: text, placeholder: Title, percentEncoded: true } # raycast.argument3 { type: text, placeholder: Note Text, percentEncoded: true, optional: true } open agenda://x-callback-url/create-note?project-title$1title$2text$3on-the-agendatruedatetoday调用链拆解如下参数$1项目标题、$2笔记标题、$3笔记正文可选分别注入 URL 的project-title、title、text三个查询字段固定字段on-the-agendatrue让新笔记直接进入 On the Agendadatetoday将其日期设为今天脚本结尾的echo Created On the Agenda Note.同样作为silent模式下的 HUD 反馈。3.1 percentEncoded 为什么必不可少三条参数声明都带上了percentEncoded: true这一点直接决定脚本能否正确工作。文档 documentation/ARGUMENTS.md 的参数表说明字段说明是否必需适用版本type参数类型支持text、password、dropdown✅1.64.0placeholder输入框占位提示✅1.2.0optional是否可选缺省视为必填Raycast 会阻止空输入执行-1.3.0percentEncoded设为true时 Raycast 会先把参数值做百分号编码再传给脚本适合直接拼进 URL query 的场景-1.4.0用户输入的笔记标题或正文可能包含中文、空格、、?等字符若不做编码直接拼进open agenda://x-callback-url/create-note?...会破坏 URL 的查询串结构导致参数错位甚至命令失败。开启percentEncoded后 Raycast 在传参前完成转义脚本拿到的$1/$2/$3即可安全拼接。这一点从仓库实现可以得到印证凡是把用户输入直接拼进 URL 的脚本如 bear-add-note.sh、goodlinks-open-link.sh都无一例外地声明了percentEncoded: true。3.2 可选参数的传参约定第三个参数text标记为optional: true。按 ARGUMENTS.md 的说明optional缺省时参数视为必填Raycast 会在输入为空时阻止执行显式标记后用户可留空。需要注意脚本中$3仍会出现在 URL 里——当可选参数未填时它会变成空字符串text后面为空Agenda 侧会按空正文处理这属于可以接受的边界行为也正说明「参数拼接 百分号编码」的组合需要使用者自己权衡。四、元数据骨架从模板到三支命令的共性对比仓库根目录下的官方模板 templates/script-command.template.sh可以清晰看到三支 Agenda 脚本沿用了完全一致的元数据骨架# Required parameters: # raycast.schemaVersion 1 # raycast.title On the Agenda Overview # raycast.mode silent # Optional parameters: # raycast.icon images/agenda.png # raycast.packageName Agenda # Documentation: # raycast.description Opens Agenda - On the Agenda Overview # raycast.author Michael Ellis # raycast.authorURL https://github.com/mtellis2三支脚本共有的关键元数据及作用raycast.schemaVersion 1脚本格式版本声明所有命令必填raycast.mode silent运行后不弹完整输出窗口仅以 HUD toast 提示成功符合快速动作类命令的交互预期raycast.icon images/agenda.png为命令指定应用图标指向本目录下 images/agenda.pngraycast.packageName Agenda把三支命令归入同一个「Agenda」分组便于在 Raycast 中统一管理raycast.description搜索结果中展示的说明文字raycast.author/raycast.authorURL作者署名与主页便于其他用户回溯来源。从截图也可以看到三支命令在 Raycast 中归属于 Agenda 应用分组并且自动获得了agc、agt等别名缩写输入agenda即可一键唤起整套命令。五、使用方法与扩展思路安装与使用将commands/apps/agenda目录下的三支.sh脚本加入 Raycast 的 Script Commands 目录具体目录位置以 Raycast 设置为准确保 macOS 已安装 Agenda。之后在 Raycast 输入agenda即可看到三支命令输入别名如截图中的agc/agt可更快触发选中创建笔记命令后按空格即可依次输入三个参数。扩展思路这支create-note命令展示了一个可直接复用的模式——「Raycast 参数 percentEncoded x-callback-url」。若想新增能力例如创建后不加入 On the Agenda、或使用具体日期只需调整 URL 中的on-the-agenda、date查询字段即可若想增加更多输入注意 Raycast 单个脚本最多支持 3 个参数见 documentation/ARGUMENTS.md 的限制说明超出后需要把参数编码进单一字段或用配置文件传入。六、小结三支 Agenda 脚本虽然代码量极小却完整覆盖了 Raycast Script Commands 的核心工程要点元数据声明标题、模式、图标、分组、参数系统text类型、optional、percentEncoded、输出模式silent HUD 反馈以及 macOS 应用互操作的 x-callback-url 调用方式。它们既是可直接安装使用的实用命令也是理解整个 script-commands 仓库写作范式的入门级样本——类似的模式在同一仓库的 Bear、GoodLinks、BusyCal 等命令中反复出现可互为参照。赞分享开发工具桌面应用【免费下载链接】script-commandsScript Commands let you tailor Raycast to your needs. Think of them as little productivity boosts throughout your day.项目地址https://gitcode.com/gh_mirrors/sc/script-commands点击查看免费下载相关推荐Raycast Script Commands 使用指南Raycast Script Commands 使用指南 1. 项目介绍 Raycast 是一款允许用户通过几个键盘快捷键控制桌面工具的应用程序。通过安装 Sc开发工具桌面应用Raycast Script Commands 项目使用教程Raycast Script Commands 项目使用教程 1. 项目目录结构及介绍 Raycast Script Commands 项目是一个开源项目它允开发工具桌面应用猫抓 cat-catch网页视频下载与资源嗅探浏览器扩展猫抓 cat catch网页视频下载与资源嗅探浏览器扩展 你肯定遇到过想存下一段教程视频网页上却只有播放按钮右键也拿不到完整文件。更麻烦的是很多课程把音视频上一篇Sentence Transformers 安全策略与信任边界漏洞报告流程、威胁模型与加载安全实践下一篇TanStack Table React 参考索引全解析从 useTable 到 createTableHook 的响应式表格 API 体系创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考