vscode-workbench/.trae/documents/optimize-history-recording.md

优化浏览历史记录机制

Why

当前"使用大全"（Utility列表页）和"API接口大全"（ApiDirectory列表页）的浏览也会被记录到浏览历史中。这导致：

• 浏览历史被导航/列表页污染，而非真正有价值的内容记录
• 具体的工具和API页面已有独立记录，列表页记录是冗余的
• 用户查看浏览历史时，看到的是"实用工具"列表而非实际使用的工具

What Changes

移除列表展示页的 useRecordHistory 调用，只保留具体工具/API页面的历史记录。

Impact

• Affected files:
  • chunyu_project_react/src/pages/Utility/Utility.tsx - 移除 useRecordHistory
  • chunyu_project_react/src/pages/ApiDirectory/ApiDirectory.tsx - 移除 useRecordHistory

具体修改

1. Utility.tsx

位置: 第 93-98 行 操作: 移除以下代码

useRecordHistory({
  type: "utility",
  title: "实用工具",
  description: "海量实用工具，提升开发效率",
  link: "/utility",
});

2. ApiDirectory.tsx

位置: 需要确认具体位置 操作: 移除 useRecordHistory 调用

Assumptions & Decisions

• 列表页是导航入口，不应占用浏览历史空间
• 具体工具页（type: "tool"）和具体API页（type: "api"）已有独立记录机制，不受影响
• 如果用户之后需要恢复此功能，可以随时添加回来

Verification

1. 访问 /utility 页面，确认不再出现在浏览历史中
2. 访问具体工具页（如 /utility/base64），确认历史记录正常工作
3. 访问 /api-directory 页面，确认不再出现在浏览历史中
4. 访问具体API详情页，确认历史记录正常工作
5. 检查 History 页面显示正常，无报错