文档
左边是目录，点哪一条就跳到哪一节；手机上是横向滑动的标签条。第一次来建议从「先上手」看起，遇到具体问题直接翻最后一节「常见问题」。
一、先上手
这个站不复杂：找工具、用工具、传工具、提意见。工具本体全部在浏览器里跑，文件不经过服务器。
这是什么站
这个站一开始是一堆自己每天在用的小工具合集：视频转 GIF、冰与火之舞谱面去特效、麦克风扬声器测试、材质包版本转换……后面还会继续加。每个工具都是独立的网页，打开就能用，不需要安装，也不需要把文件传上去。
三句话版本
1. 在「工具箱」里挑一个工具点进去；2. 把文件拖进去，结果直接下载；3. 想传自己的工具，去首页的「用户面板」上传。
要不要注册
不注册也能用所有公开工具。注册只是为了让这些跟着账号走：收藏、投稿、反馈、主题配色、头像昵称。注册只要用户名（4–16 位字母或数字）和密码，没有邮箱验证。
登录保持多久
登录状态默认保持 30 天，而且只要你在 30 天内来过一次，就会自动续到满 30 天，不用反复登录。会掉登录的只有三种情况：换了浏览器或清了缓存、在别处点了「退出所有设备」、或者超过 30 天没来。
- 换设备登录，收藏、投稿、主题都还在。
- 公共电脑用完建议在「设置」里点「退出登录」。
- 改密码会踢掉其它设备上的登录，只保留当前这台。
二、找工具
「工具箱」页左边是筛选栏，右边是卡片。筛选栏在桌面端会跟着页面滚动停在原地，不会滚走；手机端收进「筛选」按钮里。
搜索
搜索框按这些内容匹配：工具名、简介、分类、标签、作者名。也就是说记得作者是谁也能搜出来。
- 在页面任意位置按
/直接跳到搜索框。 - 按
Esc：先清搜索词；没有搜索词就清掉勾选的分类；再按一次退出搜索框。 - 搜索和勾选是「同时满足」的关系，搜到了但没勾对分类，也会被过滤掉。
分类与标签
左侧分成两组：分类（媒体、游戏、音频、其它……）和标签（官方、离线、不上传、实时……）。两组都可以多选，规则是 AND：勾得越多，结果越少也越准。
- 每项后面的数字是这一项下有多少个工具，勾之前就能判断值不值得点。
- 「清空筛选」一键回到全部工具。
- 勾选状态会写进地址栏，例如
toolbox.html?cat=游戏，把链接发别人也能看到同样的结果。 - 「官方」表示是站内自带的工具；用户投稿的工具没有这个标签。
卡片怎么读
一张卡片从上到下是：左边图标、右边工具名；下一行是一句话简介；再下一行是作者（只有用户投稿才有）；最底下一行是分类、标签、收藏数和「进入」。
三、用工具
工具页与说明
点卡片进去就是工具本体。顶部那条栏是站点的：左边「返回」回上一页、「主页」回首页，右边是「收藏」和站点名。如果作者在包里放了 README.md，顶部还会多一个「说明」按钮，点开是从右侧滑出的使用说明，不用去翻压缩包。
项目页
项目和工具是两栏：工具进工具箱，项目进项目页。一个项目就是一张卡片（封面、简介、标签、技术栈），点开在详情浮层里直接跑它的 HTML，也可以「新窗口打开」单独看。项目页左边能按标签和技术栈筛，搜索框认项目名、简介和作者。
卡片上的技术栈
技术栈是作者投稿时手写的几个词（比如 Canvas、WebGL、纯 CSS），点一下就能只留这一类。标签是「都得满足」，技术栈是「命中一个就算」。
收藏
点一下「☆ 收藏」就收藏了，再点一下取消。别人收藏你的工具，你每次 +2 信誉；取消收藏会把这两分扣回去。收藏的工具都能在工作台「我的收藏」里找到，换设备登录也还在。
被拦住怎么办
信誉值低于 10 的时候，打开工具会看到整页的拦截提示。处理办法：让别人收藏你的公开工具（每次 +2），或者在工作台提一条反馈说明情况，管理员可以手动调整。
大文件提醒
视频转 GIF、音频分析这类工具会吃内存和 CPU，建议在电脑上处理。手机浏览器也能跑，但几百 MB 的视频容易卡死标签页。
四、工作台
登录之后点头像，或者直接打开 account.html，就是工作台：左边一列导航，右边是内容。没登录也能打开，但会提示先登录。
左侧导航
- 上传新工具：传一个
.html，或者一个里面带index.html的.zip。 - 我的工具：自己传过的东西都在这儿，能看到状态（待审核 / 已公开 / 已驳回）、大小、上传时间，也能预览、更新、删除。
- 我的收藏：收藏过的工具，一键打开或取消收藏。
- 我的反馈：提过的问题和建议，以及管理员有没有处理。
- 改密码：改完会踢掉其它设备上的登录。
- 设置：头像、昵称、主题、注册时间、上次登录、信誉值。
- 审核（只有管理员看得到）：直接列出待审工具，点进去审。
被驳回的工具，理由会写在状态下面。改好之后可以删掉重传，也可以直接点「更新」换成新版本。
设置项
五、投稿
入口有两个：工作台的「上传新工具 / 项目」，或者工具箱右上角的「上传 / 安装工具」。表单里有一栏投稿类型：选「工具」进工具箱，选「项目」进项目页；选项目时可以再填几个技术栈（逗号分隔）。两种类型用的是同一套审核流程和信誉规则。
标签怎么填
音乐标签
上传音乐时，浏览器会先读文件里的 ID3 / MP4 / FLAC / Vorbis 标签，曲名、作者和封面自动填好（不想要就改，以表单为准）。
规则
表单里有一栏标签：用 # 开头、逗号隔开，比如 #游戏, #音乐, #开源。中英文逗号、顿号、分号、空格都当分隔符，# 写不写都行，重复的会自动去掉。最多 5 个，每个 12 个字以内；不填就沿用包里 tool.json 的 tags。
标签会出现在工具箱和项目页左侧的标签筛选里（带计数、可多选 AND），工具卡片上也会显示最多 2 个。分类还是单选那一栏，标签是它的补充：分类决定「放哪个格子」，标签负责「怎么找得到」。
包里要有什么
硬要求
包里必须有一个 index.html 当入口。可以整个文件夹打包成 zip，只要解压之后最外层能直接看到 index.html；如果多套了一层文件夹，系统会自动剥掉那一层。
- 单文件：直接传一个
.html，里面引用的 js / css / 图片要一起打包。 - 压缩包：
.zip，里面带index.html和它用到的所有资源。 - 图标：可以顺手传一张正方形 PNG，会显示在卡片左侧；不传就用内置的分类图标。
限制与拦截
以下情况会被直接拦下：信誉值低于 50；包里没有 index.html；带了不允许的文件类型；一小时内上传太多次（防刷）。
审核流程
投稿进来是「待审核」，只有你自己和管理员看得见；管理员点「通过并公开」之后才会出现在工具箱里，点「驳回」会写一句理由并扣 5 点信誉。管理员自己传的东西不用审，直接公开。
- 待审期间你自己能预览、能打开，别人看不到。
- 审核要人工点，不是秒过；催的话可以在「我的反馈」里提一条。
- 被驳回后改好重传不会额外扣分（只有第一次驳回扣）。
六、更新工具
工具已经公开了、想换一版，不用删了重传：进「我的工具」，在那一行点「更新」，选新的 .zip 或 .html 传上去就行。
换版不变的东西
- 链接地址（
/ut/你的工具名/）不会变，收藏和信誉也都还在。 - 非管理员的更新会重新进审核队列，审核期间线上还是旧版本，所以不会开着开着工具就坏了。
- 管理员更新直接生效，不用再走一遍审核。
- 更新被驳回不会扣信誉，旧版本继续跑。
- 如果你的工具带
README.md，换版本时说明也会跟着换。
七、信誉值
信誉值是新用户 150，也是上限 150。它决定你能做什么：
加减规则
管理员账号不受这条限制。信誉掉下去了，最直接的办法是把工具做好、让别人收藏，或者提反馈找管理员说明情况。
八、主题与配色
右上角那个月亮/太阳按钮只管亮暗切换。更多花样在「工作台 → 设置 → 主题」里：
怎么挑
- 跟随系统：系统是深色就用深色。
- 深色 / 浅色：固定一种。
- 纯黑（OLED）：背景是真正的黑色，夜里不刺眼、也更省电。
- 12 套预设配色：极光、琥珀、薄荷、樱花、午夜蓝、森野、落日、鎏金、石墨、赛博、深海、玫瑰金，点一下立刻预览。
- 自定义配色：自己挑主色和强调色，深色、浅色各存一套。
这些只影响你自己看到的样子，不会改别人的页面。选好之后记得点「保存设置」，换台设备登录也还在。
九、反馈
登录之后，工作台 →「我的反馈」就能写。类型分问题和建议，可以带最多 4 张截图（会自动压到 1280px 以内）。
怎么写
- 反馈只有你和最高管理员能看到，别的用户看不到。
- 管理员会点【落实】或者【驳回】，并写一句回复。
- 回复和处理状态都会出现在你的「我的反馈」里，不用再问一遍。
- 同一个问题不用重复提，提一次等回复就行。
十、开发自己的工具
本站的工具都是纯前端页面，没有后端接口可以调（除了站点的公开 api）。只要能在浏览器里独立跑起来，就能传上来。
目录与入口
最小结构
index.html + 你需要的 js / css / 图片。打包成 zip 时，index.html 放在最外层（或者只多套一层文件夹）。款式不限：根目录只放一个别的名字的 game.html 也能过，系统会把它当入口。
样式与入口（可选）
在包最外层放一个 tool.json，投稿页点「读包里的 tool.json」就能把这些自动填进表单：
{
"title": "我的项目",
"desc": "一句话说明",
"cat": "游戏",
"kind": "project",
"stack": ["Canvas", "WebAudio"],
"tags": ["像素", "离线"],
"entry": "dist/index.html",
"style": "full"
}entry 指定真正的入口页（默认 index.html / 发布后的 app.html）；style 写 full 时，工具页会铺满整屏、顶栏浮起来——适合全屏游戏 / 可视化作品。
- 不要依赖服务器环境变量、数据库或 Node 后端。
- 工具会被套上站点的顶栏外壳，发布在
/ut/<你的工具名>/下。 - 文件会在审核通过后才公开；待审期间可以用工作台的预览看效果。
README 说明
在包的最外层放 README.md（大小写都认，也支持 readme.txt、说明.md），工具页顶部就会出现「说明」按钮。支持标题、列表、代码块、行内代码、粗体、斜体、链接、图片、引用这些常见 Markdown；文件不要超过 200KB。
相对路径与图标
- 资源一律用相对路径，例如
./assets/app.js，不要写死域名或站根路径。 - 需要自定义卡片图标时，上传一张正方形 PNG（建议 512×512）；不传就用内置图标。
- 尽量别用会弹窗、跳转外站的交互，审核会重点看这个。
十一、数据与隐私
这里只列清楚什么会上传、什么不会。
什么会上传
删除工具会把它自己发布出去的文件一起删掉，不用等管理员审核——作者对自己的稿子有完整的删除权。账号相关的处理（停用、清空）才需要找管理员。定期备份服务器上的 data 目录就能保住账号、投稿和反馈。
十二、管理员
在跑这个网站的那台电脑上，用 http://127.0.0.1:8080/ 打开，直接就是管理员权限。其它设备（局域网、域名、隧道、公网）要先登录管理员账号，再答对安全提问才能进；没设问题的话外网一律进不去。
/admin 或 /admin.html。在本机
判断方式是「对端地址是 127.0.0.1，而且请求里没有代理转发头」。经 frp 隧道进来时，服务器看到的永远是 127.0.0.1，分不出真实的人，所以那条路一律按外网处理。
安全提问
本机打开后台左侧的「安全提问」，设一个只有你知道的问题和答案。本机直连永远不用答；其它设备登录管理员账号后会先看到这个问题，答对了才放行。答对之后 12 小时内同一台设备不用再答；改一次问题或答案，之前答对过的设备全部作废。答案只存哈希，服务器上看不到原文，忘了就在本机重设一个。连错 6 次会锁 10 分钟。
数据与审核
- 待审工具：顶部能按「新投稿 / 待审新版 / 被驳回」筛选，也能搜标题、作者、标识；左边 iframe 里跑的就是入口页。
- 数据：请求量、进出流量、运行时长、CPU / 内存 / 磁盘、数据库与工具文件占用、最近 24 小时曲线、热门页面和运行日志，12 秒刷新一次。
- 用户与信誉：改角色、停用账号、调信誉值（0–150）。每次改信誉值都写进修改记录，可以按用户查。
- 用户反馈：只有最高管理员能看，可以落实、驳回，也能改回待处理。
- 操作日志：最近的投稿、审核、改角色、安全提问、信誉值动作。
- 备份：「下载备份 zip」把数据库、未公开投稿、已公开副本和素材打包，解压覆盖回原位即可恢复。
十三、常见问题
为什么我刷新之后变游客了？
正常情况下不会：登录状态存 30 天，而且一直在用就会自动续期。会掉的情况只有：清了浏览器缓存或换了浏览器、服务器数据库被重置、或者 30 天没来过。
工具上传之后多久能看见？
管理员点过「通过」才会出现在工具箱。等待期间你自己在「我的工具」里能预览、能打开。
文件会不会被传到服务器？
不会。工具处理文件的过程全在浏览器里，文件不离开你的电脑。会上传的只有：你主动投稿的工具包、头像、工具图标、以及反馈里的截图。
为什么有些工具打不开 / 被拦住了？
信誉值低于 10 会被拦。处理方法：让别人收藏你的工具（每次 +2），或者在工作台提一条反馈说明情况。
手机上能用吗？
能，布局会自动变单栏，筛选收进「筛选」按钮。不过视频转 GIF、冰与火之舞这类吃性能的工具建议在电脑上用。
更新完了线上还是旧版？
两个可能：一是还在审核，审核期间线上就是旧版；二是浏览器缓存，按 Ctrl+F5 强制刷新一下。
网站有点卡？
本站是走隧道转发的，线路本身有延迟的话会明显慢。页面资源做了 gzip、缓存和首屏降级；想最快就用本机 http://127.0.0.1:8080/。
忘记密码了？
目前没有自助找回。找管理员在本机重置，或者换一个账号。
十四、关于
当前版本 1.2.2。前端零依赖，后端只用 Python 标准库；没有统计脚本、没有第三方字体和 CDN。完整的改动记录在公告里。
- 想加工具、想改功能、发现 bug：走「我的反馈」，附截图更好定位。
- 想投稿自己的工具或项目：看第十节「开发自己的工具」和第三节的「项目页」。
- 管理入口：本机
http://127.0.0.1:8080/admin.html，或答对安全提问的管理员账号。