chatgpt.js 快速上手指南

chatgpt.js 是一个功能强大的客户端 JavaScript 库，旨在让开发者能够极其轻松地与 ChatGPT 网页版（DOM）进行交互。它轻量、面向对象且易于使用，非常适合编写浏览器扩展、油猴脚本或前端自动化工具。

环境准备

• 运行环境：现代浏览器（Chrome, Firefox, Edge, Safari 等）。
• 前置依赖：
  • 需要已登录并打开 ChatGPT 官网。
  • 若用于开发浏览器扩展，需熟悉 Chrome Extension Manifest V3 规范。
  • 若用于用户脚本，需安装 Tampermonkey 或 Violentmonkey 插件。
• 网络要求：由于库通过 CDN 加载或直接操作 ChatGPT 页面，请确保能正常访问 ChatGPT 服务及 jsDelivr CDN。

安装步骤

根据使用场景选择以下任一方式引入库：

1. 用户脚本 (Tampermonkey / Violentmonkey)

在脚本头部添加 @require 指令即可直接引用最新版本（生产环境建议锁定版本号）：

// ==UserScript==
// @name         My ChatGPT Script
// @namespace    http://tampermonkey.net/
// @version      0.1
// @description  使用 chatgpt.js 的示例
// @author       You
// @match        https://chat.openai.com/*
// @require      https://cdn.jsdelivr.net/npm/@kudoai/chatgpt.js@3.9.0/dist/chatgpt.min.js
// ==/UserScript==

// 你的代码写在这里...

2. ES6+ 模块 (现代前端项目/控制台)

使用动态 import 异步加载：

(async () => {
    await import('https://cdn.jsdelivr.net/npm/@kudoai/chatgpt.js@3.9.0/dist/chatgpt.min.js');
    // 你的代码写在这里...
})();

3. npm 本地安装

适用于需要自定义构建或离线部署的项目：

npm install @kudoai/chatgpt.js

安装后，库文件位于 node_modules/@kudoai/chatgpt.js 目录下。

4. Chrome 扩展程序 (Manifest V3)

由于 Chrome 禁止远程代码执行，需本地引入：

1. 将 chatgpt.js 保存到项目子目录（如 lib/chatgpt.js）。
2. 在 manifest.json 中声明资源：

"web_accessible_resources": [{
    "matches": ["<all_urls>"],
    "resources": ["lib/chatgpt.js"]
}],

3. 在脚本中导入：

(async () => {
    await import(chrome.runtime.getURL('lib/chatgpt.js'));
    // 你的代码写在这里...
})();

基本使用

chatgpt.js 的设计极具灵活性，支持多种链式调用和自然语言风格的 API。只要逻辑通顺，通常都能正常工作。

获取最新回复

以下四种写法效果完全相同，均可获取 ChatGPT 的最后一条回复内容：

// 方法 1
chatgpt.getLastResponse();

// 方法 2
chatgpt.getLastReply();

// 方法 3
chatgpt.response.getLast();

// 方法 4
chatgpt.get('reply', 'last');

完整示例

以下是一个简单的油猴脚本示例，用于在页面加载后自动打印最后一条回复：

// ==UserScript==
// @require https://cdn.jsdelivr.net/npm/@kudoai/chatgpt.js@3.9.0/dist/chatgpt.min.js
// ==/UserScript==

(function() {
    'use strict';

    // 等待 ChatGPT 响应生成完毕
    chatgpt.isGenerating().then(() => {
        const lastReply = chatgpt.getLastResponse();
        console.log('ChatGPT 最新回复:', lastReply);
        
        // 例如：将回复复制到剪贴板
        // navigator.clipboard.writeText(lastReply);
    });
})();

提示：更多高级用法（如发送消息、删除对话、导出历史记录等）请参考官方 用户指南。