Author SHA1 Message Date
joywayer 237529f7db docs: switch cross-device handoff to master 2026-09-25 09:25:04 +08:00
joywayer d241174855 docs: align handoff with local master merge 2026-09-25 09:20:23 +08:00
3 changed files with 27 additions and 9 deletions
+14 -6
View File
@@ -5,11 +5,14 @@
## 1. 获取正确分支 ## 1. 获取正确分支
新架构工作分支是 `codex/new-deployment-architecture`,不是 `master`。 新架构已从 `codex/new-deployment-architecture` 合并到 `master`,用户已手动推送源码,
并授权提交、推送最新交接文档。**后续开发和跨设备接续统一使用 `master`。**
先为新设备配置仓库 SSH 权限,并从可信渠道核对 Git 服务器主机指纹;不要禁用主机校验。 先为新设备配置仓库 SSH 权限,并从可信渠道核对 Git 服务器主机指纹;不要禁用主机校验。
新设备克隆:
```sh ```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 cd server-deploy
git branch --show-current git branch --show-current
git log -1 --oneline git log -1 --oneline
@@ -21,11 +24,16 @@ git status --short
```sh ```sh
git status --short git status --short
git fetch origin git fetch origin
git switch codex/new-deployment-architecture git switch master
git pull --ff-only git pull --ff-only
``` ```
若本地尚无该分支,用 `git switch --track origin/codex/new-deployment-architecture` 创建跟踪分支。 若此前用 `--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 同步。 聊天记录、本机临时文件和未提交修改不会随 Git 同步。
@@ -80,8 +88,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`;其他设备请拉取 `master` 并按交接说明继续开发。
> 新服务器架构正在重构:选定 **Traefik + 本地管理面板 + Go deployctl**。 > 新服务器架构正在重构:选定 **Traefik + 本地管理面板 + Go deployctl**。
> 当前新执行器支持离线计划、应用包校验、受限 Compose 策略、本机预检、环境安装提案及 Docker 仓库签名/deb 文件校验,尚不能部署、升级或恢复应用。 > 当前新执行器支持离线计划、应用包校验、受限 Compose 策略、本机预检、环境安装提案及 Docker 仓库签名/deb 文件校验,尚不能部署、升级或恢复应用。
+12 -2
View File
@@ -7,8 +7,10 @@
## 已固定的选择 ## 已固定的选择
Traefik、本地 React/Node 管理面板、Go deployctl。当前目录开发,分支为 Traefik、本地 React/Node 管理面板、Go deployctl。当前目录开发,新架构已从
`codex/new-deployment-architecture`,不自动提交或推送。 `codex/new-deployment-architecture` 合并到 `master`。用户已手动推送源码,
并授权将最新交接文档提交、推送到 master;后续接续统一使用 master。
以后的提交或推送依照用户当轮要求,不自动进行。
## 第一工作包:只读执行器基础 ## 第一工作包:只读执行器基础
@@ -191,6 +193,14 @@ APT 会读取多层配置,后续适配器须隔离配置与状态,不直接
这是同一设备上的隔离源码副本/双环境验证,不是另一台物理设备或 macOS 的验收。 这是同一设备上的隔离源码副本/双环境验证,不是另一台物理设备或 macOS 的验收。
文档相对链接已检查。本轮未重复在线下载;其通过证据保留在第七、八工作包,新设备可按指南重跑。 文档相对链接已检查。本轮未重复在线下载;其通过证据保留在第七、八工作包,新设备可按指南重跑。
## 合并状态(2026-09-25)
用户随后要求提交所有剩余项目改动,旧 `claude-dev-stack/.env` 删除已记录在 `f25f5df`。
之后按明确指令快进合并回本地 master;最初用户选择“仅合并到本地 master”,助手未执行推送。
前述“不合并 master / .env 删除未纳入交付”描述的是上一阶段的历史范围,不再是当前本地状态。
随后用户确认已手动推送,并明确要求最新修改也提交、推送。只读远端核对确认源码已到达
origin/master(f25f5df);本次同步剩余文档修订,统一接续分支为 master,不再要求切换旧工作分支。
## 尚未交付 ## 尚未交付
1. 远程现场 inspect、持久化状态与执行器集成、systemd 任务监督及重启现场核对。 1. 远程现场 inspect、持久化状态与执行器集成、systemd 任务监督及重启现场核对。