feat: 规范标准时间字段 created_at/updated_at（Unix 秒级、元数据、trigger）

references/SCHEMA.md

@@ -69,7 +69,7 @@ metadata:
 | `visible` | 是 | 是否展示 |
 | `searchable` | 是 | 是否可搜索 |
 | `editable` | 是 | 是否可编辑（与宿主权限结合） |
-| `display_type` | 否 | 如 `text` / `textarea` |
+| `display_type` | 否 | 如 `text` / `textarea` / `datetime_unix_seconds`（标准时间字段见下文） |
 | `options_json` | 否 | 枚举选项 JSON |
 
 这两张表是**数据字典**，不是业务数据；宿主不会把它们当作普通业务表展示。
@@ -90,7 +90,36 @@ metadata:
 4. 状态、结果、错误等辅助字段
 5. created_at（如有）
 6. updated_at（如有）
-```
+
+## 标准时间字段（新技能统一规范）
+
+新技能业务表若需要时间审计字段，**统一**采用 Unix **秒级**时间戳，不要使用毫秒时间戳、ISO 字符串或 SQLite 文本 datetime。
+
+| 项目 | 规范 |
+|------|------|
+| 物理字段 | `created_at INTEGER`、`updated_at INTEGER` |
+| 存储格式 | Unix 秒级整数 |
+| 展示元数据 `display_type` | `datetime_unix_seconds` |
+| 中文名 | `created_at` → **创建时间**；`updated_at` → **更新时间** |
+| 用户编辑 | `editable = 0`（系统字段，宿主只展示格式化结果，不写回字符串） |
+| 字段顺序 | 位于业务字段末尾：`… → created_at → updated_at` |
+| 排序 | **不使用** `display_order`；顺序仅来自 `PRAGMA table_info` |
+
+### 自动生成与维护
+
+- **created_at**：`INTEGER NOT NULL DEFAULT (unixepoch())`；插入时可省略，由数据库生成。
+- **updated_at**：`INTEGER NOT NULL DEFAULT (unixepoch())`；插入时同样可省略。
+- **updated_at 更新**：模板默认表 `task_logs` 通过 SQLite trigger `{table}_set_updated_at` 在业务字段更新后自动刷新；若技能所有 UPDATE 都经过统一 repository，也可在 repository 层设置 `updated_at = unixepoch()`，**不要**叠加两套机制。
+
+实现参考：
+
+- DDL 与 trigger：`scripts/db/connection.py`、`scripts/db/timestamp_columns.py`
+- 中文元数据种子：`scripts/db/display_metadata.py`
+- 自检：`scripts/db/display_metadata_validator.py`
+
+宿主（匠厂）只负责把 `display_type = datetime_unix_seconds` 格式化为 `YYYY-MM-DD HH:mm:ss` 展示，**不修改**数据库原始值。
+
+> `datetime_unix_milliseconds`、`datetime_iso` 是宿主兼容能力，**不是**新技能模板推荐标准。
 
 ### 模板默认：`task_logs`
 
@@ -106,11 +135,13 @@ CREATE TABLE IF NOT EXISTS task_logs (
     status TEXT NOT NULL,
     error_msg TEXT,
     result_summary TEXT,
-    created_at INTEGER NOT NULL,
-    updated_at INTEGER NOT NULL
+    created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+    updated_at INTEGER NOT NULL DEFAULT (unixepoch())
 );
 ```
 
+插入时可省略 `created_at`、`updated_at`；`updated_at` 在 UPDATE 时由 trigger `task_logs_set_updated_at` 自动维护（见 `scripts/db/timestamp_columns.py`）。
+
 对应中文展示（由 `init_db()` 写入元数据表）：
 
 | 物理字段 | 中文名 |
@@ -123,8 +154,8 @@ CREATE TABLE IF NOT EXISTS task_logs (
 | status | 状态 |
 | error_msg | 错误信息 |
 | result_summary | 结果摘要 |
-| created_at | 创建时间 |
-| updated_at | 更新时间 |
+| created_at | 创建时间（`display_type = datetime_unix_seconds`，不可编辑） |
+| updated_at | 更新时间（`display_type = datetime_unix_seconds`，不可编辑） |
 
 表中文名：**任务日志**。