ChatGPT-wechat-bot 个性化私聊交互配置指南

一、核心功能解析 🧩

ChatGPT-wechat-bot 提供的私聊交互系统是实现个性化智能对话的核心模块，通过灵活的参数配置，用户可以打造专属的 AI 交互体验。该模块主要通过 src/config.ts 文件进行配置，包含唤醒机制、回复格式控制和上下文管理三大核心功能。

1.1 唤醒机制模块

私聊唤醒关键词（privateKey）是控制机器人响应触发的核心参数，定义了私聊场景下激活 AI 对话的条件。当该参数配置为空字符串时（默认状态），系统将对所有私聊消息进行响应；若设置特定关键词（如"ai"），则需在消息开头包含该关键词才能触发回复（例如"ai 今天天气如何"）。

// src/config.ts
export default {
  // 在私聊中设置唤醒微信机器人的关键词
  privateKey: "",  // 默认值：空字符串（所有消息触发）
}

1.2 回复格式控制

私聊回复模式（privateReplyMode）决定了 AI 回复的呈现形式。当参数设置为 false（默认值）时，回复内容仅包含 AI 生成的回答；设置为 true 时，回复将同时显示原始问题和 AI 回答，形成"问题-答案"的完整对话单元，有助于保持上下文连贯性。

// src/config.ts
export default {
  // 是否在私聊中带上提问的问题
  privateReplyMode: false,  // 默认值：false（仅显示回答）
}

1.3 上下文管理

系统内置上下文记忆功能，通过 重置关键词（resetKey）实现对话历史的清除。默认配置下，发送"reset"指令即可清空当前对话上下文，使 AI 以全新状态开始交互。该功能在需要切换话题或纠正对话方向时尤为实用。

二、场景化配置流程 🚀

2.1 日常聊天场景配置

适用人群：普通用户，追求简单直接的对话体验
核心需求：快速响应，无需唤醒词，简洁回复

配置步骤：

1. 获取并配置 OpenAI API 密钥

   // src/config.ts
   export default {
     // 填入你的OPENAI_API_KEY
     OPENAI_API_KEY: "your_api_key_here",  // 替换为实际API密钥
   }
   

2. 保持默认唤醒设置（无需唤醒词）

   // src/config.ts
   privateKey: "",  // 空字符串表示所有消息触发
   

3. 启用简洁回复模式

   // src/config.ts
   privateReplyMode: false,  // 仅显示AI回答内容
   

4. 启动服务

   git clone https://gitcode.com/gh_mirrors/ch/ChatGPT-wechat-bot
   cd ChatGPT-wechat-bot
   npm install
   npm run dev
   

2.2 专业工作场景配置

适用人群：专业用户，需要在多任务环境中使用 AI
核心需求：精确触发，避免误响应，完整上下文记录

配置步骤：

1. 配置 API 密钥及反向代理（提升访问稳定性）

   // src/config.ts
   export default {
     OPENAI_API_KEY: "your_api_key_here",
     // 配置专属反向代理地址
     reverseProxyUrl: "https://your-proxy-server.com/v1/chat/completions",
   }
   

2. 设置专属唤醒关键词

   // src/config.ts
   privateKey: "workai",  // 仅"workai "开头的消息会触发响应
   

3. 启用完整回复模式

   // src/config.ts
   privateReplyMode: true,  // 显示"问题+回答"完整格式
   

4. 启动服务并测试

   npm run dev  # 启动后扫描二维码登录微信
   

三、实战问题解决 🔧

3.1 机器人无响应问题排查

当私聊消息无法触发 AI 回复时，建议按以下步骤排查：

1. API 密钥验证
   确认 OPENAI_API_KEY 已正确配置且未过期，可通过替换为新密钥测试。

2. 唤醒条件检查

   • 若设置了 privateKey，确保消息以该关键词开头（如设置"ai"时需发送"ai 问题内容"）
   • 检查是否存在空格或特殊字符导致关键词识别失败

3. 网络连接测试
   验证反向代理地址（reverseProxyUrl）的可访问性，默认地址不可用时可更换为其他可用代理。

3.2 对话上下文管理

当对话出现混乱或需要切换主题时，可通过以下方式管理上下文：

1. 主动重置：发送 resetKey 配置的关键词（默认"reset"）清空上下文
2. 自动隔离：系统会为每个联系人维护独立对话上下文，不同联系人之间互不干扰

四、高级功能拓展 ⚡

4.1 多轮对话优化

通过调整代码中的上下文窗口大小，可优化长对话体验。在 src/chatgpt.ts 中找到对话历史管理逻辑，适当增加上下文保留的消息数量：

// 示例：调整上下文保留数量（实际代码需根据项目结构查找）
const MAX_HISTORY_MESSAGES = 10;  // 默认可能为5，增加至10可保留更多上下文

4.2 响应速度优化

通过配置本地缓存和请求超时参数，提升交互流畅度：

1. 在 src/config.ts 中新增超时配置（若不存在）

   export default {
     // 新增API请求超时设置（单位：毫秒）
     requestTimeout: 30000,  // 设置为30秒
   }
   

2. 实现本地对话缓存（需修改 src/utils.ts）

   // 示例：添加简单的内存缓存逻辑
   const对话Cache = new Map();
   function getCached对话(userId) {
     return对话Cache.get(userId) || [];
   }
   function save对话ToCache(userId, messages) {
    对话Cache.set(userId, messages.slice(-5));  // 仅保留最近5条
   }
   

4.3 个性化指令预设

通过预设常用指令模板，提升特定场景的交互效率。在 src/utils.ts 中添加指令处理函数：

// 示例：添加代码解释指令模板
function processSpecialCommands(message) {
  if (message.startsWith("解释代码:")) {
    return `请解释以下代码的功能：\n${message.replace("解释代码:", "")}\n要求：详细说明核心逻辑和潜在问题`;
  }
  return message;
}

通过以上配置和优化，ChatGPT-wechat-bot 的私聊功能将更贴合个人使用习惯，实现真正意义上的个性化智能交互体验。无论是日常聊天还是专业工作场景，合理的参数配置都能显著提升 AI 助手的实用性和效率。