doc: docs

Author: wkylin

docs/ESLint-Cheatsheet.md

@@ -201,15 +201,4 @@ npx eslint --cache "path/to/file.jsx" || true
 
 - 如果需要把所有文件问题导出并在本地用编辑器跳转，优先使用 JSON 输出并在 VS Code 中安装 ESLint 扩展加载 `eslint-report.json`。
 
----
-
-## 我在本次修复会话中记录的部分示例结果
-（仅为会话快照，具体数字会随代码修改波动）
-
-- `src/components/KeepAlive/index.jsx` — 11 problems（曾为最高）
-- `src/components/stateless/ReMarkdown/index.jsx` — 5 problems
-- `src/pages/chatgpt/index.jsx` — 最初 5 problems，已在会话中修复多数
-
----
-
-如需我把当前仓库的完整按文件问题统计（`eslint-by-file.txt`）生成并提交到仓库根目录，回复“是”，我会立刻运行并把文件写入。
+---

docs/SENTRY-CI.md

@@ -50,6 +50,3 @@ jobs:
 注意
 - `SENTRY_DSN` 是前端运行时用来发送事件的 DSN；`SENTRY_AUTH_TOKEN` 是 CI 用来上传 artifacts（source maps / releases）的私密 token，两者用途不同，不要混淆。
 - 我们的 `src/utils/sentry/index.js` 会优先使用 `process.env.SENTRY_DSN`，并允许在运行时代码中通过环境变量或构建时间注入替换。
-
-如需我：
-- 可以把这段内容合并到 `README.md` 的“部署”或“CI”节；或创建更详细的 `docs/` 页面并添加示例 workflow（我可以代为修改）。

docs/VIDEO_PLAYER_IMPROVEMENTS.md

@@ -75,41 +75,4 @@
 - 路径形态：一般为根路径 `/`。
 - 受影响点：
   - 如果 Vercel 使用 Webpack 构建，需要确保它执行的是 `npm run build:production`
-  - 若 Vercel 构建阶段运行音视频压缩：会增加构建耗时；并且 Vercel 的缓存策略可能导致压缩收益不稳定
-
-## 建议继续推进（未必已在当前仓库落地）
-
-> 下面是“包体/首包”治理的常见下一步方向，是否落地请以当前代码为准。
-
-### A) CI 默认跳过音视频压缩（推荐）
-
-动机：GitHub Actions/Vercel 的构建通常更希望“快且可重复”，而压缩属于离线资产加工，更适合：
-
-- 本地开发/专门的 asset pipeline 运行
-- 或者只在需要更新素材时才运行（通过手动触发/环境变量强制）
-
-建议策略：
-
-- CI 环境检测到 `CI=true` / `GITHUB_ACTIONS=true` / `VERCEL=1` 时，跳过 `optimize:media`
-- 通过 `OPTIMIZE_MEDIA=1` 强制开启
-
-### B) 首包（app chunk）大依赖拆分
-
-常见大头：
-
-- `antd` / `@ant-design/icons`（barrel import 容易把聚合入口带进首包）
-- `lucide-react`（从包入口导入多个图标时，容易把图标集合带进首包）
-- `html2canvas`（截图/PDF 导出这类能力不应进入首屏）
-- `react-markdown` + `remark/rehype` + `katex/highlight`（仅 markdown 页面需要）
-
-建议手段：
-
-- 图标改为“单文件导入”或“按图标模块导入”
-- 将 `html2canvas`、markdown/katex runtime 改为动态 import（按页面或按功能触发加载）
-- 收敛路由 preload（避免重页面被预取进首包）
-
-## 如何验证优化是否生效
-
-- 资源体积：对比 `dist/` 目录中图片/音视频体积（尤其是 `dist/static/js` 与 `dist/images`、`dist/audio`）。
-- Webpack performance：观察生产构建输出的 performance hints。
-- 包体归因：使用 `npm run analyze:build` / `npm run analyze:stats` 生成 stats，再按 entrypoint/app chunk 追踪主要模块来源。
+  - 若 Vercel 构建阶段运行音视频压缩：会增加构建耗时；并且 Vercel 的缓存策略可能导致压缩收益不稳定

docs/build-and-bundle-optimizations.md

@@ -62,32 +62,4 @@
 2. （可选）若你同时维护了 `src/components/index.ts`：`npm run check:components-index` 通过（避免漏加/写错导出路径）
 3. `npm run build:lib` 成功（产物 + d.ts）
 4. 如果该组件有样式（`.module.less/.css`），在消费侧能正常引入
-5. 如果该组件依赖路由/i18n 等上下文，在 Storybook 里可正常预览（可选，但建议）
-
-## 常见问题
-
-### Q1: 为什么我新增了组件但打出来的 lib 里没有？
-
-因为 `vite.config.lib.ts` 的入口是 `src/lib/index.ts`：
-
-- 你没在这里 export → Rollup 不会把它当作库 API 打包
-- dts 插件也不会把它作为入口类型导出到 `dist-lib/index.d.ts`
-
-### Q2: 新增组件放在 `src/components/OneTimePasscode/` 里，为何还要从 `stateless/OneTimePasscode` export？
-
-`src/components/OneTimePasscode/` 这种目录在当前项目里主要是 **Storybook 文档/演示（mdx/stories）**。
-真正组件实现位于 `src/components/stateless/OneTimePasscode/`，所以库入口应该导出实现目录，而不是导出 docs。
-
-### Q3: 以后这个文件会越来越大，怎么维护更舒服？
-
-建议遵循两条简单规则：
-
-1. **只导出“要发布的公共 API”**（组件/类型/hooks），避免把 demo、页面级组件、内部路由壳导出。
-2. **新增组件就顺手加一行 export + 跑 build:lib**，用构建作为“验收”。
-
-如果后续你希望进一步自动化，可以新增一个脚本（可选）：
-
-- 扫描 `src/components/stateless/*` 和 `src/components/stateful/*`
-- 生成（或校验）`src/components/index.ts`
-
-但因为当前存在少量特殊导出（例如非 default 导出、注释掉的 export），完全自动生成需要先统一约定；否则更推荐“半自动校验”而不是强制重写文件。
+5. 如果该组件依赖路由/i18n 等上下文，在 Storybook 里可正常预览（可选，但建议）