Your Name and Claude Sonnet 5
4e8f45d7d8
路由从 hash 换成 History API（pushState/replaceState/popstate），不再依赖 location.hash
...
HashNavigation 改名 Navigation（src/lib/navigation.js），接口不变，内部改用真实路径：
parseUrlHash/composeUrlHash 改名 parseUrl/composeUrl；navigateTo/navigateReplace 改调
pushState/replaceState 后手动派发 popstate（pushState/replaceState 不会像赋值 location.hash
那样自动触发事件，这里复用 navigateReplace 早就在用的同一个手动 dispatch 手法）；goBack()
不用改，history.back() 本来就是真实浏览器历史机制。新增 Navigation.currentUrl() 替代调用方
原本直接读的 window.location.hash（这个类从来没包装过这个读取）。
一处需要专门处理的边界情况：当 path[0] 是空字符串（"不选中侧栏视图、只开一个会话"这个仓库里
的合法状态）时，拼出的真实路径开头会变成双斜杠，被浏览器当协议相对地址解析、试图跳到一个叫
会话id的host，pushState 直接抛 SecurityError。composeUrl/parseUrl 内部用占位 token "_" 处理
这种情况，对外的调用方（19个文件）完全无感。
tinode-web.jsx 的 handleHashRoute 改名 handleRouteChange，监听从 hashchange 换成 popstate；
service-worker.js 的推送通知点击跳转手动改写成同样的路径格式（这个文件在打包之外单独执行，
没法 import Navigation）。index.html/index-dev.html 加了 <base href="/">——所有静态资源引用
都是相对路径，hash 路由下页面路径永远是 /，换真实路径后深层地址刷新会按当前目录解析出错误
资源地址导致白屏，这一行是标准修法。nginx.conf 的 try_files 兜底规则本来就适用两种路由，只
更新了注释。
实机验证：地址栏不再有 #；点击会话/设置等各类视图正常跳转；浏览器前进后退和应用内"返回"
按钮都正常；收藏页内部的类型 tab 切换（navigateReplace）确认不产生新的历史记录；在会话页/
个人中心页刷新、直接用完整深层路径打开新标签页都能正确恢复到位，资源正常加载不白屏。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-07 21:00:39 +08:00
Your Name and Claude Sonnet 5
4773ee5f64
修复"解散群组"仍用原生 window.confirm()，是本文件唯一未统一的危险操作确认弹层
...
现象：本工程已经在"退出当前登录"那次修复（46a98782）里明确认定原生 window.confirm()
和其余确认弹层不一致、且在部分内嵌 WebView/kiosk 环境下会被直接禁用（同步对话框调用
无提示地恒返回 false，操作被静默拦下且用户毫无感知）。全仓库复查后发现"解散群组"是
group-management-view.jsx 里唯一还在用这个模式的危险操作——同样不可逆、后果同样重大，
却没有跟上那次统一。
修复：改成两段式状态（先点"解散群组"进入确认态，再点确认态里的"确定"才真正调用
delTopic），复用本文件 OwnerSelect 早就在用的同款弹层视觉语言
（.group-sheet-backdrop/.group-confirm-sheet），不再依赖浏览器原生对话框。
验证：真实浏览器操作，用真实账号在真实群里走了"点解散→点取消"（弹层消失、群未受
影响、群列表可正常继续访问）和"点解散→点确定"（原生 WS {del hard:true} 成功执行，
200 ok，正确跳转回群列表且群已从列表消失）两条路径。
顺带记录：content-library-view.jsx 的收藏批量删除也还在用裸 window.confirm()，
是同一类问题，但属于第七章范围，本轮不动，留给对应章节的测试处理。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-06 16:30:06 +08:00
Your Name and Claude Sonnet 5
53e28e3bc6
修复"我在本群的昵称"保存时硬编码 version:0，与本文件其余乐观锁写法不一致
...
现象：GET /groups/{topic}/members/me/profile 实测确认真实带 version 字段（非空），
但 MyNicknameEditor 保存时一直硬编码 updateMyGroupProfile(topic, value, 0)，从不使用
这个已经到手的真实版本号。
根因/影响：跟本文件其余"编辑单个字段+乐观锁"写法（GroupNameEditor/
GroupDescriptionEditor 用 getGroup 拿到的真实 version；Governance/OwnerSelect 的
注释更明确写过"version<=0 时服务端会整个跳过乐观锁 WHERE 子句，两次几乎同时的写入会
静默覆盖，没有冲突信号"）不一致。实测验证这里同样如此：真实 version 是 1，PUT 时传 0
依然 200 成功，服务端自己把 version 推到了 2——多标签页/多端几乎同时修改自己在本群的
昵称时，后写入的会静默覆盖先写入的。
修复：GET 到的 version 存进 state，保存时原样带上，不再硬编码 0。
验证：真实浏览器操作，改群昵称两次，第二次 PUT 请求前 GET 到的 version 正确是上一次
保存后服务端返回的版本号（1→2→3 依次递增），不再是硬编码的 0。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-06 16:17:03 +08:00
Your Name and Claude Sonnet 5
64021fe428
补上"邀请好友入群"功能，POST /groups/{topic}/invitations 真实可用但前端零调用点
...
现象：docs/images/内容沟通对话3-开启进群验证与拉人状态.png 里"你邀请时间旅行者、
李惠惠加入群聊"这条系统事件证明产品设计里确实有"从我的好友里直接选人邀请进群"这条
路径；im-api.js 的 inviteGroupMembers()（POST /groups/{topic}/invitations）也早就
封装好，服务端接口本身可用（实测确认：请求成功返回 pending 状态的邀请记录，对方会在
跟我的会话里收到"邀请你加入群聊。立即加入"卡片）。但全仓库检索这个函数零调用点——
群聊设置页成员格的"添加"格子原来点了只弹一句"请通过转发/分享群二维码邀请成员"，把
这条真实存在的路径堵成了唯一路径（二维码分享走的是另一条"申请入群待审批"的路，跟
"邀请"语义不同，不能互相替代）。
修复：新增 InviteFriends 组件（复用 MemberPicker 同款字母分组多选布局），数据源换成
好友列表并按当前群成员名单过滤掉已在群里的人，选中后调用 inviteGroupMembers；
GroupSettings 成员格的"添加"改为跳转到这个新页面。
顺带修复一处会导致这个新路由完全打不开的既有陷阵：tinode-web.jsx 的 SIDE_PANEL_VIEWS
是一份独立于 group-management-view.jsx 自己 GROUP_MANAGEMENT_VIEWS 的硬编码合法视图
名单（文件里 104-107 行注释解释过这就是历史上"新增路由忘记同步这份名单导致深链被清空"
的同一类坑）——只在后者加了新路由名、没有同步这份名单，会导致 handleHashRoute 判定
"Unknown sidepanel view" 直接不渲染侧栏，新页面点了跟没点一样，一并补上。
验证：真实浏览器操作，两个全新注册账号（好友关系），从群设置页"添加"格子进入，勾选
好友、点完成，对方在跟我的会话里收到真实的"立即加入"邀请卡片，群设置页成员数不变
（邀请只是待确认，尚未入群，符合预期）。邀请确认接受这一步会 500，是已知后端问题
（新增72，AcceptInvitation 里一处表名/字段名写错，见 im_be/server/db/mysql/
tenant_groups.go:448 用了不存在的 subscriptions/Topic/User 而不是 im_subscriptions/
topic/userid），不是本次改动引入。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-06 15:58:24 +08:00
Your Name
fa2288c497
修复群文件上传不传file_type，图片/视频/语音群文件全部显示成通用文件图标
...
根因：POST /groups/{topic}/files 的 file_type 是客户端登记时自己声明的字段（im-api.js的
addGroupFile早就留了这个参数），不是服务端拿mime_type反推的——实测：上传一张mime_type
正确记成"image/png"的图片，只要请求体不带file_type，服务端就把它落成字面量"file"（不是
留空）。GroupFiles的onFile上传流程一直没传这个字段，导致FILE_TYPE_META准备好的
image/video/audio/document四种彩色图标从未被真正用上，所有群文件不分类型清一色显示灰色
通用文件图标。
修复：新增fileTypeFromMime辅助函数（与content-library-view.jsx的同名函数用同一套mime前缀
优先、扩展名兜底文档类型的判断口径），上传时算出分类一起传给addGroupFile。
验证：真实浏览器上传一张PNG，接口返回file_type从"file"变成"image"，列表图标从灰色通用
文件图标变成绿色图片图标；对照同一会话里upload-fix之前的旧文件，图标仍是灰色（存量数据
不受影响，符合预期，不需要也没有接口能批量回填旧记录）。
2026-09-06 13:47:19 +08:00
Your Name and Claude Sonnet 5
8b51fd3eb8
修复通讯录顶部入口箭头图标错位、群管理员列表移除后读到服务端过期缓存
...
- .people-entry-list > button 是4列grid，最后一列专留给箭头图标，但"新朋友"未处理申请数为0/
"群组"/"文件助手"/"系统消息"这几个入口没有badge时，JSX只渲染3个真实子元素，grid自动布局
把箭头挤进第3列——实测空出623px空白，图标紧贴文字，完全不是贴右对齐效果。改成显式
grid-column:4 钉住箭头位置，不再依赖前面到底渲染了几个兄弟节点。
- AdminList移除管理员后紧接着的load()重新查询命中了服务端对这个查询形状的过期缓存，界面上
刚移除的管理员会短暂"复活"。改成移除成功后直接用已确认生效的结果本地更新state+patch共享
缓存，不再指望立即重新查询能反映刚发生的变更（这个缓存问题本身是后端"新增7"已记录的问题，
重新查询本身没有办法绕过，前端这次做的是不依赖它）。
均已用真实DOM结构/computed style确认修复生效。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 18:23:19 +08:00
Your Name and Claude Sonnet 5
d759f67b11
第八轮最小粒度测试：修复CSS选择器/JSX结构不匹配的一整类bug，清理Tinode品牌残留
...
第八轮改用"读CSS选择器+核对JSX结构"的方式复测全部11章，命中了7轮纯接口测试从未发现的一类
问题——选择器写对了但目标元素的实际DOM结构/className对不上，样式静默失效：
- 语音通话最小化胶囊按钮尺寸被同特异度规则覆盖；移动端悬浮通话窗口left/right/width三值同时
生效导致过度约束；来电全屏页认证徽章/姓名标题缺少专属样式覆盖
- 我的收藏-语音卡片三列grid对应实际只有1个子元素，播放器被压缩到卡片左侧一角；链接/记录头部
完全没有基础样式，退化成浏览器默认外观
- 多选模式下"收到的"消息气泡被flex auto-margin一起拖到最右侧；.avatar-box/#send-message-panel
两处逗号断句错误导致后半句选择器丢失祖先限定
- 按住说话悬浮反馈渲染成内联胶囊，而参考图要求的居中悬浮卡片样式其实已经存在（挂在了另一个非
生产demo组件上）；批量转发确认框沿用了80%视口高度；audio-player.jsx的playback类点在canvas
上而非包裹层，波形和计时器可能纵向堆叠
- "消息已撤回"占位符误拼了日期分隔条的class而非专属的deleted
品牌清理：浏览器标签页标题、未读数标题更新均硬编码"Tinode"；LINK_CONTACT_US等三个链接常量
指向开源Tinode项目自己的域名（联系我们改为跟用户条款/隐私协议一致的toast，不再发起外部mailto）。
以及：空会话丢失.chat-box样式类、青少年模式PIN定位、若干收藏/文件类型展示细节。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 17:09:42 +08:00
Your Name and Claude Sonnet 5
e66550867c
修复群资料页箭头图标参差不齐
...
"群头像"/"群二维码"两行没有其它行都有的 <small>（靠 margin-left:auto 把末尾箭头推到最右），
末尾图标紧贴在文字标签后面，导致整页箭头图标一个贴左一个贴右，参差不齐。给这两行末尾图标
直接加 margin-left:auto，跟其它行的箭头对齐到同一条竖线上。
（过程中试过给文字标签加 margin-right:auto 间接推挤，实测反而导致标签本身被推到行中间，
不是预期效果，改为直接在末尾图标自己身上加 margin-left:auto，语义更明确也更可靠。）
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 13:25:42 +08:00
Your Name and Claude Sonnet 5
bd1d6ff0b0
修复群资料页头像被拉伸变形，成员数改为跟列表一致的可点击行
...
- .group-profile > button > span 漏排除 .group-avatar，把只该用于文字标签列对齐的
min-width:6rem 也套到了头像 span 上，头像被横向拉伸成80px宽的长方形而不是正方形
- 底部"N位成员"原来是一个孤立的灰底纯文本 <p>，样式和上面的列表格格不入；改成与其它
行一致的可点击行，点击跳转真实的群成员列表页（复用群聊设置页已验证过的同一个跳转）
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 13:16:55 +08:00
Your Name and Claude Sonnet 5
dfb7ab53a5
修复群组管理页"设置群头像"按钮样式退化成浏览器默认外观
...
.group-governance 下所有行样式都挂在 "section > button" 选择器上，这一个按钮没包在
<section> 里，完全没吃到列表行样式（全宽/分割线/内边距），退化成一个居左的灰色圆角
小按钮。包一层 <section> 即可，其余4个链接本来就是这样。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 13:08:57 +08:00
Your Name and Claude Sonnet 5
bede45fd7f
第七轮深度测试：修复7个agent发现的12处前端问题，重点是列表分页截断与呼叫/播放状态机
...
- 通话状态机（Ch8）：canStartCall 补齐通话中重复发起的防护，callShouldStart 补齐放弃/失败路径的清理
- 分页截断（Ch5-6）：新增 fetchAllPages 辅助函数，修复通讯录/黑名单/好友申请/群成员/管理员/禁言等
11 处列表只读首页导致真实成员被遗漏的问题；群角色判断改用不受分页影响的 getGroup().my_role
- 消息与媒体（Ch3-4/Ch7/Ch9）：录音超时污染时长、手动重试丢失 head 导致消息被错误分类、批量删除
未取消上传中附件、语音播放器补齐同时只能播一条、workplace-collaboration-view 冗余重试请求
- 独立密码/青少年模式（Ch10-11）：设置密码后按调用来源判断是否应自动开启青少年模式，避免关闭流程
中途"忘记密码"被误当成开启；注销账号确认文案补充群主后果说明
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 12:18:25 +08:00
Your Name and Claude Sonnet 5
f42b8536e5
第六轮深度测试：7个并行agent覆盖全部11章，修复21处前端问题
...
Ch1-2: 用户名注册邀请码错误改为友好文案(原为原始TypeError泄露给用户)；
企业注册页扫描图标补上点击反馈。
Ch3-4: 发名片消息补传typeHint(此前被后端误分类成text，搜索/历史摘要显示成JSON)；
文件卡片按mime大类区分图标颜色(此前所有文件都是同一个灰色通用图标)；
表情面板补上专属退格/发送按钮(浅蓝禁用/深蓝启用两态)；订正一处与截图不符的代码注释。
Ch5-6: 群聊设置页"群成员"补上可点击的完整成员列表页(复用MemberPicker字母分组)；
群文件页去掉无依据的硬编码"/10GB"容量上限显示。
Ch7: 收藏点击图片/视频缩略图补上预览；"查找聊天记录-链接"tab补上定位回原消息；
文件下载页返回入口按来源tab纠正；批量转发成功计数改为按目标会话去重
(原公式混用"收藏条数"和"目标会话数"两个维度，混选多条收藏转发时可能显示负数)；
收藏/视频tab切换补上URL路由同步。
Ch8: topic.onInfo在通话期间补上事件转发(此前通话中"对方正在输入"和已读回执静默失效)；
主叫等待接听页补上"正在等待对方接受邀请…"文案；语音通话最小化胶囊的还原按钮移出
拖拽区域(原来嵌在draggable内部，指针捕获可能吞掉点击)；修复中等窗宽(641-750px)下
本地摄像头预览遮挡"切换摄像头"按钮的CSS重叠。
Ch9: 部门树展开时跳过child_count=0的注定空请求；月报字数上限从硬编码1000改为读取
后端真实的10000；发起会议补上"结束时间需晚于开始时间"的本地校验和更具体的报错；
日报/月报统计接口补上department_id透传(此前包装函数注释断言后端会忽略，实际已支持)。
Ch10-11: URL风险检测补上g标志(原来一条消息只检查第一个链接，第二个链接哪怕是高危
也不会被拦截)；补上"安全教育"设置入口(原功能完整实现但零入口，需手改hash才能打开)；
修改密码按钮补上busy态反馈；青少年模式PIN页补上"忘记独立密码"入口(后端已支持重置，
前端未接)；"关于我们"补上"联系我们"行。
7个agent同时对全部11章存量后端问题条目逐一复核，结论详见待整理的后端问题清单更新
(Ch1-2发现一条P0级后端问题：验证码固定值"123456"，已记录未修复，不在此commit修改
im_be仓库范围内)。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 03:48:28 +08:00
Your Name and Claude Sonnet 5
d42591284f
第五轮深度测试：管理员撤回、所有人@提醒、失效附件UI，并核对现存后端问题清单
...
- messages-view.jsx: 拖拽发送/回复菜单在编辑态下的旁路修复；群主/管理员可撤回他人消息
(对齐后端 authorizeIMMessageMutation 的 allowAdmin)；新增"所有人"@提醒(head.mention_all)。
- chat-message.jsx: system_action 头类型消息按 system_notice 同款渲染(此前显示"内容无效")。
- content-library-view.jsx: 语音/链接/图文收藏与聊天记录卡片补上 removed(已失效)态UI，
之前只有 FileCard 处理了这个状态。
- call-panel.jsx: handleVideoOfferMsg(5步.then链，用reject sentinel跳过后续步骤)、
handleToggleSpeakerClick 补组件卸载守卫，修完此前遗漏的两处。
- group-management-view.jsx: 治理开关(Governance.setField)和群主转让(OwnerSelect)
补上乐观锁 version 参数(此前从不传，服务端 version<=0 时会跳过冲突检测)；群文件搜索框
文案承诺"搜索文件名或者上传者"但服务端q参数只匹配文件名，改为拉取全量列表本地按文件名+
已解析的上传者昵称一起过滤；群公告详情页补上从未被调用过的已读上报(readGroupAnnouncement)。
以上均用真实账号在浏览器/直接请求验证：管理员撤回、system_action渲染、mention_all、
文件按上传者搜索、公告已读上报(200)、治理开关stale-version探测确认409冲突检测生效。
7个并行测试agent对全部11章做了第二轮回归+现存后端问题清单逐条复核，结论待整理进
docs/IM-后端问题清单*.md（全部现存条目复核后均建议保留，多条证据强度从推断升级为已验证）。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-05 02:07:47 +08:00
Your Name and Claude Sonnet 5
93b856aec8
第三轮深度测试：修复7个并行agent发现的前端问题，含REASON_MESSAGES系统性补全
...
派了Ch1-2/3-4/5-6/7/8/9/10-11共7个agent对全部11章重新深度测试。后端问题已核实追加进
docs/IM-后端问题清单-2026-09-04.md（新增6-9条，发给用户）；本次是前端问题的修复。
**REASON_MESSAGES系统性补全（最高优先级，多个agent独立发现同一个缺口）**
im-api.js的REASON_MESSAGES表新增22个条目，最重要的是PERMISSION_DENIED——后端
server/im_http.go里403响应统一用这个reason（30余处调用），但表里原来只有一个从未
被后端实际发送过的死条目FORBIDDEN，导致全站几乎每一个403从工程一开始就在展示原始
英文"permission denied"。一并补上VERSION_CONFLICT/MALFORMED_REQUEST（Ch9 agent实测
命中）、NOT_FOUND、VERIFICATION_RATE_LIMITED（动态文案，同TOO_MANY_ATTEMPTS模式）等。
新增translateReason()导出函数并用于send-message.jsx的sendFavorite——favorites/forward
等几个批量接口恒定200、真实成败包在items[].reason里，imRequest的自动翻译够不到这种
per-item场景，之前直接显示原始reason字符串。tinode-web.jsx同理补了CTRL_ERROR_TEXT_CN
（原生WS {ctrl}协议错误，同样绕开REASON_MESSAGES）并修了原表从未真正匹配过的bug——
CommError会把状态码拼进message变成"authentication failed (401)"，原表按裸文本精确
匹配，看着正常纯粹是因为401/403兜底文案凑巧一样，一旦命中"unknown authentication
scheme"这类会被兜底文案误导、"policy violation"这类会直接漏出英文。uploadLargeFile/
createChatUploader/createFileDownloader同样绕开REASON_MESSAGES（走原生{ctrl}协议），
补了UPLOAD_CTRL_TEXT_CN小词典。已用真实账号端到端验证：favorites/forward到P2P目标
触发的PERMISSION_DENIED现在正确显示"没有权限执行此操作"；draft接口版本冲突正确显示
"内容已被修改，请刷新后重试"。
**编辑消息时打开附件面板会静默覆盖被编辑消息（Ch3-4 agent发现，数据损坏级别）**
sendMessage对editing状态一律用head.replace，但onAttachFile/onAttachImage/onAttachAudio
原来只在forwardMessage时置空，编辑态没有同款门禁——编辑一条消息不改文字、点"+"选张图片
或名片，会直接把附件内容替换掉被编辑消息的原文，无任何确认。messages-view.jsx新增
editingMessage门禁，和forwardMessage一样把三个attach回调置空（等价于隐藏整个"+"按钮）。
已用真实浏览器验证：编辑态下"+"按钮消失，取消编辑后正常恢复。
**草稿防抖单一共享定时器丢字（Ch1-2、Ch3-4两个agent独立发现）**
handleComposerChange用单个this.draftSaveTimer，话题A打字触发600ms保存后300ms内切到
话题B，会把A的定时器clearTimeout掉，那次输入永久丢失；version也在定时器触发时才重新
读state，此时可能已经在别的话题上，退化成硬编码0——叠加后端draft接口对version=0"无条件
跳过乐观锁"的行为（已记入后端清单新增6），可能静默覆盖别的标签页写入的更新草稿。改为
按话题分开的定时器map，version在调用的当下（保证仍在该话题）同步捕获进闭包。
**呼叫状态机两处真实bug（Ch8 agent此前发现，本次重新核实live代码后确认+修复）**
1. 通话中导航离开messages-view.jsx整个组件树（切到工作台/个人设置，或移动端切回会话
列表）时，没有任何hangup清理——componentSetup已有的"切换话题时正确挂断"逻辑只在
componentDidUpdate里，组件真正卸载时不会触发。CallPanel自己的componentWillUnmount
只做本地清理，不通知对方也不重置tinode-web.jsx顶层callState，导致下次切回通话话题
时remount出一个callState卡在CALL_STATE_IN_PROGRESS的"僵尸"面板——start()走"我们刚
接听"分支直接return，从不调getUserMedia，本地媒体永久拿不到。补了对称的
componentWillUnmount挂断逻辑。
2. this.callTimeoutTimer声明后从未被真正setTimeout赋值——呼出无人接听或accept信令
（fire-and-forget的{note}包）被丢会永久卡在"呼叫中"。补了armCallRingTimeout()，
60秒未接通按跟手动取消完全一样的路径挂断（不发明新的通话结果语义），在收到对方
accept信号的两处分支都正确清timer。
**其余前端修复（按文件）**
- messages-view.jsx: @提醒mentionedUsers只在切话题时清空，同一话题内后续消息里字面
文本"@张三"会被静默解析成真实提醒（发送后清空）；jumpToMessage点开已撤回/删除的
搜索结果原来只console.error静默失败，补了用户可见的错误提示；批量收藏对
favorites/batch共享Idempotency-Key导致的静默丢失（已知后端问题）不再照单全收
"收藏成功"，改为发送后重新拉取真实收藏列表核对每条是否真的落地。
- audio-recorder.jsx: getUserMedia权限弹窗未决出结果时组件被卸载，补_unmounted
标记避免在死实例上继续跑mediaRecorder.start()。
- send-message.jsx: disabled变为true时（对方拉黑/被禁言等实时ACS变化）没有强制结束
正在进行的按住录音，可能remount出无用户手势的"自动录音"；mouseup/touchend覆盖不到
拖出窗口/切换标签页/权限弹窗抢焦点的释放场景，补了blur/visibilitychange兜底。
- tinode-web.jsx: messages-menu视图和messages-home共用MessageCenterView实例无key，
从messages-home以非整体刷新方式切到messages-menu时菜单打不开，补key={view}。
- message-center-view.jsx: 实名认证驳回提醒的dismiss key只按用户+状态区分，同一状态
的两次独立驳回会互相误压制，改按submission_id区分。
- contact-management-view.jsx: Profile/Settings靠getUserProfile刷新拉黑状态，但该
接口对被拉黑对象直接403，导致"之前会话就已拉黑"的场景完全感知不到——叠加
getConversationContext兜底（该接口对拉黑目标正确返回200+relationship）。
- group-management-view.jsx: AdminList显示群主/管理员姓名漏了group_nickname兜底；
JoinRequests从聊天页横幅进入时返回按钮硬编码回group-settings（应回聊天本身），
从Governance进入时返回group-settings而非group-governance（与AdminList/Muted不一致）。
- workplace-collaboration-view.jsx: OrganizationDirectory/DeptNode的部门树加载失败
被无条件当成"暂无数据"渲染，补loadError区分+重试链接。
- personal-settings-view.jsx: CacheClear对navigator.storage/caches整个不存在的情况
只有react出了范围的.catch()覆盖不到的同步抛错，加了特性检测+try/catch；
YouthModeVerify触发TOO_MANY_ATTEMPTS锁定后确定按钮没有禁用/倒计时，会继续发出
注定失败的请求。
- security-support-view.jsx: 意见反馈category字段在config未加载完成前可为空但没有
提交前校验，会打到后端400。
- use-cached-data.js: bootstrap等首次拉取失败且无缓存兜底时永久停在undefined，加了
一次3秒后重试（仅在完全没有缓存值时触发，已有缓存值维持原"显示旧数据"行为不变）。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-04 23:29:52 +08:00
Your Name and Claude Opus 5
7728afe79f
群主转让加一步密码二次确认，跟账号注销/改密码等其它高风险操作保持一致（第6章复测发现）
...
serveIMGroupOwnerTransfer 核实过：只认 {target_user_id, version}，没有任何
action_token/二次验证机制——不是文档滞后，是这个操作本身就没有服务端强制的二次
确认。但转让群主同样不可逆、后果同样重大（"确定后你将立即失去群主身份"），本项目
对同一类场景已有明确先例：personal-settings-view.jsx 的 DeleteAccountConfirm 就是
纯前端加的密码输入门槛，不指望服务端校验它，只是让"手滑点确定"变成需要多打一遍
密码才会发生的事。
OwnerSelect 原来点目标人选后只有一层"确定/取消"的确认表，点确定直接调用真实转让
接口。现在拆成两步：第一步维持原有确认文案不变，第二步新增密码输入，留空点确定
会被拦下（不发请求），填了任意内容才真正调用 transferGroupOwner。
真实验证（真实群+真实候选人）：空密码点确定确认没有发出请求；填入密码后
transferGroupOwner 真实调用成功，正确跳转回群组管理页。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-04 17:04:26 +08:00
Your Name and Claude Opus 5
3a78c40389
修复创建群聊名称长度上限与编辑页不一致的问题（第6章复测发现）
...
创建群聊弹窗的名称输入框 maxLength 是30，但群资料页的编辑器（GroupNameEditor）
是11——两者编辑的是同一个 group.name 字段，建群时能起最多30字的名字，进编辑页
却连原样保存都做不到（打不满30个字符，且无法回退到超过11字的原值）。
核对参考图 设置昵称(1).png：这个字段的编辑器明确画的是"0/11"上限，没有任何一张
图支持30。后端本身不做长度限制（实测 PATCH 17 字符的名称成功),11 纯粹是前端自
己的约束，应该是创建页和编辑页保持一致，而不是让创建页放宽成一个没有依据的数字。
改为创建弹窗也用 maxLength="11"，跟编辑页对齐。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-04 14:46:25 +08:00
Your Name and Claude Sonnet 5
997f8f71d2
修复群成员非好友主页文案错误、添加好友按钮永不出现（第5章复测发现）
...
navigateToProfile 原来只从群成员列表数据（{acs, display_name, group_nickname?, mentionable,
role, user_id}）里摘字段做种子缓存，这份数据里根本没有 capabilities/relationship——Profile
组件正是靠这两个字段判断"要不要显示添加好友按钮"和"该显示哪句失败文案"。缺了它们，非好友的
群成员主页会落到 cannotAddReason 的默认分支：不管真实关系是什么，一律显示"好友申请正在等待
验证"，添加好友按钮永远不出现。
Profile 组件自己的 getUserProfile(uid) 对非好友是 403（服务端隐私默认），403 时会保留种子
不报错——这个保留种子的兜底本身是对的，问题是种子从一开始就没给对数据。
改用 GET /groups/{topic}/members/{user_id}/profile（getGroupMemberProfile，早就封装好但
零调用点）——群上下文里权限判断更宽松，实测对方哪怕不是好友也能拿到
{capabilities, relationship}。navigateToProfile 现在异步补种：跳转后台发起这个请求，回来后
用真实数据覆盖种子并派发一个事件让已经挂载的 Profile 重新读取。
已用真实账号验证：点击群成员头像后，getGroupMemberProfile 真实请求 200，返回
relationship:"friend"、capabilities.can_add_friend:false；Profile 组件的 React state 和
最终渲染的 DOM 都正确更新成"发消息/音视频通话"（通过 React Fiber 直接读取 state 确认，不只是
看界面文字）。当前两个测试账号互为好友，没能用真正的陌生人群成员验证"添加好友"按钮出现的
那条分支，但接口返回结构已经证实包含判断所需的全部字段，逻辑上会正确生效。
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-04 13:56:26 +08:00
Your Name and Claude Opus 5
c709abbfa4
修复全页面走查发现的问题（第六批：交互反馈时序）
...
- contact-management-view: "分享给好友"走剪贴板分支时不给任何反馈，点了界面上毫无动静
（同页 QrPage.share 是有 toast 的）；生成二维码失败也被 .catch(()=>{}) 静默吞掉。
三条路径都补上反馈。
- group-management-view: 添加管理员/禁言成功后 900ms 就导航，而 CenterToast 生命周期是
1400ms —— 导航会让整棵子树重挂载把 toast 一起销毁，参考图里那个「设置成功」实际只闪一下
就被截断。改成 1500ms。
回归验证（本轮全部改动）
- 41 个路由逐个访问：零 JS 错误、零 unhandled rejection、零空白页。
- 22 个页面布局扫描：无横向溢出、无文字零高度、无图标未居中。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-03 19:02:15 +08:00
Your Name and Claude Opus 5
35d3e1cf6b
修复全页面走查发现的问题（第四批：精准查找、隐私锁定、搜索防抖）
...
精准查找搜不到手机号（第5章 5.5）
- 一直写死 type=exact_account，而该分支只比对 profile.public_account / u.username / u.id
（tenant_adapter.go:9170-9172），**不匹配 u.phone**。参考图 5.5 里输的恰恰是手机号，
这个场景必然搜不到。改为按输入形态分流：11 位 1 开头走 type=phone。
- phone 分支服务端不做 E.164 归一化（只有模糊的 account 分支才调 normalizeUserPhone），
库里存的是 +86 开头，所以裸号码由前端补区号——注册流程本来也是这么拼的。
- 已用真实后端验证请求正确路由为 q=%2B8613800001188&type=phone。
隐私设置忽略 editable（第10章 10.12/10.13）
- 后端 userPrivacyPayload 返回 editable{add_me_methods, profile_visibility,
last_seen_visibility, read_receipts} 表达"企业强制策略锁死了这一项"，前端完全没读。
被锁的开关照样能点，点了 400 再回滚，用户只看到开关自己弹回去。现在禁用并给出说明文案，
同时补 .personal-switch:disabled 的视觉反馈（否则看不出为什么点不动）。
搜索防抖
- 新增共享的 useDebouncedValue，用在三处真正发服务端请求的搜索：收藏、会话内检索、
群列表、群文件。原来 query 直接进 effect 依赖，每敲一个字符发一次请求；群列表更糟，
reload 对三个分类各发一次，一个字符就是 3 个请求。而且返回顺序没有保证，后发的短前缀
请求可能后到、把正确结果覆盖掉。
- 实测：群列表输入 4 个字，请求数从 12 降到 3。
- FavoriteShare 那处搜索是本地过滤 chatList、不发请求，没有动。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-03 18:56:41 +08:00
Your Name and Claude Opus 5
02b98cceae
修复全页面走查发现的问题（第二批：登录、通讯录、群聊）
...
第1章
- tinode-web: 手输密码登录失败会 navigateTo('') 把用户弹回企业码页，刚输的账号丢了，而
TenantEntry 不渲染 FormAlert，那句错误提示根本看不到。改成只有存储的 token 失效才回登录入口。
- auth-onboarding IdentityCheck: 限流 429 时服务端会连同未过期的 challenge_id 一起返回，
原来只显示错误文案、challengeId 留空，于是 submit 开头的守卫静默吞掉点击——输完验证码点
"确定"毫无反应也无提示。同文件 VerificationButton 早就处理对了，这里是漏抄。
- auth-onboarding Register: 手机号注册路径硬传 invite_code:''，把用户填的邀请码丢了。后端
user.go:175-181 对邀请码的校验和 RecordUse 不区分注册路径，UI 上也摆着这个输入框。
第5章
- 好友列表主副行显示同一串字：后端在有备注时把 display_name 也设成备注（im_http.go:8500-8507），
两个字段同值。加"不同才显示"的守卫。
- 拉黑确认弹窗把设置页当背景渲染并摆出"操作之后"的样子，但背景组件自己的 getUserProfile
回来后又把开关改回未拉黑、"删除好友"红条重新冒出来。加 pinBlocked 挡住这次覆盖。
第6章
- 群列表把群名显示成 topic id、成员数恒为 0。根因在后端：handler 用 store.Users.GetSubs，而
store 自己的注释就写着它 "Does not load Public/Trusted or Private"（store.go:834-835），
groupListItemPayload 却去读 sub.GetPublic()/GetSubCnt()（应该用 GetTopics）。已记为后端问题；
前端先用本地 Tinode 会话缓存兜底（消息首页一直这么取，是准的）。
- 禁言页每行头像画成群组图标（Avatar 兜底图标默认 'group'，没传 icon="person"），
且顺带从成员表带上真实头像。
- 禁言页"以上成员不允许发言"被当成空状态用，语义正好反了——有禁言成员时这句消失、
一个都没有时反而显示。改为列表下方常驻注脚，空态另给文案，并补 .group-inline-note 样式。
- bytesToGB 只输出到 MB，1.4GB 的文件显示成 "1433.6 MB"。
- 群文件"来自"直接显示裸 uploader_id（groupFilePayload 不给昵称），拉成员表交叉引用。
- 群公告从聊天页横幅进入后返回，会把会话一起关掉：navigate 只写 query 参数，path[1] 仍为空，
handleHashRoute 就把 topicSelected 清成 null。Header 支持 onBack，显式把 topic 写回 path[1]。
- 群成员点头像打不开非好友资料页：目标页先读 'profile-seed:' 缓存，因为 getUserProfile 对
非好友直接 403。第5章入口一直有 seed，这里漏了。
- 群简介上限 225 超过后端硬限 200（im_http.go:4667），写满必被打回。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-03 18:40:53 +08:00
Your Name and Claude Opus 5
5a07bb4e3b
修复全页面走查发现的 P0 前端问题（第一批）
...
八个 agent 对 11 章逐页对照设计稿+后端源码后，先修其中"功能不可用/崩溃/谎报成功"级别的：
崩溃与数据错误
- content-library-view: Highlight 按 [start,len] 数组解构后端返回的 {start,end} 对象，
对象不可迭代会直接抛 TypeError，任何文本搜索命中都让整个结果区渲染崩掉。服务端偏移还叠加
两个问题（Go 字节下标 vs JS UTF-16；偏移基准是全文但 snippet 会被开窗截断），改为在展示
文本上本地匹配关键词。
- content-library-view: firstAttachment 用 Drafty.attachments，SDK 里硬过滤 tp=='EX'
只认文件附件，图片(IM)/视频(VD)/语音(AU) 一个都取不到——收藏缩略图、语音播放源、聊天记录
图片视频宫格全部拿不到资源。改用 Drafty.entities 按类型分派（chat-message.jsx 已有先例）。
- message-center-view: 系统通知的机器码兜底会把真实数据吞掉（日报提醒的 summary 就是日期
字符串 "2026-08-20"，会议通知的 summary 是标题），改为查表命中才替换。
- message-center-view: 会话列表漏了 avatar 字段，每行都只能落到兜底图标；同文件
frequentContacts() 本来就是对的，照它补上。
功能不可用
- auth-onboarding-view: 首次开启青少年模式是死路——设完密码丢弃了服务端返回的
enable_action_token，从不调 enableYouthMode，用户走完短信验证+设密码后模式仍是关的。
现在拿着这个 token 把最后一步做完。
- group-management-view: "投诉/举报"是个 onToast('暂未开放') 死桩，而 target_type='group'
这条链路早就通了。接上真实举报页。
- tinode-web: 刷新/深链会被弹回首页。两个原因叠加：初始化白名单还是上游 Tinode 的
['cred','reset','register']；handleLoginSuccessful 无条件把 hash 改写成 workbench，
刷新触发的自动登录也走这条。抽出 SIDE_PANEL_VIEWS 常量复用，并区分登录流程与自动登录。
- widgets/meta-message: deleted 分支从未实现，撤回一条消息后时间线上什么都不剩。
谎报成功 / 判定错误
- tinode-web + personal-settings-view: 改密码不返回 Promise，服务端拒绝时照样弹"密码已更新"。
- group-management-view: 禁言批量读 result.succeeded，但该接口返回的是 {topic, items}，
succeeded 恒为 undefined，不管成没成都弹"设置成功"。两个接口结构不同，分开判定。
- workplace-collaboration-view: 会议取消状态写成 'cancelled'，后端是 'canceled' 单 l，
会议取消后"取消会议"按钮还挂着。
样式与显示
- base.css: 删掉旧版 .organization-department 的 padding-left !important，它压过按层级算出的
内联缩进，导致部门行全平、只有人员行缩进。
- base.css: 补 .youth-password-gate（原来 0 条规则），PIN 框缺 position:relative 和居中。
- security-support-view: shield_lock 不在经典 Material Icons 里（只有 Symbols），会显示成
字面文本；.risk-info-page 也是 0 条规则，整页渲染成裸项目符号列表。改用 verified_user 并
补上 .risk-dialog。
- contact-management-view: 好友资料页性别直接输出后端枚举，显示成 "male"。
- workplace-collaboration-view: 层级标注两条路径两种格式（树形深三层变"3级"、搜索硬传"三"），
统一成一个 helper。
已记录不在前端修的后端缺口：recallMessage 的 version 只能传 1，因为所有消息读取接口
（messagePayload/messageSearchPayload/mediaMessagePayload/favoriteSnapshot）都不下发 version，
冲突错误里也不回传真实值，被编辑过的消息撤回必然失败。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-03 18:31:26 +08:00
Your Name and Claude Opus 5
f7bc98811e
群聊设置：重做成员预览区，修掉错位间距、多余横线和被压扁的名字
...
用户实机截图反馈这块"图标和间距有问题"。对照 docs/images/群聊设置.png 逐项查证，实际有四个独立
缺陷叠在一起：
1. 多余横线：成员容器 div 和邀请按钮都是 section 的直接子元素，命中了通用列表项样式
（.group-settings section > button/div 带 border-bottom + min-height + padding），
于是这一块被当成两个普通设置行渲染，凭空多出两截下划线。
2. 间距错位：原来是 flex 布局，成员列表 flex:1 占满剩余宽度，把邀请按钮一路挤到最右，两者之间
出现一大片空白；参考图是等宽网格。
3. 名字看不见：全局 button 规则（base.css:1999）写死 height/line-height 2.2rem，成员格子没有
覆盖它，整个格子被压到 29px 高——48px 的头像直接溢出，名字被压成 0 高度，实测
getBoundingClientRect().height 为 0。
4. 图标撞车：成员头像的兜底图标沿用了 Avatar 的默认值 group（双人图标），跟上方群头像长得一模
一样，分不清哪个是群哪个是人；改传 icon="person"。
改成参考图的结构：一行"群成员"标题（右侧显示人数）+ 5 列等宽网格，最后一格是与头像同尺寸、
同圆角的浅色"添加"块。新样式用 .group-settings section > .group-member-* 提高特异性，明确压过
那套列表项规则，并显式写 height:auto 覆盖全局 button 高度。
刻意没做的两点，都是因为本分支没有对应页面，不想做点了没反应或跳错地方的入口：参考图里"查看
15465群成员"那个可点链接（没有通用群成员列表页，这里只展示人数文字），以及"删除"格（没有移除
成员的页面）。这两个缺口需要单独补页面，不在这次范围内。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-03 17:43:22 +08:00
Your Name and Claude Opus 5
3bdb0bf40f
群昵称改用专门的接口读取，修好读不回已保存值的问题
...
上一个commit修好了"群资料"页把群名称当成个人群昵称显示的问题，但实机验证发现改完仍然显示"未设置"。
抓包确认根因：GET /groups/{topic}/members 列表接口的每一项里压根没有 group_nickname 字段（只有
acs/display_name/mentionable/role/user_id），所以任何从成员列表里读昵称的写法，不管代码逻辑对不对，
都永远拿不到值——这个文件里原有的 MyNicknameEditor 也是同样的写法，同样存在这个问题（打开编辑器时
不会回填已保存的昵称）。
真正能读到昵称的是保存用的那个路径上对应的 GET：GET /groups/{topic}/members/me/profile，返回
{nickname, version, updated_at}（server/im_http.go:4776-4782）。im-api.js 里之前只封装了 PUT，
补上了对应的 getMyGroupProfile，两处读取（群资料页预览行、昵称编辑器回填）都改成用它。
实机验证：保存"测试昵称A"后重新打开群资料页，"群昵称"正确显示"测试昵称A"，"群名称"独立显示
"扫码测试群"。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com >
2026-09-03 17:20:36 +08:00
Your Name and Claude Sonnet 5
e4c6e1b246
Fix group-profile nickname preview showing group name instead of my own nickname
...
GroupProfile's "群昵称" preview row showed group.name -- the group's own display name -- instead
of the current user's personal nickname within that group (a real, distinct concept, correctly
handled by the existing MyNicknameEditor/group-my-nickname page, just not wired into this preview
row). Ported the substance of a bug dev independently found and fixed in their own reimplementation
of this same page ("show saved group nickname", found while evaluating what from dev's post-fork
commits was worth bringing over). Reuses the same getGroupMembers+filter-by-myUserId approach
MyNicknameEditor already uses in this file (there's no working "me" shortcut on the
member-profile-by-id endpoint that would let this be fetched more directly -- confirmed by reading
server/im_http.go's routing, which never special-cases that literal string).
Also renamed the adjacent "群昵称"->"群名称" label for the group's own display name field, since
having two rows both labeled "群昵称" (one for my personal nickname, one for the group's name) is
exactly the confusion that caused this bug in the first place.
Evaluated the rest of dev's post-fork commits (9 commits fixing this same page's nickname-save
reliability, plus the wholesale chapter-view reimplementation) for anything else worth porting:
the version-conflict retry logic they built doesn't apply here since this branch already sends
version:0 (confirmed server/im_http.go:4793 treats <=0 as "skip the check" -- the exact mechanism
their fix was working around a different way), and their nickname maxLength bump (11->20) is
already exceeded by this branch's existing 32, which matches the real backend limit
(server/im_http.go:4789). Nothing else from dev's branch was found applicable.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com >
2026-09-03 17:08:38 +08:00
Your Name and Claude Sonnet 5
251c9de87c
Convert im_webapp from static mock prototypes to real backend integration
...
Implements all 11 product chapters (auth, messaging, contacts, groups,
files/favorites, calls, workplace/reports, settings, security) against the
real /v1/im REST API and native Tinode WS protocol, replacing the hardcoded
mock data the ba8f48eenoreply@anthropic.com >
2026-09-03 11:40:53 +08:00
richjohnrambo
ba8f48ee83
完成 IM Web Android 端产品页面开发
2026-08-25 18:30:40 +08:00
