# 文档结构与贡献 / Documentation structure

[中文首页](../README.md) · [English homepage](../README_EN.md)

<!-- Generated by scripts/check-docs.mjs from docs/structure.json. -->

## 中文

`docs/structure.json` 是本仓库公开文档的结构清单，登记页面职责、语言及翻译对应关系。本页由该清单生成；产品功能、安装和版本事实继续在对应指南中维护。

- 首页介绍本产品并提供安装、使用、兼容和来源入口；指南按用户任务组织，开发文档服务于外部贡献者。
- 内部计划、交接、真实会话、运行日志、原始研究和验收流水只留本地，不进入仓库、站点、安装包或 Release 附件。维护测试和合成夹具保留。
- 来源与许可保留原作者、维护者、固定版本及适配说明。历史版本和跳转页有安装、回退或外部引用时继续保留。
- 增删、移动或改变页面职责时，同步修改清单、中英文入口、首页／目录／站点导航、素材引用和打包配置。生成器或规则改变时，同步本脚本中的公开规范。
- 运行 `node scripts/check-docs.mjs --write` 更新本页，再运行 `npm run docs:check`。CI 与 prepack 运行同一检查，未登记页面、失效路径／锚点、错误翻译对应或过期生成页均阻止通过。
- 纯措辞修改不用修改结构清单。旧路径有外部引用时保留简短跳转，避免仅为统一命名造成断链。
- 版本说明按完整版本与精确宿主命名，分中文／English 两区，按实际内容列新增功能、体验优化、问题修复和其他变更，省略空分类；末尾提供统一安装区、固定包、安装指南与 SHA256SUMS。
- 市场投稿与更新按各市场当前规则和实际需要处理。首次按独立数据源去重；后续不因发版自动新建或编辑所有 PR／Issue。外部写入前核对最新指南、模板、原申请反馈、必填字段、固定包与完整宿主兼容范围；有必要的链接更新和实质整改复审沿原条目处理，自动刷新型不逐版通知，无实质变化不改帖或催审。规则、日期、原因与证据记入已有发行／投稿记录；市场同步不是一般合并或发行的统一前置。

## English

`docs/structure.json` is the repository's public documentation inventory: page responsibilities, languages and translation pairs. This page is generated from that inventory. Product behavior, installation and version facts remain in their respective guides.

- Homepages introduce this product and link to installation, usage, compatibility and sources. Guides follow user tasks; developer documentation supports contributors.
- Keep internal plans, handoffs, real conversations, runtime logs, raw research and verification output local. They must not enter Git, the website, packages or release attachments. Retain maintenance tests and synthetic fixtures.
- Preserve authorship, maintainers, pinned sources, licenses and adaptation notes. Keep historical versions and redirects needed by installation, rollback or external links.
- Add, move or remove pages together with inventory entries, translations, homepages, indexes, website navigation, assets and packaging configuration. Update this script's public policy when changing the generator or its rules.
- Run `node scripts/check-docs.mjs --write`, then `npm run docs:check`. CI and prepack use the same check for unregistered pages, missing paths or anchors, invalid translation pairs and stale generated documentation.
- Wording-only edits do not require inventory changes. Preserve short redirects where old paths have external consumers.
- Release notes name the full version and exact host, separate Chinese and English sections, omit empty categories, and finish with fixed packages, installation guides and SHA256SUMS.
- Follow each marketplace’s current rules and actual need. Deduplicate first submissions by independent data source; a release does not automatically require creating or editing every PR or issue. Before any external write, read the current guide, template and review feedback, and verify required fields, package ownership, fixed artifacts and exact host compatibility. Update the existing entry when needed and request re-review only after substantive fixes; do not notify automatic indexes for every release or send no-op edits and reminders. Record the rule, date, reason and evidence in existing release/submission records. Marketplace synchronization is not a universal merge or release prerequisite.

## 页面清单 / Page inventory

Roles: home · index · guide · development · sources · release · redirect. Languages: zh · en · bilingual.

| Page | Role | Language | Translation |
| --- | --- | --- | --- |
| [CHANGELOG.md](../CHANGELOG.md) | release | bilingual | — |
| [desktop/README_EN.md](../desktop/README_EN.md) | guide | zh | — |
| [desktop/README.md](../desktop/README.md) | guide | zh | — |
| [docs/desktop-host_EN.md](desktop-host_EN.md) | guide | zh | — |
| [docs/desktop-host.md](desktop-host.md) | guide | zh | — |
| [docs/documentation.md](documentation.md) | development | bilingual | — |
| [docs/install_EN.md](install_EN.md) | guide | zh | — |
| [docs/install.md](install.md) | guide | zh | — |
| [docs/releases.md](releases.md) | release | bilingual | — |
| [docs/usage_EN.md](usage_EN.md) | guide | zh | — |
| [docs/usage.md](usage.md) | guide | zh | — |
| [README_EN.md](../README_EN.md) | home | zh | — |
| [README.md](../README.md) | home | zh | — |
| [THIRD_PARTY_NOTICES.md](../THIRD_PARTY_NOTICES.md) | sources | en | — |