From 237529f7db5d8e11adee26c41c37780555bb7fda Mon Sep 17 00:00:00 2001 From: Joywayer Date: Fri, 25 Sep 2026 09:25:04 +0800 Subject: [PATCH] docs: switch cross-device handoff to master --- HANDOFF.md | 19 +++++++++++-------- README.md | 2 +- docs/implementation-status.md | 12 +++++++----- 3 files changed, 19 insertions(+), 14 deletions(-) diff --git a/HANDOFF.md b/HANDOFF.md index 3de32c2..6e262cf 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -5,15 +5,14 @@ ## 1. 获取正确分支 -用户已要求将 `codex/new-deployment-architecture` 合并到本地 `master`，后续本地开发以 `master` 为准。 -**本次明确只合并本地，未推送 `origin/master`。其他设备目前仍需拉取远端工作分支； -只有后续获准推送 master 后，才能从远端 master 获取这些成果。** +新架构已从 `codex/new-deployment-architecture` 合并到 `master`，用户已手动推送源码， +并授权提交、推送最新交接文档。**后续开发和跨设备接续统一使用 `master`。** 先为新设备配置仓库 SSH 权限，并从可信渠道核对 Git 服务器主机指纹；不要禁用主机校验。 -远端 master 尚未同步时： +新设备克隆： ```sh -git clone --branch codex/new-deployment-architecture --single-branch ssh://git@git.joywaygames.cn:2222/joywaygamess/server-deploy.git +git clone --branch master --single-branch ssh://git@git.joywaygames.cn:2222/joywaygamess/server-deploy.git cd server-deploy git branch --show-current git log -1 --oneline @@ -25,12 +24,16 @@ git status --short ```sh git status --short git fetch origin -git switch codex/new-deployment-architecture +git switch master git pull --ff-only ``` -若本地尚无该分支，用 `git switch --track origin/codex/new-deployment-architecture` 创建跟踪分支。 -master 获准推送后，上述命令中的分支名改为 `master`；用 `git log -1 --oneline` 核对交接提交。 +若此前用 `--single-branch` 只克隆了工作分支，先运行 +`git fetch origin refs/heads/master:refs/remotes/origin/master` 获取 master； +本地尚无 master 时，用 `git switch -c master --no-track origin/master` 创建分支， +再用 `git pull --ff-only origin master` 显式同步（避免旧单分支 fetch 配置影响跟踪关系）。 +普通完整克隆可使用 `git switch --track origin/master`。 +用 `git log -1 --oneline` 核对交接提交；旧工作分支只作历史参考。 有冲突或远端分叉时停止核对，不强制覆盖。跨设备轮换前，显式提交并推送本轮需要带走的文件。 聊天记录、本机临时文件和未提交修改不会随 Git 同步。 diff --git a/README.md b/README.md index 1d6c8d7..2b28093 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # Docker 服务部署集合 > **换设备继续开发：先读 [HANDOFF.md](HANDOFF.md)，按 [开发指南](docs/development.md) 准备环境。** -> 新架构已合并到本地 `master`，本次未推送远端。远端同步前，其他设备仍从 `codex/new-deployment-architecture` 接续；详见交接说明。 +> 新架构已合并到 `master`；其他设备请拉取 `master` 并按交接说明继续开发。 > 新服务器架构正在重构：选定 **Traefik + 本地管理面板 + Go deployctl**。 > 当前新执行器支持离线计划、应用包校验、受限 Compose 策略、本机预检、环境安装提案及 Docker 仓库签名/deb 文件校验，尚不能部署、升级或恢复应用。 diff --git a/docs/implementation-status.md b/docs/implementation-status.md index bcf1145..dabb268 100644 --- a/docs/implementation-status.md +++ b/docs/implementation-status.md @@ -7,9 +7,10 @@ ## 已固定的选择 -Traefik、本地 React/Node 管理面板、Go deployctl。当前目录开发；用户已要求将 -`codex/new-deployment-architecture` 合并到本地 `master`，并明确本次不推送。 -远端 master 尚未同步；后续提交或推送依照用户当轮要求，不自动进行。 +Traefik、本地 React/Node 管理面板、Go deployctl。当前目录开发，新架构已从 +`codex/new-deployment-architecture` 合并到 `master`。用户已手动推送源码， +并授权将最新交接文档提交、推送到 master；后续接续统一使用 master。 +以后的提交或推送依照用户当轮要求，不自动进行。 ## 第一工作包：只读执行器基础 @@ -195,9 +196,10 @@ APT 会读取多层配置，后续适配器须隔离配置与状态，不直接 ## 合并状态（2026-09-25） 用户随后要求提交所有剩余项目改动，旧 `claude-dev-stack/.env` 删除已记录在 `f25f5df`。 -之后按明确指令快进合并回本地 master；用户选择“仅合并到本地 master”，故未更新 origin/master。 +之后按明确指令快进合并回本地 master；最初用户选择“仅合并到本地 master”，助手未执行推送。 前述“不合并 master / .env 删除未纳入交付”描述的是上一阶段的历史范围，不再是当前本地状态。 -其他设备在远端 master 同步前仍须使用远端工作分支；不得将此次本地合并表述为远端已发布。 +随后用户确认已手动推送，并明确要求最新修改也提交、推送。只读远端核对确认源码已到达 +origin/master（f25f5df）；本次同步剩余文档修订，统一接续分支为 master，不再要求切换旧工作分支。 ## 尚未交付