release: 0.4.5

Author: XiSoul

.claude/worktrees/agent-a1fa4ae0

@@ -54,11 +54,16 @@ dist_pkg/
 temp_filemanager_remote*.js
 deploy_nonebot_*.sh
 *.log
+build-operation-refactor.log
 
 # Dev container
 .devcontainer
 .claude
 data/
+.pnpm-store/
+global_logs/
+projects/
+external-projects/
 
 # Scripts (dev only)
 script/

.claude/worktrees/agent-a24240fc

@@ -453,6 +453,7 @@ global_logs/
 
 # Local agent / workspace state
 .claude/
+.claude/worktrees/
 
 # Local notes
 PROJECT_LOGIC.md

.claude/worktrees/agent-a255c7c4

@@ -1,4 +1,4 @@
-ARG APP_VERSION=0.4.4
+ARG APP_VERSION=0.4.5
 ARG VCS_REF=
 ARG PYTHON_IMAGE=3.11
 ARG VARIANT=
@@ -22,7 +22,7 @@ RUN pnpm -C frontend run build-only
 
 FROM python:${PYTHON_IMAGE}${VARIANT:+-$VARIANT} AS build-stage
 
-ARG APP_VERSION=0.4.4
+ARG APP_VERSION=0.4.5
 ARG VCS_REF=unknown
 ARG PIP_INDEX_URL
 ARG PIP_EXTRA_INDEX_URL
@@ -51,10 +51,12 @@ RUN pip install --no-deps .
 
 FROM python:${PYTHON_IMAGE}${VARIANT:+-$VARIANT}
 
-ARG APP_VERSION=0.4.4
+ARG APP_VERSION=0.4.5
 ARG VCS_REF=unknown
 ARG APT_MIRROR
 EXPOSE 18080
+VOLUME ["/projects"]
+VOLUME ["/external-projects"]
 
 # 创建挂载目录
 RUN mkdir -p /opt/nonebot-projects && chmod 777 /opt/nonebot-projects

.claude/worktrees/agent-aaece09b

@@ -54,6 +54,9 @@ _✨ 面向 NoneBot 多实例运维的 WebUI ✨_
 - 优化已有实例导入，支持相对路径和容器内绝对路径识别
 - 修复坏虚拟环境导致的依赖安装失败，自动备份并重建 `.venv`
 - 补齐导入实例后的驱动 / 依赖初始化流程，减少第三步报错
+- 修复添加实例失败后仍残留实例记录的问题，失败时自动回滚
+- 修复实例列表重复污染问题，避免路径别名与自动扫描把测试实例反复塞回列表
+- 将实例运行日志与维护终端拆分，实例操作页与独立终端页职责分离
 - 调整概览、通知、日志、终端交互，让运维动作更集中
 - 新增关于页，文档入口和项目信息集中展示
 
@@ -74,7 +77,7 @@ _✨ 面向 NoneBot 多实例运维的 WebUI ✨_
 - `docker.io/xisoul/nonebot-webui:master`
 - `docker.io/xisoul/nonebot-webui:${version}`
 
-推荐优先使用显式版本号，例如 `0.4.2`、`0.4`，后面做升级、回滚、版本检测会更方便。
+推荐优先使用显式版本号，例如 `0.4.5`、`0.4`，后面做升级、回滚、版本检测会更方便。
 
 ### 非 Docker 安装
 
@@ -117,7 +120,8 @@ docker run -d \
 - `/projects` 给 WebUI 新建实例使用
 - `/external-projects` 给宿主机 / NAS 里已经存在的实例使用
 - `/app/config.json` 与 `/app/project.json` 会被程序写回，不能只读挂载
-- 如果 NAS 面板自动带出 `/data` 等默认卷，建议手动删掉，再按上面这些路径重新配置
+- 镜像会默认提示挂载 `/projects` 与 `/external-projects`
+- 如果 NAS 面板自动带出其它旧默认卷（例如 `/data`），建议手动删掉，再按上面这些路径重新配置
 
 ### 路径映射说明
 
@@ -238,20 +242,20 @@ docker logs nonebot-webui
 - `${major}.${minor}`
 - `${version}`
 
-例如版本 `0.4.4` 会自动生成：
+例如版本 `0.4.5` 会自动生成：
 
 - `xisoul/nonebot-webui:latest`
 - `xisoul/nonebot-webui:master`
 - `xisoul/nonebot-webui:0.4`
-- `xisoul/nonebot-webui:0.4.4`
+- `xisoul/nonebot-webui:0.4.5`
 
 ### 推荐发版步骤
 
 1. 修改代码并在本地测试通过
 2. 更新 `pyproject.toml` 中的版本号
 3. 同步更新 `Dockerfile` 中的 `APP_VERSION`
 4. 提交代码
-5. 打版本 tag，例如 `v0.4.4`
+5. 打版本 tag，例如 `v0.4.5`
 6. 推送 `master` 和对应 tag
 
 示例：
@@ -261,8 +265,8 @@ git add .
 git commit -m "feat: your change"
 git push origin master
 
-git tag v0.4.4
-git push origin v0.4.4
+git tag v0.4.5
+git push origin v0.4.5
 ```
 
 ### 重要说明

.dockerignore

@@ -1,8 +1,8 @@
-# Release Todo 2026-05-01
+# Release Notes Draft 2026-05-01
 
-这份清单用于下次发版前确认哪些修复需要带上。
+这份清单用于记录 `0.4.5` 计划带上的修复项。
 
-## 本次建议纳入发版
+## 0.4.5 已纳入修复
 
 ### 1. Docker / NAS 创建容器体验修复
 
@@ -19,20 +19,34 @@
 
 - 文件:
   - `nb_cli_plugin_webui/app/project/service.py`
+  - `nb_cli_plugin_webui/app/handlers/process/utils.py`
 - 内容:
-  - `add_nonebot_project()` 只有在安装流程真正走完后才写入项目元数据
-  - 失败时不再提前写入 `project.json`
+  - `add_nonebot_project()` 与 `create_nonebot_project()` 失败时自动回滚实例记录
+  - 异步流程支持失败回调，避免半成品实例残留在 `project.json`
 
-### 3. 添加实例第三步失败时不再白板
+### 3. 实例列表去重与自动扫描污染修复
 
 - 文件:
-  - `frontend/src/components/Modals/AddBot/InstallationItem.vue`
+  - `nb_cli_plugin_webui/app/project/service.py`
+- 内容:
+  - 目录别名(`/external-projects` / `/opt/nonebot-projects`)不再被当成不同实例
+  - 停用实例列表查询时的自动扫描回填，避免测试残留和重复实例反复出现
+
+### 4. 实例操作页与维护终端拆分
+
+- 文件:
+  - `frontend/src/views/Operation/OperationIndex.vue`
+  - `frontend/src/views/Operation/TerminalItem.vue`
+  - `frontend/src/views/Terminal/TerminalIndex.vue`
+  - `frontend/src/router/client.ts`
+  - `nb_cli_plugin_webui/app/process/router.py`
+  - `nb_cli_plugin_webui/app/process/service.py`
 - 内容:
-  - 增加失败态错误卡片
-  - 展示失败原因
-  - 重试时清理上次失败状态
+  - `/operation` 只展示实例运行日志
+  - 新增独立 `/terminal` 菜单用于维护 Shell
+  - 运行日志与维护终端日志使用独立 log key 分流
 
-### 4. bcrypt / passlib 兼容修复
+### 5. bcrypt / passlib 兼容修复
 
 - 文件:
   - `pyproject.toml`
@@ -41,7 +55,7 @@
   - 将 `bcrypt` 固定为 `4.0.1`
   - 避免容器启动时出现 `error reading bcrypt version`
 
-### 5. 包改名后的版本读取修复
+### 6. 包改名后的版本读取修复
 
 - 文件:
   - `nb_cli_plugin_webui/app/application.py`
@@ -63,8 +77,8 @@
 
 ## 发版前建议确认
 
-1. 确认 `pyproject.toml` 版本号与待打 tag 一致
-2. 确认 `Dockerfile` 中 `APP_VERSION` 同步更新
+1. 确认 `pyproject.toml` 版本号与待打 tag `v0.4.5` 一致
+2. 确认 `Dockerfile` 中 `APP_VERSION` 已同步更新到 `0.4.5`
 3. 确认这次不包含 `htmlrender` 下载源策略调整
 4. 构建镜像后优先验证 NAS 容器创建页是否还会自动带出错误挂载
-5. 复测“添加实例失败”场景，确认不再留脏记录、不再白板
+5. 复测“添加实例失败”场景，确认不再留脏记录

.gitignore

@@ -18,3 +18,21 @@ export const openProjectTerminal = async (projectId: string) => {
     }
   })
 }
+
+export const getProjectTerminalLogKey = async (projectId: string) => {
+  return client.get<{ detail: string }, { detail?: string }>({
+    url: '/v1/process/terminal/log-key',
+    query: {
+      project_id: projectId
+    }
+  })
+}
+
+export const getProjectRuntimeLogKey = async (projectId: string) => {
+  return client.get<{ detail: string }, { detail?: string }>({
+    url: '/v1/process/runtime/log-key',
+    query: {
+      project_id: projectId
+    }
+  })
+}