docs: sync ImageStudio migration handoff after push

这个提交存在于:
YokiiroBW 2026-07-18 23:28:46 +08:00
父节点 937ee730ce
当前提交 9ce3d3eefe

查看文件

@ -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 功能分支。新账号只要切换到正确分支并读取本文件,即可继续工作。