# 游民导航 · 小红书小工具

纯离线小红书小工具（对齐 [redmini](../../redmini) 打包规范）。**不能联网、不能打开外链、也不能程序写入剪贴板**（官方禁用 `navigator.clipboard` / `execCommand('copy')`）。

点击入口会：

1. **底部弹窗**展示标题 / 简介 / **完整网址**
2. **自动选中网址**（或点「选中网址」），引导用户**手动复制**

数据与图标同步自仓库 H5：`src/data/links.json`、`public/icons/`。

## 约束（官方）

| 项 | 说明 |
|----|------|
| 网络 | 禁止 `fetch` / CDN / 外链资源 |
| 脚本 | 仅经典 `<script src="./app.js">`，无 `type="module"` / 无内联脚本 |
| 路径 | 相对路径 `./…`，ZIP **根目录**必须是 `index.html` |
| 体积 | 硬上限 10MB，建议 ≤ 2MB |

## 构建

在 `xhs/` 目录：

```powershell
python scripts/assemble.py
python scripts/pack.py
```

**上传文件：** [`dist/youmin-nav-xhs-tool.zip`](dist/youmin-nav-xhs-tool.zip)

本地用浏览器预览 `release/`（无 `window.xhs`，复制功能仍可用）：

```powershell
cd release
python -m http.server 5188
```

## 目录

```
xhs/
├── tool/           # 源码：index.html / styles.css / app.js / icons / nav-data.js
├── release/        # 组装产物
├── dist/           # 上传用 zip
└── scripts/        # sync_data / assemble / pack
```

## 创作平台建议

| 字段 | 建议 |
|------|------|
| 名称 | 游民导航 |
| 简介 | 数字游民工具合集；点开查看网址并手动复制 |
| 场景 | 实用工具 / 效率 |
| 注意 | 容器禁用剪贴板 API，勿做一键复制 |