quicker-rpc

Routes Quicker headless action editing (P0–P7): pick workflow topic, then schema/step-runner refs. Use when creating or editing Quicker actions, subprograms, steps, or data.json on disk.

After quicker-rpc source changes, run pwsh ./build.ps1 -t (hot-reload plugin + qkrpc CLI/serve) without restarting agent-gui. Use when editing Plugin, Console, Contracts, AgentModel, build scripts, or RPC/CLI; when the user asks to build, test build, build -t, hot update, /hot-update, reload plugin, or restart qkrpc serve. For official getquicker release use quicker-rpc-publish + quicker-qkbuild-version-publish (third field +1).

Guides action designer (action-editor) UI work in agent-gui. UI originates from ../Quicker/Quicker.Designer; step double-click popup and per-field editing behavior must match ../Quicker/QuickerPc/Quicker ActionDesignerWindow and StepEditor components. Use when editing agent-gui/lib/action-editor, StepEditorPopup, param editors, step field visibility, or aligning web step editing with desktop Quicker.

Guides agents to find Quicker.exe internal types and methods for quicker-rpc plugin work. Use when implementing or debugging reflection against Quicker.exe, locating internal Quicker APIs, handling obfuscated Release builds, qkref references, or service access from QuickerRpc.Plugin.

Analyze QuickerAgent chat exports (quicker-agent-chat-export JSON) to score authoring flow, detect tool/schema issues, and recommend prompt/tool/skill optimizations. Use when the user provides an exported thread JSON or asks to improve agent-gui behavior from real sessions.

getquicker User/Actions 分页 HTML 抓取：汇总获赞 totalLikes 与动作数 actionCount。写分页 HTTP 抓取、HTML 解析聚合类动作时加载。

After editing agent-gui (Next.js), automatically run dev_frontend_check (or GET /api/dev/frontend-check) and fix until ok=true — no user reminder needed. Use when changing components/, app/, lib/ used by UI, globals.css, electron shell UI, /tool-test, or when the user asks about Next.js errors, HMR, Electron titlebar, or frontend smoke.

When adding or editing agent-gui UI (components, CSS, action-editor param editors, dialogs, code blocks), default to theme-adaptive styling — use design tokens, not hardcoded light/dark colors. Use when creating new React UI, CSS classes, popups, or fixing contrast issues in dark/light mode.

Use when calling Quicker through the local qkrpc CLI or MCP tools. Covers connectivity, qkrpc_wait, MCP-first over shell, and third-party disk editing via host file tools (not MCP file ops).

Quicker 外置表达式：files/*.eval.cs + expression.file + extract/apply。长 evalexpression 时加载。

Quicker $=, $$, sys:assign, and sys:evalexpression: inline expressions, single-var assign step, batch {var}= / LINQ. Use when writing action params or assign/evalexpression steps (P4), before sys:csscript.

Quicker 表达式优先：单行 evalexpression 替代多步 stringProcess/assign 链。写去重、排序、拼接、简单变换类动作时加载。

End-to-end webpage scripting via the Quicker browser extension: prototype RunScript live (user_browser / chromecontrol), save as a sys:chromecontrol action, then auto-run it with event triggers (quicker_trigger, e.g. BrowserUrlChanged). Use when the user wants scripts to run on pages automatically.

Control the user's real browser (Quicker Connector) via user_browser / qkrpc_chrome_control RPC, or author sys:chromecontrol steps in actions.

Quicker 多步动作自描述：sys:comment 分段注释，便于 structure 阅读与 Agent 自检。

Quicker 条件 HTTP：url 空值守卫 + sys:if + http url.var。可选 URL 请求时加载。

Quicker 剪贴板 CSV：解析表头、行数与列求和，写回聚合结果。

Quicker 文件复制加时间戳：evalexpression 目标路径 + fileOperation copyTo。

Quicker 表单参数输入：sys:form variables + formDef/formDef.file → 变量 → 格式化输出。弹窗收集多字段时加载。

Quicker 正则提取：regexExtract + match1 尾随空格 wire，或 expression-first Regex.Match 兜底。

Quicker 委托运行动作：runAction StartAction + wait + output。编排层调用另一动作时加载。

Quicker 窗口标题分支：getWindowTitle + if + windowOperations 最大化或提示。

Search getquicker action library and read shared actions for learning via qkrpc API (library search + shared get, read-only). Use when finding exemplar actions before writing Quicker actions.

Quicker 剪贴板流水线：getClipboardText → 变换 → writeClipboard。写剪贴板读写、复制结果到剪贴板、剪贴板文本处理类动作时加载。

Quicker 延迟重试：repeat + simpleIf + break + delay 轮询。等待文件/HTTP/进程就绪时加载。

sys:evalexpression 单步多变量 {var}= 赋值；number 变量字面量陷阱。SDK L2 multi-var-assign 复盘。

Quicker 多文件批处理：getSelectedFiles 或列表 + each + readFile + WriteTextFile。写合并/批量读写文件类动作时加载。

Quicker HTTP+JSON：sys:http 请求 → sys:jsonExtract 取字段。写 REST 调用、API 集成、JSON 字段读取动作时加载。

Quicker 列表循环 each + simpleIf + break/continue。写遍历列表、条件跳出循环、提前结束迭代类动作时加载。

Quicker 路径存在检查：checkPathExists + simpleIf 双分支。读写文件或启动程序前的路径守卫。

Quicker 选中文本流水线：getSelectedText/剪贴板读取 → 变换 → outputText 写回。写选区处理、文本变换写回、选中翻译类动作时加载。

Quicker 公共子程序抽取与 sys:subprogram 调用。写跨动作复用逻辑、global subprogram、callIdentifier 映射时加载。

Quicker 前台 UI：activateProcessMainWindow + delay + keyInput/sendKeys。向指定窗口发快捷键时加载。

Detailed QuickerRpc ecosystem knowledge: terminology (QuickerAgent Quicker action vs AI agent), architecture, named pipe, qkrpc serve, bootstrap, connectivity failure diagnosis. Use when qkrpc connection fails, PLUGIN_NOT_RUNNING, qkrpc_health/qkrpc_wait errors, serve 9477 unreachable, user asks how QuickerRpc or QuickerAgent works, or before telling the user to fix Quicker/plugin environment.

Detailed QuickerRpc ecosystem knowledge: terminology (QuickerAgent Quicker action vs AI agent), architecture, named pipe, qkrpc serve, bootstrap, connectivity failure diagnosis. Use when qkrpc connection fails, PLUGIN_NOT_RUNNING, qkrpc_health/qkrpc_wait errors, serve 9477 unreachable, user asks how QuickerRpc or QuickerAgent works, or before telling the user to fix Quicker/plugin environment.

Full quicker-rpc release: GitHub Release CLI, build.ps1 -Publish -NoVersion Quicker plugin upload, qkrpc action update for shared action f5c76108-3ce9-433f-8cd0-8f0d9c562052. Official getquicker upload MUST bump third semver field (see quicker-qkbuild-version-publish). Use when the user asks to publish, release, ship, GitHub release, or /publish.

Use when running or debugging Quicker actions via qkrpc MCP (not editing program body).

Deprecated — use quicker-authoring (workspace-editing) with host file tools + workspace_program patch. Kept only for old skill installs.

Publish quicker-voice-runtime (voice-asr-runtime): bump pyproject version, CI, Git tag vX.Y.Z → GitHub Release + optional Bitiful, then sync voice-plugin-channel.json in quicker-rpc monorepo. Model-only releases use tag model-sensevoice. Use when publishing voice runtime, voice-asr release, voice-plugin channel sync, or /publish-voice-runtime.

QuickerAgent LLM API Key 配置：llm-publish.config 发布（GitHub + Bitiful OSS）、 llm-dev.config 本地调试、llm-config.json 用户默认、pepper 一次性初始化。 Use when user says 发布 publish config、publish config、同步/上传 publish config、 llm-publish config、publish LLM keys、LLM apikey 配置、或改 llm-*-config.json。