@ai-workbench/network 0.4.1 → 0.4.3

package/NOTICE.md

@@ -16,3 +16,5 @@ N2 helper 已接入固定 tsnet 并可通过 Makefile 构建；未部署、未
 N3 SSH使用 golang.org/x/crypto/ssh v0.57.0（BSD-3-Clause；实际锁定版本见go.mod）；只使用none认证与可信known_hosts。Electron44.0.0官方darwin-arm64 ZIP为诊断工具，MIT及其随附第三方许可；SHA256与引擎版本见 `docs/evidence/n3-2026-10-20/electron-artifact.json`。独立进程/内存session，没有复制进发布包。
 
 N4插件peer：@deepseek-ai/cordis4.0.4、@deepseek-ai/schemastery3.18.4，均MIT，来源为固定DSH提交的vendor目录及官方npm包。TS5.9.3/Node24类型是构建依赖；实际闭包固定package-lock.json，新消费者闭包另存证据。主机下载只用Node内置http/https/tls/stream，经helper认证CONNECT，不新增外部代理库。源码/API升级需要在自有仓库适配，不提上游PR/issue或等待上游修改。
+
+0.4.3分发说明：唯一发布单元为network主包；helpers/darwin-arm64与helpers/darwin-x64的package.json是private内嵌身份元数据，不是独立发布依赖。每目标的helper-manifest.json固定二进制SHA，THIRD_PARTY_NOTICES.txt保留该目标Go实际编译依赖的许可原文，licenses-manifest.json列出模块、编译包、许可来源文件与SHA。构建来源为本仓cmd/aw-net及internal、固定go.mod/go.sum，Go1.27.3、CGO_ENABLED=0、ts_omit_logtail。

package/README.md

@@ -1,14 +1,41 @@
-安装：在 DSH「插件 → 添加插件」填写 `@ai-workbench/network@0.4.1`，或运行 `dsh plugin --profile desktop add @ai-workbench/network@0.4.1`。
+安装：在 DSH「插件 → 添加插件」填写 `@ai-workbench/network@0.4.3`，或运行 `dsh plugin --profile desktop add @ai-workbench/network@0.4.3`。
 
 # 远程主机网络
 
-0.4.1 当前为待发布版本，由编排统一发布公开 npm；工人不执行 publish。发布前可由官方添加插件入口安装本轮固定主包 tgz 的绝对路径，平台依赖也须可解析。
+0.4.3 当前为待发布版本，由编排统一发布公开 npm；工人不执行 publish。发布前可由官方添加插件入口安装本轮固定主包 tgz 的绝对路径，无需再解析平台依赖。
 
 插件通过官方 bundle/Cordis 接口提供远程主机网络、设备身份、SSH 通道、认证登录代理及主机下载能力。不替换 DSH 服务、布局或默认设置，不增加工作区/登录界面。L 负责可信连接资料导入和登录入口，员工不手填主机、用户名、路径或密钥。没有连接资料时明确说明需要导入，不把插件 Running 当作网络已连接。
 
-主包不携带 Go 二进制；精确依赖同版本的 `@ai-workbench/net-helper-darwin-arm64`、`@ai-workbench/net-helper-darwin-x64`。npm/pnpm 按 os/cpu 安装当前平台包，插件只解析该包，检查版本、平台和 manifest，启动前验证助手 SHA256。缺包、损坏或平台不支持时明确说明“我需要 X”，不使用 PATH、旧助手、另一架构或安装时下载。三个包均不需要 postinstall/prepare 或构建脚本；预编译文件直接入包。平台包同时附实际目标编译闭包的许可证原文及来源摘要（含 Go 标准库内 vendor）；构建遇缺失或不可读声明会明确失败。现阶段只提供 macOS arm64/x64，x64 的构建/文件检查不代表 Intel 真机验收。
+主包从0.4.3起完整携带`helpers/darwin-arm64`和`helpers/darwin-x64`两架构Go助手，不再声明平台optionalDependencies或下载平台包。运行时只选择本机架构的内嵌文件，严格校验主包与内嵌metadata名称/版本/private/os/cpu、manifest平台/SHA格式，并在启动前验证实际二进制SHA256；缺失、损坏或平台不支持时用中文明确说明需要完整主包并保留原始cause，不使用PATH、旧平台包、另一架构或安装时下载。安装无postinstall/prepare等脚本。两目标分别附实际编译闭包的许可证原文、模块/文件来源与摘要，构建遇缺失声明明确失败。只提供macOS arm64/x64；x64构建/字节检查不等于Intel真机运行验收。
 
-一个默认 profile 只启用一个 N 条目。独立安装与 L 聚合安装不要重复挂载 N。N 的网络身份按系统用户隔离、持久保存；不重交未知结果的一次性 key。公开 `aiWorkbenchNetwork.activate(settings, signal)`、`getActivationState/onActivationState` 和通道 API；公开类型入口 `/api`，Cordis 类型入口 `/cordis`。`active` 表示身份恢复与消费交接完成，不等于主机 SSH 或 AI 登录已通过。六项现有设置必须由 L 按可信材料及具名策略提供，无新默认值。
+旧0.4.1/0.4.2安装保留的锁/依赖树仍可能触发D16，直接add新主包不是迁移方案；L按`G-L-D16-MIGRATION-001`负责更新前重建、保留身份/配置/其他插件版本及失败恢复。本仓不移动员工profile/状态、不要求员工手删锁；公开`/api`、`/cordis`及wire apiVersion=1不变。
+
+一个默认 profile 只启用一个 N 条目。独立安装与 L 聚合安装不要重复挂载 N。N 的网络身份按系统用户隔离、持久保存；不重交未知结果的一次性 key。公开 `aiWorkbenchNetwork.activate(settings, signal)`、`getActivationState/onActivationState` 和通道 API；公开类型入口 `/api`，Cordis 类型入口 `/cordis`。`active` 表示身份恢复与消费交接完成，不等于主机 SSH 或 AI 登录已通过。原六项安装设置仍由可信开通提供；下述策略可在N自己的官方Config独立设置，不要求员工手填路径/身份，不新增数值默认。
+
+## 本插件设置
+
+本节优先于旧“六项设置/无新增设置”描述；wire apiVersion仍1，六项旧PluginSettings兼容，新增下表后六项可选数值字段。N官方Config导出全部10项，不使用新面板或L设置代替。**不改变数值默认**：N原来没有数值默认，本版仍不注入；未设沿用原开通值，已有自定义值不被覆盖。表中数字为当前L装配值，不是给所有旧配置强改的新默认。
+
+| N Config具名项 | 未设时的来源 / 当前L装配值 | 范围与改值后果 |
+|---|---|---|
+| startupObservationSeconds | 开通方显式提供 / 35秒 | helper ready观察；增大等更久，减小可能提前未知；无关闭值 |
+| shutdownObservationSeconds | 开通方显式提供 / 10秒 | 等自有helper正常退出；增大清理更久，减小可能强制结束并报告；无关闭值 |
+| controlResponseMaxBytes | 开通方显式提供 / 65536B | 控制JSON/ready/代理首帧；增大增内存，减小拒合法帧；无无限值 |
+| downloadMaxRedirects | 开通方显式提供 / 3 | HTTPS逐跳重定向；增大多跳，减小可能拒下载；0关闭跟随 |
+| statusRefreshIntervalSeconds | 原私有配置 / 2秒 | helper刷新与插件状态轮询；增大提示迟，减小开销高；无关闭值 |
+| dialTimeoutSeconds | 原私有配置 / 20秒 | TCP/SSH、控制头、下载CONNECT/响应头；增大等更久，减小可能提前中止；无关闭值 |
+| headerTimeoutSeconds | 原私有配置 / 10秒 | 本机控制/代理读请求头；增大占连接久，减小拒慢头；无关闭值 |
+| enrollmentObservationSeconds | 原私有配置 / 30秒 | 仅首次key入网结果；增大久等，减小更早未知；无关闭值，不用于销毁已有身份 |
+| httpMaxHeaderBytes | 原私有配置 / 1048576B | 本机控制/代理请求头与控制响应头；增大增内存，减小拒合法头；无无限值 |
+| httpMaxResponseHeaderBytes | 原私有配置 / 1048576B | 主机代理、下载响应头及CONNECT头；增大增内存，减小拒合法头；无无限值 |
+
+优先级：**N官方Config中显式策略 > L.activate的显式同名策略 > 原私有helper配置**。旧四项插件策略仍须N或L提供，缺项明确SETTINGS_REQUIRED；六个helper策略可不提供，原值保持。无路径/身份的N策略配置只注册未开通服务，等待L按原合同激活，不自动开通。已激活后同实例改变有效策略仍ACTIVATION_CONFLICT，需官方插件正常重载，不热替换身份/启动同身份第二实例。
+
+六个helper覆盖通过`serve --statusRefreshIntervalSeconds <数值>`等同名参数白名单传入，只含非秘密数值；L私有文件不写回。helper严格按**原始配置**校验交接inode/摘要与入网journal，运行实例另用有效策略，不把新数值混入原身份摘要。只有原合同的已确认key清理会移除authKeyFile及精确源key；策略不扩大清理权限。N无需改L即可兼容现有开通，但L展示应说明本插件显式覆盖优先，跨模块请求N-L-VISIBLE-LIMITS-001。
+
+所有超时只为可观测性，触发后提供等待事项、实际已等秒数、具名期限与下一步检查，根因仍未知，不重试/换源/换出口。Node控制/下载的req.setTimeout沿用原**阶段空闲**计时；远端拨号/SSH和请求头沿用原阶段deadline。到响应头/握手结束即移除该阶段期限，正文、NDJSON租约、SSH流仍由显式取消/释放/进程退出管理，不增加流总时限。headerTimeout在HTTP handler之前由实际Read超时处记入脱敏私有日志，不记录请求内容/授权参数；主动取消后台读不误报。首次开通到期保留未知结果及身份，不自动重新交key；已有身份不套首次窗口。
+
+固定正确性约束不是可任意调大的运行策略：Unix socket≤103字节、端口1..65535、计时器/整数可表示范围、HTTP实现溢出保护、700/600权限、当前UID/单身份、SHA256和凭据熵均不可关闭，官方Config总说明及盘点表明确列出。N没有新增自动重试次数、下载正文大小或会话寿命上限。D14旧manifest空catch已在0.4.0修复，当前packaged-helper继续返回原始cause，本轮加坏主manifest回归。
 
 开发：Node >=24.13.1、Go 1.27.3、固定 tsnet v1.104.1。运行 `npm ci --ignore-scripts --omit=optional`、`npm test`、`npm run check`、`make test`、`make test-race`、`make vet`，再执行 `npm run build`。build 显式交叉构建两个 macOS 平台包并编译 TypeScript；Go 参数固定 ts_omit_logtail、禁 VCS 元数据、trimpath、CGO_ENABLED=0。这些是开发命令，员工安装不执行。二进制、manifest 和 NOTICE 副本由构建生成，不提交。
 

package/helpers/darwin-arm64/NOTICE.md

@@ -0,0 +1,20 @@
+# 依赖与来源（N 第 1 轮）
+
+N2 helper 已接入固定 tsnet 并可通过 Makefile 构建；未部署、未发包。认证HTTP/CONNECT代理及Electron44组件诊断已交；DSH插件0.3.0及新消费者Cordis组件诊断已交。真实证据见 N 回执。
+
+| 组件 | 固定版本/来源提交 | 协议 | 用途及当前证据 |
+|---|---|---|---|
+| tailscale.com/tsnet | v1.104.1 / `9a522a9786c97eb7910c01ccb7bd66557b04c910` | BSD-3-Clause | [上游源码](https://github.com/tailscale/tailscale/tree/v1.104.1/tsnet)，实际 helper 依赖；完整闭包固定于 go.mod/go.sum |
+| tailscaled HTTP proxy | 同上，`cmd/tailscaled/proxy.go` | BSD-3-Clause | [CONNECT 处理源码](https://github.com/tailscale/tailscale/blob/v1.104.1/cmd/tailscaled/proxy.go)，只读参考；本实现使用net/http.ReverseProxy及SSH direct-tcpip，未复制该文件 |
+| DeepSeek Harness | 0.2.0-rc.2 / `639ed015397290b3745d163aafe02ffee4aa3f84` | MIT（已复核固定源码package.json），不复制核心代码 | [官方上游](https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.2.0-rc.2)，只读参考；实现只在本仓，浅克隆验证完成后精确清理 |
+| Go | 构建固定1.27.3；目标tsnet要求至少1.27.1 | BSD-3-Clause | `go mod download tailscale.com@v1.104.1` 自动选择 1.27.3。已用自动选择的1.27.3通过普通/race/vet/build |
+
+模块下载校验：`h1:9GNOm9Izqll9RH5jA5NWcLiCzXi/WtqY4EHQY2Dy2zk=`；go.mod 校验：`h1:Cb1XjScRgSOeRD7NW6uCEznme782WiOU9IxqyTWoRf0=`。原始下载元数据来自 Go 模块校验，不是构建/真实联网证明。
+
+升级注意：N2 强制用户态 netstack 拨号使用公开但不稳定 Server.Sys/Dialer API，避开 Server.Dial 的系统回退；状态恢复预检和测试依赖同版本的 StateStore/Prefs/LoginProfile 与官方启动选择逻辑。升级必须复验这些边界，不能只改版本号。
+
+N3 SSH使用 golang.org/x/crypto/ssh v0.57.0（BSD-3-Clause；实际锁定版本见go.mod）；只使用none认证与可信known_hosts。Electron44.0.0官方darwin-arm64 ZIP为诊断工具，MIT及其随附第三方许可；SHA256与引擎版本见 `docs/evidence/n3-2026-10-20/electron-artifact.json`。独立进程/内存session，没有复制进发布包。
+
+N4插件peer：@deepseek-ai/cordis4.0.4、@deepseek-ai/schemastery3.18.4，均MIT，来源为固定DSH提交的vendor目录及官方npm包。TS5.9.3/Node24类型是构建依赖；实际闭包固定package-lock.json，新消费者闭包另存证据。主机下载只用Node内置http/https/tls/stream，经helper认证CONNECT，不新增外部代理库。源码/API升级需要在自有仓库适配，不提上游PR/issue或等待上游修改。
+
+0.4.3分发说明：唯一发布单元为network主包；helpers/darwin-arm64与helpers/darwin-x64的package.json是private内嵌身份元数据，不是独立发布依赖。每目标的helper-manifest.json固定二进制SHA，THIRD_PARTY_NOTICES.txt保留该目标Go实际编译依赖的许可原文，licenses-manifest.json列出模块、编译包、许可来源文件与SHA。构建来源为本仓cmd/aw-net及internal、固定go.mod/go.sum，Go1.27.3、CGO_ENABLED=0、ts_omit_logtail。

package/helpers/darwin-arm64/README.md

@@ -0,0 +1 @@
+这是`@ai-workbench/network@0.4.3`内嵌的macOS arm64助手，不再作为独立npm包安装或发布。由本仓Go1.27.3从固定go.mod/go.sum构建；同目录helper-manifest.json记录SHA256，THIRD_PARTY_NOTICES.txt和licenses-manifest.json记录此目标实际编译闭包的许可证原文与来源摘要。运行时只能选择本机架构并在启动前校验SHA；文件校验不等于Intel真机或真实联网验收。