@senguoyun/dsh-arkme 0.1.78 → 0.1.80

package/docs/reaction-desktop-review.md

@@ -0,0 +1,33 @@
+# 桌面表态交付说明
+
+## 最终范围
+
+私聊、群聊、发给自己的消息可添加和取消表态，支持表情、手势与短语组合、自定义颜色、短语保存/排序/删除。同词不同颜色分别保存，完全相同的短语提示重复。世界页面不提供表态入口。
+
+表态显示参与者姓名，优先采用查看者的备注，再使用个人名称；群昵称单独补充。姓名可打开名片。
+
+侧边栏显示别人对自己消息的未查看表态，点击橙色预览定位原消息并强调新表态。查看会话本身不清除提醒。没有新增聊天内提醒按钮，原回到底部按钮保持既有行为。
+
+“我的一天”记录自己的添加与取消操作，沿用原时间轴、头像、发送者、时间和展开结构。前往原始来源定位消息并强调对应表态；已取消且不再存在的表态只强调原消息。高亮在进入视野、滚动停稳后开始。
+
+## 能力与数据边界
+
+- Record 后端持有当前表态、操作历史、短语及隐私策略，Chat 提供消息可读性。客户端不新增消息持久字段。
+- Host ReactionService 是权限、幂等和错误语义的单一入口；UI、公开 SDK reactions 能力和读写 Tools 共用该 owner。
+- 读取、写入及缓存均按账号作用域隔离。历史失去原消息访问权限时隐藏来源和原文，隐私锁保护历史。
+- SDK consumer 和正式 ToolRuntime 合同已测试；未完成已安装桌面中的真实模型会话验收，不将合同测试视为该验收。
+- 客户端反应查询有目标数、批大小、并发及缓存容量边界；前后台切换/卸载清理订阅和计时器。没有新增桌面原生桥或修改 DSH 源码。
+
+## 测试环境及依赖
+
+后端功能已部署测试环境：Chat #728、World 权限支持 #131、Record 后续原消息上下文 #522 均成功。生产部署须先具备这些后端合同。World 权限适配不代表本次增加世界页面表态入口。
+
+插件沿用 0.1.79 版本字段，通过不可变 tgz 和官方 DSH 安装流程装配到三个专用 Windows 测试 Profile。未发布生产渠道，未修改插件版本或客户端源码。
+
+用户已用多个账号逐项复测此前反馈的交互问题，最后确认取消表态的来源跳转灰色提示通过。最近一次局部修复 26 项检查及类型、构建、打包通过。
+
+全仓测试存在 Windows/运行环境及其他模块失败，历史全量结果并非全绿。提交前的最新测试结果以 PR 验证部分为准；不得把表态局部通过写成全仓通过。
+
+## 回滚
+
+先恢复上一插件制品，再按后端发布流程回滚对应服务；不删除表态历史集合，不改用户测试账号或已有数据。

package/docs/reaction-pre-merge-review.md

@@ -0,0 +1,78 @@
+# 表态合并前两轮审查
+
+目标分支：官方 dev `9e2d2142`。当前任务已合入该基线的聊天输入/消息渲染优化，保留 `renderedMessageRows` 缓存及原回到底部逻辑。审查范围为本分支完整差异，以及已部署的 Record 表态 owner、Chat 可读性合同和既有 World 权限适配。后端生产部署状态见文末；无数据库清理、回填或格式迁移。
+
+## 第一轮：实现、owner 和数据边界
+
+确认并修复：
+
+1. 表态参与者名为“我”时，原展示逻辑只用字符串判断自己的占位身份，可能替换别人的资料。修复为必须匹配当前用户 ID，姓名不再充当身份标识。正常服务端姓名不被旧本机资料覆盖。
+2. 会话累计挂载超过 200 条消息时，原订阅按挂载顺序占满读取容量。修复为只为可见区域及邻近区域订阅；离开区域释放订阅但保留有界缓存。显式跳转提前准备目标，避免在屏外等不到读取。没有放大批次、并发和缓存上限。
+3. 短语读取和保存并发时，旧读响应可能覆盖已确认的新版本。保留最大已确认 revision，沿用原 owner 和 CAS，不新增第二份持久状态。
+4. 旧目录测试按 button 取会话行/检查 disabled，和允许独立橙色入口的 treeitem 结构不一致。测试改为语义选择器及 aria-disabled，继续验证置顶、移除、普通点击和预览互不干扰。
+
+## 第二轮：业务场景逐项映射
+
+| 场景 | 实现链路 | 验证证据 |
+| --- | --- | --- |
+| 私聊、群聊、发给自己添加/取消 | Sidebar → PreviewStore → Host ReactionService → Record Set | reaction-preview-store、reaction-host-sdk-tools；Record service/mutation tests |
+| 同一记录不同会话的表态隔离 | 签名 source/action ref → Chat reactionTarget → Target(chat, relation) | Host target contract；Record Target/Access/Query tests；不把记录内容和消息归属混用 |
+| 世界不显示表态入口 | Sidebar 挂接消息能力；World 页面无新增表态组件 | 完整 diff 核对；遗留的通用 World 权限适配不是新页面入口 |
+| 同词不同颜色、组合手势 | expressionIdentity 与后端 Expression.Key | reaction-phrases、reaction-label-content、reaction-preview-ui |
+| 同词同色保存/保存并表态 | Phrases.create 显式重复分支；不把使用已存短语变成编辑 | reaction-preview-ui |
+| 删除确认、失败恢复和空库 | LibraryStore + Phrases.remove；revision 0 才使用默认库 | reaction-phrases、reaction-preview-ui；Library CAS tests |
+| 拖动顺序、取消拖动 | useReactionPhraseDrag 固定槽位；Library CAS | reaction-phrase-drag、phrase-layout-motion |
+| 首次加载/连续挂载/查询中加入 | PreviewStore prepare/watch/refreshAgain | reaction-preview-store |
+| 切换会话不清空已确认表态 | 有界 inactive snapshots；更新签名 ref | reaction-preview-store |
+| 长会话超过 200 条 | watchVisibleReactionTarget；显式跳转 prepare | reaction-visible-target；conversation-send-directory |
+| 发送普通消息不重载全部表态 | 稳定 target.id 订阅；最新 dev 消息行缓存 | conversation-send-directory 的发送、输入和 40/400/1000 消息测试 |
+| 断网、重复点击、不确定写重试 | 显式 active、同 request_id、revision 冲突 | PreviewStore tests；Record mutation/idempotency tests |
+| 切号/切环境时旧请求返回 | AbortController + accountKey 二次检查 | reaction-preview-store、reaction-host-sdk-tools、reaction-history-loading |
+| 名称、备注、群昵称、名片 | Chat 成员备注与 profile 分开投影；ID 判断身份 | reaction-group-nickname、reaction-actor-card、reaction-preview-ui |
+| 只提醒别人对自己的消息表态 | Record RecipientID/ActorID 和当前可读性过滤 | Record notifications tests；reaction-notifications |
+| 多人同条、多条消息、后来追加 | 消息聚合预览；逐 actor 精确 revision | reaction-notifications、reaction-notice-presentation |
+| 停留消息页面仍保留提醒 | beginViewing 只由橙色点击触发 | reaction-visible-notification、reaction-notifications |
+| 点击头像/会话名不消除橙色提醒 | 独立预览按钮；普通目录导航保留 | chat-preview-navigation、reaction-notice-presentation |
+| 一次点击跳转当前/缓存/隐藏会话 | conversationTarget revision、viewport restore 让位 | conversation-send-directory |
+| 消息整体灰色及新表态/新参与者灰色 | 独立 message backdrop 与 reaction highlights | reaction-preview-ui、reaction-locate-layout |
+| 跳转滚动和失焦不消耗提示时间 | afterMessageVisible/visible reaction observer | reaction-locate-layout、reaction-visible-notification |
+| 原来的回到底部/动效 | 未修改 ArkmeConversationBottomControl | diff 核对；相关现有会话测试 |
+| 我的一天只展示自己的操作事实 | Record.History actor filter → useReactionHistory | Record privacy/history tests；reaction-day-timeline |
+| 头像、原发送者、同日时间、沿用布局 | HistoryContext → 原有 DayTimeline 组件 | reaction-history-avatar、reaction-day-timeline、personal-day-calendar |
+| 已取消表情删除线 | ReactionAction 包括图片的删除线样式 | reaction-day-timeline |
+| 原始来源定位、单个表态颜色区分 | openReactionHistory → 相同定位入口与 expressionIdentity | reaction-day-timeline、reaction-preview-ui |
+| 已取消表态仍定位原消息 | 原消息独立高亮，不依赖表态组存在 | reaction-locate-layout；conversation-send-directory current/other |
+| 权限消失、隐私锁、旧名单 | 后端读前/后权限与 policy；UI 无权限清数据 | Record privacy/access tests；reaction-host-sdk-tools、reaction-preview-ui |
+| 会话移除时橙色入口/双击 | 第二轮发现并修复：子入口同步 disabled，双击检查移除状态 | reaction-notice-presentation、chat-directory-pin-ui |
+| Tools/SDK 不绕过业务权限 | 同一 Host owner；read/write Tools 分离、显式写授权 | reaction-host-sdk-tools、tools registrar/catalog |
+
+## 架构判断和剩余验证边界
+
+持久化仍由 Record 单一 owner 持有；短语与隐私设置分开 CAS，表态写入与幂等回执共事务。UI 的拖动、灰色提示、请求取消仅为有限生命周期状态，不引入第二套业务状态机或迁移兼容层。没有系统提示词修改。
+
+已完成的自动检查和用户此前逐项复测不能证明所有环境下绝无问题。尚未进行本轮新制品的 macOS 实机验收，也未把 SDK/Tool 合同测试称为桌面真实模型会话验收。完整仓库 Windows 测试的基线对照及最终构建结果在 PR 中列出。
+
+## 最终自动验证
+
+- 相关 26 个测试文件首轮 617 项通过；随后补充移除会话期间禁用提醒的回归测试，全量运行中这 26 个文件的 618 项全部通过。
+- TypeScript 类型检查、声明生成、插件构建、可执行入口校验、tgz 打包通过。Chat 与 Record 的表态相关后端测试通过；本 PR 不包含后端代码。
+- 不可变 tgz 经官方 DSH CLI 安装到全新 Profile；包清单检查未发现本机路径或临时目录。三个专用 Windows 测试客户端均加载最终 client revision `b942ada54c06`，Host 确认三个原测试账号仍在 test 环境且已登录。此项证明安装、启动和账号保持，不代替新制品完整交互验收。
+- 当前分支全量：8896 通过、156 失败、13 跳过；官方 dev 9e2d2142 同环境基线：8768 通过、157 失败、13 跳过。155 项失败相同，不能认定全仓绿色。
+- 当前额外失败为未修改的连接诊断异步持久化测试；该实现及测试相对 dev 无差异，单独复测该文件 17 项全部通过。保留全量失败记录，不以复测替换原结果，也不将其宣称为已修复。
+- 正式 DSH 模型会话验收通过：最终插件对应的专用 Windows 客户端使用已有 arkme-managed/deepseek-v4-flash 模型，真实会话发现并调用 arkme_reactions_read（library-query），工具返回 isError=false、revision=40、4 项短语，turn/end=completed。仅执行读取，未发表态、发送消息或修改业务数据。此前 deepseek-official 缺凭据的失败是模型路由配置问题；本次没有新增或复制凭据。
+
+## 正式分支后端复核
+
+重新核对最初后端约束：后端以 master 为基线；表态独立存储，存量消息与聊天关系不增加表态字段；不增加灰度开关或历史回填。集合为 reaction_state、reaction_event、reaction_preferences，分别持有当前状态、不可变动作/幂等回执、个人偏好。五个二级索引对应目标名单、原文维度、收件箱、我的历史和收到的动作查询，偏好仅依赖默认 _id 索引。
+
+发现并用真实 Mongo 副本集复现：不同账号的自有记录若具有相同 record_uid，原先表态聚合会混入另一账号。Record 已对自有记录的数量、分组及参与者查询增加授权 owner 约束，未改变存储身份或添加索引；回归测试先失败再通过。已同步最新 master 并复验表态 API、事务及 Completion 架构边界。
+
+正式分支合并请求：
+- [Record #417](https://codeup.aliyun.com/senguo/jotmo/jotmo-record/change/417)：表态、提醒、历史及此次账号隔离修复。
+- [Chat #453](https://codeup.aliyun.com/senguo/jotmo/jotmo-chat/change/453)：复用 chatscope 的内部鉴权查询。
+
+Chat 相关测试通过；World 权限/发布状态测试通过。World 按现有配置加载约束编译后从仓库根目录运行，裸包目录执行的配置缺失与实际断言结果分开记录。Record #417 和 Chat #453 已合入 master；2026-09-24 16:14（上海时间）正式服分别更新至 Record 镜像 154、Chat 镜像 196。两者 Ready、零重启；启动日志包含新增表态路由，未发现表态存储初始化失败。此项不替代正式客户端发布后的端到端验收。
+
+上线顺序为 Chat → Record → 桌面插件。当前 PR #687 目标是 dev，合入后仍需走 master 正式发布流程和生产 Runtime 激活。以上合并请求均未代替生产发布；回退保留新增集合及用户数据。
+
+发布范围：私聊、群聊、发给自己及“我的一天”。范围外的 World 合并请求已关闭，不纳入本次发布。