sganggs
97152828c3
- CHANGELOG 0.2.1 (2026-10-07): the streams' lines collected (新功能: the update package and MANIFEST.json; 规则（按官方）: 联防 on the round's battlefield, 突袭 onto a teammate's half, full potential, the replace dialog for consumables, the 外勤医疗 Touch, 凋亡, 贾维's 拉普兰德, the 频次 器物 / leader summons; 界面: the collapse arrow, 自选 picks in the bond lists, flyers, enemy animations, the Touch card, Esc in the 自选 picker; 联机与大厅: battle messages while a battle loads; 工具与开发: the update build, .gitignore), one intro paragraph. - README: the dev warning under the title removed, the release badge, 「当前版本 0.2.1」; DESIGN's version line names 0.2.1 (§26) as the state described; §26's intro says when the dev line shipped. - Tests: version, docs-consistency, docs-paths, package, i18n-packs, update-package, update-boot 80 / 80.
36 lines
3.5 KiB
Markdown
36 lines
3.5 KiB
Markdown
# 卫戍协议：盟约 — Web Remake · Architecture & Contracts (DESIGN.md)
|
||
|
||
This is the **single source of truth** for every implementer. Research lives in `docs/research/` (start with `00-INDEX.md`; where a research file's body and its "Addendum (critic)" disagree, the addendum wins). When this document and research disagree, **this document wins**; when this document is silent, follow research; when both are silent, choose the simplest faithful behaviour and write it down in the module's header comment.
|
||
|
||
Language: player-facing text is **Simplified Chinese** by default, with an English switch since 0.2.0 (§25.2, docs/I18N.md: UI strings through `t('中文')`, game texts from the official Chinese data or the official EN client's). Code, comments and identifiers are English.
|
||
|
||
Versions: the first public release was **0.1.0** (2026-10-02, the state of §0–§20.15); the releases after it add the player feedback and GitHub reports — 0.1.1 §21, 0.1.2 §22, 0.1.3 §23, 0.1.4 §24 — and **0.2.0** (2026-10-07; `CHANGELOG.md`) the maintainability refactor, two languages, 补位, 自选编队 and their fidelity work — §25 — and **0.2.1** (2026-10-07; `package.json`, `shared/constants.js APP_VERSION`) the 联防 battlefield restored, full potential and the GitHub fixes after it — §26 — and is the state described by this document. The labels v1 / v2 / v2.1–v2.5.2 in §0, §14–§20 and in the BALANCE / SIM comparisons name the design generations and the private playtest builds that came before it; they are kept as history.
|
||
|
||
---
|
||
|
||
## Where each section lives
|
||
|
||
Section numbers are global and never change: code, tests and the other documents cite them as "DESIGN §N". The
|
||
current rules by area are in `docs/design/`, the per-release revisions (the evidence behind each rule) in
|
||
`docs/history/`. When a revision changes a rule, the rule in `docs/design/` is rewritten too (the revision lists the
|
||
normative lines it rewrote).
|
||
|
||
| sections | file | content |
|
||
|---|---|---|
|
||
| §0, §1, §2, §11, §12 | [design/overview.md](design/overview.md) | Scope, stack, repository layout, quality bar |
|
||
| §3, §4 | [design/geometry-time.md](design/geometry-time.md) | Coordinates, fields, geometry and time |
|
||
| §5, §7 | [design/engine.md](design/engine.md) | The battle engine (server/sim) and content modules |
|
||
| §6, §16 | [design/match.md](design/match.md) | The match and meta engine (server/match), operator loadouts |
|
||
| §8, §14 | [design/network.md](design/network.md) | The network protocol and client-side combat |
|
||
| §9, §10, §13, §15 | [design/client.md](design/client.md) | Rendering, UI, local-client art, the 3D board |
|
||
| §17 | [history/v2.2-playtest3.md](history/v2.2-playtest3.md) | User playtest #3 (v2.2) |
|
||
| §18 | [history/v2.3-playtest4.md](history/v2.3-playtest4.md) | User playtest #4 (v2.3) |
|
||
| §19 | [history/v2.4-playtest5.md](history/v2.4-playtest5.md) | User playtest #5 (v2.4) |
|
||
| §20 | [history/v2.5-playtest6.md](history/v2.5-playtest6.md) | User playtest #6 (v2.5) and its follow-ups, up to 0.1.0 |
|
||
| §21 | [history/0.1.1.md](history/0.1.1.md) | 0.1.1 — player feedback after 0.1.0 |
|
||
| §22 | [history/0.1.2.md](history/0.1.2.md) | 0.1.2 — GitHub issues after 0.1.1 |
|
||
| §23 | [history/0.1.3.md](history/0.1.3.md) | 0.1.3 — community reports after 0.1.2 |
|
||
| §24 | [history/0.1.4.md](history/0.1.4.md) | 0.1.4 — community reports after 0.1.3 |
|
||
| §25 | [history/0.2.0.md](history/0.2.0.md) | 0.2.0 |
|
||
| §26 | [history/0.2.1.md](history/0.2.1.md) | 0.2.1 — after the 0.2.0 release |
|