39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# 数据存储模板
|
||
|
||
## 数据库路径
|
||
|
||
`{DATA_ROOT}/{USER_ID}/your-skill-slug/your-skill-slug.db`
|
||
|
||
## 通用任务日志表（task_logs）
|
||
|
||
模板默认建表：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `id` | INTEGER PK | 自增主键 |
|
||
| `task_type` | TEXT NOT NULL | 任务类型（disburse / reconcile / verify ...） |
|
||
| `target_id` | TEXT | 任务目标（账号、平台、客户等的 ID） |
|
||
| `input_id` | TEXT | 输入对象 ID |
|
||
| `input_title` | TEXT | 输入对象标题快照 |
|
||
| `status` | TEXT NOT NULL | success / failed / partial / require_login 等 |
|
||
| `error_msg` | TEXT | 错误说明 |
|
||
| `result_summary` | TEXT | 结果摘要（建议存 JSON 字符串） |
|
||
| `created_at` | INTEGER | Unix 时间戳 |
|
||
| `updated_at` | INTEGER | Unix 时间戳 |
|
||
|
||
## 不同业务的字段映射建议
|
||
|
||
| 业务场景 | task_type | target_id 含义 | input_id 含义 |
|
||
|---|---|---|---|
|
||
| 发布类 | publish | 账号 ID | 文章 ID |
|
||
| 工资代发 | disburse | 付款账户 | 工资表批次 ID |
|
||
| 对账 | reconcile | 银行 / 平台 | 对账批次 ID |
|
||
| 发票验真 | verify | 税务地区 | 发票批次 ID |
|
||
| 报关 | declare | 港口 / 海关 | 报关批次 ID |
|
||
|
||
## 模板原则
|
||
|
||
- 模板不做历史迁移兼容设计
|
||
- 新 skill 直接从当前 schema 起步
|
||
- 业务有特殊字段时，建议放 `result_summary`（JSON 字符串），不要乱加列
|