Conversation
helsome
left a comment
There was a problem hiding this comment.
补这个 Windows 前置说明是有价值的,但 README 现在写成“否则 Bun 无法创建符号链接”过于绝对。Windows 的 symlink 权限并不只取决于 Developer Mode:Developer Mode 允许非提升进程使用 unprivileged symlink creation;具备相应权限/提升运行的进程也可能创建 symlink。因此建议把措辞收窄成项目实际需要的场景,例如:
Windows:建议在普通(非管理员)开发终端下先开启 Developer Mode。否则本项目使用 Bun 安装 workspace/symlink 依赖时可能出现 node_modules 空目录、缺少 .bin、tsc not found 等问题。
英文同步表达即可。这样既保留作者真实复现到的故障,又不把 Windows 平台行为写成普遍定律。该 PR 目前也已与 main 冲突;改完文案后顺手 rebase 即可,不需要补运行时测试。
519e5fc to
078e751
Compare
|
@helsome 已按你的建议收窄措辞(中文/英文版同步),并已 rebase 到最新 main,冲突已解决,当前 diff 仅新增 README.md / README.en.md 各一段 Windows 前置说明。方便时再看一眼,谢谢! |
|
@helsome 打扰一下,同步下这个 PR 的最新状态:措辞已按你的 review 收窄,并已同步到 README.md / README.en.md / README.zh-CN.md 三份;rebase 后与 main 无冲突,当前 diff 仅 +6 行(纯文档,无运行时代码改动)。按你的说明没有补运行时测试。 review 状态仍停留在 changes requested,方便时麻烦再扫一眼并解除,谢谢! |
改动说明
在 README 的「面向开发者 → 前置条件」中补充 Windows 需要开启「开发人员模式」。
Windows 未开启开发者模式时,Bun 无法创建符号链接,
bun install会在node_modules下留下空目录且不生成.bin,导致bun run typecheck找不到tsc,测试也无法运行。当前前置条件只列了 Bun、Longbridge CLI 与 LLM 提供商,Windows 贡献者第一次上手会卡在这里且难以自诊断。中文版(
README.md/README.zh-CN.md)与英文版(README.en.md)同步修改,三份 README 措辞一致。关联 Issue
无(纯文档改动)
测试报告(正式审核前必填)
环境
实际执行命令与结果
本次为纯文档改动,仅修改 README.md、README.zh-CN.md 与 README.en.md 的前置条件说明,不涉及运行时行为、类型或测试变更,故未运行测试套件。
改动依据:结论来自在 Windows 未开启开发者模式环境下的实际观察——
bun install完成后node_modules下存在空目录、.bin未生成,bun run typecheck无法找到tsc。已知失败 / Baseline(如有)
无
UI 截图(仅可见 UI 变化时必填)
Scope / 后续
仅补充前置条件说明,无代码改动;三份 README 同步更新,各 +2 行。