# 自动化插件

**Repository Path**: coolfors/automation-plugin

## Basic Information

- **Project Name**: 自动化插件
- **Description**: 这是一个自动化的demo
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-19
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# DeepSeek 自动化桌面客户端

DeepSeek 自动化桌面客户端是一个基于 Electron 和 Puppeteer 构建的桌面应用程序，旨在实现与 DeepSeek AI 对话的自动化交互。该项目提供了直观的用户界面，支持富文本输入、图片上传、自动对话、结果打印等功能。

## 功能特性

本客户端集成了多项实用功能，为用户提供流畅的 AI 对话体验。富文本编辑功能允许用户在输入框中格式化文本、插入图片，并支持从剪贴板粘贴内容。自动化交互模块能够自动完成对话流程，包括页面加载监控、内容发送、实时响应接收以及增量内容更新处理。打印输出模块支持分段打印、最终结果输出、错误重试以及会话历史记录导出，可导出为 TXT 和 JSON 格式。日志记录系统提供完整的调试信息追踪，支持不同日志级别设置和日志导出功能。此外，程序还提供打印日志容器和高级设置选项，满足各种使用场景需求。

## 技术架构

项目采用现代化的技术栈构建，前端界面基于 HTML5 和 CSS3 开发，主进程使用 Electron 的 Main 进程和 Renderer 进程架构实现。浏览器自动化核心由 Puppeteer 驱动，实现对 Chrome 浏览器的精确控制。后端 API 服务采用 Express 框架，提供稳定的服务器支持。模块化的代码结构将核心功能分离到独立模块中，包括自动化模块（auto.js）、打印模块（printer.js）和日志模块（logger.js），确保代码的可维护性和扩展性。

## 项目结构

项目的文件组织结构清晰合理，便于开发和维护。应用入口文件包括 main.js（Electron 主进程）、renderer.js（渲染进程）、preload.js（预加载脚本）和 index.html（主界面）。核心功能模块位于 utils 目录下，分别处理自动化操作（auto.js）、打印输出（printer.js）和日志记录（logger.js）。服务端入口 server.js 提供 API 服务器功能。配置和文档相关文件包括 package.json（项目配置）、.gitignore（Git 忽略规则）以及 .trae/documents/ 目录下的开发计划文档。

## 快速开始

环境准备方面，请确保系统中已安装 Node.js（建议版本 16.x 或更高）和 npm 包管理器。程序依赖 Puppeteer 进行浏览器自动化，该组件在安装时会自动下载 Chrome 浏览器。

安装步骤如下：首先克隆项目仓库，然后进入项目目录执行 npm install 安装所有依赖。安装完成后，在项目根目录下运行 npm start 启动应用程序。如果需要同时启动 API 服务器，可运行 npm run server 命令进行开发调试。

## 使用指南

启动应用程序后，主界面将显示浏览器区域和结果展示区域。在下方的富文本输入框中输入问题或对话内容，支持文字格式化、图片插入等功能。点击发送按钮后，系统将自动完成与 DeepSeek 的交互，并将回复内容实时显示在结果区域。打印设置区域可配置输出格式和打印选项，打印日志会记录所有交互过程。高级设置区域提供额外的配置选项，满足特殊使用需求。

## 模块说明

DeepSeekAuto 类是自动化模块的核心，负责管理整个对话流程。它提供 start() 启动自动化、stop() 停止自动化、sendQuestion() 发送问题、startListening() 开始监听响应等方法。类中还实现了页面就绪等待、内容增量更新、响应完成标记等机制，确保对话过程的可靠性。

Printer 类管理所有的打印输出功能。核心方法包括 printSegment() 打印内容片段、printFinalResult() 打印最终结果、printError() 处理错误输出。导出功能支持 saveToFile()、exportToTxt() 和 exportToJson() 方法，方便用户保存会话记录。

Logger 类提供完整的日志记录服务。支持 debug、info、warn、error 等日志级别，可通过 setLevel() 方法调整。日志导出功能允许将记录保存到指定路径，便于问题排查和分析。

## 许可证

本项目遵循 MIT 许可证开源。