Repository navigation
项目执行环境：面板切换，默认清洁模式
在 项目映射 → 项目卡片 → 执行环境 直接选择清洁、兼容或容器模式，点击“保存并应用”。日常切换不需要手工编辑 JSON。未单独配置运行模式的新旧项目，升级后实际默认采用清洁模式；已有明确的兼容或容器配置继续保留。
清洁模式使用非登录 Shell、明确的项目工具路径与独立 HOME、临时目录和缓存。文件工具与命令看到同一份工作区；具名任务直接执行参数数组。兼容模式保留原终端和原生工具行为。容器模式使用固定镜像和受限 Linux 容器，必要条件不足时拒绝执行，不会悄悄退回账号级 Shell。
稳定性与恢复加固
- 保存不等于生效。 面板重新读取 Agent 当前配置，等待整份配置实际加载并完成认证重连后才显示“已生效”。首次将默认清洁模式保存为相同的显式设置，也不会提前报告生效。
- 不重复提交未知写入。 丢失响应、页面刷新、短暂断线和迟到回执沿原保存编号恢复；仅保存有界的不透明查询信息，不缓存配置正文、路径、环境变量值或凭据。
- 配置写入更稳健。 多窗口使用配置修订与 SHA 冲突检查；操作系统互斥配合进程退出证据回收崩溃锁。旧格式锁、活跃进程或状态未知的锁不会被强行清除。
- 保留真实落盘结果。 配置写入具有私有备份、原子替换和目录落盘检查；写后持久化不确定会明确进入待核查状态，不误报“没有保存”。拒绝重复 JSON 键、FIFO 和读取期间替换的文件。
- 验证不再误报未知。 原生成功验证不再产生虚假的空容器证据字段；实际存在的容器结果仍严格检查，不降低缺失或畸形证据的保护。
- 清洁模式与已保存 VPS 正确分离。 明确选择且经过原权限与目标绑定检查的 VPS 使用独立 SSH 传输，不冒充本地清洁运行时。直接 SSH、容器模式和原任务的严格隔离要求仍保持各自限制，不会从失败的本地操作自动切换目标。
- 容器控制有界。 stdout/stderr 在读取过程中执行合并字节上限；超时或超量只回收本次创建的进程组。工作负载退出、传输状态和清理状态分别核验。
- 跨平台与小屏修复。 补齐 Windows 配置二进制读取、文件身份校验与清洁工具路径；保留虚拟环境的调用语义。项目卡片按钮可换行，修复手机窄屏下“执行环境”、Claude 与 VPS 操作相互遮挡。
- 原任务连续性不变。 运行时修订绑定项目和工作区。切换配置不会重启已开始的命令，不重建原操作、租约或检查点；旧验证保留历史事实，但不再代表新运行环境已通过。
虚拟环境目录别名另有专门回归：保留真实调用路径，并实际启动选定解释器核对其虚拟环境与依赖，避免将发布包中的路径别名误判为错误或落到系统 Python。
发布来源与验收
源码提交：aea0c45653ed768f6ef1ea8f2e1b28ac501edb3d。
正式附件来自上述提交 CI 构建并核验的原始公开源码包，不以开发目录重新打包的文件替换。完整发布门禁要求 Linux 与 macOS 全部六个分片、完整集合与覆盖合并、Windows 核心及恢复、真实 OIDC、资源准入和长时间进程检查通过；没有跳过失败项或削弱原断言。
另从实际下载的公开 ZIP 运行 157 项本地检查，涵盖真实 Hub／Agent、Chromium、WebKit、面板切换、读写、恢复和授权，全部通过且测试前后源码一致。Windows 核心测试为 306 项通过，并独立检查真实 PowerShell 与临时计划任务恢复。
真实 Linux 项目容器验收直接从同一公开源码 ZIP 执行，非 root、项目映射、共享读写、网络拒绝、固定镜像、启动前检查、原操作幂等、真实退出、超时和清理十项全部通过。
附件
codepier-1.30.0-source.zip：兼容已有面板更新器的更新包。codepier-1.30.0-source-full.zip：完整公开开发源码。- 两份对应的
.manifest.json：归档与逐文件校验信息。
完整源码 ZIP SHA-256：6cd1e8b02797db664632ff218b6d124f819fd484be00d73c1e4dd1fde676b0a7。
面板更新 ZIP SHA-256：9cf6680a695889369982a3d2a3d10aa0262587f9be7262c12eeac905377025ae。
对应双架构镜像：ghcr.io/cyeinfpro/codepier@sha256:a32876f3ddfcf7a3b5b7655d8d5320106fa839b70f68b58019c541d883d4e26a。包含 linux/amd64 与 linux/arm64，附带 SBOM 与构建来源证明；实际加固启动检查在 amd64 上完成。
升级与真实边界
发布不会自动部署、重启现有服务、迁移业务项目或升级设备 Agent。使用新面板和默认规则需要更新匹配的 Hub 与 Agent，并刷新客户端目录；升级时应核对项目工具链、代理、证书、SSH、原生签名及构建依赖。
清洁模式提高执行环境的确定性，但仍使用原执行账号权限，不是 OS 沙箱，也不保证模型无法推断操作系统。不改变 read/write/execute/computer 授权、允许目录或原任务范围；真实平台拒绝仍须遵守。真实 Dot 新旧长会话、业务项目迁移、arm64 独立启动及 Windows 重启前登录场景不属于本次已完成的验收范围。
详细使用说明：项目运行时与连续执行。