{"id":27132975,"url":"https://github.com/iawooo/booknav","last_synced_at":"2025-07-31T09:38:19.424Z","repository":{"id":287526052,"uuid":"949989258","full_name":"iawooo/BookNav","owner":"iawooo","description":"轻量级、优雅的个人书签管理工具，专注于简单易用和高效部署。项目源代码不到 100KB，仅依赖 PHP 和 MySQL，将浏览器书签集中式管理，做到一处部署，随处访问。","archived":false,"fork":false,"pushed_at":"2025-04-12T08:27:39.000Z","size":1535,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T09:33:29.468Z","etag":null,"topics":["book","bookmark-navigation","bookmarks","bookmarks-manager","booknav","books","nav","navigation"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iawooo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-17T13:07:19.000Z","updated_at":"2025-04-12T08:27:42.000Z","dependencies_parsed_at":"2025-04-12T09:34:54.019Z","dependency_job_id":"eb963ec6-c269-40be-8b92-ae56372e475e","html_url":"https://github.com/iawooo/BookNav","commit_stats":null,"previous_names":["iawooo/booknav"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/iawooo/BookNav","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iawooo%2FBookNav","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iawooo%2FBookNav/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iawooo%2FBookNav/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iawooo%2FBookNav/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iawooo","download_url":"https://codeload.github.com/iawooo/BookNav/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iawooo%2FBookNav/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265024279,"owners_count":23699589,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["book","bookmark-navigation","bookmarks","bookmarks-manager","booknav","books","nav","navigation"],"created_at":"2025-04-07T22:36:11.514Z","updated_at":"2025-07-12T16:37:08.984Z","avatar_url":"https://github.com/iawooo.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 书签导航\r\n\r\n![License](https://img.shields.io/github/license/username/bookmark-navigator) ![Size](https://img.shields.io/github/size/username/bookmark-navigator/dist/bookmark-navigator.zip) ![PHP](https://img.shields.io/badge/PHP-7.4+-blue) ![MySQL](https://img.shields.io/badge/MySQL-5.6+-orange)\r\n\r\n**书签导航** 是一个轻量级、优雅的个人书签管理工具，支持集中式管理书签，完美解决跨设备、跨平台、跨浏览器的同步与访问难题，实现一处部署、随处访问，灵感来源于 OneNav，专注于简单易用和高效部署。项目源代码不到 100KB，仅依赖 PHP 和 MySQL，无需复杂环境即可在虚拟主机上运行。支持明暗主题、拖拽排序、樱花特效以及高级图标抓取，让你的书签管理既实用又美观。\r\n\r\n**页面展示**\r\n以下是书签导航的主页截图，展示了分类、书签卡片和樱花特效的视觉效果：\r\n![书签导航主页](images/content.png)\r\n\r\n## 亮点\r\n\r\n- **超轻量级**：源代码不到 100KB，占用空间小，加载快。\r\n- **简单部署**：只需 PHP 和 MySQL，无需额外依赖，虚拟主机即可运行。\r\n- **灵感来源 OneNav**：继承了 OneNav 的简洁设计，同时优化了功能和用户体验。\r\n- **高级图标抓取**：自动从网页提取最佳图标（支持 `favicon.ico`、HTML 链接、Manifest 等）。\r\n- **书签管理**：添加、编辑、删除书签，支持名称、URL、分类、图标和备注。\r\n- **拖拽排序**：支持多级分类，分类权重可调，拖拽调整书签顺序。\r\n- **明暗主题**：内置炫酷的渐变背景，支持一键切换明暗模式。\r\n- **樱花特效**：动态樱花飘落效果，提升视觉体验。\r\n- **备份与恢复**：导出书签数据为 JSON 文件，或从备份文件导入，支持清空现有数据。\r\n- **密码保护**：简单登录机制，确保书签隐私。\r\n- **响应式设计**：适配桌面和移动端，随时随地管理书签。\r\n- **搜索功能**：快速搜索书签名称、URL、分类或备注。\r\n\r\n## 主要功能\r\n\r\n1. **书签管理**：\r\n   - 添加、编辑、删除书签。\r\n   - 支持分类管理（新建、修改、删除分类）。\r\n   - 可添加备注，方便记录额外信息。\r\n   - 权重调整，实时保存，多端访问\r\n\r\n2. **图标自动抓取**：\r\n   - 优先检查默认 `favicon.ico`。\r\n   - 解析 HTML 中的 `\u003clink\u003e` 标签（如 `rel=\"icon\"` 或 `apple-touch-icon`）。\r\n   - 支持 Web App Manifest 和 Microsoft `browserconfig.xml`。\r\n   - 使用 CORS 代理（如 `api.allorigins.win`）确保跨域抓取成功。\r\n   - 回退到 Google FaviconV2 服务。\r\n\r\n3. **用户体验**：\r\n   - 拖拽排序书签，实时保存顺序。\r\n   - 右键或长按书签显示编辑/删除选项。\r\n   - 动态调整书签文本大小，确保显示完整。\r\n\r\n4. **视觉设计**：\r\n   - 渐变背景（明暗主题可选）。\r\n   - 半透明容器和阴影效果。\r\n   - 樱花飘落动画，提升趣味性。\r\n\r\n5. **备份与恢复**：\r\n   - 一键将所有书签和分类数据导出为 JSON 文件，文件名包含日期（如 bookmarks_backup_2025-03-19.json）。\r\n   - 上传 JSON 文件恢复数据，可选择清空现有数据后再导入。\r\n  \r\n5. **密码保护**：\r\n   - 可选密码：安装时可设置网站访问密码，留空则无需密码。\r\n   - 安全登录：使用 Session 和安全的 Cookie（HttpOnly）管理登录状态，30 天有效。\r\n   - 自动登录：若未设置密码，系统默认允许直接访问。\r\n\r\n## 部署要求\r\n\r\n- **PHP**: 7.4 或更高版本（推荐 8.x）。\r\n- **MySQL**: 5.6 或更高版本。\r\n- **Web 服务器**: 任意支持 PHP 的服务器（如 Apache、Nginx）。\r\n- **空间**: 至少 1MB（包括源代码和数据库）。\r\n\r\n## 部署教程\r\n\r\n### 1. 下载源代码\r\n\r\n### 2. 上传到虚拟主机\r\n```\r\npublic_html/\r\n  ├── add.php           # 添加书签页面\r\n  ├── backup.php        # 备份与恢复页面\r\n  ├── config.php        # 核心配置文件\r\n  ├── delete.php\r\n  ├── delete_category.php # 删除分类脚本\r\n  ├── edit.php          # 编辑书签页面\r\n  ├── edit_category.php\r\n  ├── index.php         # 主页\r\n  ├── install.php       # 安装页面\r\n  ├── login.php         # 登录页面\r\n  ├── script.js         # 前端逻辑（拖拽、樱花特效等）\r\n  ├── style.css         # 样式文件\r\n  ├── images/           # 默认图标和 favicon\r\n  │   ├── default-bookmark.png\r\n  │   └── favicon.ico\r\n```\r\n2. 上传：\r\n   - 使用 FTP 工具（如 FileZilla）将整个文件夹上传到虚拟主机的 public_html 或指定目录。\r\n   - 例如，上传到 /public_html/\r\n\r\n3. 设置权限（可选）：\r\n   - 确保 config.php 和 images/ 文件夹可读（权限通常为 644 或 755）。\r\n\r\n### 3. 访问站点\r\n- 在浏览器中访问：\r\n  http://yourdomain.com/\r\n- 填写配置数据库信息，绑定数据库\r\n- 点击“安装”，系统会自动创建 config.inc.php 和 bookmarks 表。\r\n- 登录后即可开始添加和管理书签！\r\n\r\n## 使用说明\r\n\r\n1. 添加书签：\r\n   - 点击“+”按钮，填写名称、URL、分类等信息。\r\n   - 图标字段留空会自动抓取网页图标。\r\n\r\n2. 编辑/删除：\r\n   - 右键（电脑）或长按（手机）书签，点击“编辑”或“删除”。\r\n\r\n3. 分类管理：\r\n   - 在分类标题旁点击“✏️”编辑，或“🗑️”删除整个分类。\r\n\r\n4. 排序：\r\n   - 拖动书签调整顺序，松手后自动保存。\r\n\r\n5. 搜索：\r\n   - 在搜索框输入关键词，按 Enter 或点击放大镜搜索。\r\n\r\n6. 主题切换：\r\n   - 点击“切换主题”按钮，切换明暗模式。\r\n\r\n## 注意事项\r\n\r\n- 安全性：\r\n  - 建议将 config.php 中的数据库密码和站点密码设置为强密码。\r\n  - 部署到公网时，启用 HTTPS 以保护数据传输。\r\n\r\n- 图标抓取：\r\n  - 依赖网络连接，可能受浏览器 CORS 限制影响。\r\n  - 如果抓取失败，会使用默认图标 images/default-bookmark.png。\r\n\r\n- 虚拟主机限制：\r\n  - 确保主机支持 PHP session\r\n## 贡献\r\n\r\n欢迎提交 Issues 或 Pull Requests！如果有新功能建议或 Bug 反馈，请随时联系。\r\n\r\n## 致谢\r\n\r\n特别感谢 xAI 的 Grok 在开发过程中提供的代码支持和调试帮助。\r\n\r\n## 许可证\r\n\r\n本项目采用 MIT 许可证，详情请见 [LICENSE](LICENSE) 文件。\r\n\r\n## star star star star star\r\n### 球球star一下\r\n![star](https://raw.githubusercontent.com/iawooo/StarCharts/refs/heads/main/images/booknav_star_chart.png)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiawooo%2Fbooknav","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiawooo%2Fbooknav","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiawooo%2Fbooknav/lists"}