# 源码发布、程序发布与本机升级 源码和程序发布只处理工作台自身,不依赖用户在工作台里加入了哪些项目。项目文件、会话数据库、执行工件、模型连接凭据和 Key 都不进入发布包。 ## 单独发布源码 运行 `npm run package:source`。此命令直接从 Git 的已提交 HEAD 导出源码 ZIP,并保存来源提交、Git tree、文件清单和归档 SHA-256。清单同时记录实际 ZIP 条目的字节与 SHA-256、原 Git blob 身份;Windows 启动脚本依照已提交的 `.gitattributes` 导出 CRLF 换行。未提交修改不进入该包。它不连接工作台服务、不读取用户数据目录、不要求先构建或安装程序,也不打包运行时和历次实验的原始证据。 源码包含产品源码、构建脚本、测试及夹具、锁定依赖、示例、许可证与文字说明。接收方使用 Node 24,执行 `npm ci`、`npm run build`,即可构建程序。需要实际外部引擎、Python 或历史证据的专项验收另行准备依赖,不把这些材料当成程序源码。 ## 单独发布程序 提交本次源码并运行 `npm run build`,再运行 `npm run package:app`。此命令生成新的 Windows 程序目录、ZIP 与安装器,保留文件哈希清单和来源提交;不扫描或复制历次实验的原始证据,不读取正式工作台的项目数据。运行时和第三方依赖属于程序所需组件,随程序发布。 `npm run package` 也默认只发布程序。需要兼容旧版全套归档时,显式运行 `node scripts/package.mjs --with-evidence --immutable`,才会同时生成带运行时的源码包和历史证据包。历史原件留在原处,不为每次改程序重复打包。 ## 更新已经安装的程序 是否将某份程序包安装到正在使用的工作台,是发布包生成以后的独立操作。只有实际升级时,安装器才需要核对正在运行的任务、版本及原数据是否保留,并记录失败或回退结果。这些核对不属于源码打包,不要求项目开发成功,也不把用户项目带入发布包。 专项验证使用自建项目和隔离数据目录。原真实模型错误、网络异常、重复读取与 Purge 未验证事项保留各自原记录,不作为新源码已经解决这些问题的证明。