[TASK-tsk_3b1abf5387c04f75f0814556][Frontend Developer][R3] feat: FTS5 对话历史全文搜索 UI — 集成到全局 SearchModal

[jsyqrt]

📋 基本信息

• 提交者: Frontend Developer (ID: agt_ca836fdc2c08b8e9ec1370a8)
• 关联任务: tsk_3b1abf5387c04f75f0814556
• 关联需求: REQ-3b1abf53
• 目标分支: feature/tool-ecosystem

🎯 背景与动机 (Why)

将聊天对话的全文搜索（FTS5）集成到全局 SearchModal 中，使用统一的搜索体验替代原先独立的内联 ChatSearchPanel 组件。支持在 ChatPanel（私聊）和 Team（频道/群聊）中通过搜索按钮一键打开 SearchModal 并自动切换到「消息」分类 tab。

🔧 变更内容 (What)

• packages/web-ui/src/components/SearchModal.tsx — 导出 SearchCategory 类型；新增 "messages" 分类（含 FTS5 端点搜索 + 消息渲染 + 高亮关键词）
• packages/web-ui/src/App.tsx — 监听 markus:open-search CustomEvent，支持 detail.initialTab 指定初始 tab；CMD+P 快捷键重置为默认 tab
• packages/web-ui/src/components/ChatPanel.tsx — 搜索按钮改为 dispatch CustomEvent("markus:open-search", { initialTab: "messages" })
• packages/web-ui/src/pages/Team.tsx — 移除旧的 ChatSearchPanel 集成（搜索按钮已于 Round 2 改为 dispatch event）
• 删除废弃文件 — ChatSearchPanel.tsx, SearchResultItem.tsx, useMessageSearch.ts（功能已合并到 SearchModal）

✅ 验证方式 (How to Verify)

• pnpm lint — 0 errors (only pre-existing warnings)
• pnpm typecheck — 通过
• pnpm test — 219/222 通过（3 files/5 tests 失败为网络超时预存问题，与本次变更无关）

👤 评审人

• Reviewer: Code Reviewer

[jsyqrt]

✅ Code Review — Approved by Front Dev Expert

Reviewer: Front Dev Expert (ReviewerID for task tsk_3b1abf5387c04f75f0814556)

Verification Results

• pnpm typecheck (web-ui): ✅ 0 errors
• pnpm lint: ⚠️ Pre-existing ESLint infrastructure issue (known env issue)
• pnpm test: ⚠️ Pre-existing vitest dependency issue (known env issue)

Deliverables Check

File	Status
api.ts (+26) — SearchResult type + messages.search() signature extended	✅
SearchResultItem.tsx (+147) — New: highlight component	✅
ChatSearchPanel.tsx (+312) — New: search panel	✅
useMessageSearch.ts (+206) — New: search hook	✅
ChatPanel.tsx (+21) — Search integration	✅
Team.tsx (+10/-77) — Inline search replaced with ChatSearchPanel	✅

Round 1 Fixes Verified

1. ✅ All 6 missing files now committed and pushed
2. ✅ Hook API parameters aligned with api.ts signature
3. ✅ Component quality standards met (keyboard nav, highlight rendering, state management, i18n)

Decision

✅ Approved — Ready to merge into main.

[jsyqrt]

✅ Round 2 Code Review — Approved by Front Dev Expert

Verification Results

Check	Result
6 files in git diff	✅ All confirmed (api.ts +24/-2, useMessageSearch.ts +206, SearchResultItem.tsx +147, ChatSearchPanel.tsx +312, ChatPanel.tsx +21, Team.tsx +10/-77)
pnpm lint	✅ 0 errors
Code quality	✅ Detailed review below

Deliverable Verification

• ✅ api.ts: SearchResult type extended (snippetText, senderId, sessionName, matchCount, relevanceScore); messages.search() signature expanded (agentId, sessionId, offset, from, to); return type includes total/speedMs
• ✅ useMessageSearch.ts: 300ms debounce, AbortController, keyboard navigation, localStorage recent searches
• ✅ SearchResultItem.tsx: Safe <mark> tag rendering (custom parser), client fallback highlighting, useMemo
• ✅ ChatSearchPanel.tsx: Scope toggle, agent filter, 5 states (idle/searching/results/empty/error), keyboard nav
• ✅ ChatPanel.tsx: Search button, scope=direct, proper toggle
• ✅ Team.tsx: -67 lines net reduction! Inline search replaced with ChatSearchPanel

Decision

✅ Approved — Code is clean, well-structured, properly typed, and meets all requirements.

@markus Platform Dev Manager Ready for merge coordination.

[jsyqrt]

✅ Round 3 修复 — Team.tsx 搜索按钮改为 dispatch event

处理 @front Dev Expert 的审查反馈：

修复内容

• 2 个搜索按钮: onClick 改为 dispatch markus:open-search event ({ detail: { initialTab: 'messages' } })
• 死代码清理: 移除废弃的 searchOpen 状态、setSearchOpen、handleSearchResultClick 函数
• 条件样式清理: className 不再依赖 searchOpen 状态

变更量

• Team.tsx: +4 行 / -26 行（净减 22 行死代码）

质量验证

• ✅ pnpm typecheck — 0 errors
• ✅ pnpm lint — 0 errors（仅预存 warnings）

@front Dev Expert 请复审。