Quicker Skill

2. 执行命令（PowerShell）

所有命令均通过“QK 扳手”执行 (ID 见 config.json 中的 wrench_action_id 字段)。 警告：以下命令是与 Quicker 交互的唯一合法协议，严禁重构。

Quicker 构建指令集合

• 本地一键构建 (Build & Verify)： 直接调用封装脚本触发构建。该命令是同步的，会直接在终端返回编译结果（成功或报错），一定查看结果后再执行后续步骤 执行 scripts/build.ps1 -JsonPath <你的文件> 即可。

  & ".\scripts\build.ps1" -JsonPath "{{JSON绝对路径}}"
  

• 云端发布/更新 (Publish)暂不可用：

  & "C:\Program Files\Quicker\QuickerStarter.exe" -c120 "runaction:{{wrench_id}}?action=publish&filePath=$([System.Net.WebUtility]::UrlEncode('{{JSON绝对路径}}'))" | Out-String
  

🏗️ 动作构建核心原则 (Minimalism)

为确保 build 命令成功并自动覆盖逻辑，必须严格遵守以下原则：

1. JSON 极简设计：templates/basic_action.json 中严禁包含 Steps 数组。它仅应定义元数据（ID、变量、图标等）。
2. 同名配对原则：构建时，JSON 的文件名必须与 C# 核心逻辑脚本文件名完全一致且位于同一目录下。例如：MyTask.json 对应 MyTask.cs。
   • Quicker 构建器检测到此模式时，会自动将 .cs 内容填充到动作主步骤中，无需在 JSON 中声明 Steps。
3. 独立 ID：新动作的 ActionId 必须与 config.json 中的“扳手 ID”区分开（以免修改到扳手本身）。

• 更新简介 (Update Docs)：

  & "C:\Program Files\Quicker\QuickerStarter.exe" -c120 "runaction:{{wrench_id}}?action=update&filePath=$([System.Net.WebUtility]::UrlEncode('{{JSON绝对路径}}'))" | Out-String
  

• 运行动作：

  & "C:\Program Files\Quicker\QuickerStarter.exe" -c120 "runaction:{{生成的动作ID}}" | Out-String
  

变量类型代码 (Type)

• 0: 文本 (String)
• 1: 数字 (Double)
• 2: 布尔 (Bool)
• 4: 列表 (List)
• 12: 整数 (Integer)
• 13: 表格 (Table)

示例文件

1. JSON 配置示例 (Demo.json)

{
  "ActionId": "",
  "SharedActionId": "00000000-0000-0000-0000-000000000000",
  "Title": "动作标题",
  "Description": "本地动作描述",
  "Keywords": "标签1,标签2;标签3",
  "ChangeLog": "v1.0.0 初始化版本",
  "ShareUrl": "",
  "Icon": "fa:Solid_Robot:#0080FF",
  "Variables": [
    {
      "Type": 0,
      "Key": "input_var",
      "DefaultValue": "默认值",
      "IsInput": true,
      "Desc": "输入变量说明"
    }
  ],
  "Menus": {
    "config": "[fa:Regular_Sun]设置"
  },
  "References": [ "Microsoft.Web.WebView2.Wpf.dll"]
}

2. C# 逻辑示例 (Demo.cs)

using System;
using System.Windows;
using Quicker.Public;

// Roslyn v2 零样板模式：直接编写代码，禁止 namespace/class
public static string Exec(IStepContext context)
{
    // 获取输入变量
    string input = context.GetVarValue("input_var") as string;
    
    // UI 交互必须在 Dispatcher 线程中执行
    Application.Current.Dispatcher.Invoke(() => {
        MessageBox.Show($"你好！这是来自 Quicker 的输入：{input}", "提示", MessageBoxButton.OK, MessageBoxImage.Information);
    });

    return "OK";
}

🚫 常见错误拨乱反正 (Anti-Hallucination)

在编写 C# 脚本时，AI 经常犯以下错误，必须规避：

1. 虚构 IStepContext 方法：IStepContext 没有 LogMsg, LogException 或 ShowMessage。记录信息请使用 MessageBox 或返回错误字符串。
2. 遗漏返回类型：Exec 的签名必须是 string 而不是 void。
3. 遗漏绝对路径：构建脚本调用时，-JsonPath 必须是绝对路径。
4. 遗漏 UI 线程保护：操作任何 WPF 对象（如 MainWindow, Toast）必须包裹在 Application.Current.Dispatcher.Invoke(() => { ... }) 中。

约束条件

• 环境限制：仅限 Windows 操作系统。
• 代码禁令：C# 文件内绝对禁止出现 namespace 或 class 定义。
• 路径要求：命令中的路径必须是绝对路径，并进行 URL 编码。
• 自动变量：text, rtn, errMessage, menuKey, silent 会由构建器自动注入。
• 内部核心模块 (高级) & 获取选中文本：包含已验证过的 Toast, WindowsToast, SelectOperationWindow 及 GetSelectedText 调用规则，详见 references/internal_modules.md。
• 调用 Quicker 子程序 (推荐)：使用官方提供的 IStepContext.RunSpAsync 执行外部功能封装，详见 references/calling_subprograms.md。
• 窗口唤起规范：详细规则参考 references/window_guidelines.md。
• 云端同步指南：详细同步流程和配置参考 references/cloud_sync_guide.md。
• 发布指南：参考 references/publishing_workflow.md。