Skip to main content
7

agile-workbench

781237194/agile-workbench

PM工作台(Agile Workbench)套装 bundle:一次安装装齐工作台启动器、记忆插件、浏览器插件、搜索插件、视觉插件与安全搜索 MCP。

Install

dsh plugin --profile web add github:781237194/agile-workbench

README

PM工作台(PM Workbench)

本地优先的多角色项目工作台:Electron 桌面端 + 团队协作协议 + DSH 外部会话引擎适配层。

  • 当前版本:v2.1.4
  • 运行平台:Windows / macOS / Linux(Electron 33,Node.js ≥ 20)
  • 自有代码许可证:MIT
  • 默认不联网、不收集遥测;唯一出站请求发往你自己配置的 DSH 地址

本仓库是独立实现的新项目(clean-room),不复制其他工作台项目的源码、模板、文档或图片,约定见 docs/CLEAN-ROOM.md。

核心零插件可跑 · 可选插件按需装

  • 核心不依赖任何可选插件:boot / 派单 / 回执 / 提案 / 评审 / 签字 / apply / 验收 / 看板 / 会话轮换,没装插件也能完整跑。
  • 可选插件(装了更好,不装不坏):memory-evolve 记忆、modlens 视觉、web-search-safe 搜索。
  • 缺插件自动降级:只标 memory:off / vision:off / search:off,不报错、不阻断核心;node 团队\工具\team.mjs status(或 doctor)随时看 on/off、版本、数据目录与读取源。
  • 安装 / 卸载 / 回滚:见 docs/可选插件.md(含双轨验证与故障处理)。

一句话安装(DSH 插件市场 / 一句话搞定)

装好原生 DSH 后,对 AI 说一句话即可:

帮我安装 "dsh-agile-workbench"

或者去 DSH 的插件市场(Discover)搜索/安装 dsh-agile-workbench,更新同理。

一句话会装齐整套组件:

#组件作用
1pm-workbench-dsh(随套装)注册工具 pm_workbench_open,拉起本机 PM工作台(首次打开会自动补装工作台本体)
2dsh-memory-evolve跨会话记忆 / 待办 / 技能
3dsh-ego-browser受控浏览器(ego lite)
4@liustack/modsearch联网搜索 / 读网页 / X 检索
5@liustack/modlens图片视觉读取
6mcp-web-search-safe只读安全搜索 / 抓取 MCP(web_search / web_fetch)

套装包名 dsh-agile-workbench(npm 上架版本 2.2.4);旧名 dsh-agile-workbench 已标记 deprecated,仍可安装但不推荐。

Desktop 版安装(没有 dsh 命令时):DSH Desktop 不会把 dsh 放进 PATH。装插件的等价路径是 GUI「设置 → 插件」,或本会话里让 AI 调 plugin_manager:list_bundles 看已装、install_bundle 装 dsh-agile-workbench@2.2.3、set_bundle 启停;升级是 remove_bundle → install_bundle(中途插件会短暂卸载)。

⚠ 覆盖插件配置是「整段替换」:在 profile 的 cordis.patch.yml 里覆盖 pm-workbench-dsh 行时, config 会被整体替换、不做深合并——只写 workbenchDir 会把 bundle 自带的 teamRoot 一起抹掉。 必须把两个键都重述:

- id: pm-workbench-dsh
  config:
    teamRoot: !!js process.env.AWB_TEAM_ROOT || ''
    workbenchDir: '<你的安装目录>\PM工作台'

安装器结束会写用户变量 AWB_TEAM_ROOT / PM_WORKBENCH_HOME;插件在运行期解析这两个值, 但正在运行的 DSH 进程看不到新变量——装完请重启 DSH,或直接在配置里写死路径。 不想装插件也可以直接用桌面版:见下面「新用户最短说明」的 PowerShell 一行命令。 版本:应用本体 v2.1.4 · 套装 dsh-agile-workbench 2.2.4(实际安装版本以工作台「更多 → 检查更新」显示为准)。

一句话之后会发生什么

  1. AI 安装 dsh-agile-workbench 套装 → 6 行插件全部上树(启动器 / 记忆 / 浏览器 / 搜索 / 视觉 / 安全搜索 MCP);
  2. 第一次打开工作台 → 启动器发现本机没有本体,自动后台运行官方安装器(便携 Node + Electron + 应用 + 桌面快捷方式),返回「正在安装,约 2–5 分钟」;装完再次打开即可;
  3. 安全搜索 MCP 用 DSH 自带运行时启动,PATH 没有 node 也能用;
  4. DSH 互通探针(运行期只读):工作台启动/首启后由主进程执行一次,检查 DSH 侧会话互通能力(不写 DSH、不改 asar),结果进 data/install-result.json 与「关于」页;探针失败不阻断启动;
  5. 可读日志(不再静默):安装器把每阶段结果写 data/install-result.json(ok/stage/next/warnings[]);MCP 启动失败写 ~/.dsh/logs/mcp-<时间>.log(command/args/errno/stderr 前 500 字),安装结果里给一条人话 warning,不再是空白 "server is disconnected";
  6. 版本与升级:版本号见「更多 → 检查更新」,升级行为见下节。

在线升级(工作台内)

  • 入口:更多菜单 →「检查更新」(不往标题栏加图标);显示当前版本与新版本,有新版时按钮为「立即升级」。
  • 版本源必须带 sha256:源里缺校验值时界面显示「源缺少校验值,暂不可升级」,且不会发起下载。
  • 强制升级(有角色在跑任务时):必须填写原因才允许;审计写 data/升级记录.jsonl 的 upgrade_forced{reason,runningRoles[],at} 与 force:true;无原因直接拒绝。
  • 结果:失败给顶部人话横幅(含错误代码/原因,可回滚);成功提示必须明确写 「请重启后生效」或「无需重启」(二选一,不省略),并写 升级记录.jsonl({ts,from,to,sha256,steps,ok})。
  • 边界:升级只换程序与套装,不动 团队/、data/、需求/任务账本;不改 DSH 本体;不做静默自动升级。

开局引导(新项目首启)

  • 第一次 boot 的启动简报会带 「可直接复制的下一步命令」(按角色给 boot/派单/回执模板)和红线 「禁止用 DSH 子代理代跑团队角色任务」;
  • PM 首条动作应直接粘贴命令发出 M-* 团队消息(走团队会话通道),而不是开子代理派角色。

需求流程与缺陷流程

需求流程(功能 / 改造)

  1. Owner 提目标 → PM 建需求,需求分析师写需求正文(用户故事、边界六类、验收标准、异常)。
  2. 产品评审(复杂需求先由测试人员做可测性评审 TR-Q)→ 通过才继续。
  3. Owner 评审:Owner 本人在评审弹窗点「通过」后才允许开发;正文一改旧决定自动失效。
  4. PM 派开发(一次一个角色一个任务;派单前置检查通过才发)→ 开发提交 → 测试独立复验。
  5. Owner 验收:需求到「待验收」后 只能 Owner 本人点通过;代管/PM/测试都不能代验需求(程序硬拦)。
  6. 打回走「迭代」入口,改稿后重新走 2–5。

缺陷流程(Bug / 场景缺陷)

  1. 任意角色立缺陷单(复现步骤 + 验收标准),PM 定优先级:P0 当天 / P1 三天 / P2 一周 / P3 两周。
  2. PM 派开发 → 修复提交 → 测试人员复验出报告与证据。
  3. PM 或测试人员 task accept 验收缺陷单(需求级验收不在此列,只能 Owner 本人)。
  4. 关联规则:提交信息带缺陷号/任务号;测试报告版本递增不覆盖;失败必须可见、不静默。

完整流程见《团队宪法》与 团队/流程.md 第二部分「现行工作流」;角色分工、验收权限、派单纪律、证据标准都在那一节写死。


新用户最短说明

如果你只是想把 PM工作台跑起来:

  1. 装好 DSH 并登录(Windows)。
  2. 打开 PowerShell,粘贴下面这一行。
  3. 等它自动下载、安装依赖、建桌面图标,然后双击 PM工作台。
$f="$env:TEMP\pm-workbench-install.ps1"; iwr "https://cdn.jsdelivr.net/gh/781237194/agile-workbench@6031ac5/install.ps1" -OutFile $f; & $f

这一行会处理 Node.js 没有安装的情况:自动下载便携 Node 到安装目录,不写系统 PATH、不需要管理员权限。

只装 DSH 插件(自动补齐工作台)

只装 DSH 插件也可以,插件首次加载会自动安装 PM工作台本体、便携 Node、Electron 依赖和桌面入口:

dsh plugin --profile desktop add dsh-agile-workbench

安装后重启 DSH,插件会在后台启动安装器;安装完成后对 DSH 说“打开 PM工作台”,或调用 pm_workbench_open。

这条命令安装的是 DSH 启动器插件,但它会自动补齐 PM工作台本体,仍然需要联网下载。
如果你不想装 DSH 插件,用上面的 PowerShell 一行命令直接装桌面版也可以。


一键安装(Windows)

安装器会:

  1. 检测 Git 和 Node.js;系统有 Node 20+ 就直接用。
  2. 没有 Node 就自动下载 Windows x64 便携 Node.js LTS 到 <安装目录>\.runtime\node。
  3. 下载/复用仓库,执行 npm install。
  4. 创建桌面 PM工作台 快捷方式,可选立即启动。
  5. 重复执行只补依赖,不覆盖 data/、项目/、团队/状态/。

安装 FAQ(干净 Windows / 无 Node)

  • PATH 里没有 node / npm / git / dsh:无需安装;安装器会下载便携 Node,MCP 用 DSH 自带运行时(ELECTRON_RUN_AS_NODE)。
  • DSH 桌面版没有 dsh 命令:优先用「方式 A:让 AI 装插件」;命令行方式只适合已装 DSH CLI 的环境。
  • Electron 下载慢/无进度:安装器默认走 npmmirror 镜像并每 5s 打印进度;AWB_NO_MIRROR=1 可关闭默认镜像改走官方源;失败会保留缓存 zip(不删,可重跑)。
  • 缓存兜底:若 node_modules/electron/dist 缺失,安装器自动从 %LOCALAPPDATA%\electron\Cache\*.zip 解压补齐(日志写明「从缓存解压兜底」)。
  • MCP 起不来 / 搜索不可用:看 data/install-result.json 的 warnings[] 与 ~/.dsh/logs/mcp-*.log(command/args/errno/stderr),不静默失败。
  • 审批弹窗太多:一句话安装建议在「完全访问」权限下进行;普通权限会逐次弹审批。
  • 脚本被拦(执行策略):用 powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1。

一、功能概述

项目、任务与看板

  • 本地项目库:新建项目、切换项目、从已有目录恢复/登记项目。
  • 每个项目自带角色目录、项目信息.md、文件索引与需求目录。
  • 任务:新建、认领、推进(待办 → 进行中 → 待评审 → 已完成)、删除;完成必须带证据。
  • 看板:待办 / 进行中 / 待评审 / 已完成四列,可开半透明悬浮窗。
  • 文件索引:扫描项目内文件,只读预览文本、Markdown、图片。

协作闭环(提案 → 评审 → 签字 → 应用)

  • 提案:文件级变更,绑定 SHA-256 哈希。
  • 评审:指定角色逐条通过/拒绝并写理由;作者不能审自己的提案。
  • PM 签字:签字绑定 提案哈希 + 基线哈希,换版本即作废。
  • 应用:先备份再写入,带 CAS 版本栅栏;基线被改过会返回 STALE_BASE 并停手。
  • 回滚:按备份恢复文件或删除新建文件。
  • 团队派单:一次只派一个角色,单待回执锁;没有回执 = 没发生。
  • 对账:固定表格(项目/指标/期望/实测/结果/证据),只允许 PASS / FAIL。
  • Owner 阶段:跳过 / 通过 / 打回;打回回到需求阶段。
  • 流程图:8 阶段高亮当前阶段。
  • 外观:暗金/暖白双主题。

DSH 工作区与会话

  • 探测 DSH 在线状态;不可用时显示真实错误码,不伪造会话。
  • 创建/绑定 DSH 工作区(workspace/create 按目录幂等)。
  • 建团队:按当前模式创建角色会话、重命名、写名册;支持一键唤醒(session/prompt)。
  • 嵌入 DSH 工作区页面;归档会话(先停活动再归档)。

二、六人团队与快速四人模式

团队模式保存在 project.teamMode,默认 full。切换模式不会删除已有会话和目录,只是不再显示/新建成隐藏角色。

模式角色评审链路适用场景
完整 6 人(full,默认)项目经理、产品设计师、需求分析师、程序员 A、程序员 B、测试产品评审 → 开发互审 → PM 签字需要产品/架构设计、双人并行开发
快速 4 人(fast)项目经理、需求分析师、程序员 A、测试需求分析师评审 → Owner 后程序员 A 技术评审 → 复核小改动、单人开发、快速验收

角色职责:

角色id职责
项目经理pm纯协调:建需求/任务、派单、催回执、收口;不替别人写文件
产品设计师product产品与架构:用户故事、流程图/类图、架构方案、优先级建议
需求分析师analyst需求拆解、验收标准、缺陷闭环、可行性
高级程序员 Aprogrammer1开发 A、提提案、互审;只写授权目录
高级程序员 Bprogrammer2开发 B、提提案、互审;不与 A 抢同一文件
测试人员tester独立验证、回归、验收报告;不改业务代码

快速模式的两处关键差异:

  1. 后端只创建 4 个角色会话与目录,product / programmer2 隐藏且不计入“就绪角色”;
  2. 需求评审人从产品设计师换成需求分析师;Owner 决策之后、派单之前增加程序员 A 的技术评审。

界面文案会随模式切换(六角色 → 4 人、产品评审 → 分析师评审、开发互审 → 复核)。


三、安装与启动

环境要求

最短说明:只需要 Windows + 网络 + DSH,Node.js 会自动装。

  • Windows 10+(一键安装器);macOS / Linux 桌面环境可手动 npm install
  • 首次安装需要联网:无系统 Node 时下载便携 Node.js(约 39 MB,解压约 110 MB),以及 Electron 依赖
  • Node.js 不需要预装:
    • 系统已有 Node.js 20+ → 直接使用,不下载;
    • 没有 → 自动下载 Windows x64 便携 Node.js LTS 到 <安装目录>\.runtime\node;
    • 优先 nodejs.org 官方源,失败自动换 npmmirror 镜像;
    • 下载后校验文件非空、zip 文件头;能拿到官方 SHA-256 时校验哈希;最后实际运行 node.exe / npm 确认可运行;
    • 只把实际使用的 Node 目录临时加入安装进程的 PATH,不写系统 PATH、不改系统环境、不需要管理员权限。
  • 便携 Node 只用于安装阶段;start.cmd 直接启动 Electron,日常运行不需要 Node。

安装器细节

安装器会:

  1. 检查 Git(可选)和系统 Node.js 20+。系统已有 20+ 就直接用;没有就自动下载 Windows x64 便携 Node.js LTS 到 <安装目录>\.runtime\node,只给本安装器与 npm 使用,不写系统 PATH、不改系统环境、不需要管理员权限;官方源失败会自动换 npmmirror 镜像。
  2. 当前目录是仓库 → 直接使用;否则下载 main 分支 zip 到安装目录(默认本机 PM工作台 文件夹,D 盘不存在或不可写时回退 %USERPROFILE%\PM工作台),解压后使用。
  3. 在仓库目录执行 npm install(首次会下载 Electron,可能需要几分钟)。
  4. 创建桌面快捷方式 PM工作台.lnk,指向 start.cmd,图标 assets\pm-workbench.ico。
  5. 可选立即启动:给命令加 -Launch(例如 安装PM工作台.cmd -Launch)。

重复执行是安全的:系统 Node 或 .runtime\node 已有可用版本时直接复用,不重复下载、不覆盖;已有仓库只补依赖,不重新下载;data\、项目\、团队\状态\ 等已有内容不会被覆盖。目标目录已有别的文件时安装器会停下并提示换目录,绝不删除。

可选参数(加在 安装PM工作台.cmd 或 install.ps1 后面):

参数作用
-InstallDir <目录>指定安装目录(默认本机 PM工作台 文件夹,回退 %USERPROFILE%\PM工作台)
-Launch装完立即启动
-NoShortcut不创建桌面快捷方式
-ZipPath <zip>用本地 zip,不联网下载
-ZipUrl <url>自定义下载地址
-ShortcutDir <目录>快捷方式输出目录(默认当前用户桌面)
-LogDir <目录>日志目录
-NonInteractive不暂停,适合自动化(也可设 AWB_NO_PAUSE=1)

如果自动准备 Node 失败(下载、解压或校验不通过),窗口不会立刻关闭,会打印具体原因和日志路径;也可以手动安装 Node.js 20+ LTS 后重跑,安装器会优先使用系统 Node。日志默认在 <仓库>\_tmp\install-logs\;全新下载时在 %LOCALAPPDATA%\PMWorkbench\install-logs\。

直接命令(任意平台)

git clone https://github.com/781237194/agile-workbench.git
cd agile-workbench
npm install
npm start          # 或 Windows 双击 start.cmd

只想要 zip:https://github.com/781237194/agile-workbench/archive/refs/heads/main.zip。

启动

Windows 一键启动:

start.cmd

start.cmd 会先清掉继承来的 ELECTRON_RUN_AS_NODE,检查 Electron 是否存在,再把参数透传:

start.cmd --selftest
start.cmd --check
start.cmd --help

任意平台用 npm:

npm start

只做启动前检查(不打开窗口):

start.cmd --check          # Windows
npm run check              # 语法检查
npm run test:scripts       # 入口脚本测试(不打开窗口)

首次启动后:在左下角配置 DSH 地址 → 新建或恢复项目 → 需要多人协作时用 🚀 建团队。

常见问题:app.setPath 报 undefined

在 DSH / Electron 宿主派生的终端里,ELECTRON_RUN_AS_NODE 经常是 1,此时 electron . 会退化成 Node 解释器,在 src/main.js 的 app.setPath 处报 TypeError。npm start、npm run selftest、start.cmd 都会先删除该变量;手工启动时请自己清理:

Remove-Item Env:ELECTRON_RUN_AS_NODE -ErrorAction SilentlyContinue
npx electron .

自测(沙盘,不碰真实状态)

npm run selftest

自测使用独立沙盘 .selftest-data\(可用 AWB_SELFTEST_ROOT 改),截图写到 .selftest-data\artifacts\selftest.png。


四、DSH 依赖

DSH(DeepSeek Harness)是外部会话引擎,用于登记工作区、创建/唤醒角色会话与嵌入工作区。新建项目本身就要向 DSH 登记工作区,所以 DSH 未配置或离线时:

  • 新建项目会被拒绝并回滚,不留下“本地有项目、DSH 没登记”的半成品;
  • 建团队、启动/唤醒会话、嵌入工作区同样返回真实错误码,界面不伪造会话;
  • 已登记项目的本地记录、任务与提案仍可查看。

配置与连接:

  • 地址配置:界面左下角,持久化到 <数据根>\dsh.json;
  • 环境变量:DSH_WEB_URL(优先级更高);
  • 默认值:http://127.0.0.1:52711;
  • 通信方式:公开 HTTP JSON-RPC,POST <origin>/api/<method>,使用 session/list、session/create、session/rename、session/prompt、 workspace/create、workspace/archiveSession;
  • 认证:从 DSH_HOME(默认 ~/.dsh)的 .credentials.yaml 读取 client-connection/browser-session 会话凭据,在本地派生 HMAC cookie; 凭据只读,不写入项目、日志或界面;
  • 离线行为:返回真实错误码(如 DSH_OFFLINE、DSH_TIMEOUT、DSH_AUTH_MISSING、 DSH_AUTH_REJECTED、DSH_RPC),界面不伪造会话。

适配层代码在 src/dsh-adapter.js,只实现公开协议,不含 DSH 源码。

命令行(可选,不经过界面)

# 初始化团队协议(生成 团队宪法 / 项目铁律 / 角色卡 / 状态目录)
node 团队\工具\team.mjs init

# 新建工作区(同时向 DSH 登记 workspace)
node 团队\工具\workspace.mjs create --name "示例项目" --root "<项目根目录>" --engine-url "http://127.0.0.1:<DSH端口>"

# 导入角色空会话(默认不烧 token)
node 团队\工具\launch.mjs --project "示例项目" --workspace "<项目目录>" --roles pm,analyst,programmer1,tester --no-prompt --add-members --engine-url "http://127.0.0.1:<DSH端口>"

五、数据目录

默认数据根是仓库内的 data\,数据跟着仓库走,不写死盘符。

路径内容入库
<仓库>\data\userdata\Electron / Chromium profile、状态库 workbench.json否
<仓库>\data\tmp\应用临时目录否
<仓库>\data\dsh.jsonDSH 地址否
<仓库>\.selftest-data\自测沙盘:状态库、团队状态、artifacts\selftest.png否
<仓库>\_tmp\导出 / 测试 / 安装日志临时目录否
<仓库>\团队\状态\团队运行态:名册、令牌、消息、提案、提交、锁、事件、授权否
<仓库>\团队\日志\每日人读日志否
<仓库>\项目\<项目名>\各项目自己的需求、角色目录、代码与索引否

可选环境变量:

变量作用默认
AWB_DATA_DIR应用数据根<仓库>\data
AWB_SELFTEST_ROOT自测沙盘根<仓库>\.selftest-data
TEAM_ROOT团队账本根<仓库>\团队
TEAM_PROJECTS_ROOT团队项目区根<仓库>\项目
DSH_HOMEDSH 配置目录(读凭据)~\.dsh
DSH_WEB_URLDSH 地址覆盖界面配置或 http://127.0.0.1:52711

注意:

  • 应用临时目录被重定向到 <数据根>\tmp,不写 %TEMP%;团队 CLI 仍可能用系统 %TEMP%,需要整条链路隔离时先设 TEMP / TMP。
  • --user-data-dir 会被 src/main.js 的 app.setPath('userData', ...) 覆盖;自测隔离请用 AWB_SELFTEST_ROOT。

六、安全边界

  1. 本地优先:不收集遥测,不上传项目内容;唯一出站请求发往你配置的 DSH 地址。
  2. 渲染层隔离:contextIsolation: true、nodeIntegration: false,页面只能调用 src/preload.js 暴露的白名单 IPC;主进程对参数做路径与类型校验。
  3. 文件访问受限:预览/打开文件先解析真实路径并校验是否在允许根内,文本上限 512 KB、图片上限 8 MB; 索引扫描限制深度与文件数。
  4. 凭据只读:DSH 会话凭据只从 DSH_HOME 读取,用于本地派生 cookie;不写入项目文件、日志、界面或状态库。
  5. 写入有闸门:文件变更只走 propose → show → review → sign → apply;apply 前备份并做 CAS 校验; Owner 决策与签字必须由界面显式操作。
  6. 私有数据不入库:.gitignore 覆盖 项目/、data/、团队/状态/、团队/日志/、团队/看板.*、 _tmp/、_backup/、_archive/、.selftest-data*/、userdata*/、probe-receipts/ 与常见凭据文件名。
  7. 已知取舍:preload 需要 Node 能力,因此窗口 sandbox 关闭、webviewTag 开启用于嵌入 DSH; 信任边界由 preload 白名单 + 主进程校验承担,不要把不受信任的网页当成本应用页面加载。

发布前建议自查包内容:

npm pack --dry-run

七、目录结构

src/main.js                     Electron 主进程、本地 API、窗口与 IPC
src/preload.js                  安全桥(contextBridge 白名单)
src/dsh-adapter.js              DSH 外部引擎适配层
src/team-tools.js               团队工具入口与工作流封装
src/renderer/                   独立界面(index.html / app.js / style.css)
scripts/run-electron.cjs        Electron 启动器(先清 ELECTRON_RUN_AS_NODE)
scripts/test-entrypoints.cjs    入口脚本测试(不打开窗口)
scripts/skill-check.cjs         基础流程 skill 清单自检(下载后可直接跑,输出 SKILL_CHECK_OK)
团队/工具/                       团队命令行:team / workspace / launch 及 lib
团队/skill/基础流程/             六角色基础流程 skill + 00-索引 + skill-manifest(Owner 批准版本)
团队/角色/                       六个角色卡 + 启动卡 + 索引
团队/模板/                       提案、评审、签字、授权、对账、需求模板
团队/协议/                       六份协作细则
团队/流程.md                     从需求到收口的阶段表与闸门
docs/ARCHITECTURE.md            分层、数据与流程状态
docs/FEATURE-MATRIX.md          功能矩阵
docs/CLEAN-ROOM.md              clean-room 约定
assets/                         应用图标(pm-workbench.ico / pm-workbench.png)
install.ps1                     Windows 一键安装器(环境检查 / 便携 Node / 下载 / 依赖 / 快捷方式)
安装PM工作台.cmd                Windows 双击入口,调用 install.ps1
start.cmd                       Windows 一键启动

八、开源分发

发包内容由 package.json 的 files 白名单决定,只包含:

  • src/
  • assets/pm-workbench.ico、assets/pm-workbench.png
  • scripts/run-electron.cjs、scripts/test-entrypoints.cjs、scripts/skill-check.cjs
  • 团队/工具/、团队/角色/、团队/模板/、团队/协议/、团队/skill/
  • install.ps1、安装PM工作台.cmd
  • LICENSE、NOTICE.md、README.md、start.cmd

私有项目、运行数据、团队状态与日志、备份、归档、临时文件、凭据都不会被打包。预览:

npm pack --dry-run

下载包解压后的最小自检(不需要安装依赖、不需要 DSH):

node scripts\skill-check.cjs    # 期望输出:基础流程 skill 清单校验:SKILL_CHECK_OK(0 个 finding)

依赖:该脚本只读 团队/skill/基础流程/ 与 团队/工具/lib/skill-manifest.mjs,两者都在上面的白名单里;若报文件不存在,说明包不完整(请提 issue)。


九、当前边界

  • v0.1 完成本地基座、六角色/快速四人的 DSH 会话启动与协作闭环;
  • DSH 事件流(轮询/推送)与场景页签仍在推进,独立安装包(exe/msi)与自动更新尚未提供;Windows 一键安装脚本已提供(install.ps1 + 安装PM工作台.cmd),需要时自动下载便携 Node.js,不要求预装 Node;
  • DSH 适配层只通过公开 HTTP 协议连接,不复制 DSH 内部实现;
  • 主要验证平台为 Windows,macOS / Linux 未做完整回归。

十、许可证

自有代码采用 MIT,见 LICENSE。

第三方组件与运行时(Electron、Node.js 内置模块、DSH 等)保留各自许可证, 说明见 NOTICE.md。

Related plugins