# ROADMAP 已完成项明细

最后整理时间：`2026-03-18 19:06:30`

## 说明

本文件只记录已经在当前代码库中有明确实现、页面可用、或后台已有可操作入口的功能。

这里的“已完成”含义是：

- 已经落地到代码，不是只停留在 `ROADMAP.md` 描述里。
- 至少有前台页面、后台页面、接口或设置项中的一种可用实现。
- 如果只是做了首版、但距离路线图终态还差很多，该项不会放在这里，而会放到 [ROADMAP_PENDING.md](./ROADMAP_PENDING.md)。

---

## 一、基础架构与部署

| 路线图方向 | 当前状态 | 已落地内容 |
| --- | --- | --- |
| 安装向导 | 已完成 | 已有 `install/index.php` 和 `install/database_init.sql`，支持环境检测、数据库初始化、站点信息和管理员创建，并同步内置默认项目 / 资源 / 工具分类种子。 |
| 旧库恢复兼容补齐 | 本轮完成 | `install/database_init.sql` 现会在导入种子前先补齐 `categories.parent_id` 与 `tags` 后续新增字段，旧版库恢复时不再因为 `Unknown column` 中断导入。 |
| 安装检测与重定向 | 已完成 | `includes/db.php`、`includes/install_check.php` 会在未安装或安装不完整时拦回安装流程。 |
| 配置与设置体系 | 已完成 | 已有 `settings` 表、`rjzy_load_settings()`、`rjzy_setting()`、后台 `admin/settings.php`。 |
| 静态资源版本控制 | 已完成 | `rjzy_asset_url()` 已给前后台 CSS / JS 自动追加版本号，减轻缓存不刷新的问题。 |
| 基础安全与权限 | 已完成 | 已有 CSRF、后台登录校验、页面级角色权限、输入基础清洗和安全引导。 |
| 操作日志基础能力 | 已完成 | 已有 `rjzy_log_action()`、日志列表页、CSV 导出和筛选。 |

---

## 二、全站体验层

| 路线图方向 | 当前状态 | 已落地内容 |
| --- | --- | --- |
| 深色模式 | 已完成 | 前台、后台、登录页、安装页统一支持深色模式切换。 |
| 移动端适配 | 已完成 | 侧边栏抽屉、顶部按钮、搜索区、卡片网格、后台表格页都已有移动端适配。 |
| 统一视觉系统 | 已完成 | `assets/css/theme.css`、`assets/css/admin.css` 已形成统一变量、按钮、卡片、标题区、摘要条节奏。 |
| 回到顶部 | 已完成 | 前台、后台、登录页、安装页都已有公共回到顶部按钮。 |
| 公共图标兜底 | 已完成 | 前后台不再依赖远程图标资源，已有本地图标渲染兜底。 |

---

## 三、首页内容分发模块

| 路线图模块 | 当前状态 | 已落地内容 |
| --- | --- | --- |
| 顶部品牌与全局导航区 | 已完成 | 品牌区、侧边导航、搜索入口、后台入口、主题切换、移动端菜单均已具备。 |
| 核心数据概览卡片组 | 已完成 | 首页已有项目 / 资源 / 用户 / 评论统计卡，并支持点击跳转。 |
| 首页轮播运营位（首版） | 本轮完成 | 首页新增可配置轮播运营位，支持自动轮播、手动翻页、优先级、生效时间、终端显示和 PC / 移动端双图配置；前台轮播已继续兼容移动端与深色模式。 |
| 公告已读 / 强制弹窗（首版） | 本轮完成 | 首页公告现已支持本地已读记忆、全部标记已读、版本化公告弹窗和强制确认关闭；后台可维护已读开关、弹窗文案、跳转链接和弹窗版本号，继续兼容移动端与深色模式。 |
| 创作者推荐 / 站点动态（首版） | 本轮完成 | 首页新增创作者推荐卡片和站点动态时间流，可自动汇总活跃项目作者、最新项目 / 资源更新和评论互动；后台可维护标题、简介、手动创作者名单、自动 / 手动来源切换、动态条数和评论纳入规则，并继续兼容移动端与深色模式。 |
| 精选合集模块 / 专题页（增强版） | 本轮完成 | 首页“精选合集”卡片区现已优先读取数据库里的精选合集，并在数量不足时回退到站点设置里的手动专题卡片；前台 `collections.php` 也已升级为数据化列表页，继续兼容移动端与深色模式。 |
| 精选项目 / 热门排行 / 最新资源 | 已完成 | 首页已有三块核心内容分发区，并带滚动联动 Tab。 |
| 公告与通知栏 | 本轮完成 | 首页新增公告通知模块，支持后台维护标题与多条公告。 |
| 快捷功能入口栏 | 本轮完成 | 首页新增快捷入口卡片，支持后台维护图标、名称、说明、链接和色调。 |
| 热门标签云导航 | 本轮完成 | 首页新增热门标签云，按项目标签热度展示并可直接跳到独立标签聚合页。 |
| 新手引导区 | 本轮完成 | 首页新增新手引导模块，支持后台配置引导文案、步骤提示与行动入口。 |
| 首页模块开关与排序（首版） | 本轮完成 | `admin/settings.php` 已新增首页轮播、自动播放间隔、模块开关、模块顺序、公告、快捷入口、新手引导与热门标签数量配置；`index.php` 也已按后台配置统一渲染首页模块顺序。 |

---

## 四、前台页面模块

| 页面 / 模块 | 当前状态 | 已落地内容 |
| --- | --- | --- |
| 项目列表页 | 已完成 | 已支持一级 / 二级分类筛选、标签筛选、关键词搜索、排序、分页、摘要统计。 |
| 标签聚合页（首版） | 本轮完成 | 已新增 `tag.php`，支持标签说明、近 7 天浏览趋势、关联项目、共现标签与分类分布展示，并适配移动端与深色模式。 |
| 项目详情页基础版 | 已完成 | 已有头图区、标签、演示 / 源码入口、浏览点赞数据、评论区、相关项目。 |
| 项目详情 Tab 化主体区（首版） | 本轮完成 | `project-detail.php` 已支持“项目介绍 / 项目文档 / 版本记录 / FAQ / 评论区”分栏切换，并带 hash 跳转、上次查看记忆、键盘切换，继续适配移动端与深色模式。 |
| 项目版本记录（首版） | 本轮完成 | `project-detail.php` 已开始展示版本时间轴、版本说明和版本入口，适合承接项目更新日志与历史版本说明。 |
| 项目 FAQ（首版） | 本轮完成 | `project-detail.php` 已新增 FAQ 折叠问答区，可展示部署、授权、排错等常见问题，并适配移动端与深色模式。 |
| 项目文档章节（首版） | 本轮完成 | `project-detail.php` 已开始展示文档章节目录、锚点跳转和分章节内容区，适合承接安装、部署、配置和接口说明。 |
| 资源列表页 | 已完成 | 已支持一级 / 二级真实分类筛选、类型筛选、关键词搜索、分页、卡片列表，并接入详情页与官网跳转双入口。 |
| 资源详情页基础版 | 本轮完成 | 已新增资源详情页，具备资源概览、官网跳转统计、基础信息卡、详情正文、文档 / 镜像链接、分类信息和同类推荐。 |
| 工具页 | 已完成 | 已支持分类筛选、关键词搜索、卡片展示和前台工具投稿。 |
| 搜索页 | 已完成 | 已支持项目 / 资源联搜、范围切换、联想词、`Ctrl + K` 聚焦、分页展示。 |
| 合集中心列表 / 详情（首版） | 本轮完成 | `collections.php` 现已升级为数据化合集列表页，支持关键词 / 分类 / 精选筛选，并继续保留手动专题卡片兜底；`collection-detail.php` 也已新增合集详情页，可按分组承接项目、资源、帮助文档、页面和说明卡片，继续兼容移动端与深色模式。 |
| 合集订阅 / 收藏（基础版） | 本轮完成 | `collection-detail.php` 现已支持设备级订阅 / 收藏切换，`collections.php`、`index.php` 和 `admin/collections.php` 也会同步展示合集互动热度，并继续兼容移动端与深色模式。 |
| 合集审核 / 回收隔离（基础版） | 本轮完成 | `collections.php`、`collection-detail.php` 与首页 `index.php` 的精选合集位现已统一只展示“未删除 + 审核通过 + 已发布 + 公开”的合集；后台 `admin/collections.php` 也已补上初审 / 内容复审 / 终审三段式审核阶段，待审核、已驳回和已回收合集会自动隔离在后台管理端。 |
| 合集条目点击热度 / 跳转追踪（基础版） | 本轮完成 | 已新增 `collection-link.php` 统一承接合集条目跳转，`collection-detail.php` 里的项目 / 资源 / 帮助文档 / 页面 / 外链条目现会累计 `click_count`；`collections.php`、`index.php` 和 `admin/collections.php` 也会同步展示点击热度，并继续兼容移动端与深色模式。 |
| 关于页 | 已完成 | 已有个人 / 站点介绍与信息卡结构。 |
| 联系页 | 已完成 | 已有联系信息与留言提交入口。 |
| 帮助中心（增强版） | 本轮完成 | `help.php` 现已支持从数据库动态读取帮助分类、帮助文档与 FAQ，并接入搜索关键词、FAQ 联搜、关联阅读、目录式阅读布局、帮助文档阅读统计、搜索热词、文档附件展示、搜索结果高亮、章节化内容分区阅读、前台展示规则切换，以及文档内搜索 / 阅读进度记忆 / 章节书签首版、已登录账号跨端阅读进度同步、普通访客阅读身份 / 同步码基础版、沉浸式阅读模式、当前章节高亮、字号 / 行高 / 阅读宽度调节、白天 / 夜间 / 护眼主题切换、章节命中结果列表、章节搜索排序策略、命中类型标签、帮助章节三引号代码块渲染、代码复制、代码块主题切换、阅读行为分析首版、停留时长 / 阅读质量分析、互动率 / 阅读参与度分析、阅读质量综合评分、阅读完成度 / 进度分布统计、文档内搜索趋势 / 转化统计、零命中分析、章节级阅读漏斗、搜索同义词 / 自动纠偏建议、`7 / 30 / 90` 天阅读分析时间范围切换、CSV 报表导出、上一周期报表对比、异常告警、内容运营建议、模板化运营 / 任务化编排，以及任务派发通知 / 状态回写 / 审批闭环；后台 `admin/help-center.php` 可直接维护帮助分类、帮助内容、分类表现、展示规则、阅读工具开关、跨端进度同步开关、章节级搜索范围 / 排序策略 / 结果条数、代码块纳入检索与命中标签显示、阅读模式 / 默认偏好 / 默认主题 / 默认代码块主题配置、搜索关键词、搜索纠偏规则、关联文档、章节内容、文档附件、排序、发布状态，并查看版本历史、高频阅读文档、帮助搜索热词，以及可按近 `7 / 30 / 90` 天切换、导出 CSV、和上一周期同窗口对比，并自动生成异常告警、内容运营建议、运营模板库、任务编排卡和任务跟进闭环的阅读事件概览、高频章节热区、停留时长 / 阅读质量排行、互动率排行、阅读质量综合评分排行、阅读完成度排行、章节阅读漏斗、阅读趋势、文档内搜索零命中排行和文档内搜索转化排行。 |
| 用户协议 / 隐私政策（增强版） | 本轮完成 | `terms.php` 与 `privacy.php` 现已支持后台 `admin/site-pages.php` 可视化维护、版本号 / 更新时间管理与 `static_page_versions` 历史留痕，前台也会同步展示最近版本记录。 |
| 站点地图（增强版） | 本轮完成 | `sitemap.php` HTML 版和 `sitemap.xml.php` XML 输出现已接入后台配置，可控制纳入内容类型、`changefreq / priority`、自动分片与 `?part=` 子文件输出；`admin/site-pages.php` 也已补上 `robots.txt` 在线编辑、根目录同步写入、搜索引擎推送配置 / 手动验证，以及项目 / 资源发布后自动推送开关。 |
| 友好 404 页面（增强版） | 本轮完成 | 已新增 `404.php` 承接页，并补齐 `not_found_logs` 访问统计；项目详情、资源详情、标签聚合页的缺失态现会自动入库，后台统计页可直接查看高频失效链接。 |
| 维护模式页（增强版） | 本轮完成 | `maintenance.php` 现已补齐白名单 IP、维护范围切换、恢复倒计时，以及公开写入 / 公开读取 API 的维护拦截，后台仍可继续做验收与排查。 |

---

## 五、互动与内容反馈

| 路线图方向 | 当前状态 | 已落地内容 |
| --- | --- | --- |
| 评论功能基础版 | 已完成 | 项目详情页支持评论展示与提交，后台支持审核和开关控制。 |
| 点赞功能基础版 | 已完成 | 项目详情页支持点赞，接口与后台开关已接通。 |
| 留言功能基础版 | 已完成 | 联系页留言、后台留言管理、状态切换、批量处理已具备。 |
| 通知中心基础版 | 已完成 | 后台已有通知中心，工具投稿等行为会推送站内通知。 |
| 工具投稿审核链路 | 已完成 | 前台投稿、后台待审核状态、通知提醒、日志记录已打通。 |

---

## 六、后台管理端

| 后台模块 | 当前状态 | 已落地内容 |
| --- | --- | --- |
| 仪表盘 | 已完成 | 已有统计卡、最近项目、热门项目、最新留言、待审评论，并补上实时重算、禁缓存响应头、旧库缺字段兼容补齐与页面级兼容提示。 |
| 项目管理 | 已完成 | 已支持创建、编辑、删除、状态切换、精选切换、列表查看，并可直接维护项目版本记录、FAQ 问答、文档章节和相关排序。 |
| 资源管理 | 已完成 | 已支持创建、编辑、删除、列表展示、推荐分值维护，并可维护资源真实分类、详情字段、链接状态、文档 / 镜像链接、查看跳转次数和前台详情入口。 |
| 分类管理中心（树形首版） | 本轮完成 | `admin/categories.php` 现已支持项目 / 资源分类父子级维护、层级校验、树形展示、子级删除拦截和路径显示，工具分类仍保留一级结构。 |
| 标签管理中心（首版） | 本轮完成 | 已新增 `admin/tags.php`，可统一维护项目标签，并支持热度统计、未使用标签删除、重复标签合并、标签说明、推荐标签维护，以及标签页浏览量 / 7 日趋势查看。 |
| 工具管理 | 已完成 | 已支持创建、编辑、删除、排序、状态管理、待审核工具发布。 |
| 评论管理 | 已完成 | 已支持筛选、审核、批量操作、CSV 导出、分页跳转。 |
| 留言管理 | 已完成 | 已支持筛选、详情查看、批量标已读 / 已回复 / 删除、CSV 导出。 |
| 用户管理 | 已完成 | 已支持用户创建、编辑、状态切换、批量状态修改、CSV 导出。 |
| 数据统计 | 已完成 | 已支持基础运营统计、热门项目排行、互动数据概览，并补上实时重算、旧库缺字段兼容补齐与兼容提示。 |
| 通知中心 | 已完成 | 已支持未读筛选、批量已读、分页查看。 |
| 站点设置 | 已完成 | 已支持站点资料、作者资料、联系方式、互动开关、首页运营模块配置。 |
| 合集管理中心（增强版） | 本轮完成 | `admin/collections.php` 现已支持合集主体 CRUD、审核状态 / 审核阶段 / 审核备注、审核历史时间线、批量通过 / 驳回 / 阶段流转 / 发布草稿 / 精选 / 可见性 / 分类 / 类型 / 章节模板 / 顺序重排 / 作者归属 / 回收恢复、独立统计面板、更细来源拆分、来源漏斗、站内页面 / 详情归因、外部域名归因、高点击跳转归因、项目 / 资源联动看板、联动观察池、可扩散候选、章节结构洞察、结构观察池、当前表单结构摘要、热度榜、软删除回收站、恢复 / 彻底删除、公开 / 私密与发布状态控制、首页精选标记、作者归属、条目分组配置、阶段队列统计和点击热度回流展示，并支持项目 / 资源 / 帮助文档 / 页面 / 外链 / 说明卡片混排。 |
| SQL 导入中心（持续增强） | 本轮完成 | `admin/sql-import.php` 已支持业务表白名单、可视化字段映射、来源字段自动识别、目标字段智能补全、文件 / 语句双模式、导入预览、字段类型校验、模板新增 / 更新 / 删除、任务详情、异步分批导入、实时进度、暂停 / 继续 / 终止、单日 / 单批次 / 并发 / 时段管控、失败明细导出、审计日志与 7 天内安全场景回滚。 |
| 操作日志 | 已完成 | 已支持日志列表、按操作人 / 时间筛选、CSV 导出。 |

---

## 七、文档与项目治理

| 路线图方向 | 当前状态 | 已落地内容 |
| --- | --- | --- |
| README | 已完成 | 已持续记录版本、部署说明、目录结构和阶段性进度。 |
| CHANGELOG | 已完成 | 已记录版本演进、修复轨迹与文档同步。 |
| ROADMAP | 已完成 | 已有完整规划文档，作为分阶段改造基线。 |
| 路线图状态拆分文档 | 本轮完成 | 新增 [ROADMAP_COMPLETED.md](./ROADMAP_COMPLETED.md) 与 [ROADMAP_PENDING.md](./ROADMAP_PENDING.md)。 |
| 文档目录整理 | 本轮完成 | 已把 `CHANGELOG.md`、`ROADMAP.md`、`ROADMAP_COMPLETED.md`、`ROADMAP_PENDING.md` 收拢到 `docs/` 目录，并补上旧路径兼容与 VS Code 文件分组设置，根目录观感更清爽。 |

---

## 八、本轮相对 `ROADMAP.md` 新增落地的内容

1. 首页公告通知栏已从“路线图描述”变成真实模块，并允许后台维护。
2. 首页快捷入口栏已落地，图标、标题、说明、链接与色调都可配置。
3. 首页热门标签云已接入真实标签数据，不再只是构想。
4. 首页新手引导区已落地，可配置提示文案和行动入口。
5. 后台 `站点设置` 已承担首页运营模块的首版配置职责。
6. 资源详情页已落地，资源模块不再只有“列表直接跳外链”的单层结构。
7. 资源模块已开始真正使用 `categories` 表，旧资源 `type` 可自动映射到真实资源分类。
8. 前台资源列表、资源详情页和资源 API 已统一接入分类字段与同分类入口，资源链路更完整。
9. 后台已新增首版分类管理中心，项目 / 资源 / 工具分类开始有统一维护入口。
10. 分类中心现已支持项目 / 资源父子级结构，能真正维护首版树形分类，而不只是单层目录。
11. 安装初始化 SQL 已同步补齐默认分类种子，新装站点可直接使用当前分类体系。
12. 后台已新增首版标签管理中心，项目标签开始具备统一维护、热度统计、浏览趋势查看和重复标签合并入口。
13. 项目编辑页已补上标签复用提示，保存项目后会自动同步标签使用次数。
14. 首页热门标签、项目筛选页、项目详情页和搜索联想已开始接入标签说明 / 推荐标签信息，标签体系不再只停留在后台列表。
15. 已新增独立 `tag.php` 标签聚合页，标签开始拥有自己的内容承接页，而不只是 `projects.php?tag=` 形式的筛选参数。
16. 标签页浏览量已开始累计，后台可查看累计浏览、近 7 天热度和最近访问情况，首版标签热度分析已落地。
17. 前台项目页和资源页现已支持一级 / 二级分类筛选，选中父分类时会自动聚合子级内容，不再只支持单层 slug 过滤。
18. 后台项目管理、资源管理、项目详情页和资源详情页已开始展示分类路径，多级分类不再只停留在分类管理页内部。
19. 后台项目管理现已新增首版版本记录与 FAQ 维护区，项目编辑不再只停留在基础介绍层。
20. 前台项目详情页已开始展示版本时间轴与 FAQ 折叠区，项目内容沉淀开始具备“持续更新 + 常见问题”结构。
21. 后台项目管理现已新增首版文档章节维护区，项目编辑可直接录入章节标题、锚点和结构化内容。
22. 前台项目详情页已开始展示章节目录、锚点跳转和章节正文，文档中的代码块也开始支持一键复制。
23. 项目详情页现已切成首版 Tab 化主体区，项目介绍、文档、版本记录、FAQ 与评论区可以分栏切换，并会记住上次查看位置。
24. 安装器现已补齐 `tag_daily_stats`、`project_versions`、`project_faqs`、`project_docs` 的表前缀替换，带自定义前缀的新装环境不会再把这些表按无前缀导入。
25. 安装初始化 SQL 现已开始兼容旧库恢复场景，导入时会先补齐 `categories.parent_id` 和 `tags` 的后续新增字段，再继续写默认分类与标签种子。
26. 后台现已新增首版 SQL 导入中心，管理员可按业务表范围导入 SQL，并在导入前看到字段映射、风险预览和失败明细。
27. SQL 导入中心现已接通模板保存、更新、删除、操作日志、失败明细导出和 7 天内安全场景回滚，历史数据迁移开始具备更完整的后台闭环。
28. SQL 导入预览现已补上字段长度 / 类型 / 日期 / URL / 邮箱 / 枚举校验，并可在同页查看任务详情、预览警告和最近失败明细，新装环境也会默认写入三套导入模板。
29. SQL 导入中心现已新增首版异步分批任务模式，预览通过后可启动任务、实时查看处理进度，并支持暂停、继续、终止和自动回滚已执行批次。
30. SQL 导入中心现已补齐最大并发导入数限制；分批任务在并发已满时会转为等待执行，直接执行模式也会按并发上限明确拦截，同时新装环境会同步写入并发管控默认设置。
31. SQL 导入字段映射现已升级为可视化面板，支持直接增删映射行、切换目标字段、查看原始规则同步结果，字段提示也会随目标表实时更新。
32. SQL 导入字段映射现已支持从 SQL 编辑器或本地 `.sql` 文件识别来源字段，并按当前业务表常见别名智能补全目标字段，管理员不再需要逐条手敲映射。
33. 前台现已新增首版友好 `404.php` 页面，项目详情、资源详情和标签聚合页在内容不存在时会直接进入搜索 + 推荐承接页，不再生硬跳回列表。
34. 友好 404 缺失态现已开始记录到 `not_found_logs`，后台 `admin/analytics.php` 可直接查看近 7 天 404 次数与高频失效路径，排查断链不再只能靠手工复现。
35. 维护模式现已从首版承接页继续增强到白名单 IP、维护范围切换和恢复倒计时；公开写入与公开读取 API 也开始按配置统一进入 `503` 维护响应。
36. 站点地图现已具备首版 HTML + XML 双输出：`sitemap.php` 可供访客人工浏览站点结构，`sitemap.xml.php` 可直接提交给搜索引擎或部署平台使用。
37. 用户协议与隐私政策现已补齐首版静态页：`terms.php` 和 `privacy.php` 已可直接访问，页脚与站点地图也已同步挂上入口。
38. 帮助中心现已补齐首版页面：`help.php` 支持按分类和关键词检索当前帮助内容，并提供常见问题折叠区与快速入口。
39. 后台现已新增 `admin/site-pages.php` 静态页面管理页，可集中维护协议 / 隐私文档正文、版本号、更新时间和更新摘要，并写入 `static_page_versions` 历史记录。
40. 站点地图现已继续增强到“后台配置 + 自动分片”阶段：纳入范围、`changefreq / priority` 和单文件 URL 上限都可配置，超过阈值时 `sitemap.xml.php` 会自动输出 sitemap index 与 `?part=` 分片。
41. `admin/site-pages.php` 现已继续补齐 `robots.txt` 在线编辑、根目录文件同步写入、搜索引擎推送配置与手动推送验证，静态页与抓取入口开始形成更完整的后台闭环。
42. 项目与资源在“发布”动作上现已支持自动触发搜索引擎推送，后台配置页可直接开启 / 关闭该能力，并统一记录最近一次推送结果。
43. 帮助中心现已升级到“后台可维护”阶段：`admin/help-center.php` 可直接维护帮助文档、分类表现与 FAQ，前台 `help.php` 会自动读取数据库中的最新内容。
44. 帮助中心现已补上首版版本留痕：`help_article_versions` 会记录帮助文档每次保存的快照、版本摘要与操作人，后台帮助中心可直接查看最近版本历史。
45. 帮助中心现已补上搜索关键词、FAQ 联搜与关联阅读：管理员可为帮助文档配置搜索关键词和关联文档 Slug，前台搜索会同时命中这些字段；文档 Slug 变更或删除时，关联引用也会自动同步清理。
46. 帮助中心现已补上目录式阅读和统计运营承接：前台帮助页改为“目录 + 正文”结构，并开始沉淀帮助文档阅读次数、最近阅读时间和近 30 天搜索热词；后台帮助中心也可直接查看高频阅读文档和搜索热词面板。
47. 帮助中心现已补上文档附件管理：后台每篇帮助文档都可维护“名称 / 链接 / 说明”形式的附件清单，前台会以附件卡片展示并纳入帮助搜索，版本快照与初始化 SQL 也会同步保留附件数据。
48. 帮助中心现已补上搜索结果高亮：当前帮助搜索命中后，目录标题、正文摘要、帮助要点、文档附件、同批匹配文档和 FAQ 问答都会直接高亮关键词，定位问题时不再需要二次翻找。
49. 帮助中心现已补上章节化内容编辑：后台每篇帮助文档都可按 `## 章节标题 | 锚点` 维护章节正文，前台会自动生成章节导航、分区阅读卡片，并把章节标题 / 正文一起纳入搜索与高亮。
50. 帮助中心现已补上帮助分类独立管理：后台可单独新增、编辑、排序和隐藏帮助分类，前台会按分类中心的名称、图标、色调和排序统一输出帮助筛选与目录结构。
51. 帮助中心现已补上前台展示规则配置：后台可直接切换目录样式、FAQ 默认展开方式，并控制搜索热词、分类说明和文章章节导航是否显示，前台帮助页会实时按规则渲染且继续兼容移动端与深色模式。
52. 帮助中心现已补上阅读工具首版：前台当前文档支持文档内搜索、阅读进度记忆、继续上次阅读和章节书签；后台可统一控制这些阅读工具是否开启，移动端与深色模式也会一起承接。
53. 帮助中心现已补上沉浸式阅读模式与阅读偏好：前台当前文档可一键切换沉浸式阅读，并支持当前章节自动高亮、字号 / 行高 / 阅读宽度本地记忆；后台可统一控制阅读模式、偏好面板及默认阅读样式，移动端与深色模式会一起承接。
54. 帮助中心现已补上阅读主题配色：前台当前文档可在白天 / 夜间 / 护眼三套主题间切换并本地记忆，帮助正文、章节卡片和附件卡会一起跟随主题变化；后台可统一控制主题切换是否开放，并设置默认阅读主题，移动端与深色模式也会一起承接。
55. 帮助中心现已补上章节级搜索配置：前台当前文档搜索会额外列出命中的章节结果、摘要片段和一键跳转入口；后台可统一控制章节命中面板、搜索范围和结果条数，移动端与深色模式会一起承接。
56. 帮助中心现已补上代码块主题切换：帮助章节支持三引号代码块渲染、行内代码样式和代码复制，前台可在“跟随阅读主题 / 浅色代码 / 午夜深色 / 终端绿黑”之间切换代码块主题；后台也可统一控制该能力和默认代码块主题，移动端与深色模式会一起承接。
57. 帮助中心现已补上更细的章节搜索权重与命中类型配置：前台当前文档搜索可按“标题优先 / 综合均衡 / 代码优先”排序章节结果，并标出标题 / 锚点 / 正文 / 代码命中标签；后台也可统一控制代码块是否纳入章节检索以及是否显示命中类型标签，移动端与深色模式会一起承接。
58. 帮助中心现已补上阅读行为分析首版：前台当前文档会继续沉淀章节阅读、继续上次阅读、章节搜索跳转、书签新增和代码复制等阅读行为事件；后台帮助中心可直接查看近 30 天阅读事件概览与高频章节热区，帮助持续优化技术文档的结构和重点内容。
59. 帮助中心现已补上文档内搜索趋势与转化统计：前台当前文档会继续沉淀文档内搜索关键词和章节搜索跳转关键词；后台帮助中心可直接查看近 7 天阅读趋势、每天的搜索 / 跳转 / 阅读 / 复制变化，以及高频关键词的搜索次数、跳转次数、覆盖文档数与转化率。
60. 帮助中心现已补上文档内搜索零命中分析：前台当前文档在关键词没有命中任何内容区块时会继续沉淀零命中事件；后台帮助中心可直接查看近 30 天零命中次数、零命中率、最近零命中时间和高频零命中关键词排行，方便继续按路线图定位帮助内容缺口。
61. 帮助中心现已补上更细的章节级阅读漏斗：后台帮助中心可直接查看近 30 天纳入漏斗的章节数、跳转 / 收藏 / 复制覆盖率，并按章节展示阅读次数、跳转率、收藏率、复制率和综合互动率，方便继续按路线图优化高价值章节与低转化章节。
62. 帮助中心现已补上搜索同义词 / 自动纠偏建议：后台帮助中心可直接维护 `规范词 => 别名` 规则，前台帮助搜索和当前文档搜索在零命中或结果较少时，会自动推荐更接近的关键词，方便继续按路线图把 Mac / macOS / OSX、SQL 导入 / 导库等常见写法统一起来。
63. 帮助中心现已补上已登录账号的跨端阅读进度同步基础版：前台当前文档会先合并本地与云端阅读进度，再展示“继续上次阅读”入口并按节流策略写回云端；后台帮助中心也可统一控制跨端同步开关，同时修复首次进入文档时覆盖旧进度的问题。
64. 帮助中心现已补上阅读完成度 / 进度分布统计基础版：前台当前文档会自动沉淀 25% / 50% / 75% / 完读里程碑事件；后台帮助中心可直接查看起始阅读人数、阶段覆盖率、完读率、完读文档数和文档级完读排行，继续按路线图补齐阅读质量分析能力。
65. 帮助中心现已补上停留时长 / 阅读质量分析基础版：前台当前文档会按可见章节、有效交互和页面可见状态持续沉淀有效停留秒数；后台帮助中心可直接查看累计停留、人均停留、深读率、完读均停留和文档级阅读质量排行，继续按路线图补齐更细的帮助内容运营分析能力。
66. 帮助中心现已补上互动率 / 阅读参与度分析基础版：后台帮助中心可直接按搜索跳转、书签新增、代码复制、继续阅读等互动事件汇总互动读者率、互动事件量、互动读者均互动次数和文档级互动率排行，继续按路线图补齐“完读率 + 停留时长 + 互动率”的内容效果分析闭环。
67. 帮助中心现已补上阅读质量综合评分基础版：后台帮助中心会把完读率、互动率和人均停留时长合成为文档级质量分数，并按“高价值 / 潜力 / 待优化 / 观察中”识别文档状态，继续按路线图补齐高价值内容识别能力。
68. 帮助中心现已补上阅读分析时间范围切换基础版：后台帮助中心可直接在近 `7 / 30 / 90` 天之间切换同一套报表窗口，帮助搜索热词、阅读趋势、完读率、停留时长、互动率、质量评分、章节漏斗、零命中和搜索转化都会统一联动，继续按路线图补齐更精细的帮助内容运营分析能力。
69. 帮助中心现已补上阅读分析报表导出基础版：后台帮助中心可直接把当前 `7 / 30 / 90` 天窗口下的热词、阅读趋势、完读率、停留时长、互动率、质量评分、章节漏斗、零命中和搜索转化统一导出为 CSV，方便继续按路线图做留档、复盘和跨团队同步。
70. 帮助中心现已补上阅读分析报表对比基础版：后台帮助中心可直接把当前 `7 / 30 / 90` 天窗口与上一周期同窗口做对比分析，快速复盘帮助搜索、阅读事件、完读率、人均停留、互动率、质量均分、零命中率和搜索转化率的变化。
71. 帮助中心现已补上阅读分析异常告警基础版：后台帮助中心会结合当前窗口和上一周期同窗口，对零命中率、完读率、停留时长、互动率、质量均分、搜索转化，以及高访问低质量文档和高频零命中关键词自动给出风险提示。
72. 帮助中心现已补上内容运营建议基础版：后台帮助中心会把高频零命中关键词、低完读文档、低转化搜索词、高价值文档和高互动章节整理成优先处理队列，方便内容运营直接落动作。
73. 帮助中心现已补上模板化运营 / 任务化编排基础版：后台帮助中心可维护运营模板库，并把当前窗口的运营建议自动映射成“今日排期 / 本周编排 / 观察池”任务卡，直接输出步骤清单、负责人、建议截止天数和可复制执行文案。
74. 帮助中心现已补上任务派发通知 / 状态回写 / 审批闭环：后台帮助中心可把模板任务直接派发给负责人和审核人，通知中心会带深链回任务筛选视图；任务跟进区也可继续回写处理中 / 待审核 / 已通过 / 待调整状态，形成基础审核闭环。
75. 帮助中心现已补上普通访客阅读身份 / 同步码基础版：前台 `help.php` 可直接创建阅读身份、一次性展示同步码、连接已有同步码和断开当前设备；`api/help-reader.php` 与 `help_reader_progress` 也会按阅读身份继续复用既有云端进度同步链路，让普通访客在 Mac、手机和其他设备间继续同步帮助文档阅读进度。
76. 首页现已补上创作者推荐首版：前台会优先按已发布项目作者自动汇总活跃创作者，也支持后台直接维护手动推荐名单，在当前作者主页体系尚未完成前先把首页内容承接补起来。
77. 首页现已补上站点动态首版：前台会按时间流统一展示项目发布 / 更新、资源上新 / 更新，以及已通过评论的互动动态；后台可直接控制动态条数和是否纳入评论，让首页开始具备持续刷新的内容节奏。
78. 首页现已补上精选合集模块首版：后台可直接维护专题标题、简介、首页展示条数和专题卡片列表，首页会把项目、资源、帮助文档和排错经验按主题做成专题卡片承接。
79. 前台现已补上 `collections.php` 专题页首版：当前先按手动运营方式集中承接专题卡片，并同步接入侧边导航与页脚入口，方便后续继续升级为完整合集中心。
80. 合集中心现已进入数据化首版：前台 `collections.php` 会直接读取 `collections` 表里的已发布合集，支持关键词 / 分类 / 精选筛选，并继续保留手动专题卡片兜底。
81. 前台现已补上 `collection-detail.php` 合集详情页：合集可按分组继续承接项目、资源、帮助文档、页面、外链和说明卡片，开始具备真正的专题内容编排能力。
82. 后台现已补上 `admin/collections.php` 合集管理首版：管理员可直接维护合集主体、条目分组和首页精选标记，首页 `index.php` 也会优先读取数据库合集，不再只依赖站点设置里的手动专题卡片。
83. 合集中心本轮已补上基础互动能力：前台 `collection-detail.php` 现支持设备级订阅 / 收藏切换，并通过 `collection_interactions` 记录合集互动状态，为后续前台账号体系保留升级空间。
84. 合集互动热度现已同步回流到前后台多个承接位：`collections.php`、`index.php` 和 `admin/collections.php` 会直接展示合集订阅量 / 收藏量，不再只有浏览量和条目数。
85. 初始化 SQL 与后台 SQL 导入本轮也已同步纳入合集互动表：`install/database_init.sql` 现会创建 `collection_interactions`、补齐默认互动种子，`admin/sql-import.php` 也已识别合集互动迁移模板和对应业务表白名单。
86. 合集中心本轮已补上基础审核隔离：前台 `collections.php`、`collection-detail.php` 和首页精选合集只会展示“未删除 + 审核通过 + 已发布 + 公开”的合集，待审核 / 已驳回内容不会提前暴露到前台。
87. 后台合集管理本轮已补上基础回收站：管理员可把合集移入回收站、恢复或彻底删除；软删除期间会保留条目与互动记录，直到明确执行最终清理。
88. 初始化 SQL、默认站点设置与 SQL 导入规格本轮也已同步纳入合集审核 / 回收字段，让新装环境、旧库恢复和后台迁移配置都能直接承接当前合集运营基础版。
89. 合集详情本轮已补上条目点击热度基础版：`collection-detail.php` 里的项目 / 资源 / 帮助文档 / 页面 / 外链条目现会统一经过 `collection-link.php` 跳转，并按条目累计 `click_count`，详情头部与分组标题也会同步展示热度。
90. 合集列表、首页精选合集与后台管理页本轮已同步承接点击热度：`collections.php` 新增按更新时间 / 浏览 / 点击 / 互动排序，`index.php` 的精选合集卡片与 `admin/collections.php` 的曝光列也会直接展示条目点击量。
91. 初始化 SQL、默认站点设置与 SQL 导入规格本轮也已同步纳入 `collection_items.click_count`、旧库兼容补列和默认热度种子，让新装环境、恢复环境和后台导入配置都能直接承接这轮合集点击热度基础版。
92. 后台合集管理本轮已补上多阶段审核基础版：管理员可为待审核 / 已驳回合集标记初审、内容复审或终审阶段，列表筛选、状态徽章、表单摘要和队列统计都会同步展示当前审核进度；已通过合集保存时会自动归到终审。
93. 初始化 SQL、默认站点设置与 SQL 导入规格本轮也已同步纳入 `collections.review_stage`、`idx_review_stage`、旧库兼容补列与审核阶段迁移说明，让新装环境、恢复环境和后台导入配置都能直接承接这轮合集多阶段审核基础版。
94. 后台合集管理本轮已补上审核历史留痕基础版：当管理员修改合集的审核状态、审核阶段或审核备注时，`admin/collections.php` 会自动写入时间线记录，并在右侧详情卡直接展示最近审核流转。
95. 初始化 SQL、默认站点设置与 SQL 导入规格本轮也已同步纳入 `collection_review_logs`、合集审核历史迁移模板、导入白名单补齐和默认留痕种子，让新装环境、恢复环境和后台导入配置都能直接承接这轮合集审核追溯基础版。
96. 后台合集管理本轮已补上批量审核 / 批量状态操作基础版：管理员可直接在 `admin/collections.php` 列表区勾选合集，批量执行通过、驳回、初审 / 内容复审 / 终审批量流转、发布 / 草稿，以及回收 / 恢复操作；批量审核备注也会和单条审核一样继续进入时间线。
97. 初始化 SQL、默认站点设置与 SQL 导入规格本轮也已同步纳入 `collections.last_review_action_at`、旧库兼容补列 / 索引、默认审核动作时间回填，以及“合集中心补上批量审核管理”的首页公告 / 弹窗文案，让新装环境、恢复环境和后台导入配置都能直接承接这轮合集批量审核基础版。
98. 后台合集管理本轮已补上独立统计面板基础版：`admin/collections.php` 现已支持独立查看公开可展示率、平均条目、平均互动、审核活跃度、待审积压、来源拆分概览、分类热点和热度榜，运营复盘不再只依赖顶部总数条。
99. 初始化 SQL、默认站点设置与公共默认文案本轮也已同步切到“合集中心补上独立统计面板”的当前阶段，确保新装环境、恢复环境和默认配置都能直接承接这轮合集运营看板基础版能力。
100. 后台合集管理本轮已补上更细来源拆分与章节结构洞察基础版：`admin/collections.php` 现已支持按来源回看覆盖合集数、单合集均值和单条点击均值，并新增章节结构洞察卡、结构观察池和当前表单结构摘要，方便管理员直接发现单分组、未命名分组、说明卡偏重和来源单一的合集。
101. 初始化 SQL、默认站点设置与公共默认文案本轮也已同步切到“合集中心补上章节结构洞察”的当前阶段，并把首页公告弹窗版本提升到 `home-popup-v11`，确保新装环境、恢复环境和默认配置都能直接承接这轮合集来源细分与结构洞察基础版能力。
102. 后台合集管理本轮已补上更完整批量运营动作基础版：`admin/collections.php` 现已支持批量设为精选 / 取消精选、批量设为公开 / 私密，以及批量设置作者归属 / 清空作者归属；列表区也会同步展示新的批量能力提示和作者选择器，管理员不再只能逐条调整运营属性。
103. 初始化 SQL、默认站点设置与公共默认文案本轮也已同步切到“合集中心补上批量运营动作”的当前阶段，并把首页公告弹窗版本提升到 `home-popup-v12`，确保新装环境、恢复环境和默认配置都能直接承接这轮合集批量运营增强基础版能力。
104. 后台合集管理本轮已补上来源漏斗 / 跳转归因基础版：`admin/collections.php` 现已支持把来源继续细到域名 / 站内页面 / 详情目标层级，并直接查看来源漏斗、站内页面 / 详情归因、外部域名归因和高点击跳转归因，管理员可更直接识别哪些目标已形成点击、哪些目标仍停留在“已配置但未点击”的阶段。
105. 初始化 SQL、默认站点设置与公共默认文案本轮也已同步切到“合集中心补上来源漏斗归因”的当前阶段，并把首页公告弹窗版本提升到 `home-popup-v13`，确保新装环境、恢复环境和默认配置都能直接承接这轮合集来源漏斗 / 跳转归因增强基础版能力。
106. 后台合集管理本轮已补上批量分类 / 批量类型基础版：`admin/collections.php` 现已支持批量设置分类 / 清空分类，以及批量设置合集类型，管理员可直接按主题统一整理合集分类归属和官方 / 用户类型，不再需要逐条修改。
107. 初始化 SQL、默认站点设置与公共默认文案本轮也已同步切到“合集中心补上批量分类与类型”的当前阶段，并把首页公告弹窗版本提升到 `home-popup-v14`，确保新装环境、恢复环境和默认配置都能直接承接这轮合集批量编排增强基础版能力。
108. 后台合集管理本轮已补上批量章节模板 / 章节排序联动基础版：`admin/collections.php` 现已支持批量套用章节模板、批量重排章节顺序，并新增章节模板库；当前表单在保存时也会自动按章节顺序整理条目，减少分组顺序散乱的问题。
109. 初始化 SQL、默认站点设置与公共默认文案本轮也已同步切到“合集中心补上章节模板联动”的当前阶段，并把首页公告弹窗版本提升到 `home-popup-v15`，确保新装环境、恢复环境和默认配置都能直接承接这轮合集章节模板 / 排序联动增强基础版能力。
110. 后台合集管理本轮已补上项目 / 资源联动运营基础版：`admin/collections.php` 现已支持按项目 / 资源查看联动合集数、跨合集复用、点击热度、问题目标观察池和可扩散候选，管理员可直接判断哪些目标值得继续扩散、哪些目标需要先修复状态。
111. 初始化 SQL、默认站点设置与公共默认文案本轮也已同步切到“合集中心补上项目 / 资源联动运营”的当前阶段，并把首页公告弹窗版本提升到 `home-popup-v16`，确保新装环境、恢复环境和默认配置都能直接承接这轮合集联动运营增强基础版能力。
112. 项目根目录本轮已完成一轮低风险整理：更新日志和路线图相关文档已统一移入 `docs/` 目录，根目录先减少 4 个散落文档文件，保留 `README.md` 作为项目入口说明。
113. 旧文档路径本轮也已补上兼容：`rjzy_collection_resolve_link()`、首页入口和页脚 / 站点地图链接现在会自动把旧的 `CHANGELOG.md`、`ROADMAP_PENDING.md` 等路径映射到 `docs/`，同时新增 `.vscode/settings.json` 做根目录入口页折叠显示。

---

## 九、已完成但仍建议继续打磨的区域

这些内容已经“有”，所以放在已完成文档中；但它们还值得继续增强：

- 首页模块目前已进入首版运营配置，轮播、模块开关和排序已经落地，但距离路线图中“自定义模块增删、展示规则、权限配置、全可视化管理”还有距离。
- 首页创作者推荐与站点动态虽然已经落地首版，但作者主页、关注能力、合集联动、更细的运营规则和点击统计还没有完成。
- 精选合集虽然已经补到了数据化列表、详情页、后台 CRUD、基础订阅 / 收藏、基础审核 / 回收站、条目点击热度、多阶段审核基础版、审核历史留痕基础版、批量审核基础版、独立统计面板基础版、来源细分 / 章节结构洞察基础版、来源漏斗 / 跳转归因基础版、批量分类 / 批量类型基础版、批量章节模板 / 章节排序联动基础版、项目 / 资源联动运营基础版，以及批量运营增强基础版能力，但合集分享 / 批量导出和更多前台行为统计还没有完成。
- 项目详情页虽然已经补上首版 Tab 化结构、版本记录、FAQ 和文档章节，但多级目录树、版本对比、评分和更完整的内容运营能力仍未完成。
- SQL 导入中心虽然已补到字段校验、模板管理、任务详情、异步分批执行、限流管控和智能映射，但短信二次验证、跨表联动导入和更完整的多表迁移编排仍未完成。
- 维护模式虽然已经补齐白名单 IP、影响范围切换和恢复倒计时，但维护原因分类、服务健康状态展示和更细的应急编排仍未完成。
- 后台内容管理已经具备可用骨架，合集也已补上多阶段审核、批量审核、独立统计面板、章节结构洞察、来源漏斗 / 跳转归因、批量分类 / 批量类型、批量章节模板 / 章节排序联动、项目 / 资源联动运营和批量运营增强基础版，但跨内容类型的统一审核流、合集分享 / 批量导出和更多前台运营能力还没到位。