docs: align handoff with local master merge

This commit is contained in:
2026-09-25 09:20:23 +08:00
parent f25f5df62d
commit d241174855
3 changed files with 19 additions and 6 deletions
+8 -3
View File
@@ -5,9 +5,13 @@
## 1. 获取正确分支 ## 1. 获取正确分支
新架构工作分支是 `codex/new-deployment-architecture`,不是 `master`。 用户已要求将 `codex/new-deployment-architecture` 合并到本地 `master`,后续本地开发以 `master` 为准。
**本次明确只合并本地,未推送 `origin/master`。其他设备目前仍需拉取远端工作分支;
只有后续获准推送 master 后,才能从远端 master 获取这些成果。**
先为新设备配置仓库 SSH 权限,并从可信渠道核对 Git 服务器主机指纹;不要禁用主机校验。 先为新设备配置仓库 SSH 权限,并从可信渠道核对 Git 服务器主机指纹;不要禁用主机校验。
远端 master 尚未同步时:
```sh ```sh
git clone --branch codex/new-deployment-architecture --single-branch ssh://git@git.joywaygames.cn:2222/joywaygamess/server-deploy.git git clone --branch codex/new-deployment-architecture --single-branch ssh://git@git.joywaygames.cn:2222/joywaygamess/server-deploy.git
cd server-deploy cd server-deploy
@@ -26,6 +30,7 @@ git pull --ff-only
``` ```
若本地尚无该分支,用 `git switch --track origin/codex/new-deployment-architecture` 创建跟踪分支。 若本地尚无该分支,用 `git switch --track origin/codex/new-deployment-architecture` 创建跟踪分支。
master 获准推送后,上述命令中的分支名改为 `master`;用 `git log -1 --oneline` 核对交接提交。
有冲突或远端分叉时停止核对,不强制覆盖。跨设备轮换前,显式提交并推送本轮需要带走的文件。 有冲突或远端分叉时停止核对,不强制覆盖。跨设备轮换前,显式提交并推送本轮需要带走的文件。
聊天记录、本机临时文件和未提交修改不会随 Git 同步。 聊天记录、本机临时文件和未提交修改不会随 Git 同步。
@@ -80,8 +85,8 @@ dpkg 清单/版本锁、Docker 仓库签名认证、实际五个 Docker deb 的
- 私钥、有效密码、token、真实 `.env`、个人 SSH 配置、备份和数据库不能新增到提交中。 - 私钥、有效密码、token、真实 `.env`、个人 SSH 配置、备份和数据库不能新增到提交中。
`.gitignore` 不会自动移除历史已跟踪的敏感文件;旧配置不得作为新部署输入。 `.gitignore` 不会自动移除历史已跟踪的敏感文件;旧配置不得作为新部署输入。
历史凭据轮换和 Git 历史清理需另行授权,不在本次交接范围。 历史凭据轮换和 Git 历史清理需另行授权,不在本次交接范围。
- 原设备已有的 `claude-dev-stack/.env` 本地删除不属于新代码交付清单,不恢复它, - `claude-dev-stack/.env` 的删除已按用户要求提交(`f25f5df`),并包含在本地 master 中,不恢复它。
也不以这次交接擅自清理旧目录。新设备若见到历史文件,不要使用或复制凭据。 不以合并为由擅自清理其余旧目录;Git 历史仍可能含旧配置,不要使用或复制其中凭据。
- 远端写入前重新核对主机身份、数据/服务、容量和影响,并取得具体操作授权。 - 远端写入前重新核对主机身份、数据/服务、容量和影响,并取得具体操作授权。
不做整机升级、不重置防火墙、不删除卷/数据库、不把备份恢复覆盖到原数据。 不做整机升级、不重置防火墙、不删除卷/数据库、不把备份恢复覆盖到原数据。
+1 -1
View File
@@ -1,7 +1,7 @@
# Docker 服务部署集合 # Docker 服务部署集合
> **换设备继续开发:先读 [HANDOFF.md](HANDOFF.md),按 [开发指南](docs/development.md) 准备环境。** > **换设备继续开发:先读 [HANDOFF.md](HANDOFF.md),按 [开发指南](docs/development.md) 准备环境。**
> 新架构工作分支:`codex/new-deployment-architecture`;拉取 `master` 不包含该阶段成果。 > 新架构已合并到本地 `master`,本次未推送远端。远端同步前,其他设备仍从 `codex/new-deployment-architecture` 接续;详见交接说明。
> 新服务器架构正在重构:选定 **Traefik + 本地管理面板 + Go deployctl**。 > 新服务器架构正在重构:选定 **Traefik + 本地管理面板 + Go deployctl**。
> 当前新执行器支持离线计划、应用包校验、受限 Compose 策略、本机预检、环境安装提案及 Docker 仓库签名/deb 文件校验,尚不能部署、升级或恢复应用。 > 当前新执行器支持离线计划、应用包校验、受限 Compose 策略、本机预检、环境安装提案及 Docker 仓库签名/deb 文件校验,尚不能部署、升级或恢复应用。
+10 -2
View File
@@ -7,8 +7,9 @@
## 已固定的选择 ## 已固定的选择
Traefik、本地 React/Node 管理面板、Go deployctl。当前目录开发,分支为 Traefik、本地 React/Node 管理面板、Go deployctl。当前目录开发;用户已要求将
`codex/new-deployment-architecture`,不自动提交或推送。 `codex/new-deployment-architecture` 合并到本地 `master`,并明确本次不推送。
远端 master 尚未同步;后续提交或推送依照用户当轮要求,不自动进行。
## 第一工作包:只读执行器基础 ## 第一工作包:只读执行器基础
@@ -191,6 +192,13 @@ APT 会读取多层配置,后续适配器须隔离配置与状态,不直接
这是同一设备上的隔离源码副本/双环境验证,不是另一台物理设备或 macOS 的验收。 这是同一设备上的隔离源码副本/双环境验证,不是另一台物理设备或 macOS 的验收。
文档相对链接已检查。本轮未重复在线下载;其通过证据保留在第七、八工作包,新设备可按指南重跑。 文档相对链接已检查。本轮未重复在线下载;其通过证据保留在第七、八工作包,新设备可按指南重跑。
## 合并状态(2026-09-25)
用户随后要求提交所有剩余项目改动,旧 `claude-dev-stack/.env` 删除已记录在 `f25f5df`。
之后按明确指令快进合并回本地 master;用户选择“仅合并到本地 master”,故未更新 origin/master。
前述“不合并 master / .env 删除未纳入交付”描述的是上一阶段的历史范围,不再是当前本地状态。
其他设备在远端 master 同步前仍须使用远端工作分支;不得将此次本地合并表述为远端已发布。
## 尚未交付 ## 尚未交付
1. 远程现场 inspect、持久化状态与执行器集成、systemd 任务监督及重启现场核对。 1. 远程现场 inspect、持久化状态与执行器集成、systemd 任务监督及重启现场核对。