allowBuilds 占位符键为单引号且值为提示文案,升级 rc.8 后需手工置 true 才能继续

[yangfei222666-9]

现象一句话

rc.8 profile 升级时,pnpm-workspace.yaml 生成的 allowBuilds 占位符使用单引号键、值为提示文案而非布尔值,文档未说明,用户须手工置 true 才能继续。

复现、预期与验收

• 复现步骤:

dsh plugin --profile <p> add \
  '@deepseek-ai/dsh-base@0.1.0-rc.8' \
  '@deepseek-ai/dsh-web-app@0.1.0-rc.8'

随后查看该 profile 的 pnpm-workspace.yaml 的 allowBuilds 段。

• 实际结果:生成项为单引号键、值为提示文案,非 YAML 布尔:

allowBuilds:
  'xxx': set this to true or false

• 预期结果:键格式与周边一致,并直接给出明确布尔值;或文档明确说明该占位符用途、注明需构建对应包时单引号键同样须手工置 true。
• 环境:DSH 0.1.0-rc.8;macOS;pnpm v11。
• 建议(任一):①错误提示中说明单引号键也需置 true ②升级文档记录该步骤 ③直接生成有效布尔结构。
• 验收条件:按文档/提示操作无需试错即可继续安装。

---

English

Title: allowBuilds placeholders use single-quoted keys with placeholder text — rc.8 upgrades require manual true before continuing

Summary: During an rc.8 profile upgrade, the generated allowBuilds placeholders in pnpm-workspace.yaml use single-quoted keys with instructional text instead of a YAML boolean, and the docs do not mention this; the user must set true manually to proceed.

Reproduction, expectation, acceptance

• Repro:

dsh plugin --profile <p> add \
  '@deepseek-ai/dsh-base@0.1.0-rc.8' \
  '@deepseek-ai/dsh-web-app@0.1.0-rc.8'

then inspect the allowBuilds section of that profile's pnpm-workspace.yaml.

• Actual: entries use single-quoted keys with placeholder text instead of a YAML boolean:

allowBuilds:
  'xxx': set this to true or false

• Expected: key formatting consistent with the surrounding entries and an explicit boolean; or the docs should describe the placeholder and state that single-quoted keys must also be set to true when the package needs builds.
• Environment: DSH 0.1.0-rc.8; macOS; pnpm v11.
• Suggestion (any): ① mention single-quoted keys in the error message ② document this step in the rc.8 upgrade docs ③ generate a valid boolean structure directly.
• Acceptance: following the docs/prompt lets the install continue without trial and error.

[yangfei222666-9]

补充复现细节(同一问题的更新说明):

• 测试 profile:dsh profile create 新建任意 profile,或使用已存在的 profile 均可;以下命令在全新 profile 上同样复现。
• 'xxx' 含义:该键为包名占位(实际生成项如 '@deepseek-ai/dsh-subprocess-local',键=包名)。
• 环境补充:DSH 0.1.0-rc.8;macOS 26.x;pnpm 11.x。
• 脱敏 YAML 片段:升级后 allowBuilds 段包含 '<package-name>': set this to true or false(值为提示字符串而非布尔);手工改为 '<package-name>': true 后安装继续。
• 核心问题表述澄清:问题核心是值被生成为提示字符串而非布尔值;单引号键属附带观察项。

感谢各位 upvote/反馈。

[yangfei222666-9]

更正与校准(感谢进一步核查):

1. 单引号键不是异常 —— @scope/pkg 以 @ 开头,按 YAML 规范必须加引号,属正确行为;set this to true or false 是 pnpm 11 审批门故意写入的未审批占位符,不是生成错误。
2. 根因定性修正:这不是 YAML 生成错误,而是 pnpm 11 的安全审批门正常触发,但 DSH 没有把原因和受控解除方式讲清楚 —— 尤其对 registry 包名安装路径,缺少可操作的指引。
3. 修复诉求收敛:遇到 ERR_PNPM_IGNORED_BUILDS 时,打印准确的 profile 路径,并提示 dsh plugin --profile <p> approve-builds。不建议无条件自动写 true —— 那等于绕过依赖脚本权限门;本次 blocked 本身就是正确的安全停止,缺的是解释与受控恢复路径。

(上文建议中"直接生成有效布尔结构"一条请视为已被本更正取代。)