refactor(docs): [SITE-AI-DOCS-01] make generation offline and translation draft based

This commit is contained in:
Harvey Zhao committed 2026-09-14 08:22:44 +08:00
1 parent 647f3e7f12
commit 078cd9ef72
27 files changed
+8642 -4263

No files matched your search

+7 -3
View File
@@ -57,9 +57,13 @@ The repository generators have different ownership:
complete playback or plugin behavior. See its maintenance README and SITE-SMOKE-01.
- `scripts/build-i18n.js`: core language source bundles and copies to `docs/compiled/i18n/`.
- `scripts/build-docs.js`: this VitePress build.
- `scripts/build-llm.js` and `scripts/trans-docs.js`: explicit remote DeepSeek
operations, with a required key. They are not part of `ci:build` or `build:all`.
Do not invoke them just to inspect or regenerate local documentation.
- `scripts/build-llm.js`: offline source-preserving `docs/llms.txt` and fingerprint
manifest. `yarn check:llm` checks drift in CI; `ci:build` regenerates after types.
- `scripts/trans-docs.js`: local plan by default; explicit `--remote` creates a
reviewable draft, `--validate <draft>` checks edited drafts, and `--apply <draft>`
replaces selected English files with stale-input and rollback checks. Remote
translation is never part of CI. See [tool maintenance](../../scripts/documentation/README.md)
for the migration from destructive translation, module boundaries and limits.
## Browser boundaries and ownership