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/references/CLI.md
+++ b/references/CLI.md
@@ -24,7 +24,7 @@ python {baseDir}/scripts/main.py <command> …

 | 类型 | 本技能命令（自填） | Agent |
 |------|--------------------|-------|
-| **短 CLI 白名单** | （例）`health` / `version` / `logs` / `render-html` / `<your-read-or-prep>` | 可用 bash/exec + 共享 `python` |
+| **短 CLI 白名单** | （例）`health` / `version` / `render-html` / `<your-read-or-prep>` | 可用 bash/exec + 共享 `python` |
 | **Action 强制黑名单** | （例）`<your-long-or-rpa-command>` | **禁止** bash + `process poll`；必须 `run_skill_action` |

 细节与 Action 清单见 [`ACTIONS.md`](ACTIONS.md)。若提供 HTML 报告，「重新生成」须有 Action id **`render-html`**（可同时进短 CLI 白名单）；见 ACTIONS.md「HTML 页面报告」。
@@ -48,13 +48,12 @@ python {baseDir}/scripts/main.py init-db
 - **`policy`（可选）**：仅当 `actions.json` 顶层启用 Data Policy 时需要；向 stdout 输出 Snapshot JSON（见 `references/POLICY.md`）。模板默认不实现；多数技能保持 L0 即可。
 - **`run` / RPA / 长任务**：CLI 仍是同一内核；**Agent 禁止**用 bash 干等长任务结束。须走宿主 Skill Action（`run_skill_action`），且该 Action 一般为 `executionProfile: "async"` → **任务中心**。长时间无 stdout **不代表卡死**；进度看任务中心 / Run Journal。
 - **排查顺序**（由快到慢）：
-  1. `python {baseDir}/scripts/main.py logs`
-  2. `python {baseDir}/scripts/main.py log-get <log_id>`
-  3. 统一日志文件 `{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/logs/jiangchang.log`（含 `trace_id`、`task_failed` 等）
-  4. Run Journal `{JIANGCHANG_DATA_ROOT}/.jiangchang/runs/{job_id}.jsonl`
-  5. RPA artifacts / `video_log` / 失败截图（开发规范见 `development/RPA.md`）；未开启录屏时可能只有截图或日志
+  1. 任务中心 / Run Journal `{JIANGCHANG_DATA_ROOT}/.jiangchang/runs/{job_id}.jsonl`
+  2. 统一日志文件 `{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/logs/jiangchang.log`（含 `trace_id`、`task_failed` 等）
+  3. 业务表（宿主数据管理；有才建）
+  4. RPA artifacts / `video_log` / 失败截图（开发规范见 `development/RPA.md`）；未开启录屏时可能只有截图或日志
 - **录屏默认关闭**：模板 `.env.example` 为 `OPENCLAW_RECORD_VIDEO=0`；若未开启录屏，任务**可能不会**打印录屏路径。
- 需要录屏时在用户 `.env` 或进程环境变量中设置 **`OPENCLAW_RECORD_VIDEO=1`**；开启后任务完成时 CLI 应打印录屏路径、录屏日志、视频/音频诊断（见 `task_run_support._print_video_summary`），且 `result_summary` 含 video 字段。
+- 需要录屏时在用户 `.env` 或进程环境变量中设置 **`OPENCLAW_RECORD_VIDEO=1`**；开启后任务完成时 CLI 应打印录屏路径、录屏日志、视频/音频诊断（见 `task_run_support._print_video_summary`），且 `finish()` 含 video 字段。

 ## config-path（配置路径）

@@ -82,12 +81,8 @@ python {baseDir}/scripts/main.py init-db
 ```bash
 python {baseDir}/scripts/main.py run
 python {baseDir}/scripts/main.py run -t <target> -i <input_id>
-python {baseDir}/scripts/main.py logs
-python {baseDir}/scripts/main.py logs --task-type demo --status failed
-python {baseDir}/scripts/main.py log-get <log_id>
 ```

 | 命令 | 用途 | Agent 注意 |
 |------|------|------------|
 | `run` | 执行一次任务（常为长任务 / RPA） | **走 `run_skill_action`**，不要 bash poll |
-| `logs` / `log-get` | 查任务日志 | 可用短 CLI |
--- a/references/SCHEMA.md
+++ b/references/SCHEMA.md
@@ -66,7 +66,7 @@ metadata:
 ```

 - 数据库文件：英文 slug，例如 `your-skill-slug.db`（默认 `{skill-slug}.db`）。
- 业务表、字段：**英文 snake_case** 物理名，例如 `demo_items`、`task_logs`、`created_at`。
+- 业务表、字段：**英文 snake_case** 物理名，例如 `demo_items`、`created_at`。
 - **禁止**用中文作为 SQLite 真实表名或字段名。

 ## 外部来源只读与本地数据可写
@@ -442,7 +442,7 @@ readonly = 0

 - **created_at**：`INTEGER NOT NULL DEFAULT (unixepoch())`；插入时可省略，由数据库生成。
 - **updated_at**：`INTEGER NOT NULL DEFAULT (unixepoch())`；插入时同样可省略。
- **updated_at 更新**：模板默认表 `task_logs` 通过 SQLite trigger `{table}_set_updated_at` 在业务字段更新后自动刷新。
+- **updated_at 更新**：业务表通过 SQLite trigger `{table}_set_updated_at` 在业务字段更新后自动刷新（`init_updated_at_trigger`）。

 实现参考：

@@ -450,51 +450,18 @@ readonly = 0
 - 中文元数据种子：`scripts/db/display_metadata.py`
 - 自检：`scripts/db/display_metadata_validator.py`

-### 模板默认：`task_logs`
+### 系统自动写入表的只读约定

-`task_logs` 是技能内部**系统自动写入**的任务审计日志（由 `task_logs_repository` INSERT/UPDATE），不是供用户在宿主数据管理中手工维护的业务表。
-
-权限设计：
+技能内部**系统自动写入**、不供用户在宿主数据管理中手工维护的表，应声明：

 | 层级 | 值 | 说明 |
 |------|-----|------|
 | 表级 `readonly` | `1` | 宿主数据管理只读展示，不提供新增/编辑/删除表单 |
-| 所有业务字段 `editable` | `0` | 含 `task_type`、`status`、`error_msg`、`result_summary` 等 |
-| 技能内部 repository | 正常 INSERT/UPDATE | 元数据权限只约束宿主 UI，不限制技能代码写库 |
+| 相关业务字段 `editable` | `0` | 元数据权限只约束宿主 UI，不限制技能代码写库 |

-物理定义（权威顺序）：
+模板**默认不建**此类审计表。过程看 `jiangchang.log`，进度/终态看任务中心，业务结果看业务表。

-```sql
-CREATE TABLE IF NOT EXISTS task_logs (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    task_type TEXT NOT NULL,
-    target_id TEXT,
-    input_id TEXT,
-    input_title TEXT,
-    status TEXT NOT NULL,
-    error_msg TEXT,
-    result_summary TEXT,
-    created_at INTEGER NOT NULL DEFAULT (unixepoch()),
-    updated_at INTEGER NOT NULL DEFAULT (unixepoch())
-);
-```
-
-对应中文展示（由 `init_db()` 写入元数据表）：
-
-| 物理字段 | 中文名 | editable |
-|----------|--------|----------|
-| id | 编号 | 0 |
-| task_type | 任务类型 | 0 |
-| target_id | 目标编号 | 0 |
-| input_id | 输入编号 | 0 |
-| input_title | 输入标题 | 0 |
-| status | 状态 | 0 |
-| error_msg | 错误信息 | 0 |
-| result_summary | 结果摘要 | 0 |
-| created_at | 创建时间 | 0 |
-| updated_at | 更新时间 | 0 |
-
-表中文名：**任务日志**；表级 `readonly = 1`（宿主只读；技能 repository 仍可写入）。
+表级 `readonly = 1` 时，宿主数据管理只读展示；技能 repository 仍可写入。

 ### 通用示例：`demo_items`（测试 fixture 参考）

@@ -617,7 +584,7 @@ seed_column_metadata_batch(

 ## 中文命名质量

- 使用普通用户能理解的业务用语：`task_logs` → **任务日志**，`error_msg` → **错误信息**。
+- 使用普通用户能理解的业务用语：`error_msg` → **错误信息**，`created_at` → **创建时间**。
 - 禁止：`Task Logs`、`input编号`、`errormsg`、直接把物理名当 `display_name`。
 - 不宜向用户暴露的实现细节（如 `payload_json`、`selector`）应设 `visible = 0` 或给出可理解中文名。

@@ -629,17 +596,6 @@ seed_column_metadata_batch(
 4. 初始化脚本必须幂等。
 5. 元数据中的表、字段必须在库中真实存在；可见项不得缺少中文 `display_name`。

-## 不同业务的 `task_logs` 映射
-
-| 业务场景 | task_type | target_id | input_id |
-|----------|-----------|-----------|----------|
-| 发布类 | publish | 账号 ID | 内容 ID |
-| 工资代发 | disburse | 付款账户 | 批次 ID |
-| 对账 | reconcile | 平台标识 | 对账批次 ID |
-| 发票验真 | verify | 税务地区 | 发票批次 ID |
-
-业务特有字段优先放入 `result_summary`（JSON 字符串），避免随意加列；若确需新列，必须同步元数据并保持合理物理顺序。
-
 ## 开发自检

 - `init_db()` 后运行 `tests/test_display_metadata.py` 与 `tests/test_data_management_contract.py`。
@@ -649,5 +605,5 @@ seed_column_metadata_batch(
 ## 模板原则

 - 模板不做复杂历史迁移框架；新 skill 从当前 schema 起步。
- 元数据 DDL 与 `task_logs` 中文种子以 `scripts/db/display_metadata.py` 为单一权威来源。
+- 元数据 DDL 与种子 helper 以 `scripts/db/display_metadata.py` 为单一权威来源。
 - 模板定义「如何声明能力」；具体技能定义「声明什么业务能力」；宿主负责「如何通用渲染和执行」。