feat(i18n): key translation pairing records by heading section (#5036)

* feat(i18n): key translation pairing records by heading section

Replace the whole-file blob hashes in *.i18n.yaml with one entry per
heading section that still holds language-specific content, keyed by the
English heading-slug path. Blocks identical across the pair (generated
table rows, code blocks, shared regions) stay out of the hash, so edits to
different sections and identical regenerations merge with Git's default
text merge, including on GitHub.

Remove the dsh-translation-pairing merge driver, its resolver command and
installer wiring; gen-translation-brief recovers last-confirmed text from
commit history. Migrate all active records, archive the superseded Agent
Note, and record the replayed conflict reduction in the new one.

* test(i18n): refresh translation prompt snapshot for the terminology note

* feat(i18n): exclude only code blocks and generated regions from pairing records

Replace byte-equality masking with an explicit rule: a record hash skips
fenced code blocks and BEGIN/END GENERATED regions, the two kinds of
content the pairing gate already requires to be identical on both sides.

Move generated data into regions written into both pages:
gen-config-catalog renders both languages and the record with per-package
regions labelled by code identifiers; gen-module-graph keeps its table in a
region; gen-doc-graphs splices the event matrix regions into the Chinese
page. Add a generic region splice beside the region grammar.
This commit is contained in:
Turtle authored and GitHub committed 2026-09-23 22:32:06 +08:00
1 parent d9ff18ec2a
commit e7def469e1
1154 files changed
+48932 -8951

No files matched your search

+15 -5
View File
@@ -1,6 +1,16 @@
# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write python/README.md
README.md: d82195fa8a3f39bea129030b2eaf7d65536041e0
README.zh.md: c1432ae94369c37df548d2fd09fb3a7ac088e393
/deepseek-harness-python-sdk:
en: aa08432a8887185d
zh: 85b40b48790c04db
/deepseek-harness-python-sdk/packages:
en: 485e9978ed4f6dee
zh: fccda14b1b84cecf
/deepseek-harness-python-sdk/behavior:
en: ccb264c8850ae568
zh: 2580e6d587193bb0
/deepseek-harness-python-sdk/contributor-workflows:
en: 292b8aab762f515a
zh: 93da3d5c6af97d70
+21 -5
View File
@@ -1,6 +1,22 @@
# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# Bilingual-pair consistency record for development.md (docs/i18n/README.md): per heading
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write python/development.md
development.md: b36a26b08631ae02532d6f190bab968c1ec24720
development.zh.md: 81e8015bbcf45424dfb595154bab0ffe1e501251
/python-contributor-workflows:
en: e14647f4d39e03f6
zh: 354bd37e6aea1e86
/python-contributor-workflows/build-runtime-artifacts:
en: 8e99640e4936332d
zh: 729d5de1e0ad2869
/python-contributor-workflows/validate-the-sdk:
en: a5d58453392437d2
zh: aa3fa84703d894da
/python-contributor-workflows/run-against-node-source:
en: 4d30c74632781443
zh: 13191cb05f99dd31
/python-contributor-workflows/build-distributions:
en: 4aa941562dba5482
zh: 50543a92b3d0cf04
/python-contributor-workflows/validate-a-release-candidate:
en: dd3298f2b221451f
zh: 8dad5bf59caa2636
+18 -5
View File
@@ -1,6 +1,19 @@
# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write python/sdk-runtime/README.md
README.md: 39d1ce71c4c291650e4e1bafcf28f3bde4d0659a
README.zh.md: 4dd2b363cc3e436691be47b6500e515352163e34
/deepseek-harness-runtime-bin:
en: 1ea1d8e6d2c14b02
zh: 8e0b9903158667a1
/deepseek-harness-runtime-bin/installed-commands-and-artifacts:
en: af4e7919327e1991
zh: b4114823b4f1a3fa
/deepseek-harness-runtime-bin/python-module-api:
en: a88b7574e0e00a28
zh: 3fd4fe8c0b338e79
/deepseek-harness-runtime-bin/packaged-profile-resolution:
en: 641c647efc49c568
zh: a29371de9fbbebfd
/deepseek-harness-runtime-bin/build-and-distribution:
en: 9a4ba11944fbfc54
zh: 2ae046803108df2b
+15 -5
View File
@@ -1,6 +1,16 @@
# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write python/sdk/README.md
README.md: bfca3b0dda6c97bbef255815f33ca81121832f4e
README.zh.md: a10f1f501357e4a9f5c8eaf9aca9f8b408803e80
/deepseek-harness-python-sdk:
en: 43f7de064985e731
zh: 9ad59629660b1f13
/deepseek-harness-python-sdk/start-a-runtime:
en: 9a069c1a7cbb0779
zh: 7f625a802cd1e9ea
/deepseek-harness-python-sdk/customize-plugins:
en: d32ee602f121e6af
zh: fdea4487688e5774
/deepseek-harness-python-sdk/results-and-notifications:
en: 2658424dd12e1ad9
zh: 110d72f5bd836caf
+12 -5
View File
@@ -1,6 +1,13 @@
# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write python/sdk/examples/README.md
README.md: 82715c67cebe5d06decd3a6301cb1a8c245958c6
README.zh.md: 6821be33bf2e04fab0c7ba4f216f95a607e1693a
/python-sdk-example:
en: d9dfc996ea2ace40
zh: 33de241bad6c4ee1
/python-sdk-example/run-the-minimal-agent:
en: 0a23802ca759a16c
zh: 9a68ff9642f90efb
/python-sdk-example/add-plugins:
en: 5e1e30dac13f6c9e
zh: 0af98ebb75c88f43