# 微信智能运营助手

**Repository Path**: mrjkchen/wechat-operations-assistant

## Basic Information

- **Project Name**: 微信智能运营助手
- **Description**: 独立 Windows AI 运营助手：会话绑定、可靠回复任务与 API Nebula 模型接入。当前为开发基础版，尚未完成真实微信自动回复验收。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微信智能运营助手

独立实现。参考识流的产品流程，使用自有客户端、模型接口和后端。

当前完成：任务去重、持久化状态、暂停取消、发送前会话检查、发送后新增正文检查、结果未知不重发。`npm test` 运行故障回归。

模型接口：已实现 API Nebula Responses 流式 HTTP 适配器及独立测试。官方文档默认接口 https://apinebula.ai/v1；用 APINEBULA_MODEL 填控制台可用模型，用 APINEBULA_API_KEY 传入密钥。2026-10-10 已使用本地配置通过真实中文模型调用；密钥不进入仓库。接入依据：https://docs.apinebula.com/docs/quickstart/ 与 https://docs.apinebula.com/docs/cli/codex/。

已继续实现：Electron 桌面界面、自动回复主流程、业务资料、任务记录、独立 Win32 窗口适配器、模型图像识别、可见未读会话切换、暂停与本机便携构建。手动输入仅用于模型调试，自动流程无需人工粘贴每条消息。

验证边界：30 项自动回归、9 项隔离桌面检查、真实文本接口调用及合成微信图像识别通过。真实微信原生截图、点击输入、发送确认和未读切换尚未验收，当前为开发预览，不能宣称已交付稳定的全自动微信回复成品。详见 docs/desktop-delivery.md。

模型服务商已接 API Nebula，模型名由本地配置决定，密钥不得写入代码或提交。所有本地数据放在本项目 data 目录。第三方识流安装包和代码保留在独立研究目录，不纳入产品或 Git。

## API Nebula 本机配置

复制 .env.example 为 .env，在本机编辑 APINEBULA_MODEL 和 APINEBULA_API_KEY；模型名称以控制台实际可用列表为准，不把令牌管理页面 URL 当作模型接口。`.env` 已被 Git 忽略。

配置完成后可手动执行 `node --env-file=.env src/model-smoke.mjs`，仅发送固定的中文测试消息；这会产生一次正常模型调用，不读取微信或客户数据。连接成功不代表已完成微信自动回复验收。

请求使用 `instructions`、显式 `input_text` 和 `stream: true`，保留 1024 输出 token 上限和 60 秒总超时。只接收 `response.completed` 的完整文本；部分文本、失败事件、截断响应均不能成为待发送回复。不会自动重试计费请求。超时错误区分等待 HTTP 响应头、读取响应正文和用户取消。详见 docs/model-connection-diagnosis.md。

Gitee：https://gitee.com/mrjkchen/wechat-operations-assistant 。公开仓库仅包含自有实现和测试。

## 桌面运行与自动回复

Windows 使用 Node.js 24+。执行 `npm install`，再执行 `npm start`；启动前会编译 native/WechatBridge.cs。或执行 `npm run pack`，打开 dist/微信智能运营助手/微信智能运营助手.exe。便携构建不会包含你的 .env，分享构建前务必检查本机后来写入的 .env 和 data。

在模型与连接中配置模型，业务资料页保存参考资料。自动回复页查找并绑定微信窗口、每行填写一个完整的允许回复会话名称、选择自动发送或自动生成草稿，明确授权截图分析和窗口控制后启动。自动发送还需发送授权。启动将最大化并切到微信窗口，软件保持串行处理；Esc 或暂停按钮可停止。如果全局 Esc 注册失败，界面会提示使用暂停按钮。

文件传输助手用于单独固定发送自检：只向该会话发送 `WeChat assistant test OK 20261010`，不使用其他联系人。其自己发送的消息通常属于本方消息，不构成“收到对方消息并自动回复”的完整验收。

视觉无法提供平台级消息 ID。目前以会话、方向和正文摘要做保守去重；无法区分的相同消息可能被跳过。同名会话、完全相同回复、表情/图片/语音消息、当前可见范围以外的未读和显著不同的布局仍需进一步适配。截图识别调用计费模型；同一帧复用识别结果，当前 gpt-6 系列视觉任务使用 low 推理强度，失败不自动重试。