企业微信新账号扫码与多账号切换演示手册

1. 本次演示目标

在一个新克隆的项目目录中完成：

安装通用版 fmode-qiwei；
使用新设备 UID 生成企业微信二维码；
扫码、必要时提交 6 位验证码；
登录成功后保存新账号并切换到该账号；
重启工作台后仍恢复正确账号；
在两个已保存账号之间往返切换，客户 Workbench 与 Claude Session 不串号。

本流程不包含房源、看房、购房画像或房源推荐 Skill。

2. 演示前准备

Node.js 22.5.0+；
已登录 Fmode Studio，或当前项目能读取有效 Fmode 鉴权；
手机企业微信可扫码；
新项目目录可写；
端口 4320 未被其他项目占用。

克隆项目后，先备份项目根目录的 .env.local。若本次必须演示“全新账号首次绑定”，可删除克隆文件中的 QIWEI_UID 与 QIWEI_GUID 两行；保留现有 Fmode 鉴权配置。不要把 .env.local 发到聊天或提交到 Git。

3. 从本地迁移版安装

在 PowerShell 中执行：

$Source = 'E:\workspace\openclaw-voc-skill\claude-code\claude-code-qiwe-assistant'
$Project = 'E:\你的新克隆项目'
node "$Source\install.js" workspace "$Project" --smoke
Set-Location $Project
node .claude\plugins\qiwei-assistant\install.js preview .

浏览器应打开：

http://127.0.0.1:4320/

0.5.1 发布后可直接使用 npx --yes fmode-qiwei@latest workspace --smoke；上述本地源码命令继续用于开发分支验证。

4. 页面操作步骤

打开右上角账号菜单，点击 添加账号；或进入 账号状态 → 添加账号。
页面会生成一个新的设备 UID，并请求新的登录二维码；旧账号仍保留在已保存账号列表中。
用待演示的企业微信扫码，并在手机端确认。
若页面出现验证码输入框，输入手机端显示的 6 位数字。
等待页面显示“登录成功”和新账号名称。
进入 账号状态，确认新账号为当前账号且状态为在线。
在已保存账号中选择旧账号，点击切换；再切回新账号。
打开 智能会话，确认切换后显示的是对应账号的独立会话数据。
选择测试联系人加入白名单，将全局模式保持为 待审核，再启动监听。

5. 必做验收

扫码链路

二维码能展示；
状态能从等待扫码进入已确认或验证码，再进入登录成功；
新 UID 的请求没有携带旧账号 GUID；
扫码取消后原账号仍可继续使用。

切换与重启

切换接口成功后页面才更新当前账号；
项目 .env.local 中的 UID/GUID 属于同一个当前账号；
关闭工作台并重新执行 preview，当前账号仍正确；
A → B → A 往返切换后，会话、草稿和 Claude Session 不串号；
监听恢复不把原来的审核/自动/人工模式重置。

工作区隔离

同一浏览器打开另一个克隆项目时，账号列表使用新的 workspaceId；
不会因为同样使用 127.0.0.1:4320 而自动写入上一个项目的账号。

6. 快速自检命令

在技能包目录执行：

npm run check
npm run account:switch-smoke
npm run runtime:smoke
npm run agent:smoke
npm run connection:smoke
npm run install:check
npm run package:smoke

专项测试不访问真实账号，也不输出任何凭据。

7. 刘总交给 Agent 的一键配置提示词

请在当前克隆项目中完成 fmode-qiwei 通用版的安装、启动和新企业微信账号绑定，并把每一步结果简洁汇报给我。

执行要求：
1. 先确认 Node.js >= 22.5，并识别当前项目根目录；不要读取或输出任何 Token、GUID、sessionToken、Authorization 或 .env.local 全文。
2. 优先使用已经安装在当前项目的 .claude/plugins/qiwei-assistant；若未安装，使用我提供的本地 fmode-qiwei 源码目录执行 workspace --smoke 安装。不要安装或启用任何房源、看房、购房画像、房源推荐 Skill。
3. 检查 4320 端口；若被其他项目占用，先确认对应进程，停止旧项目服务后再启动当前项目，不要让两个项目共用同一个工作台进程。
4. 启动 preview，读取 /api/health，确认返回的 workspaceId 属于当前项目。
5. 本次目标是“添加新企微账号”：生成全新的 uid；调用登录开始、状态检查和验证码时始终使用该 uid，禁止复用旧账号 guid；扫码成功前 persistConfig=false。
6. 展示二维码并等待我扫码。状态为 10 时只向我询问手机端 6 位验证码；状态为 2 后保存该 uid 与本次返回的 guid，并切换为当前账号。
7. 若扫码取消或切换失败，恢复原当前账号并保留已保存账号列表，然后报告失败步骤和可重试动作。
8. 登录成功后验证账号在线；重启一次工作台验证账号能恢复；如已有两个账号，再执行 A→B→A 切换并确认 Workbench/Claude 客户 Session 隔离。
9. 打开智能会话，把测试联系人加入白名单；默认保持待审核模式，启动监听。不要自动向任何非白名单联系人发送消息。
10. 最终只汇报：安装状态、workspaceId 后 6 位、扫码状态、当前账号脱敏名称、重启恢复、账号切换、白名单、监听状态和未完成项。不要回显任何凭据或完整设备标识。

8. 回滚

停止当前项目工作台与监听；
恢复演示前备份的 .env.local；
重新启动工作台；
在账号状态页切回原账号；
确认白名单与 Agent 模式符合演示前状态。

ACCOUNT-SWITCH-DEMO.md 5.6 KB История Исходник