fix: clarify setup doctor after install - #197
Merged
Merged
Conversation
Closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Mainline Intent
Intent:
int_4516e83fStatus:
proposedTitle: 澄清 doctor --setup 的安装后引导
What changed
把 README 和 reference 文档里的安装后校验从
mainline doctor --setup改成mainline version，并在doctor --setup不在 Git 仓库内运行时输出专门提示，说明它是仓库配置检查而不是 CLI 安装验证。Why
Issue #196 的日志显示 install.sh 已经安装成功，但紧接着运行的
mainline doctor --setup因为不在 Git 仓库内报NOT_IN_GIT_REPO，让用户误以为安装失败。安装验证和仓库配置检查需要在文档和错误提示里明确分开。Decisions
mainline version验证 CLI 已安装并在 PATH 中 (mainline version不依赖 Git 仓库，符合刚安装后的任意目录验证场景。)mainline doctor --setup作为安装验证命令doctor --setup在非 Git 目录里的行为: 保留失败状态，但把提示改成说明必须在 Git 仓库内运行，并建议先用mainline version验证安装 (doctor --setup检查的是 refspec、identity、.gitignore、policy 等仓库配置；让它在非仓库目录成功会掩盖真实语义。)Subsystems: README.md, README.zh.md, cli, docs, doctor setup onboarding