Skip to content

[Bug] apps/web README 的环境要求与已发布 alpha.14 冲突:写 0.2.0-rc.2,实际硬要求 0.1.7-rc.2 #52

Open

Description

@nothingp

Affected area / 涉及区域

Startup or installation / 启动或安装(文档与已发布产物不一致)

Operating system / 操作系统

All supported platforms / 所有已支持平台(与平台无关)

What happened? / 实际发生了什么?

按 apps/web/README.zh-CN.md 的「快速开始」准备环境时,同一个 README 内部就自相矛盾,照第 69 行做会让安装器直接报错退出。

同一个文件里三处表述:

位置 内容 是否与已发布产物一致
apps/web/README.zh-CN.md:20 「这批 Alpha 安装包内置 WorkDSH v0.1.0-alpha.14 和官方 Harness 0.1.7-rc.2 Profile」 ✅
apps/web/README.zh-CN.md:35 「alpha.14 整包包含 12 个可安装模块……并适配 Harness 0.1.7-rc.2 的公开接口」 ✅
apps/web/README.zh-CN.md:69 「环境要求:Node.js ^22.19.0 || >=24.0.0、Corepack/pnpm,以及官方 0.2.0-rc.2 版本的 dsh CLI」 ❌ 不一致

已发布的最新 Web release 是 v0.1.0-alpha.14(2026-09-26),其 release-manifest.json 声明:

{ "version": "0.1.0-alpha.14", "harness": "0.1.7-rc.2",
  "runtimeOverrides": { "@deepseek-ai/dsh": "0.1.7-rc.2", ... } }

而 install-workdsh.mjs:75 是硬校验:

if (actualHarness !== expectedHarness) {
  throw new Error(`WorkDSH ${manifest.version} requires dsh ${expectedHarness}; found ${actualHarness || 'unknown'}. Pass --dsh /absolute/path/to/a-compatible-dsh.`);
}

即照 README 第 69 行装了 @deepseek-ai/dsh@0.2.0-rc.2 的用户,会在安装第一步得到:

WorkDSH 0.1.0-alpha.14 requires dsh 0.1.7-rc.2; found 0.2.0-rc.2.
Pass --dsh /absolute/path/to/a-compatible-dsh.

时间线上的原因(供参考)

  • 0.2.0-rc.2 对齐发生在 2026-10-02(Deliver optional enterprise connection and retire ECS execution #32 中的 99be89c "chore: align the official DSH runtime with 0.2.0-rc.2")
  • 而最新的 Web release v0.1.0-alpha.14 发布于 2026-09-26,早于这次对齐
  • 10-04 之后的 release 都是 desktop-v2.0.6-alpha.*,只发 dmg/exe 安装包与企业插件,不含 Web Profile 的 .tgz

也就是说:仓库已经推进到 0.2.0-rc.2,但还没有切新的 Web release,README 的版本要求已经跑到已发布产物前面了。

Expected behavior / 预期结果

两者对齐其一即可,想确认哪个是预期:

  1. 改文档:把第 69 行改回已发布 alpha.14 实际要求的 0.1.7-rc.2(或改成"以 release-manifest.json 的 harness 字段为准",这样以后不会再漂移);或
  2. 切新 release:发布对到 0.2.0-rc.2 的 Web 包,让文档与产物一致。

倾向于 2 的话,第 69 行可以暂时改成引用 manifest,避免下一个人又踩到。

Additional context / 补充信息

Activity

  1. techflag commented on Oct 10, 2026

    @techflag
    Owner

    收到,我们这边会注意这个细节。另外,请稍等打包,我们这两天会更新 工作台插件,类似于workbuddy的工作台

  2. nothingp commented on Oct 13, 2026

    @nothingp
    Author
    1. 收到,我们这边会注意这个细节。另外,请稍等打包,我们这两天会更新 工作台插件,类似于workbuddy的工作台

    预计什么时候更新,更新什么内容呢

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions