常见问题

关于本站

Q：需要数据库吗？ 不需要。文档就是 .md 文件，全文搜索也是直接读文件。面板里那个 MySQL 用不上，放着就行。

Q：需要我电脑一直开着吗？ 不需要。网站跑在你的虚拟主机上，7×24 小时在线。你电脑关机、断网都不影响。

Q：为什么没有 .html 文件？ 因为 PHP 会在服务器上执行，然后吐出 HTML 给浏览器。所以服务器上放的是 .php，浏览器看到的仍然是网页。

Q：128MB 空间够吗？ 够。整站（含两套玩法/工具）大约 435KB，剩下的空间能放上万篇 Markdown 文档。

Q：4Mbps 带宽慢吗？ 对文字站完全够。一篇文档通常几十 KB，秒开。真要放图片/视频建议上对象存储。

写文档相关

Q：侧边栏名字能改吗？ 能。改文档第一行 # 标题，保存即可。

Q：怎么控制侧边栏顺序？ 给文件名加数字前缀：01-快速开始.md、02-写文档教程.md。目录也是按名字排序。

Q：怎么写一个"分类首页"？ 在目录里放一个 index.md，点分类名时就有内容可看。

Q：能放图片吗？ 能。用 Markdown 的 ![](地址)。图片可以直接上传到站点目录（注意 128MB 空间），也可以填外链地址。

Q：能不能写草稿不发布？ 暂时没有内置草稿功能。变通办法：把文件放在 docs/ 之外（比如 draft/ 目录），前台就不会显示。

后台相关

Q：忘了后台密码怎么办？ 下载 config.php，用 bcrypt 生成新哈希替换，重新上传。详见《03-后台编辑器说明》。

Q：后台能多人用吗？ 目前是单密码，没有多用户。想多人协作建议改用支持账号的方案。

Q：编辑器加载不出来？ 编辑器走 CDN。若 CDN 被墙/被屏蔽，把 Vditor 下载到本地 assets/，改 admin/index.php 里的 <script> 和 <link> 路径即可。

搜索相关

Q：搜索搜不到刚写的文档？ 搜索是实时读文件的，写完保存即可搜到。搜不到检查一下是不是中文关键词打错，或者文档在 docs/ 之外。

Q：搜索区分大小写吗？ 不区分。

玩法中心相关

Q：玩法中心在哪？ 顶部导航「玩法」，或直接访问 /play/。里面有电脑钢琴、鼓机、像素画板、算法可视化、怀旧小游戏。

Q：钢琴 / 鼓机没声音？ 浏览器要求"用户交互后才允许播放声音"。先点一下页面里的琴键、按钮或「播放」就激活了。另外检查系统音量和标签页有没有被静音。

Q：保存的曲子、节奏、画作在哪？ 在你自己电脑的浏览器下载目录里，是 .json 文件。不会上传到服务器，关掉页面服务器那边什么都没留下。

Q：能分享给朋友吗？ 能。把 .json 文件发给他，他在本站打开对应页面，点「读取文件」即可（钢琴还支持直接把文件拖进页面）。

Q：这些文件能手动编辑吗？ 能，都是普通 JSON 文本。钢琴里 m 是音高、t 是起始毫秒、d 是持续秒数；鼓机里每行就是 16 个 0/1。

Q：最高分怎么清零？ 最高分存在浏览器的 localStorage 里。换浏览器、清缓存、用无痕模式都会自动清零；也可以手动：

localStorage.removeItem('jhp-snake-best')   // 换成 jhp-2048-best / jhp-break-best

Q：搜索搜不到玩法页面？ 对，搜索只索引 .md 文档。所以每个玩法都在文档里配了一篇说明，见左侧目录的「玩法中心」「工具中心」两个分类。

工具中心相关

Q：工具中心在哪？ 顶部导航「工具」，或直接访问 /tools/。

Q：这些工具会上传我的数据吗？ 不会。二维码、MD5、JSON 格式化全部在你自己的浏览器里算，输入的内容不会离开你的电脑。

Q：SHA-256 为什么点不了？ 浏览器只在 https 或 localhost 下提供 SHA-256 接口。站点是 http 时只能用 MD5（MD5 是本地纯 JS 实现的，不受限制）。

Q：生成的二维码扫不出来？ 把「格子大小」调大，或者缩短内容、把容错级别调高。要放 logo 的话一定选 H（30%）。

扩展相关

Q：能加评论吗？ 纯静态站加评论要接第三方（如 Giscus，需要 GitHub 仓库）。本站没内置。

Q：每日新闻是从哪来的？ 36氪 / IT之家 / 量子位 / 少数派 / Solidot / 爱范儿 六个媒体的 RSS，服务端每 12 小时抓一次，缓存在 data/news-cache.json。想换源或加源：改 lib/site.php 里的 $NEWS_SOURCES。

Q：天气数据哪来的？ Open-Meteo 免费接口（不用注册），定位用 ip-api.com。想换城市：天气页直接搜，会记住你的选择。

Q：RSS 订阅地址是什么？ 你的域名/rss.php，自动收录 docs/ 里最新 20 篇文档。

Q：关于页的内容怎么改？ 直接改 about.php，介绍、技能、时间线、友链都是占位文字，页首有注释标明。

Q：能导出成静态 HTML 吗？ 可以做一个导出脚本（遍历 docs/ 生成 .html）。有需要可以加。

Q：能换主题/配色吗？ 改 assets/style.css 顶部的几个 CSS 变量（--accent、--bg 等）就能整体换色。

Q：有暗色模式吗？ 有。顶栏导航右边有个 🌙 按钮，点一下就切暗色，选择会记住（localStorage），下次打开自动恢复；第一次访问会跟随系统的明暗设置。玩法/工具页面的按钮在顶部返回条右侧。原理是 <html data-theme="dark"> + CSS 变量覆盖，页面代码都在 assets/style.css 末尾的暗色块里。