Conversation
helsome
requested changes
Sep 14, 2026
helsome
left a comment
Owner
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 即可,不需要补运行时测试。
RXQ6
force-pushed
the
docs/windows-dev-mode-prereq
branch
from
September 14, 2026 05:31
519e5fc to
078e751
Compare
Contributor
Author
|
@helsome 已按你的建议收窄措辞(中文/英文版同步),并已 rebase 到最新 main,冲突已解决,当前 diff 仅新增 README.md / README.en.md 各一段 Windows 前置说明。方便时再看一眼,谢谢! |
5 tasks
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
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.
改动说明
在 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 行。