@tedbrain/vlink 0.1.120 → 0.1.122

package/README.md

@@ -246,6 +246,129 @@ VLINK_VERSION=0.1.21 npx --registry=https://registry.npmmirror.com -y @tedbrain/
 
 ## 发布
 
+### 通过 SSH 调度 s02
+
+在干净的 `luyukai` 工作区使用一条命令完成推送、自动升级版本、容器构建和
+发布，不需要常驻 CI。其他分支可以通过 `--repo` 指向现有 `luyukai` worktree。
+
+```bash
+./scripts/publish_vlink_s02.sh --dry-run
+./scripts/publish_vlink_s02.sh
+./scripts/publish_vlink_s02.sh --resume
+```
+
+默认构建机为 `s02`，远端状态目录为 `~/.local/state/vlink-release-s02`，可用
+`--host`、`--branch`、`--state-dir` 覆盖。`--bump minor|major`、`--version`、
+`--jobs` 和 `--cargo-jobs` 控制版本与并发。远端使用独立 checkout，保留已有
+开发目录及其未提交修改；先提交并正常推回 Cargo 版本，再构建七个平台。
+分支发生并发更新时停止，不强制推送。成功后，本地工作区仍干净且 HEAD 未被
+用户改变时自动快进到远端版本提交。
+
+任务在 s02 后台执行，SSH 断开后仍可运行。`active.json` 指向最近一次任务，
+日志位于 `runs/<任务ID>/build.log`，状态和源码/版本提交 SHA 位于同目录的
+`status.json`。失败后用 `--resume` 跟随或恢复原任务，避免重新选择版本。
+并发调用不能重复启动构建，已完成的步骤和已校验产物会复用。
+上传前和恢复时还会检查 Gitee release 的源码 SHA；若同版本属于其他构建，
+立即停止，不替换该 release 的附件。
+
+`--dry-run` 不推送 Git、不写持久状态、不构建或发布。`--build-only` 会推送
+已提交源码到 Codeup，在远端生成版本提交并构建，但不推回该版本提交，也不发布
+Gitee/d01/npm；之后可用 `--resume` 发布同一批签名产物。
+
+本机和远端均加载 `~/.proxy`。远端先加载已有的
+`~/ted/servers/tedmind/docker/tedbrain-ci-env/vlink-release.env`，再加载
+`~/.config/tedmind/vlink-release.env` 覆盖同名配置、保留其他变量；也可用
+`--env-file <远端绝对路径>` 只加载指定文件。所需凭据与下方本机构建入口相同，值不会传到
+本机或写入任务请求。s02 需具备 Codeup 拉取/推送和 d01 下载目录写入权限。
+
+npm 默认使用 s02 的 `~/.npmrc`，不会被旧的 `NPM_TOKEN` 环境变量覆盖。
+`--npm-config <远端路径>` 可选择其他文件；`--npm-config ''` 改用 token
+环境变量。原 npmrc 不修改，认证配置临时复制为 `0600` 文件。正式发布前先运行
+`npm whoami`，认证失败立即停止，不升级版本或开始编译。
+
+Gitee 默认以其已有的 `master` 作为 release tag 目标；Codeup 源码提交并未
+镜像到 Gitee，真实源码 SHA 保存在构建记录和二进制中。若 Gitee 已包含所需引用，
+可通过 `--gitee-target <引用>` 指定。
+
+可调用仓库内的 [vlink-release-s02 Skill](../../../../../.agents/skills/vlink-release-s02/SKILL.md)
+执行这套流程。
+
+### 在构建机直接运行
+
+CI 停止时，在仓库根目录使用手动发布入口：
+构建宿主机使用 Linux x86_64，需要 Python 3.9+、GNU tar、Git、curl、Node/npm
+以及可用的容器引擎和 Virtuoso 许可证。
+s02 已缓存完整工具链镜像和 ic618 镜像，可同步本仓库当前版本后在 s02 的
+checkout 中运行以下 Docker 示例。镜像存在时直接复用；只有缺少 Rust 工具链
+镜像时才构建镜像。ic618 缺失时加载共享归档，不重新构建它。
+
+```bash
+# 查询线上版本并预览；不修改文件、不构建、不发布
+./scripts/publish_vlink_npm.sh --engine docker --dry-run
+
+# 编译并正式发布；默认自动递增 patch 版本
+./scripts/publish_vlink_npm.sh --engine docker
+
+# 发布中断后，使用原版本及原始构建产物继续
+./scripts/publish_vlink_npm.sh --resume
+```
+
+入口自动选择可用的 Docker 或 Podman，也可通过 `--engine` 或
+`VLINK_CONTAINER_ENGINE` 指定。Podman 适配只对本次脚本及其子进程生效，
+不需要系统级 `docker` 别名或 Docker daemon。首次构建会自动准备缺失的
+Rust 编译镜像；需要访问 Docker Hub、GHCR 和 Rust/crates 镜像源。
+Virtuoso context 使用现有 `cadence-virtuoso:ic618-centos7` 镜像编译，缺失时
+沿用 `VLINK_CXT_IMAGE_ARCHIVE` 加载流程。
+旧版 OpenAccess 无法识别新内核时，使用镜像提供的 `linux_rhel60` 平台；
+自定义 Virtuoso 镜像可通过 `VLINK_CXT_OA_PLATFORM` 覆盖。
+
+版本基线取本地 Cargo、npm 已发布稳定版本和 Gitee 最新稳定 release 中的
+最高值，再递增并避开已有 release。支持 `--bump minor`、`--bump major`，
+或 `--version 0.1.121` 指定尚未发布且不低于本地/线上基线的版本。
+脚本更新 `Cargo.toml`、`Cargo.lock` 及 npm 元数据，使用默认完整功能编译七个
+平台，并校验每个 cxt manifest 和 SHA-256。发布顺序是 Gitee 二进制、d01
+正式下载镜像、npm；任一步失败立即停止。Git 提交和推送由调用者管理；正式
+发布会使用当前 HEAD 作为 Gitee 的 `target_commitish`，因此该提交需已在
+Gitee 上可用。
+
+正式发布需要环境变量：
+
+- `NPM_TOKEN`，兼容 `NODE_AUTH_TOKEN` 和原 CI 的 `TEDBRAIN_CI_NPM_TOEKN`；
+  或使用 `--npm-config <npmrc路径>`（也可设置 `VLINK_NPM_CONFIG`）指定现有认证文件。
+- `GITEE_TOKEN`，兼容 `TEDBRAIN_CI_GITEE_TOKEN` 和现有
+  `~/.config/tedmind/gitee_token` 文件。
+- `VLINK_LOG_RELEASE_KEY`，用于在宿主机签署二进制，至少 32 UTF-8 字节。
+  可从本机已有、Git 忽略的 `docker/tedbrain-ci-env/vlink-release.env` 导出。
+- SSH 需能以 `D01_USER`（默认 `luyukai`）访问 `D01_HOST`（默认 `d01`）的
+  `/var/www/download_files` 目录，沿用现有发布脚本的权限要求。
+
+凭据不会写入源码或构建镜像。临时 npm 配置权限为 `0600`，退出时删除。
+发布进度和构建校验信息保存在
+`${TED_DATA:-<仓库>/.tedbrain}/vlink-publish/manual-<version>.json`，与 CI 共用
+发布锁。`--resume` 复用校验通过的原始二进制；Gitee/d01 已完成时直接补发
+npm，部分上传失败时用相同文件恢复。原始产物或校验信息丢失时会拒绝重建
+已发布版本。
+
+启动入口会先 `source ~/.proxy`（文件存在时），其导出的代理配置由 Python、
+npm 和 Podman/Docker 子进程继承；文件不存在时沿用终端环境。
+连接失败时尝试直连，并明确打印回退信息。也可显式覆盖连接方式：
+
+```bash
+./scripts/publish_vlink_npm.sh --proxy direct --dry-run
+./scripts/publish_vlink_npm.sh --proxy http://proxy.example:7990 --dry-run
+```
+
+也可设置 `VLINK_RELEASE_PROXY`。显式指定代理时不会自动绕过它。
+个人代理地址及认证信息维护在 `~/.proxy`，不复制到仓库。
+
+`--build-only` 会升级本地版本并构建、校验、预览 npm 包，不发布到外部。
+如果之后希望用 `--resume` 发布这批产物，构建时也需提供发布签名密钥。
+未签名的构建仅用于本地验证，可对尚未发布的版本用 `--version` 重新构建。
+默认并发为 2 个平台，每个平台 8 个 Cargo 编译任务，可用 `--jobs`、
+`--cargo-jobs` 或现有 `VLINK_BUILD_JOBS`、`CARGO_BUILD_JOBS` 调整。
+
+已有的底层 npm 打包入口仍可独立使用，调用前需要准备匹配版本的二进制：
+
 ```bash
 cd biz/eda/packages/vlink/npm
 ./scripts/publish.sh --dry-run

package/binaries.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.120",
+  "version": "0.1.122",
   "binaries": {
-    "linux-x86_64": "9a4b691509c580df9294dc6370286480b199ea94173042f221b0ae24aedaba02",
-    "linux-x86_64-glibc2.17": "edd26e8a641588bafa49d4615c1ab8a51ec8e9827da9d88e5bdec1e15ad4e8c0",
-    "linux-aarch64": "72ef89c58f93c4c6d338fcb365e39b611070c97b41b1d2d0cdbf2680eae4d3b1",
-    "macos-x86_64": "6bc560b8f5f8a787132e1be5dfaff833290c76999ef253c59caa0f29c1dfff40",
-    "macos-aarch64": "e705ca0d1dc9d28df1b67f9dffb106b78ae4814bc60f288c1f7d43d44ff6d86e",
-    "windows-x86_64.exe": "48df5488455edb7b8bf4036e3c5763c2a408a1f863af76aa379b28e86801b5e1",
-    "windows-aarch64.exe": "04d1ca1c8fadd0fa47f6567304ed3011c7bf9a0961a8d105477b0783519b173c"
+    "linux-x86_64": "b748d4543b648789235b9f77aa591818360f26ca66c2a4789ffc847f040a72bc",
+    "linux-x86_64-glibc2.17": "5b0ae058282126bb22b3bba86d4a6c3bddc450047896c465fea178a91696155d",
+    "linux-aarch64": "4c0f2d49eb7d053782a44df96cc21e9b0b78e28fd6fbf3e0b48777d0888fbfd9",
+    "macos-x86_64": "66fdfda8b4de12ef719c9bf5cdcb89f3921586ddd6aaa4e3115c2e9bbec05ff9",
+    "macos-aarch64": "b5086aed9a6d299f7017dbec3e6230f317a488bf2e3bab126540ec8c4f29580d",
+    "windows-x86_64.exe": "56c46dbc3ef0b44ca30129d855e4bc16e8e39df3b1f5205543a59d30e73b1196",
+    "windows-aarch64.exe": "eded2270f21e69a81a551455385507b6766b2275d33089f74d58e6a9941dea77"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tedbrain/vlink",
-  "version": "0.1.120",
+  "version": "0.1.122",
   "description": "vlink Virtuoso bridge CLI installer. Installs the matching platform binary at npm install time, like Claude Code / Codex.",
   "license": "UNLICENSED",
   "bin": {