每个所有者一间「策略工作室」：写过的策略脚本与不可改的版本、运行配置、回测记录（摘要），以及模拟部署的逐根账本、事件与权益曲线。
不存钱：回测与模拟部署只算模拟账本，不对应任何 HL 订单，订单 / 仓位 / 资产权威在 Hyperliquid L1（ADR-0083）；行情归 MARKET_ARCHIVE 行情归档（采集 DO 写）；回测大块结果归 R2 BACKTEST_RESULTS；所有者身份与最近活跃时间归 USER_DB（apps/server）。
users.user_id（getByName(userId)），库里没有 owner 列，不同所有者天然互不可读（ADR-0227 第 2 条）。docs/data/CONVENTIONS.md 约定 3（ISO TEXT）的已接受例外，不迁移、新列延续；迁移账本 schema_migrations.applied_at 照常是 ISO TEXT，owner_state.value 把毫秒存成十进制字符串。number 中转。*_json）；读时 RunConfigSchema 校验运行配置、engineSnapshotOf 校验快照格式版本。status / kind / *_reason / origin_kind）只由领域类型约束。await 的连续 sql.exec 不会被别的请求插进来（DO 输入闸）；部署变更显式用 transactionSync 包成一个事务。跨 await 的判定 → 落库（回测、部署操作）靠 DO 内排队串行。STRATEGY_SCHEMA_MIGRATIONS 有序数组，🔒 只增不改（apps/strategy/src/doMigrations.snapshot.test.ts 快照守），DO 构造函数里同步跑完才接请求；旧行的新列为 NULL，读时按注明的默认值解释。scriptscompileScript 静态校验 + 转译，失败直接返回全部问题，不落库versions 追加一行，版本号 = 该脚本 MAX(number)+1，源码、产物、参数声明一起存versions_immutable 挡下run_configs；之后改它只更新这一行，不产生新版本reuse_keybacktests 里有同键的 → 直接返回最早那条（不重算、不计配额）created_at），满 100 次返回 quota_exceeded 与重置时刻sandbox_bundle_versions 当天包，在沙箱里跑引擎backtests（摘要），再把大块结果写到 R2 backtests/<id>.json；R2 失败就删掉这行deployments（运行配置快照 + 引擎快照），alarm 拨到 next_run_atreschedule 到 30 秒后transactionSync：改 deployments（游标、收盘价、最高权益、出错计数、快照）+ 追加 deployment_events + upsert deployment_equitypaused（errors）；回撤到上限 → 平仓、转 stopped（drawdown），推送照发saveowner_state.dormancy_checked_at 已满一天，经 service binding 问 server 最近活跃时间dormancy_checked_at；超过 30 天就把运行中的部署全部转 paused（dormant）并推送running，写 resumed 事件user_id，库里没有 owner 列，也不可能查到别人的策略；隔离由 DO 边界给，不靠 WHERE。versions_immutable 兜底不可改；运行配置可改，所以回测与部署各自存 config_json 快照，改配置不追溯。reuse_key 把「同一次回测」的全部身份规范化成一个串；命中就返回最早那条、不计配额。没有 UNIQUE，靠 DO 内排队串行。BACKTEST_RESULTS。先落库后写 R2，R2 失败补偿删行，不留没有大块的 completed 回测。transactionSync 里一起写；转换本身是 domain 纯函数，仓储只负责落盘。compiledOf / originOf / deploymentOf）。通用语言（术语定义）以 contexts/strategy/CONTEXT.md 为准，这里不重复。
scripts + versionsStrategyScript / StrategyVersion / VersionOrigin contexts/strategy/src/domain/entities/strategy.ts — 脚本、版本（源码 + 产物）与来源compileScript contexts/strategy/src/domain/script/compileScript.ts — 保存前的静态校验 + 转译 + 参数声明提取officialTemplate contexts/strategy/src/domain/templates/officialTemplates.ts — 官方模板目录（代码常量，不在库里）saveVersion / createScript contexts/strategy/src/application/strategyScripts.ts — 用例| 版本保存后不可修改 | 数据库 | 触发器 versions_immutable（任何 UPDATE 都 ABORT）；仓储也没有改版本的方法 |
| 同一脚本内版本号唯一，从 1 起递增 | 数据库 | UNIQUE (script_id, number) + appendVersion 的 COALESCE(MAX(number), 0) + 1（同步执行，无并发窗口） |
| 版本必须属于已存在的脚本 | 数据库 | 外键 versions.script_id → scripts.id |
| 版本保存前必须通过静态校验与转译；不在 Worker 里执行脚本 | 领域代码 | saveVersion → compileScript（strategyScripts.ts） |
来源：origin_kind = user ⇒ template_id = ''；official_template 或 NULL ⇒ template_id 是模板 id | 领域代码 | appendVersion 写入 / originOf 读出（strategyRepository.ts），库里无 CHECK |
| 执行的是转译产物；v3 前旧行无产物时按源码现转译，转译失败即报错 | 领域代码 | compiledOf（strategyRepository.ts） |
| 脚本与版本永不删除 | SQL | 全仓无 DELETE FROM scripts / DELETE FROM versions；被 backtests / deployments 外键引用 |
run_configsRunConfig / RunConfigSchema contexts/strategy/src/domain/value-objects/runConfig.ts — zod strictObject：币、周期、杠杆 1–50、初始资金为正的十进制串、参数取值、成本StoredRunConfig contexts/strategy/src/domain/entities/strategy.ts| 运行配置必须属于已存在的脚本 | 数据库 | 外键 run_configs.script_id → scripts.id；createRunConfig 用例先查脚本 |
config_json 永远是合法的 RunConfig | 领域代码 | 路由层 zod 校验写入、configOf → RunConfigSchema.parse 读出 |
| 回测 / 部署只能用同一脚本的运行配置 | 领域代码 | runBacktest / startDeployment 比对 runConfig.scriptId !== version.scriptId → run_config_not_found（库里无复合外键） |
| 改运行配置不影响已有回测与部署 | 领域代码 | backtests.config_json / deployments.config_json 存发起时快照 |
backtestsBacktestRecord / backtestReuseKey / isTruncated / splitBacktestResult contexts/strategy/src/domain/entities/strategy.ts — 记录、复用键、截断判定、摘要与大块的拆分runBacktest / createBacktestRunner / DAILY_BACKTEST_QUOTA contexts/strategy/src/application/backtests.ts — 复用 → 配额 → 沙箱 → 落库 → 写 R2createBacktestDetailsStore contexts/strategy/src/infrastructure/backtests/backtestDetailsStore.ts — R2 backtests/<id>.json| 「同一次回测」只跑一次，再请求直接返回最早那条，不计配额 | 领域代码 | backtestReuseKey + findBacktestByReuseKey（索引 backtests_by_reuse_key）；reuse_key 无 UNIQUE，靠 createBacktestRunner 串行排队防并发重复 |
| 每个所有者每个 UTC 日最多新跑 100 次（失败也算，复用不算） | SQL | countBacktestsSince(dayStart)（索引 backtests_by_created_at）+ DAILY_BACKTEST_QUOTA；同样靠排队防并发绕过 |
completed 的回测在 R2 一定有大块结果；R2 写失败就删掉刚落库的那条（不占配额） | 领域代码 | runBacktest 的补偿 deleteBacktest（backtests.ts） |
status 与 outcome_json.status 一致 | SQL | saveBacktest 从同一个 record.outcome 写两列 |
| 数据段只截到当时归档里有数据的部分，之后采进来的行情不会混进旧回测 | 领域代码 | runBacktest 按首根 / 末根定 range_*；复现按 data_revision 读归档 |
| 回测引用的版本与运行配置必须存在 | 数据库 | 外键 backtests.version_id / backtests.run_config_id |
deployments + deployment_events + deployment_equityDeployment / DeploymentEvent / DeploymentChange contexts/strategy/src/domain/entities/deployment.ts — 部署、事件联合类型、一次变更要写的东西pausedDeployment / stoppedDeployment / settledBar / intrabarSettled contexts/strategy/src/domain/deployment/transitions.ts — 纯函数状态转换MAX_ACTIVE_DEPLOYMENTS / MAX_CONSECUTIVE_ERRORS / drawdownBreached / isOwnerDormant contexts/strategy/src/domain/deployment/lifecycle.ts — 生命周期规则nextRunAfter / ARCHIVE_RETRY_MS contexts/strategy/src/domain/deployment/schedule.ts — next_run_at 的计算EngineSnapshot contexts/strategy/src/domain/engine/session.ts — snapshot_json 的形状| 部署行、快照、新事件、新权益点要么一起写下，要么都不写 | SQL | save 的 storage.transactionSync（deploymentRepository.ts） |
事件在部署内按 seq 连续编号、只追加 | 数据库 | PK (deployment_id, seq) + appendEvents 的 MAX(seq) + 1；无 UPDATE / DELETE 路径 |
| 权益点每部署每时刻一条，同时刻再写覆盖 | 数据库 | PK (deployment_id, time) + appendEquity 的 ON CONFLICT … DO UPDATE |
| 每人最多 10 个活跃部署（运行中 + 暂停中） | 领域代码 | MAX_ACTIVE_DEPLOYMENTS（startDeployment）；部署操作在 DO 内排队串行 |
stopped 是终态：暂停 / 恢复 / 换版本对已停止的部署一律拒绝 | 领域代码 | lifecycle.ts 用例返回 deployment_stopped；库里 status 无 CHECK |
pause_reason 只在暂停中有值，stop_reason / stopped_at 只在停止后有值；停止 ⇒ next_run_at 为 NULL | 领域代码 | pausedDeployment / stoppedDeployment / resumeDeployment |
| 运行中连续 3 根交易根求值出错自动暂停；收盘权益从最高点回撤到上限自动停止 | 领域代码 | settledBar（transitions.ts）+ MAX_CONSECUTIVE_ERRORS / drawdownBreached |
| 快照格式版本对不上就报错，不按错的格式推进 | 领域代码 | engineSnapshotOf（deploymentRepository.ts，只认 v: 1） |
| 用户停止按最近一小时内已收盘 15m 的收盘价平仓，拿不到就拒绝 | 领域代码 | stopDeployment → no_price（stop.ts，STOP_PRICE_MAX_AGE_MS） |
| 模拟账本不是金融权威，不产生任何 HL 订单 | 外部 | ADR-0083；实盘运行（M2）另走 Bot 写管线 |
user）/ 连续 3 根出错（errors）/ 所有者 30 天没打开 App（dormant）consecutive_errors 清零user）/ 收盘触到回撤上限（drawdown）：平仓、撤挂单、next_run_at 置空sandbox_bundle_versionsenterSandboxBundle contexts/strategy/src/application/sandboxBundle.ts — 记入当天包并返回包内版本 id 与按需装载产物的函数| 只保留当天的包；同一天同一版本只记一次 | SQL | addToSandboxBundle：先 DELETE … WHERE day < ? 再 INSERT OR IGNORE；PK (day, version_id) |
| 只有新跑的回测和运行中部署的推进才记入（复用命中、暂停中走账本不记） | 领域代码 | runBacktest / advanceDeployment 调 enterSandboxBundle 的位置 |
owner_stateDORMANCY_CHECK_INTERVAL_MS / isOwnerDormant contexts/strategy/src/domain/deployment/lifecycle.tspauseIfOwnerDormant contexts/strategy/src/application/deployment/advance.ts — alarm 推进完之后调用| 休眠检查每天最多向 server 查一次；查不到（server 不可用）不算查过、不暂停 | 领域代码 | pauseIfOwnerDormant：只在拿到 lastSeenAt 后才 markDormancyChecked |
| 每个键一行 | 数据库 | PK key + ON CONFLICT (key) DO UPDATE |
schema_migrationsmigrateStrategySchema contexts/strategy/src/infrastructure/sqlite/migrate.ts — DO 构造函数里同步调用STRATEGY_SCHEMA_MIGRATIONS contexts/strategy/src/infrastructure/sqlite/migrations.ts迁移版本从 1 起连续；每版 up 与版本行在同一事务里，失败整版回滚、DO 构造失败 | 领域代码 | migrateStrategySchema（migrate.ts） |
| 已发布的迁移只增不改 | 领域代码 | apps/strategy/src/doMigrations.snapshot.test.ts 快照比对（CI） |
保证方：数据库 约束 / 索引 / 触发器 SQL 仓储里的条件写 / batch 领域代码 domain 层规则 外部 链上等外部权威
| 操作 | 原子性 | backtests | deployment_equity | deployment_events | deployments | owner_state | run_configs | sandbox_bundle_versions | schema_migrations | scripts | versions |
|---|---|---|---|---|---|---|---|---|---|---|---|
| createScript contexts/strategy/src/infrastructure/sqlite/strategyRepository.ts | single | ● | |||||||||
| appendVersion contexts/strategy/src/infrastructure/sqlite/strategyRepository.ts 先 SELECT MAX(number) 再 INSERT，同步执行 | single | ● | |||||||||
| addToSandboxBundle contexts/strategy/src/infrastructure/sqlite/strategyRepository.ts 删前一天及更早的行 + INSERT OR IGNORE 当天这条（两条同步语句，未包事务） | single | ● | |||||||||
| createRunConfig contexts/strategy/src/infrastructure/sqlite/strategyRepository.ts | single | ● | |||||||||
| updateRunConfig contexts/strategy/src/infrastructure/sqlite/strategyRepository.ts UPDATE … RETURNING id，没命中返回 false | single | ● | |||||||||
| saveBacktest contexts/strategy/src/infrastructure/sqlite/strategyRepository.ts 之后才写 R2 大块 | single | ● | |||||||||
| deleteBacktest contexts/strategy/src/infrastructure/sqlite/strategyRepository.ts 只在 R2 写失败时补偿调用 | single | ● | |||||||||
| insert（启动部署） contexts/strategy/src/infrastructure/sqlite/deploymentRepository.ts 部署行 + 预热后的快照 | single | ● | |||||||||
| save（推进 / 暂停 / 恢复 / 换版本 / 停止 / 盘中成交） contexts/strategy/src/infrastructure/sqlite/deploymentRepository.ts transactionSync：改部署行与快照 → 追加事件 → upsert 权益点 | batch | ● | ● | ● | |||||||
| reschedule contexts/strategy/src/infrastructure/sqlite/deploymentRepository.ts 只改 next_run_at（归档没跟上 / 推进失败 → 30 秒后） | single | ● | |||||||||
| setMuted contexts/strategy/src/infrastructure/sqlite/deploymentRepository.ts 只改 muted，不碰快照 | single | ● | |||||||||
| markDormancyChecked contexts/strategy/src/infrastructure/sqlite/deploymentRepository.ts upsert dormancy_checked_at | single | ● | |||||||||
| migrateStrategySchema contexts/strategy/src/infrastructure/sqlite/migrate.ts 每个待跑版本一个 transactionSync：DDL + 版本行 | batch | ● |
| 本库字段 | 对应 | 说明 |
|---|---|---|
backtests.id | R2 BACKTEST_RESULTS 对象 backtests/<id>.json（equityCurve / trades / fills / skippedOrders） | 按环境各一个桶，只由所有者 DO 按回测 id 读写；failed 的回测没有对象；对象没有清理 |
backtests.outcome_json | R2 BACKTEST_RESULTS | 库里只存报告摘要，大块字段由 splitBacktestResult 拆到 R2（v2 / BERTH-1875 起） |
backtests.data_revision | R2 MARKET_ARCHIVE 行情归档的数据修订号 | 按「每块取不超过这个号的最新修订」读归档即可复现 |
deployments.id | strategy-collector-do intrabar_watches.deployment_id | reportDeployments 整份替换上报；采集 DO 的 owner 是本 DO 的 ctx.id.toString()，不是 user_id |
deployments.config_json | strategy-collector-do deployed_coins.coin | 活跃部署的币去重后上报，production 采集据此优先抓 |
deployments.id | PUSH_QUEUE 的 StrategyPushIntent.deploymentId → apps/server 推送 | 尽力而为，投递失败只记日志 |
owner_state.value | USER_DB 最近活跃时间（经 service binding SessionRpc.lastSeenAt） | 这里只记「上次查的时刻」，不复制对方的值 |
versions.template_id | officialTemplates.ts 官方模板目录（代码常量） | 模板只增不删，已有版本永远能找到来源 |
| 表 | 规则 |
|---|---|
scripts | 永不删除（没有删除入口） |
versions | 永不删除、不可修改 |
run_configs | 永不删除；只原地修改 |
backtests | 不清理；唯一的删除是落库后 R2 写失败时的补偿删除。R2 里的大块对象也不清理 |
sandbox_bundle_versions | 只留当天：每次记入时顺手删掉 day 早于当天的行（没有新记入就留着最后那天） |
deployments | 停止后不删，永久保留供回看 |
deployment_events | 只追加，不清理 |
deployment_equity | 只追加（同时刻覆盖），不清理 |
owner_state | 单键覆盖写，不删除 |
schema_migrations | 永不删除 |
| 字段 | 级别 | 说明 |
|---|---|---|
versions.source | 个人数据 | 所有者 / AI 写的脚本原文，只给本人看；日志不记脚本内容（spec §9） |
versions.compiled | 个人数据 | 源码的转译产物，同上 |
scripts.name | 个人数据 | 用户自填，出现在本人推送里 |
scripts.description | 个人数据 | 用户自填 |
0003 绿色迁移号表示该字段由后续迁移 ALTER TABLE 加入。点表名展开。
BACKTEST_RESULTS，这里只有摘要。行一旦写入不再修改；「同一次回测」靠 reuse_key 复用最早那条。| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKid | TEXT | PK | 回测 ID（UUID）；也是 R2 对象键 backtests/<id>.json 的一部分 | 1 |
| FKversion_id | TEXT | FK→versions.id · NOT NULL | 跑的策略版本 | 1 |
| FKrun_config_id | TEXT | FK→run_configs.id · NOT NULL | 首次发起时用的运行配置；复用命中时返回值会换成这次请求的 id，库里不变 | 1 |
| config_json | TEXT | NOT NULL | 发起时的运行配置快照（之后改运行配置不影响这条） | 1 |
| range_from | INTEGER | NOT NULL | 实际数据段起点（首根开盘，ms）；区间里没有 K 线时等于请求起点 | 1 |
| range_to | INTEGER | NOT NULL | 实际数据段终点（末根收盘，ms，开区间）；即请求截到可回测区间后的结果 | 1 |
| data_revision | INTEGER | 读到的最大数据修订号（K 线 / 资金费 / 市场参数取最大）；NULL = 三者都没有修订号 | 1 | |
| engine_version | TEXT | NOT NULL | 跑这次回测的引擎版本（ENGINE_VERSION） | 1 |
| created_at | INTEGER | NOT NULL | 发起时间（ms）；也是每日配额按 UTC 日计数的依据 | 1 |
| status | TEXT | NOT NULL | completed / failed，与 outcome_json.status 同源写入，冗余出来便于不解析 JSON 判断 | 1 |
| outcome_json | TEXT | NOT NULL | 结果摘要：completed 时是去掉大块字段的报告（splitBacktestResult），failed 时是错误 | 1 |
| requested_from | INTEGER | 请求的区间起点（相对区间已在发起时换算成具体时刻）；NULL = v2 之前的旧行，按数据段读 | 2 | |
| requested_to | INTEGER | 请求的区间终点；NULL 同上。与数据段比出 truncated（不落库，读时 isTruncated 现算） | 2 | |
| reuse_key | TEXT | 「同一次回测」的键：版本 + 运行配置内容 + 数据段 + 最后一条资金费时刻 + 数据修订号 + 引擎版本的规范化 JSON（backtestReuseKey）；NULL = v2 之前的旧行（永不被复用） | 2 |
| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKFKdeployment_id | TEXT | PK · FK→deployments.id | 所属部署 | 4 |
| PKtime | INTEGER | PK | 权益点时刻（ms）；同一时刻再写覆盖 | 4 |
| equity | TEXT | NOT NULL | 该时刻模拟账户权益（十进制串） | 4 |
| buy_and_hold | TEXT | NOT NULL | 同一时刻「启动即买入持有」的基准权益（十进制串） | 4 |
| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKFKdeployment_id | TEXT | PK · FK→deployments.id | 所属部署 | 4 |
| PKseq | INTEGER | PK | 部署内序号，从 1 起，appendEvents 按 MAX(seq)+1 连续分配 | 4 |
| kind | TEXT | NOT NULL | fill / trade / skipped / error / paused / resumed / version_switched / stopped / engine_upgraded | 4 |
| time | INTEGER | NOT NULL | 事件的业务时刻（ms）：成交时刻、平仓时刻、出错那根的开盘、操作时刻等，不是写入时刻 | 4 |
| event_json | TEXT | NOT NULL | 完整 DeploymentEvent JSON（含 kind / time 冗余） | 4 |
| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKid | TEXT | PK | 部署 ID（UUID）；也是推送意图与采集 DO 盘中检查里的 deploymentId | 4 |
| FKscript_id | TEXT | FK→scripts.id · NOT NULL | 所属脚本（冗余自版本，便于按脚本展示与换版本时校验同脚本） | 4 |
| FKversion_id | TEXT | FK→versions.id · NOT NULL | 当前钉住的版本；换版本时原地改写，换前换后记一条 version_switched 事件 | 4 |
| FKrun_config_id | TEXT | FK→run_configs.id · NOT NULL | 启动时选的运行配置（只作溯源，执行用的是 config_json） | 4 |
| config_json | TEXT | NOT NULL | 启动时的运行配置快照，initialCapital 已被请求的模拟资金覆盖（缺省 10000） | 4 |
| status | TEXT | NOT NULL | running / paused / stopped；stopped 是终态 | 4 |
| started_at | INTEGER | NOT NULL | 启动时刻（ms）：收盘不晚于它的 K 线只预热、不交易 | 4 |
| stopped_at | INTEGER | 停止时刻（用户停止 = 操作时刻，回撤停止 = 那根收盘）；未停止为 NULL | 4 | |
| cursor | INTEGER | NOT NULL | 推进到的最后一根 K 线的开盘时刻（ms） | 4 |
| last_close | TEXT | NOT NULL | 那根的收盘价（十进制串），权益与未实现盈亏按它算 | 4 |
| next_run_at | INTEGER | 下一次该推进的时刻（下一根收盘 + 宽限）；归档没跟上 / 推进失败时改为 30 秒后；停止为 NULL。DO 只挂一个 alarm，拨到活跃部署里最早的这个时刻 | 4 | |
| snapshot_json | TEXT | NOT NULL | 引擎快照（账本 + 信号状态 + 挂单，格式版本 v: 1）；每次推进 / 改状态整列覆盖，列表查询不读它 | 4 |
| pause_reason | TEXT | 暂停原因 user / errors / dormant；只在 paused 时有值，恢复或停止时清空 | 5 | |
| stop_reason | TEXT | 停止原因 user / drawdown；只在 stopped 时有值。NULL 且已停止 = v4 旧行，按 user 读 | 5 | |
| max_drawdown_pct | TEXT | 回撤上限（百分比，十进制串），收盘权益从最高点回撤到它就自动停止；NULL = 不设（v4 旧行也是 NULL） | 5 | |
| peak_equity | TEXT | 启动以来最高收盘权益（回撤基准）；NULL = v4 旧行，按初始资金读 | 5 | |
| consecutive_errors | INTEGER | NOT NULL · DEFAULT 0 | 运行中交易根连续求值出错的根数；成功一根、恢复、换版本都清零，到 3 自动暂停 | 5 |
| muted | INTEGER | NOT NULL · DEFAULT 0 | 1 = 静音：开平仓与出错不推送（自动暂停 / 停止照常推送） | 5 |
| engine_version | TEXT | 上一次推进用的引擎版本；与当前 ENGINE_VERSION 不同时下次推进记一条 engine_upgraded。NULL = v4 旧行，按 2026.11.2.1 读 | 5 |
dormancy_checked_at：上次向 server 查所有者最近活跃时间的时刻，用来把休眠检查节流到每天一次。| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKkey | TEXT | PK | 键；当前只有 dormancy_checked_at | 5 |
| value | TEXT | NOT NULL | 值（TEXT）；dormancy_checked_at 存 epoch ms 的十进制串。没有这行 = 从没查到过 | 5 |
| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKid | TEXT | PK | 运行配置 ID（UUID） | 1 |
| FKscript_id | TEXT | FK→scripts.id · NOT NULL | 所属脚本 | 1 |
| created_at | INTEGER | NOT NULL | 创建时间（ms） | 1 |
| updated_at | INTEGER | NOT NULL | 最近一次修改时间（ms）；创建时等于 created_at | 1 |
| config_json | TEXT | NOT NULL | RunConfig JSON；写前经路由层 zod、读时经 RunConfigSchema.parse | 1 |
| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKday | INTEGER | PK | UTC 日起点（ms） | 3 |
| PKFKversion_id | TEXT | PK · FK→versions.id | 当天进过沙箱的版本 | 3 |
migrateStrategySchema 据 MAX(version) 决定从哪一版接着跑。| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKversion | INTEGER | PK | 迁移版本号（1 起连续） | 1 |
| applied_at | TEXT | NOT NULL | 应用时刻（ISO TEXT，库里唯一不是 ms 的时间列） | 1 |
versions；只建不改不删（没有改名 / 删除入口）。| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKid | TEXT | PK | 脚本 ID（UUID，createScript 生成） | 1 |
| name | TEXT | NOT NULL | 脚本名；也是部署推送里的标题（取不到时退回币名） | 1 |
| description | TEXT | NOT NULL | 说明文字，创建时写入，之后无修改入口 | 1 |
| created_at | INTEGER | NOT NULL | 创建时间（ms）；列表按它排序 | 1 |
| 字段 | 类型 | 约束 | 含义 | 迁移 |
|---|---|---|---|---|
| PKid | TEXT | PK | 版本 ID（UUID） | 1 |
| FKscript_id | TEXT | FK→scripts.id · NOT NULL | 所属脚本 | 1 |
| number | INTEGER | NOT NULL | 脚本内的版本号，从 1 起；appendVersion 按 MAX(number)+1 分配 | 1 |
| created_at | INTEGER | NOT NULL | 保存时间（ms） | 1 |
| dsl_version | INTEGER | NOT NULL | 保存时的 DSL 版本（DSL_VERSION） | 1 |
| source | TEXT | NOT NULL | 保存时的源码原文（官方模板则为模板源码） | 1 |
| template_id | TEXT | NOT NULL | 来源模板 id；用户写的版本存空串 ''（v1 列是 NOT NULL，只能用空串表示「无」），来源以 origin_kind 为准 | 1 |
| params_json | TEXT | NOT NULL | 静态取出的参数声明数组（ParamDeclaration[]） | 1 |
| compiled | TEXT | 转译产物，沙箱里实际执行的是它；NULL = v3 之前存下的旧行（只可能是官方模板），读时由 compiledOf 现转译 | 3 | |
| origin_kind | TEXT | 来源：user / official_template；NULL = v3 之前的旧行，按官方模板读 | 3 |
CREATE TRIGGER versions_immutable BEFORE UPDATE ON versions
BEGIN
SELECT RAISE(ABORT, 'strategy versions are immutable');
END