返回秀秀每日修改日志

秀秀 3.226 - 精确来源返回、显式分享搜索与桌面原生编辑菜单

记录日期：中国时间 2026-08-22；不可覆盖快照 ID：c3fa53ffd14952b5650ac0036c1343d286a930b4fb41c00ad95747337f323c8b

记录完整性：九项详细记录完整

## 秀秀 3.226 - 精确来源返回、显式分享搜索与桌面原生编辑菜单

- 建立时间：2026-08-22 CST。
- 详细记录标准：v1。
- 父版本：秀秀 3.226；固定严重故障回滚基准仍为秀秀 3.2。
- 修改目的：解决案例库、刻秀圈和Q工程分享关闭后跳到消息首页，案例库与刻秀圈在手机端和电脑端都看不到真人/BOT搜索入口，Windows安装版输入框右键不能剪切/复制/粘贴，以及新工程分享时间未固定为中国时间的问题。
- 原因判断：旧恢复逻辑只记页面级来源，并且只有部分状态存在时才恢复，未完整保存来源会话、案例库设置层、作者刻秀圈主页和滚动位置；工程分享存在“秀秀预览壳套工程预览壳”的双层iframe，但内层关闭事件没有向外转发，工程页自身的`history.back()`又会与父层关闭竞争。旧分享搜索藏在可见范围设置或卡片下拉选择中，没有在案例卡片及刻秀圈操作菜单提供统一、可见的直接入口。Electron壳仅处理选中文本，未为可编辑输入框注册系统编辑菜单。后端生成时间直接使用服务器本地时区，不能保证固定为中国时间。
- 修改逻辑：打开预览前按来源元素保存页面、精确会话、设置面板、案例库、作者刻秀圈主页和滚动位置，关闭时无条件按该快照恢复；外层`/open-artifact`接收并转发内层关闭事件，工程页优先通知父层而不再抢先执行历史回退。手机端与电脑端统一增加“分享给真人/BOT”显式入口和搜索弹窗，只列出当前账号已有权限的真人/BOT会话，按姓名、账号或BOT名称筛选；原群组分享、可见范围和外链流程继续保留。Electron对可编辑区域按`editFlags`显示剪切、复制、粘贴和全选，对普通消息仍保留原秀秀菜单。新生成报告和聊天分享统一使用UTC+8。
- 采用方法：在四个标准节点共用源码和守一替身保留X军团差异的源码上分别做窄补丁，不整文件互相覆盖；更新Web和App静态资源缓存标记。Windows壳增加原生`context-menu`处理并分别构建四套标准安装包和秀秀替身安装包，先上传可执行文件与blockmap，最后原子更新`latest.yml`。部署前逐节点校验原文件哈希并建立独立备份，只重启`xiuxiu3-web`，未重启OpenClaw、Bridge、Q或X服务。
- 数据/调用链路：案例卡片或刻秀圈“...” -> 分享给真人/BOT -> 搜索当前可用真人/BOT -> 发送现有分享卡片；分享卡片或工程链接 -> 捕获来源页面/会话/面板/滚动位置 -> 同页预览 -> 内层关闭事件逐层转发 -> 关闭预览 -> 恢复精确来源。桌面输入框右键 -> Electron读取`editFlags` -> 调用系统剪切/复制/粘贴角色。报告生成 -> `china_now()` -> 页面和分享时间使用UTC+8。
- 兼容保护：未修改账号、群组、好友、聊天记录、BOT、人设、模型、4.5、Loop、001/002、Q/X军团、206中转、跨服权限和数据库结构；未扩大分享权限，搜索结果仍以当前已授权会话为准；原群组下拉分享和外链分享继续可用。守一替身的XBot身份与前端差异保留，安装包自动更新仍使用单调递增技术版本，公开功能版本保持3.226。
- 改动文件：五节点`web/web.js`、`web/index.html`、`app/mobile.js`、`app/index.html`、`xiuxiu3_core/standalone.py`；Windows壳`main.js`、`package.json`及五套构建产物；专项Playwright测试、Electron菜单单元测试、`VERSION_RECORDS.md`、每日修改日志和长期功能总台账。
- 验证结果：JavaScript和Python语法检查通过；Electron菜单单元测试4/4通过，五套打包ASAR均确认包含原生粘贴菜单、正确服务器地址与技术版本。守一完整浏览器回归5项通过、1项节点条件跳过；立志教育相关回归与新增显式分享搜索测试通过；守一替身保留差异版本的手机/电脑搜索测试2/2通过。案例卡片可打开搜索器、无结果提示正确，刻秀圈事件委托可打开同一搜索器，嵌套工程和历史分享均返回原会话。五节点Web、App和版本接口HTTP 200。
- 同步与回滚：Web源码回滚点为守一`/opt/xiuxiu3-sync-backups/20260822-before-source-return-cn-time/`，其余四节点`/opt/xiuxiu3-sync-backups/20260822-before-share-search-source-return/`；Windows更新源回滚点为206`/var/www/xiuxiu-client-packages/.backup-20260822-context-menu/`。回滚只恢复故障节点自己的源码或对应客户端更新目录，禁止跨节点恢复数据库、身份、密钥和工作区。
- 客户端技术版本：立志教育、影团AI、守一、守一替身为`3.1786.0`；秀秀替身为`3.219.2`；界面统一显示功能版本`秀秀 3.226`。