release: bump version to 0.44.0

docs/technical/zh/backend-system-service-control.md

@@ -22,10 +22,10 @@
 
 | Action 名称 | 用途 | `planet.sh` 命令 | 备注 |
 | --- | --- | --- | --- |
-| `restart-backend` | 只重启后端 API | `./planet.sh restart -b` | 推荐作为 UI 触发重启流程的第一阶段实现。 |
+| `restart-backend` | 只重启后端 API | `./planet.sh restart -b` | 页面通常短暂失联后由 `/health` 轮询恢复。 |
+| `restart-frontend` | 只重启前端开发服务器 | `./planet.sh restart -f` | 页面入口会短暂不可用；UI 通过前端入口探测恢复后刷新。 |
 | `restart-database` | 重启 PostgreSQL 和 Redis 容器 | `./planet.sh restart -d` | 适合数据库/缓存需要受控重启但不希望重启 UI 的场景。 |
 | `restart-system` | 重启整个应用栈 | `./planet.sh restart` | 前端会短暂中断；UI 应进入引导恢复模式。 |
-| `restart-frontend` | 只重启前端开发服务器 | `./planet.sh restart -f` | 谨慎使用；UI 连续性弱于只重启后端。 |
 | `restart-backend-port` | 在指定端口重启后端 | `./planet.sh restart -b <port>` | 执行前必须由后端校验端口。 |
 | `restart-frontend-port` | 在指定端口重启前端 | `./planet.sh restart -f <port>` | 执行前必须由后端校验端口。 |
 | `health-check` | 读取当前服务健康状态 | `./planet.sh health` | 安全的只读运维动作。 |
@@ -269,21 +269,25 @@ health-check         -> ["./planet.sh", "health"]
 - `服务已恢复，正在刷新页面`
 - `恢复超时，请手动检查服务状态`
 
-## 第一阶段建议
+## 当前 Dashboard 实现
 
-第一阶段只实现：
+Dashboard 当前已实现：
 
 - `restart-backend`
+- `restart-frontend`
+- `restart-ai-provider`
+- `restart-database`
+- `restart-system`
 - `super_admin` 权限门禁
 - 任务创建接口
 - Redis 任务状态
 - 前端确认 modal
-- 前端 `/health` 轮询
+- 后端 `/health` 轮询
+- 前端入口轮询
 - 恢复后自动刷新页面
 
-第一阶段不要实现：
+暂不实现：
 
-- 完整 `./planet.sh restart`
 - 原始 shell 命令透传
 - 任意服务控制
 - 完整终端 stdout 流式输出
@@ -305,17 +309,18 @@ health-check         -> ["./planet.sh", "health"]
 
 ### 前端
 
-1. 在 dashboard 为 `super_admin` 增加 `重启后端` 控件
+1. 在 dashboard 为 `super_admin` 增加 `重启服务` 控件
 2. 发送前展示确认 modal
 3. 提交后将 modal 切换为阻塞式重启状态
-4. 轮询 `/health` 直到确认后端恢复
-5. 连续健康检查成功后自动刷新页面
-6. 展示简短阶段日志，而不是原始终端流
+4. 后端重启使用 `/health` 轮询确认恢复
+5. 前端重启和完全重启使用前端入口探测确认恢复
+6. 连续健康检查成功后自动刷新页面
+7. 展示简短阶段日志，而不是原始终端流
 
 ### 运维说明
 
-1. 第一阶段目标应限定为只重启后端
-2. 前端重启初期保持在范围外
+1. 优先使用局部重启，只有确实需要时才执行完全重启
+2. 前端重启会打断当前页面入口，必须进入恢复等待状态
 3. 命令执行必须始终从仓库根目录发起
 4. API 边界只能传递固定 action 名称
 
@@ -324,10 +329,5 @@ health-check         -> ["./planet.sh", "health"]
 - 拒绝任何不在白名单中的 action。
 - 如果增加带端口 action，端口必须校验为 `1..65535` 的整数。
 - 从仓库根目录解析命令，确保 `planet.sh` 的工作目录稳定。
+- detached runner 使用 `zsh -ic` 执行白名单命令，确保 `~/.zshrc` 中的本地环境变量进入重启流程。
 - 记录请求 action、操作者身份、执行开始时间和结果。
-
-## 实现建议
-
-- UI 触发重启流程时，优先实现 `restart-backend`。
-- 不要依赖当前 API 请求进程在触发自身重启后继续输出完整日志。
-- 主 UX 使用任务记录加轮询/健康检查恢复流程，而不是原始终端流。