pro/im_webapp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,899 Commits 2 Branches 0 Tags
d01547d3de880f70f183193a76438789cd041423
Commit Graph
1899 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Your NameandClaude Opus 5 d01547d3de 重新生成 base.min.css（自9月3日起已落后11次真实CSS提交，生产环境从未见过） 
生产环境的 index.html 引用的是 base.min.css，本地/测试用的 index-dev.html 引用的
是未压缩的 base.css——这次全需求复测（含第6-11章一系列真实bug修复+今天新增的
实名提醒弹窗/群主转让确认等样式）改的都是 base.css，没有一次顺手跑
`npm run build:css` 重新生成压缩版。也就是说，这段时间验证过的每一处CSS修复，
如果现在直接照旧部署 index.html 到生产，用户会一处都看不到。

跑 `npx postcss css/base.css > css/base.min.css` 补上这次遗漏，往前追平到
c4189646 之后累计的 11 次 base.css 提交。这个文件本身是纯构建产物（postcss确定性
输出，源头 base.css 早就在开发环境反复验证过），不涉及任何新的手写代码，但下次
真正部署生产环境前必须包含这次重新生成的版本，否则等于白修。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-04 17:21:33 +08:00
Your NameandClaude 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 NameandClaude Opus 5 542aca3dc2 接线1.10实名认证提醒弹窗到真实消息首页（第1章遗留项，此前一直是孤立demo路由） 
auth-onboarding-view.jsx 的 RealnameReminder 组件此前是完全孤立的demo：自己画一套
假会话列表背景，只能靠手动改hash访问，没有任何真实入口会导航过去。核对参考图
"实名认证（安卓）.png"确认过的弹窗文案本身是对的，只是从来没有接上真实触发条件。

抽出弹窗内容（不带假背景）做成 RealnameReminderModal，挂到真实 MessageHome 挂载时
按 bootstrap.security.realname 的真实状态判断——这个字段本来就在 MessageHome 已经
在用的同一个 bootstrap 请求里，不需要额外接口调用。

参考图本身画的是不可跳过的单按钮强制态，但真实核对 im_be 源码发现这只是
required:true 那个分支的样子；这个环境的真实配置（也是目前后端唯一会返回的默认值）
是 required:false / allow_skip:true。如果照抄参考图做成完全关不掉的弹层，等于把
"实名认证目前是可选的"这个真实产品配置，实现成挡住所有人使用消息功能的强制墙——
按这两个字段分叉：允许跳过时加一个参考图没画、但后端字段明确允许的关闭按钮；且
遵守后端给的 remind_after（当前值24h），关闭后在这个时长内不重复弹，不是每次进
消息首页都弹一次。

联调中发现关闭按钮初版样式是个跟全局 button 选一样宽的圆角方块（漏了覆盖
min-width/box-shadow/margin 这几个全局 button 规则），已修正为纯图标按钮。

真实验证（账号 asn494180，真实 status:"unverified"）：弹窗内容与参考图逐句一致；
点击关闭按钮弹窗消失且 localStorage 正确记录时间戳；刷新页面重新连接后，24小时
窗口内弹窗不会重复出现；未清除记录时保持不弹，符合"提醒而非骚扰"的预期。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-04 16:40:27 +08:00
Your NameandClaude Opus 5 d21d046443 修复精准查找对拉黑关系显示"添加"，跟实际能不能添加对不上（第5章复测发现） 
/users/search 返回结果本身带 relationship 字段，服务端 imRelationshipAction() 对
blocked_by_me/blocked_by_peer 都明确映射成 action:"none"（不允许发起添加）——但
前端 actionLabel 只认 friend/pending_outbound/pending_inbound 三种，其余（含两种
拉黑关系）一律落到兜底的"添加"文案。点进去虽然会跳到资料页、由资料页自己的
cannotAddReason 挡住（不会真的误发出申请），但列表这一行本身的文案是误导的。
补上跟 Profile 组件里已有的 cannotAddReason 一致的两条文案（已拉黑/无法添加），
只是精简成适合一行列表项的长度。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-04 16:25:44 +08:00
Your NameandClaude Opus 5 7340b5e135 修复消息首页"置顶聊天"读了个不存在的字段，从来没有视觉效果（第2章复测发现） 
normalizeConversations 里 pinned 读的是 item.pinned——原生 Tinode 订阅对象上根本
没有这个键，恒为 undefined。第5/6章的置顶开关点了之后，服务端确实存了，但这个
列表拿到的永远是"没置顶"，用户会觉得这个开关是假的。

真实存放位置是订阅的原生 private.pinned 字段，但只对群聊成立：群聊置顶走
updateGroupMemberSettings，服务端真的写进 Subs.Private，会随原生 {meta} 同步下来
（真实验证：重连后能看到；同一连接内没有实时 {pres} 通知，所以点亮开关那一刻不会
立即反映在列表上，要等下一次重连，这个次要延迟这次没有顺手解决）。单聊置顶走的
是完全不同的 updateConversationSettings，服务端存进独立的 im_conversation_settings
表，从不写入原生 Subs.Private——不管等多久重连都不会在这里出现，这是真实的后端
架构缺口（没有批量查询会话设置的接口，前端不可能为渲染一屏列表去挨个 topic 发
请求核对置顶状态），已记录、这次没法在前端解决。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-04 16:25:23 +08:00
Your NameandClaude Opus 5 4337c45674 修复第9章工作台三处问题：日报列表错误吞没/月报重新编辑未接线/信箱附件超限（复测发现） 
1. DailyReportList 的 load() 把请求失败（网络错误、403等）整个 catch 吞掉，只留一个
   空/旧列表，跟"今天真的没有日报"是同一种"暂无日报"空态展示——用户没法分辨到底是
   没数据还是加载失败了。补上 loadError + onToast，参照 DailyReportDetail/
   MonthlyReportList 已有的同款处理方式。

2. reopenMonthlyReport 早就在 im-api.js 里写好但零调用点：MonthlyReportDetail 一直
   没有"重新编辑"入口，已提交的月报只能干看着改不了。核对 im_be 源码发现原函数还多
   传了一个 reason 字段——serveIMMonthlyReportReopen 用 DisallowUnknownFields 只认
   {version}，真调用起来会先 400。同时确认这是纯自助操作（SQL 的 UPDATE 条件里
   author_id=调用者自己），不存在"管理员帮别人退回"这回事，去掉多余字段后在
   MonthlyReportDetail 给本人的已提交月报加上这个入口。

   接上之后在真实账号上跑通整条链路时，又炸出一个新竞态：reopen 成功后跳转编辑器，
   编辑器用同一个月份的模块级缓存做"再次进入不清空"的初始渲染，但缓存里存的是
   reopen 之前的旧 version——首次自动保存草稿用这个旧 version 发出去，服务端真实
   返回 409，界面弹出"请检查网络后重新编辑"（其实跟网络毫不相干）。加了个 hydrated
   门槛：只有当组件自己这次挂载真正拿到新鲜数据确认过之后，才允许自动保存的
   effect 生效；没有旧缓存要甄别的场景（绝大多数情况）行为完全不变。修复前后各跑
   了一次完整的"提交→查看详情→重新编辑"，前者复现了 409，后者干净无报错。

3. 总经理信箱的附件上传一直没有数量上限——真实 config.attachment_policy.max_files
   （联调确认默认租户是5，不是后端Go默认结构体里那个从未在这个环境出现过的
   max_count）从来没被读取过，界面上能一直点"上传文件"加到任意多个。补上跟
   意见反馈页一致的"数量/上限"展示与到达上限后禁用。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-04 16:25:05 +08:00
Your NameandClaude 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 NameandClaude Opus 5 211d93a0e4 修复青少年模式独立密码校验报错显示英文原文的问题（第10-11章复测发现） 
关闭/开启青少年模式都要先过 POST /settings/independent-password/verify 这一关，
PIN 输错、连续错误触发限流这两种失败，后端 reason 分别是 CODE_INVALID/
TOO_MANY_ATTEMPTS——REASON_MESSAGES 表里没收录这两个 key，直接透传英文原文
message（"code invalid"/"too many attempts"），且限流的具体等待时长（details.
retry_after_seconds）完全没有展示给用户。

REASON_MESSAGES 原来只支持字符串值，限流提示需要按 retry_after_seconds 动态拼
文案，所以顺带把 imRequest 的取值逻辑改成支持函数值（传入 payload.details）。

已用真实账号端到端验证：对 https://api.118im.com 连续发送错误 PIN，前3次真实
返回 401 CODE_INVALID，UI 正确显示"独立密码不正确"；第4次起后端真实触发限流
返回 429 TOO_MANY_ATTEMPTS（details.retry_after_seconds 从300开始递减），UI
正确显示"连续输错次数过多，请 240 秒后重试"，秒数随后端返回值动态变化。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-04 14:46:08 +08:00
Your NameandClaude 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 NameandClaude Sonnet 5 0dcef54fed 修复置顶/免打扰开关未接后端、好友二维码死按钮（第5章复测发现） 
置顶聊天/消息免打扰：原来是纯本地 useState，onChange 只切一下布尔值，从不调用任何接口——
GET/PATCH /conversations/{topic}/settings 早就封装好了，只是零调用点。打开设置页永远显示
"关"，点了也只是那次会话内生效、离开页面就丢，和会话列表真正读取的置顶/免打扰状态是两套
毫不相关的东西。

实测确认真实字段：{pinned, mute_notifications, version}，PATCH 需要带 version 做乐观锁。
接入 getConversationSettings/updateConversationSettings，失败时回滚开关视觉状态。
已用真实账号验证：点击后发出真实 PATCH 请求，带正确的 version。

好友个人主页"二维码"图标：参考图里是独立一行（不是贴在头像卡片里的小图标），点击生成这个
好友的二维码名片，对应接口 createUserQRCode() 早就封装好了，原来这个图标没有任何 onClick，
是个看着能点、点了没反应的死装饰。新增 friend-qr 路由和 FriendQr 组件（复用 QrPage 的结构），
CSS 复用了 .people-settings 那套现成的行样式，不是新造一套。
已用真实账号验证：点击后正确跳转、生成出真实二维码。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-04 13:43:22 +08:00
Your NameandClaude Sonnet 5 d3d7e11b08 修复会议详情页显示裸user_id的问题（第9章复测发现） 
创建/详情/更新/取消/我的回应这5个会议接口的 organizer.display_name/participants[].display_name
实测恒等于裸 user_id，只有列表接口 GET /meetings 会真的解析姓名。之前的注释误以为"响应已带
姓名解析"对所有会议接口都成立（可能是当时只测过列表接口就下了结论），这次复测用真实创建的
会议逐个接口验证，证伪了这个假设。

MeetingDetail 接入已有的 useUserNames（日报/月报详情页已经在用同一套机制），发起人和参会人
姓名解析不出来时不再显示裸 uid。同时更正了 MeetingCard 上那条误导性注释，说清楚它只对列表
接口成立。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-04 13:31:55 +08:00
Your NameandClaude Sonnet 5 1d51e53a46 修复通话发起失败静默无反应的问题（第8章复测发现） 
sendMessageToTopic 自己的 .catch 会吞掉发送失败——publishMessage 在服务端拒绝时只标记
pub._failed=true 让消息列表画红色感叹号（这是给聊天气泡设计的反馈方式），resolve 成 undefined
而不是 reject。通话邀请这条消息不会被用户看到（用户盯着的是全屏通话面板，不是消息列表），走
这条路径等于什么反馈都没有；而且原代码 `ctrl.code` 直接解引用，undefined.code 会抛
TypeError，变成一个没人 catch 的 rejected promise——handleCallClose() 根本不会被调用，
通话面板会卡在"呼叫中"状态出不来。

这条路径今天有了真实后果：后端新增的全局通话开关(im_client_feature)关闭时，服务端会拒绝
这条 {pub}，正好命中这个从未被验证过的失败分支。

修复：判断 ctrl 是否存在、补 .catch，两处都调用 handleError 提示 + handleCallClose 复位。
顺带给通话按钮可见性加了一层预判——读共享的 bootstrap 缓存，features.audio_call/video_call
为 false 时不显示按钮；读不到缓存时按原行为放行（fail-open，只是预判不是安全边界）。

已用真实账号验证：通话菜单项在开关为真时正常显示，无回归。真实失败场景（开关被关闭）无法在
当前浏览器沙盒环境下端到端验证（摄像头/麦克风权限被拦截，此前已确认的环境限制），修复依据是
逐层读 tinode-sdk 源码精确追踪出的调用链，不是猜测。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-04 13:14:44 +08:00
Your NameandClaude Sonnet 5 8e703d86eb 修复第2章复测发现的3个问题：好友申请通知按钮/时间格式/新机器码样本 
- 好友申请通知的"查看新朋友"按钮永远不出现：判断条件是 action.type==='friend_request'，
  但实测 GET /system-notifications 拿到的 friend.request.created 通知，action 里只有
  {user_id}，从来没有 type 字段——这个判断条件是当初凭对接文档猜的，不是照真实响应写的。
  改用 event_type.startsWith('friend.request')。
- 系统消息时间格式：默认 toLocaleString('zh-CN') 输出"2026/8/20 18:04:00"（年份/斜杠/秒），
  参考图是"6月28日 10:04"。新增 formatNotificationTime。
- 机器码兜底表补一条：新样本 security.risk.continue 事件的 summary 是 decision 字面量
  "continue"，同样会被机器码识别但查表落空、原样显示英文单词。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-04 13:06:00 +08:00
Your NameandClaude Sonnet 5 02a565b8e5 修复登录失败显示英文原文的问题（第1章复测发现） 
Tinode 原生 WS 登录走 {ctrl} 协议，不经过 im-api.js 的 REASON_MESSAGES 翻译表（那张表只在
REST 请求里生效）。ctrl.text 是服务端 datamodel.go 里固定的英文串（"authentication failed"
等），ctrl.params 也没有 REST 层那种稳定的 reason 字段（已实测确认）。原来 doLogin 的 catch
直接把 err.message 原样传给 handleError，密码打错时用户看到的是英文 "authentication failed"，
不是参考图要求的"账号或密码错误"。

新增 loginErrorMessage()：已知的几个固定英文串映射成中文，未知文案按状态码兜底
（401/403 → 账号或密码错误）。

已用真实账号验证：错误密码显示"账号或密码错误"，正确密码登录正常进入工作台。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-04 12:21:44 +08:00
Your NameandClaude Opus 5 5bc3fee20b 实现合并转发（第4章 4.20）：后端已支持 bundle 模式，补上前后两端 
后端把 POST /v1/im/messages/forward 的 mode="bundle" 实现了（此前直接返回 501，前端因此
只做了逐条转发）。这次把前端两侧都补上。

接收侧（新增 widgets/forward-bundle.jsx）
- 服务端生成的这条消息 head 带 x-im-type:"forward_bundle"，content 是
  {bundle_id, title, item_count, preview, items, source_refs, comment}，不是 Drafty。
  前端全仓搜这个类型零命中，收到会落到 chat-message 的 "invalid content" 兜底
  （⚠ + 灰字）。本端自己发不出 bundle，但别的端发过来就会踩到。
- 渲染成一张"聊天记录"卡片：标题 + 摘要行 + 展开/收起。items[] 里已经带了每条被转发消息的
  完整快照，所以"查看完整记录"是就地展开，不额外发请求。
- 快照里的 from 是不带 usr 前缀的裸 uid（与收藏快照一致），补前缀后查本地会话缓存拿显示名；
  查不到就不显示发送者，宁可少一行也不要把一串 uid 摆在摘要前面。
- 没有正文的媒体消息用 [图片]/[视频]/[语音]/[文件]/[链接] 标签兜底。

发送侧（batch-forward-dialog.jsx）
- 转发模式改为按"用哪种方式选的目标"推导，这是参考图给的规则：
  转发—逐条转发.png 是单选一个目标、占位写 [逐条转发]共2条消息；
  转发—合并转发—多选状态.png 是多选目标、占位写 [合并转发]共16条消息。
  原来 mode 硬编码 'separate'、占位也写死 [逐条转发]。

样式（base.css）
- 新增 .forward-bundle 一组规则，避免又造一批零样式类。

验证
- 用后端 buildForwardBundle 的真实产出结构，注入真实会话的消息缓存，由真正的 ChatMessage
  渲染：卡片正常显示、未落到 invalid content；展开显示全部 5 条、收起回到 3 条；截图确认视觉正常。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-03 21:15:33 +08:00
Your NameandClaude 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 NameandClaude Opus 5 08bd8915c5 修复全页面走查发现的问题（第五批：失效文件状态、日报搜索、client_context） 
- content-library-view: 收藏列表的 FileCard 一直没传 removed，需求 7.3「失效文件需展示明确
  状态而非直接报错」在收藏页就没生效（聊天记录页本来就传了，只有这条漏了）。后端
  messageAvailability 在源消息被删/撤回时给 'removed'。

- workplace-collaboration-view: 日报"团队统计"的搜索占位符写着"搜索姓名/部门"，但过滤用的
  department_name 后端根本不返回（dailyReportListPayload 只有 report_id/author_id/report_date/
  content_short/status/draft_updated_at/read_state/version），拼进来恒为空串，"部门"那半个
  搜索永远搜不到任何东西。改为按真实有的字段搜（姓名+摘要），占位符也改成如实的；
  卡片上同样读了这个不存在字段的角色徽章一并改掉。

- im-api: 企业注册申请 / 入口反馈 / 意见反馈三个接口后端都定义了 client_context 且会入库
  （im_http.go:255/263/367，落库点 :790/:840/:1478），需求与对接文档也都要求带设备版本信息，
  前端一直没发。在 im-api 层统一注入，三处调用点不用各写一遍。navigator.connection 不是所有
  浏览器都有，拿不到就不发 network 这一项。
  已用真实提交验证（返回 fb_G9GtMsAbSHQ6z6Li）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-03 18:59:09 +08:00
Your NameandClaude 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 NameandClaude Opus 5 c9b8125013 修复全页面走查发现的问题（第三批：转发、i18n、自聊天显示名） 
第4章 批量转发
- 确认弹层里那栏留言是个只读 <div>，需求 4.19 与对接文档要求的"附加留言"根本没法填，
  comment 永远是空串。改成真实输入框（方括号那段是占位文案不是内容），并补 input 的样式。
- 无条数上限：服务端硬卡 sources ≤ 100（im_http.go:3560），超了直接 400 MALFORMED_REQUEST，
  用户只看到一句无从下手的"转发失败"。本地先拦并说清超了多少。
- 无目标数上限：bootstrap 下发 limits.max_forward_targets=9、服务端硬限 20，前端两个都不读。
  读各视图已在写的同一份 bootstrap 缓存，不额外发请求；选择视图也补上错误显示。

i18n（这几条影响真实页面，不只是演示页）
- menu_item_forward "重定向" → "转发"，forward_to "重定向消息" → "转发给"。Forward 被当网络
  术语直译了，第4章通篇和参考图用的都是"转发"。
- last_seen_timestamp 中英两侧都丢了 {timestamp} 占位符，离线时头部只显示"最后可见"没有时间。
- peers_messaging_disabled "成员间消息已禁用" → "对方已关闭消息"（原文是 Peer's）。
- search_no_results "搜索返回任何结果" 缺"无"；icon_title_send "发信息" → "发送消息"。
- 已跑 build:i18n 同步 src/i18n.min/（那份才是打包进产物的）。

自聊天显示名
- topicDisplayName 不处理 slf，消息首页把"已保存的消息"显示成"未命名会话"。该显示名靠
  Tinode.isSelfTopicName 特判得出、不在 public 里。集中到这个共享函数，所有调用点都受益。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-03 18:45:13 +08:00
Your NameandClaude 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 NameandClaude 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 NameandClaude Opus 5 c4189646f4 消息首页：群聊头像图标、昨天的时间格式、常联系的人名字截断 
对照 docs/images/消息.png 逐项核对消息首页，实测 DOM 后确认三处：

1. 群聊会话的兜底头像画成了单人像：normalizeConversations 没给任何会话设 icon，全部落到
   Avatar 的默认值 person，列表里分不出哪条是群。按 topic 的 grp 前缀区分，群用 group 图标。
   顺带把群的 online 传 undefined——群不存在"在线"概念，之前会给群也渲染一个状态点。

2. 昨天的会话只显示"昨天"，参考图是"昨天21:03"带具体时间。实测修复后显示"昨天17:40"。

3. "常联系的人"的名字被截断：格子 3.75rem(50px)，而 "kcg051307" 这类用户名需要 52px，
   显示成 "kcg0513..."；参考图里这一栏名字是完整显示的。加宽到 4.4rem，实测 59px 可见宽、
   59px 实际宽，不再截断。

另外记录一个未改的观感偏差供决策：这一栏的头像实测占视口宽 10.1%（42.7px / 424px），参考图
里约占 17%，明显小一号。放大属于观感调整不是缺陷修复，没有自行改动。

本轮还做了一次全局层叠扫描（遍历 19 个页面，自动检测图标在容器内不居中、文字被压成 0 高度、
元素溢出视口、意外截断四类问题）：除上面这处截断外没有新命中，说明之前群设置页那组 CSS 层叠
冲突是孤立的，没有蔓延到其他页面。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-03 18:09:00 +08:00
Your NameandClaude Opus 5 0ba3577c96 群头像图标贴顶不居中；成员格子文字区过窄 
用户实机反馈的三点，逐项查证后：

1. 图标垂直不居中（真bug，已修）：.group-settings-header span 这条规则把 .group-avatar 一起
   命中了——它本身就是个 span，被改成 flex-direction:column 之后，自己的 place-items:center
   只剩交叉轴（水平）生效，主轴（垂直）退回 flex-start，图标贴着方块顶部。实测头部群头像上边距
   0px、下边距 28.7px，左右各 14.3px，正好对应这个成因。选择器改为
   > span:not(.group-avatar) 精确排除；同时给 .group-avatar 补 align-content/justify-content，
   以后再被外部规则改成 flex 也不会散架。修完三处（头部群头像、成员头像、添加格）实测上下左右
   边距全部对称。

2. 文字区过窄只显示两个字（真问题，已修）：上一版把成员格子宽度收到与头像等宽（3rem），昵称
   被截成"测试..."。按参考图比例重算——那张图里头像约占格子宽七成、相邻头像间隙约头像宽四成，
   且五字昵称完整显示——格子改 4.4rem、头像改 3.6rem、间距 0.5rem。实测"测试昵称A"完整显示
   不再截断。

3. 头像配色：上一版我把兜底头像从饱和蓝底白图标改成了浅蓝底蓝图标，这是自作主张、用户没要求，
   已还原成原来的 #4389df 底 + 白色图标。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-03 17:54:22 +08:00
Your NameandClaude 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 NameandClaude Opus 5 8225848493 系统消息：按通知自身内容决定入口和文案，不再一律显示"前往安全设置" 
用户实机测试反馈：系统消息列表里每条通知底部都是同一个"前往安全设置"按钮，点进去跟通知内容毫不
相关；正文还直接显示 "group.settings.updated" 这种原始事件码。查证后两个问题性质不同：

入口按钮（前端问题，已修）：原来无条件对所有通知渲染同一个按钮、固定跳 security 页。改为按通知
自己的 action 字段决定——action.topic 是 grp 开头的进对应群聊设置页，好友申请类（action.type
为 friend_request）进"新朋友"页，带 device/ip 的安全类才进安全设置页，都不匹配就不显示按钮。
注意 action.topic 不能直接当群用：好友申请通知的 action 里带的是 p2p 会话 topic
（db/mysql/tenant_adapter.go:8643），所以判断加了 grp 前缀检查。跳转目标都核对过在
tinode-web.jsx 的路由白名单里（friend-requests / group-settings），没有凭空造路由名。

正文文案（后端问题，前端只做兜底）：后端多处把机器码直接当 summary 写进通知——群事件统一写
summary=event.EventType（im_group_events.go:42-44，7 种群事件还共用同一个 title"群聊动态"），
好友申请处理结果写 summary=status（im_http.go:5956 等，值就是 "accepted"/"rejected"）。前端加
了一层兜底：summary 命中"纯小写字母数字点下划线"这种机器码特征时，按已知码翻译成中文，翻译不了
就退回通用文案；后端以后补上真正的文案会自动优先使用，不会被兜底覆盖。这条已记入后端问题清单。

实机验证：两条群通知正文由 "group.settings.updated" 变为"群设置有更新"、按钮变为"查看群聊"且
点击后正确进入 grpXDkK5cbXoK0 的群聊设置页；两条好友通知正文由 "accepted" 变为"对方已通过你的
好友申请"，不再显示无关的安全设置按钮。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-09-03 17:32:36 +08:00
Your NameandClaude 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 NameandClaude 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 NameandClaude Sonnet 5 2c77a8e229 Ignore local .claude/ dev-server config 
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-03 17:01:13 +08:00
Your NameandClaude 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 ba8f48ee prototype commit shipped with. Adds src/lib/im-api.js
as the REST client, plus supporting fixes across messages-view.jsx and the
attachment/upload/download pipeline (wrong SDK auth headers, group topic
naming, seq/timezone edge cases) found via live end-to-end testing against
the real backend.

Backup checkpoint before reconciling with origin/dev's parallel rewrite.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-09-03 11:40:53 +08:00
richjohnrambo ba8f48ee83 完成 IM Web Android 端产品页面开发 2026-08-25 18:30:40 +08:00
Your Name ca5e74ee98 修复静态资源发布后不生效: /umd/缓存策略从immutable改为no-cache 
构建产物文件名不带内容哈希，一年免验证的缓存策略导致每次蓝绿发布后
浏览器和CDN都会继续吃旧版本，用户需要清缓存或开无痕窗口才能看到更新。
改为no-cache后浏览器/CDN每次都会带条件请求向源站确认，未变化时只是
一次很快的304，一旦文件真的变了会立刻拿到新内容，不再需要手动清缓存。
 2026-08-12 12:54:41 +08:00
Your Name 111d9040a7 修复健康检查失败: nginx补上IPv6监听 
首次部署时健康检查一直失败——容器内nginx只listen了IPv4(0.0.0.0:80)，
但/etc/hosts里localhost解析到::1在前，wget http://localhost/因而连不上。
补上 listen [::]:80 双栈监听解决。部署脚本那边也同步改成直连127.0.0.1，
避免再依赖localhost的解析顺序。
 2026-08-11 12:52:06 +08:00
Your Name 85ac8ce43b 接入Gitea Actions蓝绿发布：API_KEY构建时注入、新增Dockerfile 
- src/config.js 的 API_KEY 改为从构建时环境变量 TINODE_API_KEY 注入，
  不再依赖官方demo默认值；未设置时保留原demo key作为本地快速测试的兜底
- webpack.config.js 新增 DefinePlugin 完成注入，并自动加载(gitignored的)
  .env.local，开发者本地调试不需要每次手动export
- 新增 Dockerfile(node构建+nginx serve) 和 docker/nginx.conf
- 新增 .gitea/workflows/deploy.yml：手动触发的蓝绿发布流程
 2026-08-11 12:40:12 +08:00
or-else 14e1e6b549 bug fix: typo 2026-07-04 16:01:47 +03:00
or-else 70a9ab8996 firebase updated, two bugs related to fb fixed 2026-07-04 15:42:55 +03:00
or-else d24b297685 adding new files 2026-07-04 15:19:29 +03:00
or-else 7bf3fa71d6 partially dependencies updated 2026-07-04 15:19:03 +03:00
Gene ac9d61eaad Merge pull request #143 from Moraussubara-Shi/devel 
proposed Portuguese translation
 2026-05-23 22:07:47 +03:00
Moraussubara Shi ece2aa0e87 proposed Portuguese translation 2026-05-20 20:12:23 +01:00
or-else ac779ef31b merge devel 2026-03-03 13:36:48 +03:00
or-else e2c32de5c2 update the sdk version 2026-03-03 13:32:29 +03:00
or-else 6bd9afe017 update translations 2026-03-02 14:39:27 +03:00
or-else 91799adb9a rebuilt, new translation modules added to git 2026-03-02 14:11:36 +03:00
or-else 3bfabc90f3 add missing vi translations, rearrange language imports in alpha order 2026-03-02 14:06:40 +03:00
Gene 6b21c1deaa Merge pull request #141 from Antoanyabo/i18n-vi 
feat(translation): Add Vietnamese (vi) translation
 2026-03-02 13:34:19 +03:00
amit d674deeca6 feat(translation): Add Vietnamese (vi) translation 2026-03-02 15:07:52 +07:00
or-else 573f99993a rebuilt with the sdk bug fix 2026-03-01 19:05:14 +03:00
or-else e6dfde28f6 restore topic subscription after a reconnect 2026-03-01 18:31:24 +03:00
or-else 389ef305ab cleanup 2026-03-01 14:03:18 +03:00
or-else 2aa1b731ee fix for #140, fix for some UI breakage, cosmetic changes 2026-03-01 13:59:59 +03:00