更新

从 v1.0 立项到 v6.9，记录每一个版本的关键变化。

v6.9 2026-08-25 当前版本

v6.9 分享入口整合

  • 顶部分享按钮改为弹出站内分享面板（不再直接复制链接，手机/电脑体验统一）
  • 邮箱分享渠道下线：分享面板与后台渠道候选均移除，不再显示
  • 分享入口合并：移除顶部分享按钮，仅保留右下角悬浮分享面板（后台「浮动分享按钮」开关控制）
v6.8 2026-08-24

v6.8 AI 运维助手说明书

  • AI 运维助手说明书注入指令层：系统结构图（主站 / 数据API / KV / 助手关系）、数据存储结构（cfg / cat / lnk / sec / ai / widget）、分类与 id 规则、链接字段、模型配置（内置优先 → 智谱免费备选 → 自费厂商）、操作 SOP、红线（绝不 POST /api/kv 全量替换、sec.json 只读等）
  • 说明书仅 AI 运维助手内部使用不公开：完整版存本地私有副本（gitignore），仓库与线上无公开文档
v6.7 2026-08-24

v6.7 AI 运维知识库

  • AI 运维知识库注入指令层：数据文件结构、链接字段（id/nm/url 必填）、id/ord 递增规则、事故规避（数据修改走单文件接口，绝不 POST /api/kv 全量替换）
v6.6 2026-08-24

v6.6 分类定位与一键加链接

  • nav_cat_resolve：分类/子分类名 → 链接文件精确路径（如「知识百科」→ lnk/Cat8_2.json），杜绝猜测 Cat 编号
  • nav_link_add：一键添加链接（自动定位分类、生成唯一 id、去重、保持 Lnk 数组格式）
v6.5 2026-08-24

v6.5 平台全管理与 KV 备份

  • EdgeOne Pages 平台管理：环境变量 list/set/rm、部署记录查询、平台状态、手动触发构建
  • KV 全量备份（nav_kv_backup）与高危全量恢复（nav_kv_restore，恢复前必须备份并确认）
v6.4 2026-08-24

v6.4 双项目自治与 Gitee API

  • 管理目标解析：main 主站 / self 自身，AI 助手可统一管理两个项目
  • 仓库读写改 Gitee REST API（不再依赖沙箱命令执行）
  • 构建期向助手页面注入 build-time 构建标记，供 nav_build_check 轮询验证上线
v6.3 2026-08-24

v6.3 前台体验与 AI 助手扩权

  • 前台体验：首屏按需加载 + 记忆子分类（/api/catlnk 按需拉取 + 悬停预取 + localStorage 持久缓存 + 记忆上次子分类）、站内搜索联想（/api/search 防抖联想）、PWA 离线包（manifest + Service Worker 网络优先离线兜底）、RSS 订阅（/rss.xml 收录更新订阅 + 页脚入口）、失效跳转友好提示页（/go 跳转页网络探测 + 反馈失效链接入口）
  • AI 运维助手扩权：依赖/漏洞管理（nav_dep_check：npm registry 版本对比 + pnpm audit 尽力审计）、构建验证（nav_build_check：轮询站点 build-time 构建标记确认部署完成）、修改 UI 升级为多文件批量提交（nav_edit_push 一次提交多个文件）
  • 工程重构：运维脚本统一入口 ops.mjs（env / kv / deploy / build 子命令，原脚本保留兼容）；前后端规则经核查无重复维护面（颜色白名单/URL 协议各单一职责），保留单点维护
v6.2 2026-08-23

v6.2 安全加固与全面清理

  • iconfont 纯云端同步链路：后台改图标库链接 → 自动触发云端重建 → 构建期同步到本地 → 前后台统一本地加载（修复微信等内置浏览器图标不显示）
  • 主站安全加固：JSON API 统一安全响应头（nosniff / 禁 iframe 嵌套 / referrer 策略）、后台 CSP、前台隐私 referrer 策略
  • AI 运维助手安全加固：命令注入防护（路径/消息白名单）、来源白名单（仅主站后台可访问）、密钥信息脱敏
  • 双项目纯云端收官：Git 导入模式为唯一正式部署方式（主站 main / 助手 master），push 即自动构建上线，本地工具仅作应急
  • 全面清理：删除模板残留、死代码/死配置键、调试脚本与过期文档，README 重写为真实项目文档
v6.1 2026-08-22

v6.1 加固与发布链路

  • 安全加固：后台密码改 PBKDF2 哈希比对、天气 Key 入后台「密钥管理」面板、推荐位颜色规则白名单、data/ 加入 .gitignore
  • 接口防护：登录防爆破 + IP/UA 分桶限流 + 全局限流、后台备份自动清理、点击统计
  • Git 导入模式：Gitee 作为唯一代码源直连 Makers，push 自动构建上线，本地电脑退出部署链路
  • 后台「发布」一键重建：部署钩子（MAKERS_DEPLOY_HOOK）自动触发构建，改数据 + 点发布即前台生效
  • 热榜源修复：微博/抖音官方接口失效后经 uapis.cn 免费聚合恢复；热榜支持后台填「自定义接口 URL」（SSRF 防护 + 失效自动降级内置源）
  • 外部接口后台可配：天气（源/Key/Host）、一言（接口地址）、热榜（来源/自定义接口）均可后台修改；日历为本地计算、零外部依赖
  • 图标库支持 iconfont 真实前缀 icon-*（兼容 ic-* / mdi:*），前后台渲染逻辑一致
  • 广告位增强：文字广告支持文字颜色/链接/描述，图片广告支持描述，视频广告支持链接 + 描述
v6.0 2026-08 下旬

v6.0 整合版

  • 整合 v3.0 交互体系与 v5.0 特性：后台 UI/交互与 v3.0 一致，保留 v5.0 的 AI 运维助手、iconfont 图标、登录校验、深色侧栏
  • 全量数据缓存 → 本地过滤：切换分类、站内搜索零请求，对标参考站纯前端体验
  • 后台路径 /manage 由平台环境变量 ADMIN_PATH 控制，构建期自动生成
v5.0 2026-08-19

v5.0 重建版（绕开 Gitee，本地构建部署）

  • 从 0 重建：彻底绕开 Gitee，改 EdgeOne Makers 本地构建部署（Upload 类型），一条命令直达线上
  • AI 运维助手：独立 Agent 项目（futtnav-ai）+ 主站后台 /api/agent/* 代理集成，仅开发者后台可见
  • 站内分享功能：右悬浮分享按钮（微信/微博/QQ空间/复制链接）+ 后台开关
  • 数据链路：/api/all 全量拉取 → localStorage 持久缓存 → 内存过滤；后台保存 meta_dv 自增、前台自动重拉（保存即生效）
  • 加速区域固定全球可用区（含中国大陆）
v4.0 2026-08 中旬

v4.0 Gitee 集成版

  • 尝试 Gitee 集成部署（Provider: Gitee）
  • 数据模型与 API 升级 v4.0（/api/all、/api/catlnk 双兼容响应）
  • 凭据环境变量化：ADMIN_USER / ADMIN_PASS / ADMIN_PATH 统一由环境变量管理
  • 图标方案完善：iconfont（ic-* / mdi:*）优先 + 自定义图片 + DNSPod favicon 代理
v3.0 2026-08 中旬

v3.0 前台交互体系（零请求）

  • 全量数据缓存 → 本地过滤：首帧后后台静默拉取全量数据，切换分类、站内搜索均为纯本地操作（零请求）
  • 前端交互单文件重构（front.ts），后台/前台数据响应双兼容
v2.3 2026-08-17

v2.3 部署终检收敛 + iconfont 上线

  • 全新干净开发目录（navsite-new），pnpm 一次性安装成功
  • 依赖健康度核查：锁定 astro 6.4.8、packageManager pnpm@11.22.0
  • 修复后台「头部自定义代码」cfg.headHtml 此前未渲染的隐藏 bug
  • iconfont 图标库上线（后台可编辑 CDN，自动 preconnect + crossorigin 加载）
  • MAKERS=1 生产构建验证通过（@edgeone/astro 适配器）
v2.2 2026-08-17

v2.2 生产部署前整体重构整备

  • 清理开发期临时文件（21 个探测脚本、日志、_verify.html、ck.txt）与泄漏端点 /api/diag
  • 工具函数收敛单源：HTML 转义、图标映射/兜底/favicon 代理、网络请求与 IP、TTL 缓存、公开接口限流统一
  • API 统一：catlnk / search / click / data 复用 json()/readBody，hot / weather 复用缓存与限流
  • 安全加固：移除 diag 端点、公开读接口防滥用；帮助/隐私/关于页面重写
  • 凭据三合一环境变量化（ADMIN_USER / ADMIN_PATH / ADMIN_PASS），后台一律禁止修改
v2.0 2026-08-17

v2.0 前台体验改造

  • 包管理器 npm → pnpm（依赖不可变 + 脚本白名单 + 内容寻址存储）
  • 首页按需加载：子分类链接不再全量内联，改为 /api/catlnk 按需拉取 + 悬停预取 + localStorage 持久缓存（数据版本号失效）+ 记忆上次子分类
  • 站内搜索改为输入联想：删除引擎下拉虚拟项，新增 /api/search 联想接口（防抖 250ms、limit=8、回车仍走真实引擎）
  • 图标优先级定稿：iconfont > 自定义图片 > DNSPod favicon 代理，前后台渲染逻辑一致
v1.9 2026-08-15

v1.9 前台交互特效定稿

  • 前台 hover 高亮统一、友链规格补齐
v1.8 2026-08-14

v1.8 CSS 单位规范

  • 主单位 rem，边框/细线/断点例外 px
v1.7 2026-08-13

v1.7 前台布局重构

  • 精选推荐并入分类树 Cat1（首个主分类 + 子分类 Tab）
  • 新增右侧挂件栏 Widget（天气/一言/热榜/时钟）
  • 搜索引擎支持图标/联盟号/默认引擎
  • Header 滚动吸顶 + 左侧分类栏滚动跟随
v1.1 2026-08-12

v1.1 规格细化

  • 后台功能模块规格细化、favicon 代理方案、数据保存/发布双轨制、R1 风险与方案 A/B 决策
v1.0 2026-08-11

v1.0 项目立项

  • 技术栈（Astro + React + Tailwind）、三栏布局、数据模型、后台模块清单、部署链路（Makers）定稿