Repo Document

更新日志 - 2026年4月7日

重写 docs/Openclash Config.md

changelogs/2026-04-07.md更新于 2026年4月12日

更新日志 - 2026年4月7日

文档体系更新

1) 重写 OpenClash 主手册

  • 重写 docs/Openclash_Config.md
  • 将教程改为“一份文档,按版本分流”的结构
  • 明确区分:
    • OpenWrt 24.10 及更早稳定版 使用 opkg
    • OpenWrt 25.12 及更新版本 / 新分支 使用 apk
  • 补充内容包括:
    • 如何判断系统版本
    • 如何选择仓库内不同 YAML 配置
    • config_linkedin_auto.yaml 的适用场景
    • 学术网站为何通常建议走直连
    • 如何添加自定义直连/代理规则

2) 补全 opkg / apk 双版本说明

  • 更新 docs/ExtendOverlaySize.md
  • 更新 docs/en/ExtendOverlaySize.md
  • 更新 docs/Storage_Expansion_Guide.md
  • 更新 docs/en/Storage_Expansion_Guide.md
  • 更新 docs/OpenWrt_AutoBackup.md
  • 更新 docs/en/OpenWrt_AutoBackup.md
  • 更新 docs/OpenWrt_Backup_Resotre.md
  • 更新 docs/en/OpenWrt_Backup_Resotre.md
  • 更新 docs/System_Maintenance.md
  • 更新 docs/en/System_Maintenance.md
  • 更新 scripts/README.md
  • 更新 scripts/README_EN.md
  • 将多个原本默认写死 opkg 的页面,统一改成:
    • 先判断系统版本
    • 再分别给出 opkg / apk 路线
  • 对第三方安装脚本增加兼容性提醒,避免在 25.12+ 上直接照抄旧命令

3) 同步 README 入口说明

  • 更新 README.md
  • 更新 README_EN.md
  • 让首页入口明确说明:
    • OpenClash 教程已经兼容 opkg / apk
    • 主题与插件安装不再默认照抄旧命令
    • 推荐直接进入新版主手册

前端重构

4) 重做文档站首页信息结构

  • 更新 frontend/components/HomePage.tsx
  • 更新 frontend/app/globals.css
  • 首页重新组织为:
    • 核心介绍
    • 版本分流提示
    • 推荐阅读路径
    • 文档分组目录
  • 强化“先判断版本,再执行命令”的信息层级

5) 重做文档阅读页头部

  • 更新 frontend/app/m/[...slug]/page.tsx
  • 更新 frontend/app/en/m/[...slug]/page.tsx
  • 文档页新增更清晰的页头信息:
    • 文档标题
    • 摘要
    • 仓库路径
    • 更新时间
    • 语言切换入口

结果

  • 新旧 OpenWrt 版本的读者现在会先看到 opkg / apk 分流,不再直接掉进旧教程
  • OpenClash 主手册从“补丁式说明”变成了可持续维护的主教程
  • 首页与文档页的阅读路径更清晰,前端视觉层级更稳定