# -*- coding: utf-8 -*-
"""
可选片段：最小 SQLite 示例（请复制后按需修改）
==============================================

【用途】
  演示「单表 + 自增主键 + INTEGER 时间戳」的一种严谨写法；与具体业务无关。

【使用步骤】
  1. 复制到 scripts/db_example.py（或并入你的模块）。
  2. 修改 TABLE_SQL 中的表名与字段；保持时间字段为 INTEGER Unix 秒（UTC）若需跨时区一致。
  3. 在入口脚本中仅在需要持久化时 import。

【注意】
  - 不在模板中做迁移兼容；schema 变更请用你们组织的迁移策略。
  - 数据库文件路径建议：get_skill_data_dir() / "skill.db"（paths_snippet 中函数）。
"""

from __future__ import annotations

import sqlite3
import time

# 示例表：与任何业务无关
TABLE_SQL = """
CREATE TABLE IF NOT EXISTS template_audit (
    id INTEGER PRIMARY KEY AUTOINCREMENT, -- 自增主键
    action TEXT NOT NULL,                -- 动作标识，如 health_ok
    created_at INTEGER NOT NULL          -- Unix 秒 UTC
);
"""


def connect(db_path: str) -> sqlite3.Connection:
    return sqlite3.connect(db_path)


def init_db(conn: sqlite3.Connection) -> None:
    conn.execute(TABLE_SQL)
    conn.commit()


def record_action(conn: sqlite3.Connection, action: str) -> None:
    conn.execute(
        "INSERT INTO template_audit (action, created_at) VALUES (?, ?)",
        (action, int(time.time())),
    )
    conn.commit()