FDE-X 交付工作台

仓库：https://github.com/losebird/fdex--workbench

• workbench/ — 可运行的 FDEDeliveryWorkbench 源码（DeepSeek Harness 0.1.1-rc.2 + FDE 插件，含侧栏收起点击修复）
• scripts/start-workbench.sh — 本机起 dsh web 并打开浏览器（无需 .dmg）
• Electron 安装包相关文件仍保留，但日常请直接跑源码

课程/实验材料再分发建议用私有仓库，见 NOTICE.md。

你只需要 Node + npm

不必安装全局 pnpm，也不必有 corepack。
Mac 上装好 Node 24 LTS（自带 npm / npx）即可。

setup 内部用一行：npx --yes pnpm@11.7.0 … 临时下载 pnpm 来装 monorepo；装完后 启动只用 node。

git clone https://github.com/losebird/fdex--workbench.git
cd fdex--workbench

# 强烈建议 Node 24（nvm install 24 && nvm use 24）
# 国内网络（推荐先设镜像，避免 npx 拉 @pnpm/exe 失败）：
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com

npm run setup:workbench   # 首次：npx pnpm install + build
npm run start:workbench   # 之后每次：起服务并打开浏览器

默认地址：http://127.0.0.1:3080
改端口：FDEX_PORT=3081 npm run start:workbench
DSH_HOME 默认在 workbench/.runtime/dsh-home，不会动你全局其它 dsh 安装。 npm run start:workbench 会自动把 vendor/dsh-our-free-model 挂进 DSH_HOME（幂等，无需 pnpm）。

侧栏收起后点不了（必须 rebuild ui-sidebar）

源码里的修复在 packages/client/ui-sidebar（以及 ui-layout 的 track 裁剪）。
只 git pull 不够——要重新 bundle 前端包，否则浏览器仍跑旧 CSS。

cd fdex--workbench
git pull
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
cd workbench/upstream/deepseek-harness
npx --yes pnpm@11.7.0 --filter @deepseek-ai/dsh-client-ui-sidebar run bundle
npx --yes pnpm@11.7.0 --filter @deepseek-ai/dsh-client-ui-layout run bundle
cd ../../..
npm run start:workbench

然后浏览器 Cmd+Shift+R 强制刷新。再试收起左侧栏，主区与顶栏展开按钮应可点。

OpenAPI 工具：别再挂 dsh-openapi

FDE 的 @deepseek-ai/dsh-fde-project（fde-project）已经内置 OpenAPI 工具（如 openapi_list 等）。
再挂外部 vendor/dsh-openapi 会重复注册同名工具，服务秒退，日志类似：

tool "openapi_list" is already registered

因此：

• 默认不 seed dsh-openapi
• 每次启动若发现旧挂载，会自动卸掉（自愈）
• 日常用工作台里的 OpenAPI / API 文档能力即可，无需外挂插件

高级用途才需要强制挂 vendor 插件（会与 fde-project 冲突，一般不要）：

SEED_OPENAPI=1 npm run start:workbench

若你本地曾误挂过 openapi、服务仍秒退：git pull 后再 npm run start:workbench（脚本会 unseed）。

网络 / 镜像说明

若出现连不上 registry.npmjs.org、下载 @pnpm/exe 失败：

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
# 可选（部分环境还认这个）：
export COREPACK_NPM_REGISTRY=https://registry.npmmirror.com
npm run setup:workbench

脚本默认已用 registry.npmmirror.com；若你要官方源：

export NPM_CONFIG_REGISTRY=https://registry.npmjs.org
npm run setup:workbench

为什么不是「纯 npm install」？

workbench/upstream/deepseek-harness 是 pnpm workspace（pnpm-lock.yaml、link: overrides）。
根目录 npm install 装的是 Electron 壳，不会装好工作台 monorepo。
对 harness 目录直接 npm install 也装不全。
所以首次必须走 npm run setup:workbench（底层仍是 pnpm，但经由 npx，不用你装）。

目录

workbench/                 # 工作台源码（git 可见）
  upstream/deepseek-harness/
  vendor/dsh-openapi/
  vendor/dsh-our-free-model/
  frontend/
  start.sh
scripts/
  setup-workbench.sh       # npm run setup:workbench（npx pnpm@11.7.0）
  start-workbench.sh       # npm run start:workbench（仅 node）
  seed-plugins.sh         # 挂 free-model；默认卸掉会冲突的 dsh-openapi
src/                       # Electron 壳（可选）

node_modules、.runtime、构建产物 不进 git。

Electron 安装包（可选，已不推荐日常用）

体积大、未签名。若仍需要，见 BUILD.md。