docs: 将 README 改为自然中文#3
Conversation
…a.1 prerelease The README becomes a natural-Chinese landing page for the same beginner-first contract: the verbatim English "Session paused" transcription, install commands, flags, URLs, and every verified evidence string (500+ tests, stdlib-only runtime, offline wheel install, pinned action SHAs, the one Linux / Claude Code 2.1.208 smoke with FABLE_BETA1_SMOKE_OK, PURE, and the measured cost) stay untranslated and exactly as verified. Release status now matches the live facts: the v0.3.0-beta.1 GitHub prerelease exists at its releases/tag URL, points at merge commit 181d321, and carries wheel, sdist, SHA256SUMS, and source archives. The checklist records that as a checked gate with no unchecked operational action left; the permanent dirty-history warning and all security gates stay. PyPI publication remains out of scope. README-related semantic checks move to Chinese needles and to the live-prerelease truth without weakening any guardrail: the checker now requires the exact release URL in README and checklist, zero unchecked checklist items, and a checked prerelease record; regression tests cover unchecking or dropping that record and losing the release URL. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The Simplified-Chinese landing page now reads like it was written in Chinese, not translated: full-width punctuation (，：；（）？——) throughout Chinese prose, natural spacing such as "Linux + Claude Code 2.1.208", a plain-words opening (套在 Claude Code CLI 外面的 本地 Python 工具), an idiomatic non-affiliation notice (不是 Anthropic 出品，也没有得到 Anthropic 的认可或支持), and ordinary developer wording for the audit claim (核对这次实际用了哪些模型). Source lines now wrap only next to Latin tokens or after full-width punctuation, so GitHub no longer renders a stray space inside words like 确定性发布检查. Everything verified stays byte-exact: commands, flags, URLs, the English "Session paused" transcription, FABLE_BETA1_SMOKE_OK, PURE, the measured smoke cost, the pinned install sources, and the v0.3.0-beta.1 release URL and commit. The only semantic-needle change follows the reworded opening: 本地 python 封装 becomes 本地 python 工具 in the readiness checker and its unit test, with equivalent enforcement. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
![adaptcom[bot]](https://avatars.githubusercontent.com/in/1609964?s=60&v=4){kind=small}
There was a problem hiding this comment.
Confidence Score: 5/5
Summary
Docs-and-tests-only PR that translates the public README into natural Simplified Chinese and records the shipped v0.3.0-beta.1 prerelease. No source code changes. All claims verified against live GitHub state: the v0.3.0-beta.1 annotated tag exists and points at merge commit 181d321 as documented, the GitHub prerelease is live (prerelease=true, not draft) with the wheel, sdist, and SHA256SUMS assets, and the release workflow succeeded on that commit. The translation preserves the verbatim English 'Session paused' transcription, all commands, flags, URLs, versions, and evidence strings, and keeps (arguably strengthens) the safety-boundary wording: no retries, no model switching, no safeguard bypass. Verified locally at the PR head: compileall clean, 553 unittest tests pass (5 workflow-parsing tests need PyYAML, an env dependency, not a regression; CI on the PR head is green), public_readiness_check PASS, full_history_readiness_check PASS (12 commits, 101 blobs), git diff --check clean, README is valid UTF-8. The semantic gates were coherently updated to check the Chinese content, with sensible new tests (Chinese no-bypass explanation must immediately follow the English transcription, exact release URL required, translated-marketing phrases banned). One minor parity nit, noted inline.
Important Files Changed
| File | Overview |
|---|---|
| README.md | Full rewrite of prose into natural Simplified Chinese. English 'Session paused' transcription, commands, paths, versions, evidence strings ($0.15400099999999997, FABLE_BETA1_SMOKE_OK, --max-budget-usd 0.5), and safety boundaries all preserved. Now records the live v0.3.0-beta.1 prerelease with its exact releases/tag URL and target commit, replacing the stale pre-tag wording. Claims verified true against GitHub. |
| PUBLIC_RELEASE_CHECKLIST.md | Converts the sole unchecked item (push the prerelease tag) into a checked record of the shipped prerelease, with the release URL and merge commit 181d321. Verified accurate: tag, release, and successful release workflow all confirmed via the GitHub API. Package-index publication correctly stays out of scope. |
| tests/public_readiness_check.py | Readiness gate updated: prose needles switched to the Chinese wording, English transcription and evidence strings still required verbatim, new RELEASE_URL requirement for README and checklist, and checklist logic flipped from 'exactly one unchecked item' to 'no unchecked items plus a checked prerelease record'. Passes on the PR head. Minor: its banned-marketing list is a subset of the unittest's. |
| tests/test_mit_release.py | Mirrors the gate changes: asserts the live release URL in README and checklist, bans stale pending-tag wording (cleverly composed so the test file never contains the strings literally), and adds mutation tests for unchecking/dropping the prerelease record and losing the release URL. All pass. |
| tests/test_public_readiness.py | README contract tests translated to Chinese needles; adds good new tests: the Chinese no-bypass explanation must appear within 400 chars after the English transcription, the release URL must precede install commands, and a translated-marketing-Chinese ban list. All pass. |
| for banned in ("production-ready", "production ready"): | ||
| for banned in ("production-ready", "production ready", | ||
| "赋能", "无缝", "重磅", "最佳实践", | ||
| "完整生命周期", "可复现证据"): |
There was a problem hiding this comment.
Parity drift with the unittest mirror: test_public_readiness.py bans 10 translated-marketing phrases (adding 一站式, 它想解决的问题, 操作者, 技术 beta) but this standalone checker only bans 6. CI still catches all 10 via the unittest, but anyone running only public_readiness_check.py gets weaker coverage. Consider syncing the two lists or hoisting them into a shared constant.
1 participant
这次改了什么
Session paused英文提示、命令、路径、版本和证据字段v0.3.0-beta.1已发布这一事实写回 README 和发布清单验证
python3 -m compileall -q src testspython3 -m unittest discover -s tests：553 tests passedpython3 tests/public_readiness_check.pypython3 tests/full_history_readiness_check.pypython3 tests/offline_install_smoke.pygit diff --check两次独立 Fable 5 high 审查后，最终中文审查结果为
PASS / READY_TO_PUBLISH。模型审计均为PURE，没有 fallback。