贡献者百科¶

社群协作久了会累积许多不成文规定：标题该如何下、文件名如何命名、PR 描述要写什么、Issue 如何分类、新贡献者第一周会碰到的疑问。这份贡献者百科把这些散落在 README、Issue 留言、Matrix 对话里的内容整合成一页，方便新成员一次看完，也让资深成员有共同对话的依据。

如果你是第一次参与，建议先看如何参与与认领主题决定方向，再回来这页查具体做法。完整的工具入口与账号申请见社群自架服务。

第一周的入门路径¶

依「我想做什么」分流：

想试水温，先看看内容：先读基础概念任一篇，再用自我技能评估表评估自己对 Tor、Tails、OONI 的熟悉度
想开始写作或翻译：申请 Matrix 账号（见社群自架服务）→ 加入 Public Space → 表达意愿 → 认领一个 Issue
想参与技术维运：申请 GitHub 对 anoni-net/docs 的协作权限 → 看项目研究预先准备建好开发环境
想加入活动筹备：到 Matrix 对应 room 询问近期活动（COSCUP、工作坊、小聚），协助文宣、现场、报名等任务

每条路径的第一步都是「进到 Matrix 表达意愿」。社群运作偏向 async，留消息后等一两天回复是正常节奏。

写作风格规范¶

禁用句型与标点¶

不使用 ——（双破折号）作为句中插入语。需要补充说明时，改用冒号、逗号，或拆成两句
不使用「不是...而是...」句型。改用正向直述
避免用「；」断句，优先用「。」或拆句
并列词语或短语请用「、」，不要用全形「／」当列举符号（半形 / 用在路径、URL、技术惯用写法）

并列引号的标点¶

连续的「」引号之间要加「、」。错误与正确对照：

「决策者」「被咨询者」「需被告知者」
「决策者」、「被咨询者」、「需被告知者」

段落语气¶

像一位了解主题的社群成员在解释，而非教科书或百科条目
不在每段末尾加总结句，让段落自然收尾
避免「值得注意的是」、「总的来说」、「综上所述」、「谈的是」、「指的是」、「涵盖的是」这类开头
避免「这…」、「这个…」开头，与「其实」、「换句话说」这类填充转折，能删则删
「这」不要在同一句里堆叠。同句出现 3 次以上，或两个「这」中间隔不到 9 个字，就把其中一个换成它实际指的名词，或整句重写。例：这件事说明有人在卖这个概念，不等于这套技术已经在运作 改成 有人在卖这个概念，不等于技术已经在运作。全文密度可以拿来抓大方向，站上每千汉字约 5 个是常态，超过 10 个的文章通常整段都要重写。zhe-repeat 规则只扫同句堆叠，全文密度要人工判断

标点集合¶

正文主要使用：「、」、「，」、「。」、「：」、「「」」、「（）」。技术术语（Tor、OONI、IP、USB 等）保持英文原文，不加引号。

用词¶

口语字改书面语。例：「讲」改成「提到」、「说明」。常见的还有：

口语	书面语
跑（执行软件）	依语境用执行、架设、运作、运营
拿到	取得
得先、得靠	需先、需仰赖
动手	实际操作、着手、实作
踩到	遇到
找上门	依语境用接洽、找上、追究
省事、省力	简便、容易
怎样	副词用「如何」，修饰语（怎样的 X）用「什么样的」。「长怎样」整句改写，不要写成「长如何」
照旧	维持原状
差不多	相近
挂了	无法连接
搞错、弄坏	出错、损坏

照录他人说法不在此限。例：把读者的感受写成「连不上」、「跑很慢」时保留原样，因为那正是要呈现的口吻。

文件命名与目录¶

文件名¶

全部小写，使用连字号分隔（tor-browser-advanced.md、anonymity-vs-privacy.md）
slug 以英文为主，避免中文文件名
缩写保持小写（vasp-2026.md 而非 VASP-2026.md）

目录结构¶

文件站的目录结构维持扁平，不再加深层子目录。新文章放进现有的 7 大分类：

分类	内容性质
`basics/`	概念层，匿名与隐私的核心思考工具
`tools/`	工具层，具体的工具介绍与比较
`scenarios/`	场景层，特定角色或情境的应用
`advanced/`	进阶层，技术深度的延伸阅读
`taiwan/`	在地脉络，台湾的法规、观测、研究
`reports/`	严选报告，外部研究的中译
`community/`	社群文件，治理、流程、入口页

如果你的新文章不确定该放哪一类，先在 Matrix 上问一声，避免直接 PR 后又要搬。

搬档、改名、删页要补 redirect¶

移动、改名或删除已上线的页面时，在同一个 PR 补上 redirect，让旧网址不会变成 404。旧网址会长期活在搜索引擎、书签与外部链接里，少了 redirect 就流失既有读者与累积的 SEO 权重。

redirect 写在三支 mkdocs 设定的 plugins.redirects.redirect_maps：mkdocs.yml 对应 zh-TW（同时涵盖 /docs/ 与 /docs/zh-tw/）、mkdocs_en.yml 对应 en、mkdocs_cn.yml 对应 zh-cn。
格式是「旧路径: 新路径」，路径相对各语系的 docs 目录，不含 docs/<lang>/ 前缀。例：'tools/what-is-ooni.md': 'tools/index.md'。
找不到一对一的新页时，导向所属分类的 index 页（community/index.md、tools/index.md 等）。
既有 redirect 保留不删，旧网址会一直有人点进来。唯一要回头改的情况：某条的目标页自己也被移掉，redirect 变成断链。

图片与资源¶

图片放在 docs/zh-TW/assets/images/
在 markdown 引用：对于 basics/、tools/ 等深度 1 的目录，用 ../../assets/images/文件名
对于 reports/interseclab-network-coup/ 等深度 2 的目录，用 ../../assets/images/文件名（刚好一样）
截图优先使用 webp 或最佳化过的 png，不直接放手机原始大档
图片如果有 lightbox（点击放大），HTML 用 <figure> + <a href> 包 <img>，两个的相对路径都要对齐

跨档链接规则¶

内部链接用相对路径，不要写成 /docs/zh-TW/... 绝对路径：

同一目录：./other-file.md 或直接 other-file.md
跨目录：../basics/anonymity-vs-privacy.md
跨深度：../../blog/posts/2025to2026.md

文章末尾建议放「接下来」、「相关阅读」之类的小节，链接到 2–4 篇相关文章。基础、工具、场景、进阶之间的横向链接比单向引用更有用。

PR 流程¶

Branch 命名¶

docs/<short-slug> 处理文件变动（例：docs/vasp-2026-rewrite）
feat/<short-slug> 处理新功能或新分类（例：feat/payments-stubs）
fix/<short-slug> 处理 bug 修正

Commit 消息格式¶

采用 conventional commits：

<type>(<scope>): <subject>

<body>

常用 type：docs、feat、fix、chore、refactor。scope 用语系或子项目名称（zh-TW、zh-CN、en、pulse、asn_coverage）。

PR 描述¶

PR 描述至少包含：

改动的「为什么」（链接 Issue 或社群讨论）
改动的范围（哪些文件、哪几个段落）
对读者的影响（链接是否会坏、URL 是否变更、有没有相依的文件要一起改）

Review¶

翻译、文字校对：请求至少一位非作者 review
结构性变动（搬档、改 nav）：先在 Matrix 提案讨论，再开 PR
图片、资源：自我检查 alt 文字、文件名、版权标示

Issue 分类¶

Issue 标签体系（持续调整中）：

type:docs 文件相关
type:bug 行为错误
type:enhancement 改进建议
type:question 问题讨论
area:zh-TW / area:zh-CN / area:en 语系区分
area:tools / area:scenarios 等对应分类
good first issue 给新贡献者的入门 Issue
help wanted 需要更多协助的 Issue

开 Issue 前可以先在 GitHub 搜寻既有 Issue，避免重复。

翻译流程¶

zh-TW 是 single source of truth，zh-CN 与 en 从 zh-TW 同步。详细流程见中文化与文件翻译：

新文章默认先写 zh-TW
zh-CN 用 Claude Code 直接翻译为候选稿（包含台式→中式词汇、政治措辞调适），再由社群成员校对词汇与政治措辞差异
既有 zh-CN 档已有人类校对版本，结构搬迁时只 git mv，不重翻覆盖
en 需要更多人工，因为文化脉络转换比语系翻译费时
zh-CN 与 en 的翻译不必同步上线，依社群人力滚动处理

提问前先看哪里¶

新贡献者最常问的问题与对应出处：

问题	看这里
如何选择主题开始？	如何参与与认领主题
如何申请 Matrix 账号？	社群自架服务
我的程度适合做什么？	自我技能评估表
如何设定开发环境？	项目研究预先准备
翻译有什么规范？	中文化与文件翻译
紧急情况的对外资源？	紧急求救

如果上述都没答案，到 Matrix 询问。询问前尽量提供：你想做什么、你已经试过什么、你卡在哪。

行为准则摘要¶

社群以开放、互助、合法为原则。以下是快速摘要，完整版（含角色定义、决策流程、争议处理）见治理章程，两者不一致时以治理章程为准。重点：

互相尊重：不同背景、不同熟悉度的成员一视同仁
讨论议题不攻击个人：对事不对人
合法前提：所有讨论与协作以合法用途为前提，不协助洗钱、规避税务、骚扰、跟踪、未授权入侵等行为
信息披露：涉及个人资料、机敏信息的处理走上传机敏信息流程
争议处理：先在 Matrix 讨论，没有共识可提案到下一次社群同步讨论

违反原则的行为会由核心成员依治理章程处理。

这份百科是活文件¶

新贡献者遇到不在这页的问题、发现某个流程其实没写清楚，欢迎提案改这页。改 contributor-handbook 本身就是一个 good first issue 的好题目。