fix: drop default task_logs; process in log, progress in task center (v1.0.81)

2026-08-14 20:53:25 +08:00
parent ff75aefcdd
commit 25b0c62dea
39 changed files with 387 additions and 696 deletions
--- a/development/LOGGING.md
+++ b/development/LOGGING.md
@@ -11,9 +11,9 @@
 | 通道 | 给谁看 | 能否单独当排障依据 |
 |------|--------|-------------------|
 | 统一文件日志 `jiangchang.log` | 运维 / 离线打包 | **必须能单独定位到失败阶段与 error_code** |
-| Activity / 任务中心 `emit` | 用户进度 | **不能**替代文件日志 |
+| Activity / 任务中心 `emit` / `finish` | 用户进度与终态 | **不能**替代文件日志 |
 | `print` / stdout | CLI 一眼结果 | **禁止**作为唯一失败记录 |
-| `task_logs` | 终态审计 | 摘要层；**不能**替代逐步 trace |
+| 业务表 | 用户可见业务结果 | 有业务才建；**不是**默认排障通道 |

 硬规定：

@@ -48,7 +48,7 @@ OpenClaw 技能常在客户电脑上异步执行，且大量依赖 RPA、浏览

 ## 2. 日志分层

-技能日志分四层，职责互不替代：
+技能日志分三层，职责互不替代：

 ### 2.1 统一文件日志（开发 / 运维排查）

@@ -122,17 +122,9 @@ RPA 等待用 `interruptible_sleep`，**不要**裸 `asyncio.sleep`（否则暂

 Journal 会写入 `type: lifecycle` 事件（`paused` / `resumed` / `stopping`），供宿主任务中心显示状态。

+### 2.3 业务表（可选，不是默认排障通道）

-### 2.3 `task_logs`（任务结果审计）
-
-**来源**：`db/task_logs_repository.save_task_log`
-
- 适合 `python scripts/main.py logs` / `log-get <id>` 查询。
- 记录任务最终状态、`result_summary`（可含 `video_path`、`video_log` 等）。
- 面向「这次任务成功还是失败、摘要是什么」，不是逐步 trace。
- **鉴权失败与未捕获异常也必须写入 `task_logs`**，保证 `logs` / `log-get` 排查链不断（见模板 `cmd_run` 示范）。
-
-表结构与字段见 [`references/SCHEMA.md`](../references/SCHEMA.md)。
+模板**默认不建**任务审计表。业务结果写入各技能自己的业务表；过程看 `jiangchang.log`，进度/终态看任务中心。

 ### 2.4 RPA video step / artifacts（用户可见动作与存证）

@@ -140,7 +132,7 @@ Journal 会写入 `type: lifecycle` 事件（`paused` / `resumed` / `stopping`

 - video artifact 是**标准可启用能力**，**不保证默认每次生成 MP4**（模板默认 `OPENCLAW_RECORD_VIDEO=0`）。
 - **`OPENCLAW_RECORD_VIDEO=0`**：不生成最终录屏，但 RPA / 长任务仍须保留 `RpaVideoSession`、`video.add_step` 与 Activity 进度同步。
- **`OPENCLAW_RECORD_VIDEO=1`**：`result_summary` 应包含 `video_path`、`raw_video`、`video_log`、`video_warnings` 等字段；CLI 可打印录屏路径与诊断。
+- **`OPENCLAW_RECORD_VIDEO=1`**：`finish()` 字段应包含 `video_path`、`raw_video`、`video_log`、`video_warnings` 等；CLI 可打印录屏路径与诊断。
 - 用户可见的中文步骤（「打开登录页」「点击提交」）。
 - 失败截图：`{数据目录}/rpa-artifacts/{batch_id}/...`（受 `OPENCLAW_ARTIFACTS_ON_FAILURE` 控制，默认开）

@@ -161,7 +153,6 @@ Journal 会写入 `type: lifecycle` 事件（`paused` / `resumed` / `stopping`
 | `entitlement_ok` / `entitlement_failed` | info / warning | 鉴权结果 |
 | `item_start` / `item_done` | info | 批量逐条时；单条可用 `task_start`/`task_success` 代替 |
 | `task_success` 或 `task_failed` | info / warning\|exception | 终态；失败须含 `error_code=` |
-| `task_log_saved` | info | 写入 `task_logs` 后 |

 ### 3.2 RPA / 桌面 / 浏览器额外最低集

@@ -198,7 +189,6 @@ rpa_start stage=open_window
 rpa_start stage=locate_control
 rpa_start stage=submit
 task_failed error_code=ELEMENT_NOT_FOUND ...
-task_log_saved status=failed
 ```

 成功路径则出现 `task_success` 而非 `task_failed`。若只有 `cli_start` → **不合格**。
@@ -224,7 +214,7 @@ task_log_saved status=failed

 | 字段 | 含义 |
 |------|------|
-| `task_type` | 任务类型（与 `task_logs.task_type` 对齐） |
+| `task_type` | 任务类型 |
 | `target_id` | 目标标识（平台、店铺、报表类型等） |
 | `input_id` | 输入记录 ID |
 | `batch_id` | 批次 / 录屏批次 |
@@ -251,7 +241,7 @@ batch_progress current=7 total=20 target_id=store-001

 | 级别 | 使用场景 |
 |------|----------|
-| **info** | 关键阶段、成功路径、外部调用开始/结束、批量进度、`task_log_saved` |
+| **info** | 关键阶段、成功路径、外部调用开始/结束、批量进度 |
 | **warning** | 可恢复问题、重试、跳过、人工介入、部分失败、鉴权失败（业务可预期） |
 | **exception** | 异常路径；**必须**用 `log.exception(...)` 保留 traceback |
 | **debug** | 低频诊断；**默认不依赖 debug 才能排查问题** |
@@ -264,7 +254,7 @@ batch_progress current=7 total=20 target_id=store-001

 ### 禁止记录原始值

-以下字段**不得**以明文出现在日志、Activity、task_logs 的 `error_msg` / `result_summary`、stdout：
+以下字段**不得**以明文出现在日志、Activity、`finish()` 字段、stdout：

 - `password`、`token`、`cookie`、`secret`、`api_key`、`authorization`
 - 验证码、动态口令全文
@@ -318,8 +308,6 @@ def cmd_run(target=None, input_id=None):
                "erp", "submit", elapsed_ms, "ok",
            )

-            tlr.save_task_log(..., status="success", ...)
-            log.info("task_log_saved task_type=%s status=success", task_type)
            finish(status="success", message="任务完成", skill=SKILL_SLUG)
            return 0
        except Exception:
@@ -328,7 +316,6 @@ def cmd_run(target=None, input_id=None):
                task_type, target, input_id,
            )
            emit("任务失败，已记录诊断信息", type="warn", skill=SKILL_SLUG, stage="run")
-            tlr.save_task_log(..., status="failed", error_msg="...", ...)
            finish(status="failed", message="任务执行异常", skill=SKILL_SLUG)
            return 1
 ```
@@ -342,11 +329,10 @@ def cmd_run(target=None, input_id=None):
 客户现场或测试机排障，建议按以下顺序（由快到慢、由用户可见到运维细节）：

 1. **CLI stdout** — 是否有 `ERROR:<CODE>:`、`HINT:`、模板提示文案。
-2. **`python scripts/main.py logs`** — 最近任务是否写入 `task_logs`、status 与 `error_msg`。
-3. **`python scripts/main.py log-get <id>`** — 单条 JSON，含 `result_summary`（video 路径等）。
-4. **统一日志文件** — `{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/logs/jiangchang.log`（grep `trace_id`、`task_failed`）。
-5. **Run Journal** — `{JIANGCHANG_DATA_ROOT}/.jiangchang/runs/{job_id}.jsonl`（宿主 UI 进度来源）。
-6. **RPA artifacts** — `rpa-artifacts/` 失败截图；若 `OPENCLAW_RECORD_VIDEO=1` 还有录屏 MP4、`video_log`。未开启录屏时可能只有截图或日志，需要完整录屏请在用户 `.env` 中设置 `OPENCLAW_RECORD_VIDEO=1`。
+2. **任务中心 / Run Journal** — `{JIANGCHANG_DATA_ROOT}/.jiangchang/runs/{job_id}.jsonl`（进度与 `finish` 终态）。
+3. **统一日志文件** — `{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/logs/jiangchang.log`（grep `trace_id`、`task_failed`）。
+4. **业务表** — 宿主数据管理中该技能自己的业务结果（有才建）。
+5. **RPA artifacts** — `rpa-artifacts/` 失败截图；若 `OPENCLAW_RECORD_VIDEO=1` 还有录屏 MP4、`video_log`。未开启录屏时可能只有截图或日志，需要完整录屏请在用户 `.env` 中设置 `OPENCLAW_RECORD_VIDEO=1`。

 长时间无 stdout **不代表卡死**；先看 Run Journal / Activity，再看统一日志。

@@ -359,8 +345,8 @@ def cmd_run(target=None, input_id=None):
 | [`RUNTIME.md`](RUNTIME.md) | 统一日志能力来源、`util.logging_config` 薄封装、数据根约定 |
 | [`TESTING.md`](TESTING.md) | 日志相关 hard policy 测试（`test_development_policy_guard.py`） |
 | [`RPA.md`](RPA.md) | RPA step、`RpaVideoSession`、video / artifacts 标准 |
-| [`SCHEMA.md`](../references/SCHEMA.md) | `task_logs` 表结构与查询命令 |
-| [`CLI.md`](../references/CLI.md) | `logs` / `log-get` 命令与手工排查入口 |
+| [`SCHEMA.md`](../references/SCHEMA.md) | 业务表结构与展示元数据 |
+| [`CLI.md`](../references/CLI.md) | 最小命令与手工排查入口 |
 | [`CONFIG.md`](CONFIG.md) | 敏感配置不进日志；`.env` 边界 |
 | [`DEVELOPMENT.md`](DEVELOPMENT.md) | `service/` 层日志职责与发布前检查清单 |
 | [`SKILL_ACTION_RUNTIME.md`](SKILL_ACTION_RUNTIME.md) | 任务中心 / async Job 与 `job_context` 边界 |