Nav-Manage

本仓库仅提供扩展 + 后端 API，需要hugo主题及网站源码请前往noisedh-nav

全新重构扩展，带有AI一键分析推荐分类的扩展，随时随地收藏你的网址

Nav-Manage 由两部分组成：

• 浏览器扩展（前端）：Nav-manage-extension
• 后端 API（Node + Express）：yaml-server

扩展用于给 Hugo 静态导航站提供“收录/删除/搜索/失效检测/导出书签/通知推送”等管理能力。

后端后台入口：/admin 密码为自定义设置的api token，支持一键站点配置、失效检测、网站管理智能添加

演示站点：NOISE导航

扩展在线安装：点击访问

快速开始（仅部署后端）

说明：本节是“仅后端 API”部署，不包含 Hugo 主题网站的静态服务。
如果你需要“一次性部署 Hugo 主题网站 + Docker 运行教程”，请先看：

• noisedh-nav

已发布镜像：noise233/nav-manage（默认端口 8990）。

示例（按实际路径修改）：

docker run -d \
  --name nav-manage \
  -p 8990:8990 \
  -e PORT=8990 \
  -e BASE_DIR=/app/hugo \
  -e API_TOKEN=change_me_to_a_strong_token \
  -e ENABLE_HUGO=false \
  -e REMOTE_UPDATE_WEBHOOK= \
  -v /path/to/your/hugo-site:/app/hugo \
  --restart=always \
  noise233/nav-manage:latest

说明：

• BASE_DIR：站点根目录，容器会读写 ${BASE_DIR}/data/*.yml，并可能写入 ${BASE_DIR}/content/invalidlinks.md
• API_TOKEN：写入/删除/失效检测等接口鉴权 Token（扩展设置里要一致）
• ENABLE_HUGO=true：收录/删除后在容器内执行 hugo（需要挂载完整 Hugo 源码目录）
• ENABLE_HUGO=false：不在容器内编译 Hugo，建议配合 REMOTE_UPDATE_WEBHOOK 触发远程更新

如果你还希望同时启用 MCP（供 AI 客户端接入，自然语言站内搜索/可点击翻页），可以这样启动：

docker run -d \
  --name nav-manage \
  -p 8990:8990 \
  -e PORT=8990 \
  -e BASE_DIR=/app/hugo \
  -e API_TOKEN=change_me_to_a_strong_token \
  -e MCP_TOKEN=change_me_to_a_mcp_token \
  -e MCP_REQUIRE_TOKEN=true \
  -e MCP_RATE_LIMIT_MAX=120 \
  -e MCP_RATE_LIMIT_WINDOW_MS=60000 \
  -e ENABLE_HUGO=false \
  -e MCP_HTTP=true \
  -v /path/to/your/hugo-site:/app/hugo \
  --restart=always \
  noise233/nav-manage:latest

AI 客户端接入（URL 方式，最少配置）：

{
  "mcpServers": {
    "NOISE导航": {
      "url": "https://<你的域名或IP>:8990/mcp",
      "headers": {
        "Authorization": "Bearer <Token>"
      }
    }
  }
}

鉴权说明（/mcp）：

• 默认需要鉴权：Authorization: Bearer <Token>
• Token 的取值优先级：MCP_TOKEN（若设置）→ 否则复用 API_TOKEN
• 若希望公开给所有人使用：设置 MCP_REQUIRE_TOKEN=false（不再需要 Authorization）

传输说明（/mcp）：

• HTTP 端点统一为 /mcp
• 支持标准 MCP HTTP 的 GET / POST / DELETE
• 服务端会根据客户端请求头返回单次 JSON 响应或 text/event-stream
• 初始化后，服务端可能返回 Mcp-Session-Id，客户端后续请求应继续携带

访问频率限制（/mcp，按 IP 计数）：

• MCP_RATE_LIMIT_MAX：窗口内最大请求数（默认 120）
• MCP_RATE_LIMIT_WINDOW_MS：窗口毫秒数（默认 60000）
• MCP_RATE_LIMIT_DISABLED=true：关闭限制

公开模式示例（不需要 Token，但保留访问频率限制）：

docker run -d \
  --name nav-manage \
  -p 8990:8990 \
  -e PORT=8990 \
  -e BASE_DIR=/app/hugo \
  -e ENABLE_HUGO=false \
  -e MCP_HTTP=true \
  -e MCP_REQUIRE_TOKEN=false \
  -e MCP_RATE_LIMIT_MAX=120 \
  -e MCP_RATE_LIMIT_WINDOW_MS=60000 \
  -v /path/to/your/hugo-site:/app/hugo \
  --restart=always \
  noise233/nav-manage:latest

使用示例（自然语言 / 格式化）：

• 自然语言： “在 NOISE导航 里搜一下 AI 工具，翻到第 2 页”
• 自然语言： “帮我找可以 AI 生成图片的网站”
• 自然语言： “在 NOISE导航 里搜一下 AI 绘图工具”
• 自然语言： “找一些支持文生图的站点”
• 自然语言： “搜索能生成图片的 AI 网站，优先国外热门产品”
• 自然语言： “帮我找 AI 图片生成工具，第 2 页”
• 自然语言： “在 NOISE导航 里搜一下：云盘资源库（可以命中描述）”
• 格式化： “搜索：关键词=AI，页码=2，每页=20”
• 带筛选： “搜索：关键词=AI，一级分类=设计，二级分类=图标”
• 结构化： “搜索：关键词=AI，格式=json”（需要完整字段时用）

字段映射（数据文件真实字段；其中 taxonomy/term 可作为筛选参数）：

• 一级分类 → taxonomy
• 二级分类 → term
• 地址 → url
• 描述 → description

前后端分离部署（推荐）

典型方式：

• Hugo 导航站（前端）：静态发布在 Nginx / CDN / GitHub Pages
• yaml-server（后端）：部署在云服务器，仅负责写入数据与触发更新

有两种常见更新策略：

策略 A：后端同机编译 Hugo

• 把 Hugo 源码目录挂载到容器（包含 config.toml、themes/、content/、data/）
• ENABLE_HUGO=true
• Web 服务指向 Hugo 的输出目录（例如 publishDir=docs 则为 docs/）

策略 B：Webhook 触发远程构建（更通用）

• ENABLE_HUGO=false
• 配置 REMOTE_UPDATE_WEBHOOK 指向你的构建/发布入口（例如：拉取仓库、执行 hugo、同步到站点）
• 后端写入数据完成后会自动 POST 该 webhook 触发更新

浏览器扩展使用

扩展安装后，在设置页填写并保存：

• serverUrl：后端 API 地址（例如 https://api.example.com）
• serverToken：与后端 API_TOKEN 一致
• 推送通知参数：webhookUrl、telegramChatId、telegramBotToken
• RSS 自定义参数：rssChannelTitle、rssChannelLink、rssChannelDescription、rssImageUrl、rssImageTitle、rssImageLink
• Telegram 文案参数：telegramMessageTitle、telegramNavText

并在“写入同步”里勾选：

• 云服务器（写入到 yaml-server）
• GitHub（写入到仓库 data/ 目录）

两者可以同时勾选：一次收录会同时写入两端，并分别提示成功/失败原因。

说明：以上推送/RSS/文案参数会随“保存”同步到后端 /api/server-settings，服务端会持久化并直接用于 RSS 生成与 Telegram 推送。

扩展完整说明见：USAGE.md

常用 API（示例）

写入类接口需携带：

Authorization: Bearer <API_TOKEN>
Content-Type: application/json

示例：

curl "http://localhost:8990/data"

curl -X POST "http://localhost:8990/api/yaml" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"filename":"webstack.yml","newDataEntry":{"title":"Example","url":"https://example.com","logo":"https://example.com/favicon.ico","description":"desc","taxonomy":"分类名","term":"子分类名"}}'

curl -X DELETE "http://localhost:8990/api/delete" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"filename":"webstack.yml","title":"Example"}'

curl -X POST "http://localhost:8990/api/invalid-links/check" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"filename":"webstack.yml","limit":40,"offset":0}'

curl -O "http://localhost:8990/api/export-bookmarks"

完整接口与参数请以noisedh-nav为准。

如果你觉得本项目对你有所帮助，请赞赏支持它！