SimpleNav/README.md

# SimpleNav · 简航

简航（SimpleNav），一个面向个人的**轻量级网站导航系统**。PHP + SQLite，零外部依赖、无需 Composer，上传即用。

## 特点

- **轻量**：纯 PHP + SQLite，不依赖 MySQL / 框架 / Composer；前端无 Bootstrap / jQuery，原生 CSS + JS。
- **个人向**：单管理员，页面就是「你自己常用网站的起始页」。
- **搜索引擎可切换 + 联想下拉**：后台勾选喜欢的搜索引擎即可显示在顶部；输入时下拉联想词由服务端代理（规避跨域）。后台的「显示/隐藏」按钮点一下**原地生效、不跳页**，且无 JS 时也能正常提交。
- **添加即补全**：填网址后先访问该网址拿到标题，再按「高清优先」的顺序去网上找相关图标（`manifest` 512 → `apple-touch-icon` → `<link rel=icon>` → 第三方聚合服务），下载后统一规范化为 **128×128 PNG** 存到服务器本地。
- **图标可自定义，且自定义后不再被覆盖**：可为任一网站上传图标或直接填图标地址；一旦自定义，该网站的图标会被标记保护，「一键全部更新」只刷新它的名称、跳过图标。
- **显示简称**：每个网站有「名称（自动）」和「简称（手动）」两个字段，页面展示你自定义的简称。
- **自定义排序**：网站 / 板块 / 搜索引擎都可上移下移排序。
- **一键全部更新**：批量刷新所有网站的图标与名称，**不会改动你自定义的简称，也不会覆盖你自定义的图标**。
- **合集标签页**：把「合集」做成标签页，点标签平铺该合集下的全部链接。
- **前后台永远一致**：所有动态页面都发 `Cache-Control: no-store, no-cache`，静态资源走「长缓存 + 版本号」（文件名不变、URL 带 `?v=mtime-size`）。

## 页面结构（复刻 n.yangyq.net 风格）

1. 顶部：搜索引擎切换 + 搜索框（带联想下拉）
2. 中部：网格板块（如「常用」「工具」）
3. 下部：「合集」标签页

## 目录结构

```
SimpleNav/
├─ index.php              前台首页
├─ suggest.php            搜索联想代理（多引擎，服务端请求）
├─ login.php / logout.php 管理员登录 / 首次初始化
├─ db.php                 数据库初始化（建表 + 默认数据 + 幂等列迁移）
├─ config.php             基础配置
├─ functions.php          公共函数（抓取元信息、下载图标、资源版本号、不缓存响应头）
├─ .htaccess              根目录安全规则（禁止访问 data/ 与 .git/）
├─ admin/                 后台（网站 / 板块 / 搜索引擎 / 设置）
│   ├─ index.php          后台页面
│   ├─ actions.php        增删改 / 排序处理（支持 AJAX 原地切换）
│   ├─ fetch_meta.php     添加网站时自动抓取名称与图标
│   └─ update_all.php     一键“全部更新”（分批）
├─ assets/                CSS / JS / 图标 / logo
│   └─ .htaccess          静态资源长缓存（配合 ?v= 版本号）
├─ uploads/icons/         抓取到的网站图标（需可写）
└─ data/                  SQLite 数据库（需可写，禁止 Web 访问）
```

## 部署

1. 上传全部文件到站点目录（如 `/www/wwwroot/n.yangyq.net/simplenav`）。
2. 确保 web 用户对 `data/` 与 `uploads/icons/` 有写权限。
3. 服务器需开启 PHP 的 **GD 扩展**（图标规范化要用）与 `curl`。
4. 浏览器打开站点 → 首次访问进入「初始化管理员」，创建账号后即可在后台管理。
5. 若服务器是 **Apache**（宝塔默认可能装 Apache 或 Nginx），`data/` 的访问拦截由仓库自带的
   `data/.htaccess` + 根目录 `.htaccess` 完成，无需改 vhost；若是 Nginx，请把
   `nginx-simplenav-deny-data.conf`（见本机 `_tooling/simplenav-deploy/`）里的规则加进 `server{}`。

服务器上创建最小权限部署账号：以 root 运行 `setup-simplenav-user.sh`（同样在 `_tooling/simplenav-deploy/`）。

> 需要额外说明的是：**服务器上若装了宝塔「网站加速」之类的页面缓存插件，本站也不需要为它做任何特殊配置**。
> 动态页发的 `Cache-Control: ... no-cache ...` 会被这类插件视为「不缓存」而直接跳过写入。

## 搜索引擎联想接口说明

联想接口需服务端代理（浏览器直接调用会跨域）。内置解析类型：

| 类型 | 平台 | 联想接口 |
|---|---|---|
| `bing_osjson` | 必应 | `https://api.bing.com/osjson.aspx?query={q}` |
| `baidu_sugrec` | 百度 | `https://www.baidu.com/sugrec?prod=pc&wd={q}` |
| `google_firefox` | 谷歌 | `https://suggestqueries.google.com/complete/search?client=firefox&q={q}` |
| `sogou_ajaj` | 搜狗 | `https://www.sogou.com/suggnew/ajajjson?type=web&key={q}` |
| `so360` | 360 | `https://sug.so.360.cn/suggest?encodein=utf-8&encodeout=utf-8&format=json&word={q}` |
| `ddg` | DuckDuckGo | `https://duckduckgo.com/ac/?type=list&q={q}` |

> 注：国内服务器访问 Google / DuckDuckGo 可能不通，联想会优雅降级为空（不影响搜索跳转）。

## 许可

Apache License 2.0