diff --git a/docs/project-migration-handoff-2026-07-18.md b/docs/project-migration-handoff-2026-07-18.md index 7938906..8024050 100644 --- a/docs/project-migration-handoff-2026-07-18.md +++ b/docs/project-migration-handoff-2026-07-18.md @@ -3,6 +3,7 @@ > 更新时间:2026-07-18(Asia/Shanghai) > 当前工作区:`C:\Users\Administrator\Documents\AstrBot ImageStudio` > 当前开发版本:`1.0.32` +> 1.0.32 代码快照提交:`937ee73` > 目标读者:迁移后的新 Codex 账号、新工作区维护者、后续开发者 > 文档目的:只读取本文件即可恢复当前开发背景、代码状态、实机环境、最新问题和下一步修复任务。 @@ -10,9 +11,19 @@ ## 0. 必须首先阅读的迁移警告 -当前 Forgejo 远端、远端分支和 Git 提交历史只到 **v1.0.20**。 +Forgejo 的 `main` 分支和正式标签仍停在 **v1.0.20**,但完整的 1.0.21~1.0.32 开发成果已经提交并推送到: -本地工作区中从 **1.0.21 到 1.0.32** 的大量核心代码尚未提交,其中很多文件仍是 `??` 未跟踪状态,包括: +```text +origin/codex/ui-navigation-s130-s145 +``` + +1.0.32 代码快照提交为: + +```text +937ee73 release: complete ImageStudio 1.0.32 advanced material workflows +``` + +该提交已经包含: - 进阶素材主服务; - 多图片画风工作流; @@ -23,21 +34,26 @@ - 1.0.21~1.0.31 发布包; - 1.0.32 最新算法修改。 -因此迁移时: +因此迁移时可以直接从 Forgejo 恢复,但必须切换到正确分支: -1. **不能只在新地址重新 `git clone` Forgejo 仓库。** -2. **不能执行 `git reset --hard`、`git clean -fdx` 或删除所有未跟踪文件。** -3. 必须复制当前项目完整目录,包括 `.git`、未跟踪文件和当前工作树。 -4. 迁移完成后先执行 `git status --short --branch`,确认下面列出的修改与未跟踪文件仍存在。 -5. 在完成备份、审查和提交前,不要把远端 v1.0.20 当作当前源码真相。 +1. 可以重新 `git clone` Forgejo 仓库。 +2. 克隆后必须执行 `git checkout codex/ui-navigation-s130-s145`。 +3. 必须确认 HEAD 至少包含提交 `937ee73`。 +4. 不要直接停留在 `main`,否则只会得到 v1.0.20。 +5. `.tmp` 中的视觉审计副本没有推送,但它不是源码真相;真实测试图片和数据库仍在 NAS `plugin_data`。 -最安全的迁移方式是复制整个目录: +推荐恢复命令: -```text -C:\Users\Administrator\Documents\AstrBot ImageStudio +```powershell +git clone ssh://git@forgejo-nas:18086/YokiiroBW/astrbot_plugin_imagestudio.git +cd astrbot_plugin_imagestudio +git checkout codex/ui-navigation-s130-s145 +git pull --ff-only +git status --short --branch +git log -3 --oneline --decorate ``` -包括隐藏的 `.git` 目录。复制完成后再切换 Codex 账号或更改项目地址。 +也可以复制整个本地项目目录(包括 `.git`),但现在已经不再是唯一安全方式。 --- @@ -47,8 +63,8 @@ C:\Users\Administrator\Documents\AstrBot ImageStudio - 当前分支:`codex/ui-navigation-s130-s145` - 跟踪分支:`origin/codex/ui-navigation-s130-s145` -- 当前 HEAD:`176ee24` -- 当前 HEAD 标签:`v1.0.20` +- 1.0.32 代码快照:`937ee73` +- 当前 HEAD 可能在其后包含仅交接文档同步的提交 - `origin/main` 也位于 `176ee24` - Forgejo 远端: @@ -59,6 +75,7 @@ ssh://git@forgejo-nas:18086/YokiiroBW/astrbot_plugin_imagestudio.git ### 1.2 最近提交 ```text +937ee73 release: complete ImageStudio 1.0.32 advanced material workflows 176ee24 release: add ImageStudio 1.0.20 install package 7cfa01b docs: record ImageStudio 1.0.20 deployment verification 2212800 merge: synchronize Forgejo main before 1.0.20 @@ -69,14 +86,14 @@ b5dd6c5 release: publish ImageStudio 1.0.8 ### 1.3 重要结论 - 当前本地代码版本是 `1.0.32`。 -- Git 历史仍停留在 `1.0.20`。 -- 1.0.21~1.0.32 尚未 commit/push。 -- 本轮没有执行 Git 暂存、提交、推送或发布。 -- 后续必须先审查并保存当前脏工作树,再决定如何整理提交历史。 +- 1.0.21~1.0.32 已提交到 `937ee73`。 +- `codex/ui-navigation-s130-s145` 已推送并与远端同步。 +- 提交后的工作树干净。 +- `main` 尚未合并,v1.0.32 尚未建立正式 tag/release。 -### 1.4 当前主要修改文件 +### 1.4 1.0.32 提交的主要修改范围 -已有文件的修改包括但不限于: +提交中包含但不限于: - `CHANGELOG.md` - `_conf_schema.json` @@ -93,9 +110,9 @@ b5dd6c5 release: publish ImageStudio 1.0.8 - `pages/imagestudio/` 和 `web/` 的构建产物 - AstrBot provider bridge 相关测试 -### 1.5 当前关键未跟踪文件 +### 1.5 已纳入版本控制的关键新增文件 -这些文件绝对不能在迁移时丢失: +这些文件已经包含在 `937ee73` 中,切换到正确分支后应当存在: ```text backend/dto/advanced_material_dto.py @@ -124,7 +141,7 @@ tests/test_material_catalog_resolver.py tests/test_model_route_chain.py ``` -发布包 `release/astrbot_plugin_imagestudio-1.0.21.zip` 至 `1.0.31.zip` 也仍是未跟踪文件。 +发布包 `release/astrbot_plugin_imagestudio-1.0.21.zip` 至 `1.0.31.zip` 已包含在 `937ee73` 中。 目前没有正式生成 `release/astrbot_plugin_imagestudio-1.0.32.zip`;1.0.32 是通过临时 tar 包直接部署到 NAS,NAS 临时包已删除。 @@ -142,7 +159,7 @@ frontend/package.json: version = 1.0.32 frontend/package-lock.json: version = 1.0.32 ``` -`CHANGELOG.md` 已新增 1.0.21~1.0.32 的开发记录,但这些记录仍未提交到 Git。 +`CHANGELOG.md` 已新增并提交 1.0.21~1.0.32 的开发记录。 --- @@ -1046,15 +1063,18 @@ tests/test_model_route_chain.py ```text 请先完整读取 docs/project-migration-handoff-2026-07-18.md。 -这是 AstrBot ImageStudio 的当前开发交接文档。当前工作树从远端 v1.0.20 -继续开发到了本地 1.0.32,但 1.0.21~1.0.32 仍有大量未提交和未跟踪文件。 -禁止 git reset --hard、git clean 或用远端重新覆盖本地。 +这是 AstrBot ImageStudio 的当前开发交接文档。完整 1.0.32 代码已经提交并推送到 +origin/codex/ui-navigation-s130-s145,代码快照提交为 937ee73。main 仍停留在 v1.0.20, +因此必须在克隆后切换到 codex/ui-navigation-s130-s145,不能直接使用 main 开发。 先执行只读检查: -1. git status --short --branch -2. 确认 backend/services/advanced_style_set_service.py 存在 -3. 确认 metadata.yaml 和 core/config_service.py 均为 1.0.32 -4. 阅读交接文档第 7~10 节 +1. git checkout codex/ui-navigation-s130-s145 +2. git pull --ff-only +3. git log -3 --oneline --decorate,并确认历史包含 937ee73 +4. git status --short --branch,并确认工作树干净 +5. 确认 backend/services/advanced_style_set_service.py 存在 +6. 确认 metadata.yaml 和 core/config_service.py 均为 1.0.32 +7. 阅读交接文档第 7~10 节 下一项开发目标是完成文档中的 1.0.33 修复队列: - 年龄与身体比例解耦 @@ -1074,7 +1094,7 @@ tests/test_model_route_chain.py ### 文件完整性 -- [ ] `.git` 已复制。 +- [ ] 已复制完整 `.git`,或已经从 Forgejo 重新克隆仓库。 - [ ] `backend/services/advanced_style_set_service.py` 存在。 - [ ] `database/migrations/0016_advanced_materials.sql` 存在。 - [ ] `database/migrations/0018_advanced_style_sets.sql` 存在。 @@ -1085,8 +1105,9 @@ tests/test_model_route_chain.py ### Git 状态 - [ ] 当前分支仍为 `codex/ui-navigation-s130-s145`,或已明确创建新的 `codex/` 分支。 -- [ ] 未跟踪的进阶素材文件仍显示在 `git status` 中。 -- [ ] 没有执行 destructive reset/clean。 +- [ ] Git 历史包含 `937ee73`。 +- [ ] `git status --short` 没有意外修改或未跟踪源码。 +- [ ] 没有把 `origin/main` 的 v1.0.20 当成当前代码。 ### 版本 @@ -1131,6 +1152,6 @@ tests/test_model_route_chain.py - 1.0.33 修复队列中的年龄/身体、安全、证据门控、评分一致性、二次语义审查、跨层消重和中性验证场景。 - 1.0.32 正式 release zip。 -- 1.0.21~1.0.32 的 Git 整理、commit、push 和 Forgejo 发布。 +- 将功能分支合并到 `main`、创建 v1.0.32 tag/release,以及后续 1.0.33 开发。 -不要把“插件已部署到实机”等同于“代码已保存到 Forgejo”。当前最重要的迁移动作仍然是完整保存本地工作树。 +当前代码已经同时保存在本地 Git 和 Forgejo 功能分支。新账号只要切换到正确分支并读取本文件,即可继续工作。