先选一条路
照着这张表挑，不用全看：
| 你想做的事 | 走哪条 | 要 GitHub 账号吗 |
|---|---|---|
| 给某张图补 / 改资料（难度、标签、作者、神器 / 道具、视频、来源…） | ① 网页表单 | 不用 |
| 有一大段背景故事想交 | ① 网页表单（选「背景故事」） | 不用 |
| 有这张图的游戏内截图，想放进条目的「图片集」 | ① 网页表单（选「图片集图片」，可一次选多张） | 不用 |
| 一次说好几件事，或者一整段攻略 | ② 提 issue | 要（注册免费） |
| 想直接改文件，或者一次改很多张图 | ③ 提 PR | 要 |
| 想给某张图换封面（要传图片） | ④ 传封面，或把图发给站长代传 | 要（注册免费，且必须先 Fork） |
| 什么都不想学，把东西发过来就行 | ⑤ 找站长 | 不用 |
动手之前，先认清两件事
1. 「地图英文名」是什么
就是地图详情页标题下面那行小字，也是网址里 /maps/ 后面那一段， 例如 ze_obj_abyss_v2、ze_ffvii_mako_reactor。 下面所有操作都要用到它，不是 Steam 的分片名（2001-ze_xxx-123456 那种）。
2. 「原稿」和「打印稿」，只能改原稿
| 文件 | 能不能改 | |
|---|---|---|
| ✅ 原稿 | data/research/<地图英文名>.json | 改这里，网站从它生成条目内容 |
| ❌ 打印稿 | src/content/maps/<地图英文名>.mdx | 脚本自动生成的，手改会被整段覆盖（真发生过好几次） |
所有 .mdx 都由脚本生成。包含路线图等富内容的页面也从对应的data/research/ JSON 中生成；需要修正资料时只改 JSON。
① 网页表单（最省事，不用账号）
- 打开地图库找到那张图 → 进详情页 → 看右侧栏的「补充 / 纠错」， 点 ✏️ 补充这张图的资料。
或者直接打开 投稿表单，在里面输地图名（中文名也行）也能进。 - 在「要提交哪一项」里选这次要补什么 —— 一次只能提交一项， 要补好几项就提交几次。
- 填内容。左侧表单旁边有一栏「这张图现在的内容」：基本信息、神器表、本站正文、 已经通过的社区投稿都在里面，照着改不容易出错。
正文类那几项（背景故事 / 攻略讲解 / 补充说明）还能改已经通过的那一条： 在右侧点那条的「修订这条」，正文会带进表单，提交后是替换它 —— 署名仍记原作者，条目页会标出是谁修订的。
下面的「理由 / 来源」和「你的昵称」都是选填，但来源很重要（见下）。 - 点提交。会给你一个投稿编号，凭它可以在表单页下面查审核状态。
表单里能填什么
下面这张表由站点的字段定义直接生成，和表单、服务器校验是同一份，所以不会对不上：
| 字段 | 能填什么 | 说明 |
|---|---|---|
| 难度 | 入门 / 简单 / 普通 / 困难 / 火星 / 入土 / 未知 | 必须从这几个里选 |
| 地图中文名 | 最多 40 字 | 只给「标题还是地图代码」的图用 —— 例如标题写着 ze_grace，社区都叫它「优雅」，就填「优雅」。已经有中文名的图请不要用这个字段改名（那属于译名之争）：想讨论叫法请投「其他叫法」或「补充说明」。中文名不宜超过 20 字，写社区里最通用的那个叫法；不同社区的写法进另一个字段。 |
| 其他社区叫法 | 最多 48 字 | 一行一条，写成「社区名：叫法」，例如「X 社区：爬雪山【娱】」「UB 难度表：雪山逃亡v6」。最多 8 条、每条 48 字以内。只写**确实见过别人这么叫**的（社区名写不清就写「社区」或来源，例如「B站：雪山大冒险」）；写进条目后显示在地图名下方的小字里，便于对不上名字的人找到这张图。 追加合并，不会顶掉已有的 |
| 标签 | 每行一个，最多 15 个，每个最多 24 字 | 从全站已有标签里勾选（括号里是「全站多少张图用过」，方便挑常用的）；「这张图现有的标签」已经帮你勾好了，你只要加要加的、取消不要的即可（提交的是整组，不是追加）。列表里没有想要的，就在下面「新建标签」里输入 —— 新标签需要审核确认，通过后会进全站标签，以后任何人给任何图投稿都能选到。 整组替换 |
| 作者 | 最多 120 字 | 尽量与工坊署名一致 |
| 署名详情 | 最多 300 字 | 多作者 / 原作与移植的区分 |
| 版本 | 最多 40 字 | |
| 人数 | 最多 40 字 | 如「最多 64 人」 |
| 时长 | 最多 40 字 | 如「约 40 分钟」 |
| 关卡数 | 1 ~ 30 的整数 | |
| 神器 / 道具 | 一件一行：填道具名 + 冷却秒 + 次数（后两项留空表示不改这一项）。名字选条目页表里的写法就是更正，表里没有的就是新增，不用自己选 | 一行填一件。上面列着本站这张图现在的表 —— 点名字就能改它（名字、冷却、次数、说明都会带出来）；点那件后面的「删除」就是反馈**本图没有这件**，提交后这一行会从表里删掉（原因可以写在备注里）。要加表里没有的，点「＋ 再加一件」手填。动作不用你选：名字对得上表里已有的算「更正」，对不上算「新增」。「说明」是神器表那一列的一句话介绍（这件神器是干嘛的，最多 200 字，长文请投「攻略 / 神器讲解」）；「备注」写的是我们服和原表的差别（例如「第四关才刷」）。冷却 / 次数留空 = 这一项不动。 逐行合并：按道具名对上号，服务器配置的原值会保留在表格备注里 |
| 攻略视频 | 每行一个 https 链接，最多 12 条 | 每行一个 **B 站**视频链接（bilibili.com/video/BV… 或 b23.tv 短链）。会用「官方播放器嵌入」（点击才加载，本站不转存、不下载、不剪辑）。**只收 B 站**：YouTube 等其它站点一律不收（站长 2026-10-11 明确要求站上只放 B 站视频）。只投公开视频 —— 付费、未公开、或者你不确定能不能公开的请别提交；不是自己拍的，请把作者 / 来源一并写在下面的「理由」里。版权归原 UP 主，作者说不想被收录我们会立刻撤下（「关于」页的版权一节写了规则）。 追加合并，不会顶掉已有的 |
| 通关视频 | 每行一个 https 链接，最多 12 条 | 全流程、通关实录、指挥视角。每行一个 B 站链接（bilibili.com/video/BV… 或 b23.tv 短链）。只收公开视频；不是自己拍的请在「理由」里写原作者。 追加合并，不会顶掉已有的 |
| 老司机经验 | 每行一个 https 链接，最多 12 条 | 神器 / 僵尸操作、进阶技巧、实战教学。每行一个 B 站链接。 追加合并，不会顶掉已有的 |
| 触发攻略 | 每行一个 https 链接，最多 12 条 | 触发点、机关讲解。每行一个 B 站链接。 追加合并，不会顶掉已有的 |
| 彩蛋触发 | 每行一个 https 链接，最多 12 条 | 彩蛋、隐藏关 / 隐藏房间。通过后会同时给这张图加上「彩蛋」标签。每行一个 B 站链接。 追加合并，不会顶掉已有的 |
| 音乐 | 每行一个 https 链接，最多 12 条 | BGM / OST / 主题曲 / 歌单。每行一个 B 站链接。 追加合并，不会顶掉已有的 |
| 相关视频 | 每行一个 https 链接，最多 12 条 | 拿不准属于哪一类的放这里（实况、整活、合集等）。每行一个 B 站链接。 追加合并，不会顶掉已有的 |
| 资料来源 | 每行一个 https 链接，最多 12 条 | 每行一个，https 开头 追加合并，不会顶掉已有的 |
| 地图封面 | 一张图：浏览器里自动裁成 16:9、压成 webp（上限 700 KB）再上传，不用自己处理 | 选一张横向图（16:9 最好）。会在你的浏览器里自动裁成 16:9、压成 webp 再上传，不用自己处理。请用作者在工坊公开的预览图，或者你自己截的图 —— 版权归原作者，作者要求撤下我们会立刻删。 替换当前人工封面（渲染图仍在，删掉人工封面即回退） |
| 图片集图片 | 可一次选多张游戏内截图：浏览器里压成 webp（单张上限 1.5 MB）再上传，每张能单独写一句说明 | 真实的游戏内截图 / 作者自己发的图，可一次选多张（一张图最多收 36 张投稿图）。会在你的浏览器里压成 webp 再上传，通过后进条目底部的「图片集」，每张都能写一句说明。不要传本站渲染的 3D 视角示意图。只传你自己截的、或者作者公开允许传播的图：别人的作品请先问过再传；图片版权归原作者，作者要求撤下我们会立刻删。 追加进条目的「图片集」，署你的昵称；不会顶掉已有的图 |
| 整篇条目草稿（大面积整理） | 最多 20000 字 | 给这张图写一整篇：用一行 `## 小节标题` 分节，例如 `## 简介`、`## 背景故事`、`## 关卡流程`、`## 神器 / 道具`、`## 常见问题`。**没写到的小节不会被删**，写到的小节会替换掉同名的那一节。投稿后先以「社区整理版（未采纳）」显示在页面上（会标注未经本站采纳），站长在审核台点「采纳为原稿」后才真正改进条目正文。想插图片集里的图：单独一行写 `:::figure 2`（引用第 2 张，图在左）或 `:::figure 2 right`（图在右），文字写在下面、最后用单独一行 `:::` 结束。支持简单 Markdown（分段、列表、表格、引用），**不支持 HTML / MDX**；最多 2 万字。请只写自己整理的内容与可核实的事实，别整段搬运别人的攻略。 |
| 地图简介 | 最多 1500 字 | 条目打开后、标题下面那第一段话（导语）：这张图是什么题材、大致怎么玩、有什么特别之处，一两段说清就行。和「背景故事」的分工：这里是开头那段总览，剧情、设定、来历请投「背景故事」（它会单独成一块，不占开头）。规则：只有本站还没写简介的图可以补 —— 已经有本站简介的图不能覆盖，那种情况请投「背景故事」或「补充说明」。支持简单 Markdown，不支持 HTML 与 MDX，最多 1500 字。 只补空白：本站还没写简介的图，你投的就是它正文开头那段；已经有本站简介的图不接受覆盖（投稿页会直接拦住，请改投「背景故事」或「补充说明」） |
| 背景故事 | 最多 4000 字 | 地图的剧情、设定与来历，可以分多段写 —— 注意这不是开头那段导语：开头那段总览请投「地图简介」，这里写的是故事本身（会单独成块显示）。支持简单 Markdown，不支持 HTML 与 MDX。通过后会显示在条目的「背景故事（社区投稿）」一节：不会覆盖本站整理的正文，会署你的昵称。右侧面板里列着本站正文与已经通过的社区投稿 —— 想改哪一条，点那条的「修订这条」，正文会带进下面的框里，改完提交即可（署名仍是原作者，页面上会标出是谁修订的）。 作为新的一条正文（署你的昵称），不覆盖本站整理的正文；投过一次之后可以在投稿页右侧点「修订这条」改它 —— 替换正文，署名仍记原作者 |
| 攻略 / 神器讲解 | 最多 4000 字 | 神器机制、道具怎么用、关卡要点这类玩法讲解（剧情与来历请投「背景故事」，开头那段总览请投「地图简介」）。支持简单 Markdown：分多段写即可，正文里换行就换行。想做成左图右文，先在下面的「图片集图片」里传图，再在正文里写一行 :::figure 2 （引用图片集第 2 张，图在左；写成 :::figure 2 right 则图在右），紧接着写文字，最后用单独一行 ::: 结束。通过后显示在条目的「攻略 / 神器讲解（社区投稿）」一节，署你的昵称。改已完成的那一条：点右侧面板里它的「修订这条」，正文会带进下面的框里。 作为新的一条正文（署你的昵称），不覆盖本站整理的正文；投过一次之后可以在投稿页右侧点「修订这条」改它 —— 替换正文，署名仍记原作者 |
| 补充说明 / 纠错 | 最多 4000 字 | 纯文本，支持简单 Markdown，不支持 HTML 与 MDX。通过后会显示在条目末尾的「社区补充」一节，同样会署名。改已完成的那一条：点右侧面板里它的「修订这条」，正文会带进下面的框里。 作为新的一条正文（署你的昵称），不覆盖本站整理的正文；投过一次之后可以在投稿页右侧点「修订这条」改它 —— 替换正文，署名仍记原作者 |
| 社区整理（自定义小节） | 最多 4000 字 | 给这张图补一节**本站正文里没有的**内容，标题你自己起（例如「彩蛋与机关」「老玩家心得」）。一次可以写 1~3 节；标题 2~20 字、不能和本站小节同名，正文每节最多 4000 字，需要登录。通过后显示在条目末尾，带「社区整理」小标和你的署名；本站正文不会被它盖掉。 |
② 提 issue（会填表就行）
适合「一次说好几件事」或者「有一整段攻略想交」：不用改任何文件，填空就行。
- 注册并登录 GitHub（免费），打开仓库hhjjdsj/ze-map-site
- 点上方 Issues → 右侧绿色按钮New issue
- 选模板 补充地图资料，按格子填：地图名（中文名也行）、想补充哪方面（可多选）、具体内容、来源链接、署名
- 点 Create 提交，等站长处理
其它模板：报告网站问题（页面报错、链接失效、显示错乱）、其它建议。
③ 提 PR（直接改文件，全程网页操作）
适合熟悉 GitHub 的人，或者想一次改很多张图。
- 在仓库里找到
data/research/<地图英文名>.json，点开它 - 点右上角的铅笔图标（Edit this file）
- 改字段（能填什么见上面那张表；难度只有 入门/简单/普通/困难/火星/入土/未知 七种）
- 滚到页面底部，写一句「改了什么」，点 Propose changes
- 下一页点 Create pull request，再点一次确认
GitHub 会自动帮你复制一份仓库、开好分支，fork / branch 这些概念你都不用管。 提交后仓库会自动跑一遍检查，结果直接显示在 PR 页面上，有问题会告诉你哪里不对。 JSON 每个字段的详细写法（含填空模板的样子）见data/research/README.md。
用这种方式改，只改 JSON 就够了，不用管地图条目文件。条目（src/content/maps/<地图英文名>.mdx）是脚本从资料打印出来的， 但线上构建时会用资料重新生成 —— 所以你的资料一定生效，检查会放行。
别手工编辑条目文件。 检查会用资料重新生成一遍，发现「你动了条目、却没动资料或烘焙数据」 就判红 —— 那是手改打印稿，下次构建会被覆盖。
想让仓库里的打印稿也同步（可选）：npm run maps:generate，把src/content/maps/ 下的改动一起提交。不想碰这些文件的话，用 ① 的表单也一样。
JSON 的标点很严格，这是新手最容易翻车的地方：
- 每个字段末尾要有英文逗号
,（最后一行不要） - 引号要成对，用英文双引号
"，不能用中文引号“ - 字段名后面是冒号，写成
"sources"[就错了 - 字段名拼错（比如把
author写成awthor）语法上没问题， 但那条内容会静默消失 —— 现在检查会把它抓出来并提示正确写法
不确定就少改一点，或者改用 ① 的表单。
④ 换地图封面（要传图片）
推荐：直接在投稿页传，不用 GitHub 账号。在地图详情页右侧栏点「✏️ 补充这张图的资料」→ 在「要提交哪一项」里选地图封面 → 选一张图。图片会在你的浏览器里自动裁成 16:9、压成 webp（通常几十 KB）再上传， 站长审核通过、写回仓库后就会替换成这张，和本站其它社区内容一样。
地图封面默认是脚本从地图数据渲染的（俯视密度图 + 实体点）。觉得某张图有更好看的封面，可以换成自己的图。 这张图会同时用在两处：地图库卡片（16:9 画幅）和详情页顶部（满宽背景大图，上面压了一层暗色遮罩）， 所以挑横向的图。想直接改成文件（提 PR）也行，下面是那条路 —— 但它必须先 Fork：
⚠️ 这一步必须先 Fork，不能直接往本站仓库传。你在这个仓库没有写权限，直接在目录里点「Add file → Upload files」会被 GitHub 拒绝 （提示 You need write access to this repository）。 正确做法是先把仓库复制一份到你自己的账号下，在你自己的副本里上传，最后发一个 PR 回来：
- 打开仓库hhjjdsj/ze-map-site，右上角点 Fork → Create fork（得到
你的用户名/ze-map-site） - 在你自己那份副本里打开public/images/covers/custom/ 目录
- Add file → Upload files，把图片拖进去
- 文件名必须正好是「地图英文名」，例如
ze_obj_abyss_v2.jpg。 格式.jpg/.png/.webp都收 - 拉到底 Commit changes（提交进你自己的副本，不会影响本站）
- 回到原仓库 hhjjdsj/ze-map-site —— 顶部会出现 Compare & pull request； 没看到就点 Contribute → Open pull request，写一句「换了 xx 的封面」再 Create pull request
嫌折腾？投稿页的「地图封面」就是给这件事准备的：选一张图传上去，浏览器会先裁成 16:9、压成 webp 再提交，通过后自动写进 custom/，文件名由系统按地图英文名对齐 —— 不用 Fork、不用 PR。 也可以直接把图发给站长（⑤ 里那个 QQ），站长在本地跑 npm run cover:set 代传。
| 要求 | 建议 |
|---|---|
| 比例 | 横向 16:9。竖图会被裁成中间一条 |
| 宽度 | 1280px 左右最合适，至少 640px（详情页顶部会放大当背景） |
| 体积 | 尽量 300 KB 以内，硬上限 800 KB（超了检查会红）。截图直接存 PNG 往往有 1~2 MB，存成 JPG（画质 80 左右）就行 |
⚠️ 文件名写成 Steam 分片名（2001-ze_xxx-123456）或者拼错一个字符，这张图永远不会显示—— 而页面和构建全都正常，你不会收到任何报错。 所以上传后请确认 PR 页面上的检查是绿的。
为什么换封面必须用「上传」，不能用铅笔？GitHub 的铅笔编辑只能改文字文件 —— 图片这类二进制文件它不给编辑器。 不过新增、替换、删除图片都能在网页上完成，不用装任何东西（都要在你自己 fork 的副本里做）：
- 换成另一张：在你 fork 的
custom/里还是 Add file → Upload files，文件名和路径保持一模一样，就是覆盖（PR 里会显示成修改） - 换回脚本渲染的封面：在
custom/里点开那张图 → 右上角⋯ → Delete file → 同样提一个小 PR。不用改任何配置
⑤ 什么都不想学：直接联系站长
QQ 3157410575（宇宙机器人）。把资料发过来就行 —— 文字、截图、视频链接、攻略原文都可以， 整理的事交给站长。
也可以进 QQ 群说：投稿、报错、问神器怎么用都行，群里也有人在玩同一张图。
提交之后会发生什么
| 你走了哪条 | 接下来 |
|---|---|
| ① 表单 | 进人工审核队列（凭编号可查）→ 站长审核 → 通过的会攒进待写回队列， 由站长批量写进仓库并自动重新构建，通常几分钟内就能在页面上看到，并署上你留的昵称 |
| ② issue | 站长看到后整理进站点，可能用你留的方式追问细节 |
| ③④ PR | 自动检查跑一遍 → 站长合并 → 自动构建部署上线 |
审核不通过或被搁置，通常是这几种原因：
- 没有来源 —— 查不到的宁缺勿假，写「网上说」没法核对
- 说法有争议（比如难度），会先挂起来等更多依据
- 整段搬运他人文章 —— 引用请注明出处，别原样复制
- 格式没法用（JSON 坏了、文件名不对），会退回让你改
站里还没有的新地图
新地图需要先提供 Steam 创意工坊物品 ID，由站长烘焙实体与地形数据后收录。 可以提 issue 告知地图的工坊链接与资料来源。
- 刚发布、还没收录：提 issue 提供工坊链接
- 想为未收录地图补充资料：提 issue，等地图收录后再补对应 JSON
- 需要路线图、视频嵌入等富内容：交给站长整理进 JSON 的
document字段
给开发者的命令
在本机跑开发时用得上，普通投稿完全不需要：
| 命令 | 作用 |
|---|---|
npm run build | 完整构建（含日期清单、生成条目、搜索索引） |
npm run maps:generate | 从资料 JSON 与实体索引重新生成条目 |
npm run content:verify | 校验资料 JSON（来源、难度、字段名、可疑措辞） |
npm run cover:set -- <地图名> <图片> | 本机裁图并换成人工封面（自动转 16:9 webp） |
npm run cover:verify | 校验人工封面（文件名、格式、体积、比例） |
npm run content:links | 扫全站站内链接与静态资源，查死链 |
注意事项
- 请尽量附上可核对的来源链接，避免无法验证的说法
- 不要直接整段搬运他人文章；引用请注明出处
- 地图版权归原作者，本站只做整理