quicker-connector

name	quicker-connector
description	与 Quicker 自动化工具集成，读取、搜索和执行 Quicker 动作列表。支持 CSV 和数据库双数据源，智能匹配用户需求并调用本地 QuickerStarter 执行。
author	CodeBuddy (optimized by Advanced Skill Creator)
version	1.2.0
license	MIT
tags	["automation","productivity","quicker","windows","workflow"]
trigger	["quickre","quick","快键","快速","调用.*动作","执行.*quicker","用.*quicker","quicker.*帮我"]
examples	[{"user":"用quicker截图","description":"匹配并执行截图相关动作"},{"user":"帮我翻译这段文字","description":"智能匹配翻译动作"},{"user":"quicker搜索包含'搜索'的动作","description":"搜索特定关键词的动作"},{"user":"列出所有可用的quicker动作","description":"获取完整动作列表和统计"}]
requirements	{"python":">=3.8","system":[{"platform":"windows","reason":"依赖 QuickerStarter.exe，仅 Windows 可用"}]}
settings	{"initialized":{"type":"boolean","description":"是否已完成初始化配置","default":false},"csv_path":{"type":"string","description":"Quicker 动作 CSV 文件路径","default":""},"db_path":{"type":"string","description":"Quicker 数据库路径","default":"C:\\Users\\Administrator\\AppData\\Local\\Quicker\\data\\quicker.db"},"starter_path":{"type":"string","description":"QuickerStarter.exe 路径","default":"C:\\Program Files\\Quicker\\QuickerStarter.exe"},"default_source":{"type":"string","description":"默认数据源类型","default":"csv","options":["csv","db"]},"encodings":{"type":"array","description":"CSV 编码检测顺序","default":["utf-8-sig","utf-8","gbk","gb2312","gb18030","latin-1"]},"auto_select_threshold":{"type":"number","description":"自动选择动作的匹配分数阈值","default":0.8,"minimum":0.5,"maximum":1,"step":0.05},"max_results":{"type":"number","description":"最大返回结果数量","default":10,"minimum":1,"maximum":50}}
system_prompt	你现在是一个 Quicker 自动化专家，具备以下能力： - 理解用户的自然语言需求并转化为 Quicker 动作搜索 - 根据动作名称、描述、类型、分类等多维度智能匹配 - 精确控制动作执行（同步/异步、参数传递） 重要原则： 1. 当用户提到"用 quicker 做 X"时，你应理解这是调用 quick 动作完成任务 2. 优先选择匹配分数 > auto_select_threshold 的动作自动执行 3. 如果匹配分数低或存在歧义，询问用户确认 4. 执行前检查 QuickerStarter 是否可用 5. 向用户清晰说明即将执行的动作及其作用
thinking_model	多阶段认知管线： 1. 需求解析：提取核心动词和对象（如"截图"、"翻译"） 2. 上下文识别：是否涉及特定应用（浏览器、Excel、代码编辑器） 3. 候选筛选：基于类型、面板、关键词三层过滤 4. 置信度评估：检查最高分是否超过阈值 5. 决策下达：执行或请求确认
security_notes	- 所有文件操作限制在配置路径和用户数据目录 - subprocess 调用仅限 QuickerStarter.exe，参数经过验证 - 无网络访问，不收集用户数据 - 配置文件仅存储路径，不包含敏感信息 - CSV/DB 读取使用安全编码检测

Quicker Connector 技能

📋 概述

Quicker Connector 是一个专业的 Quicker 集成工具，让你能够通过 AI 助手直接检索、匹配和执行 Quicker 软件中的自动化动作。支持两种数据源模式，智能语义匹配，准确理解用户意图。

✨ 核心特性

特性	说明
📊 双数据源	同时支持 CSV 导出文件和 SQLite 数据库
🔍 多字段搜索	按名称、描述、类型、面板等字段搜索
🧠 智能匹配	基于关键词提取和语义分析的自动匹配
🎯 精确执行	支持同步/异步、参数传递、等待结果
🔧 编码自适应	自动检测 UTF-8/GBK 等多种编码
📈 统计信息	完整动作分类和面板分布统计
📤 JSON 导出	一键导出完整动作列表

🚀 快速开始

1️⃣ 首次初始化

运行引导脚本配置 CSV 路径：

python scripts/init_quicker.py

按提示操作：

• 在 Quicker 中导出动作列表（工具 → 导出动作列表(CSV)）
• 将 CSV 文件保存到任意位置
• 输入完整路径完成配置

配置将保存在 config.json。

2️⃣ 验证安装

python scripts/test_quicker_connector.py

预期看到：

• ✅ 编码检测通过
• ✅ CSV 读取成功，动作数量 > 0
• ✅ 搜索和匹配功能正常
• ✅ QuickerStarter 路径检测

3️⃣ 基本使用

from quicker_connector import QuickerConnector

# 创建连接器
connector = QuickerConnector(source="csv")

# 读取所有动作
actions = connector.read_actions()
print(f"共 {len(actions)} 个动作")

# 搜索动作
results = connector.search_actions("截图")
for action in results:
    print(f"- {action.name}")

# 智能匹配
matches = connector.match_actions("帮我翻译这段文字", top_n=)
 m  matches:
    ()


result = connector.execute_action(
    action_id=,
    wait_for_result=,
    timeout=
)
()