📖 企业微信/QQ自动化脚本（.fc文件）使用教程

---

一、介绍

.fc 是便于企业微信/QQ自动化发送消息的自动化脚本 主要功能是通过模拟点击来进行消息发送 目的是更便捷的处理操作 发送消息等等

同时 此脚本也支持中文编写

二、文件结构解析

.fc 是基于 JSON 的配置文件格式，包含两大核心模块：

{
    "settings": {},   // 全局配置和变量声明
    "scenarios": []   // 自动化场景流程定义
}

三、settings 全局配置

"settings": {
    "global_interval": 0.1,
    "app_window": "企业微信",
    "button_positions": {
        "search": [215, 100],
        "confirm": [355, 342]
    },
    "group_id": "987654",
    "hotkey_save": ["ctrl", "s"]
}

变量特性：

• 使用 $变量名 调用（支持数组索引 $var[0]）
• 支持嵌套数据结构（如字典/数组）
• 优先读取当前场景变量，找不到时使用全局变量

四、scenarios 场景配置

每个场景包含 窗口定位 和 操作步骤 两部分：

{
    "window": {
        "title": "$app_window",
        "wait": 0.3
    },
    "steps": [/* 操作步骤 */]
}

五、操作步骤语法

支持 5 种基础操作类型 您可直接输入中文也可输入括号里的英文：

1. 点击（click）

{
    "action": "click",
    "x": "$button_positions.search[0]",
    "y": "$button_positions.search[1]",
    "relative": true,
    "clicks": 2,
    "interval": 0.2,
    "button": "left"
}

2. 输入（typewrite）

{
    "action": "typewrite",
    "text": "$group_id",
    "interval": 0.05
}

3. 热键（hotkey）

{
    "action": "hotkey",
    "keys": "$hotkey_save"
}

4. 拖拽（drag）

{
    "action": "drag",
    "start_x": 100,
    "start_y": 200,
    "end_x": 300,
    "end_y": 400,
    "duration": 1.0
}

5. 关闭（close）

{
    "action": "close"
}

六、变量系统详解

• 定义方式： 所有非 global_interval 的 settings 键值都会存储为变量
• 引用规则： 字符串变量："$app_window"，数组元素："$button_positions.search[0]"
• 错误处理： 未定义变量 → 抛出 ValueError；数组越界 → 抛出 IndexError

七、执行示例说明

示例配置文件：

{
    "settings": {
      "global_interval": 0.1,
      "window_titles": ["user"], // 这里设置需要发送对象的名称 例如:微信名 聊名等
      "line_edit": [ 265, 555 ],  // 聊天框的位置
      "send_button": [ 164, 412 ],
      "send_information": "test"
    },
    "scenarios": [
        {
            "window": {
                "title": "$window_titles[0]",
                "wait": 0.2
            },
            "steps": [
                {
                    "action": "click",
                    "x": "$line_edit[0]",
                    "y": "$line_edit[1]",
                    "relative": true,
                    "duration": 0.1
                },
                {
                  "action": "typewrite",
                  "text": "$send_information",
                  "interval": 0.1
                },
                {
                  "action": "hotkey",
                  "keys": ["enter"],
                  "interval": 0.1
                }
            ]

        }
    ]
}

1. 主窗口操作：点击输入栏
2. 新建会话窗口：输入固定文本
3. 确认操作：回车

八、最佳实践建议

• 使用截图工具或 pyautogui.mouseInfo() 获取精确坐标
• 调试技巧：pyautogui.PAUSE = 1 设置全局操作间隔便于观察
• 错误处理机制：步骤失败自动跳过，窗口未找到跳过整个场景

九、扩展性设计

• 在 WindowController 类中添加新的操作类型
• 支持更多变量类型（如环境变量、动态变量）
• 增加条件判断和循环逻辑

十、执行方式

此脚本可以在软件:Fuchen中按F12打开控制台后执行 来进行导入

load {次数}

⚙️ 建议在虚拟机或测试环境中先行验证脚本，确保操作流程符合预期后再投入生产环境使用。