主题
附录 M:数据字典
逐表列定义(列/类型/注释/索引)。表名与实库一致;逻辑引用见 §7.6。
直接由生产库
information_schema导出。id/deleted/create_time/update_time四列在几乎所有表里都有,为节省篇幅统一省略(含义见 §7.3)。⚠️ 少数表的注释在生产库里有双重编码(迁移时连接字符集不匹配所致,见 §九), 本文档中的中文注释已按迁移脚本原文还原。
AI 域(27 张)
ai_care_checkin · 情感主动关怀:素材→消息→回复→记忆的可回溯链路(V43) · 约 15 行
列:checkin_date date — 归属日期(当日频次统计用)、topic_type varchar(16) — 素材来源:open_loop 未了线头 / emotion 情绪 / relation 关系 / todo 待办、topic_ref varchar(64) — 素材引用(线头 id / 记忆 id / 待办 id),人工可回溯、topic_key varchar(128) — 主题标识({topic_type}:{topic_ref}),跨天去重的依据、dedup_key varchar(160) — 幂等键 care:{topic_key}:w{窗口序号}(唯一索引兜底,防同窗口重复推送)、facts text — 本次引用的事实原文("凭什么发这条"的证据;不记则不填)、content varchar(512) — 实际发出的正文(模型润色失败时为模板原文)、status varchar(16) — sent 已投递 / failed 投递失败 / replied 博主已回复、fail_reason varchar(200) — 投递失败摘要(status=failed 时)、tokens int — 历史列:2026-11 扩展平台化后不再写入(润色 token 由微信桥侧记录);保留历史值、reply_text varchar(1024) — 博主回复原文(可空)、reply_memory_id bigint — 回复落到 ai_memory_item 的 id(可回溯到长期记忆)、replied_at datetime — 回复时间
索引:PRIMARY(id)、idx_care_date(checkin_date,status)、idx_care_topic(topic_key,checkin_date)、uk_care_dedup(dedup_key)
ai_chat_turn · AI 对话 turn · 约 2 行
列:conversation_id bigint — 会话 ID、request_id varchar(64) — 前端请求幂等键、user_message_id bigint — 用户消息 ID、assistant_message_id bigint — 助手消息 ID、dsh_session_id varchar(64) — 本轮使用的 DSH 会话、status varchar(16) — queued/running/completed/failed/cancelled、phase varchar(24) — queued/thinking/tool/finalizing、error_code varchar(64) — 错误码、error_detail varchar(500) — 错误详情(脱敏)、started_at datetime — 开始执行时间、finished_at datetime — 完成时间、retry_of bigint — 重试的原 turn
索引:PRIMARY(id)、idx_ai_chat_turn_conversation(conversation_id,create_time)、idx_ai_chat_turn_status(status,update_time)、uk_ai_chat_turn_request(request_id)
ai_conversation · AI 会话 · 约 105 行
列:title varchar(200) — 会话标题、scene varchar(30) — 场景:admin_avatar 博主分身 / admin_chat 普通对话 / portal_avatar 访客分身、visitor_id varchar(64) — 访客标识(portal 场景)、dsh_session_id varchar(64) — 对应 dsh session id;NULL=老会话/尚未建立
索引:PRIMARY(id)、idx_scene(scene)
ai_daily_digest · 每日总结(M42;一天一条,date 唯一) · 约 33 行
列:date date — 总结日期(一天一条,唯一键)、conversation_count int — 当天计入的会话数(agent_turn 按 session_id 去重)、turn_count int — 当天计入的对话行数(user/assistant)、todo_total int — 当天待办总数(daily_todo.due_date=当天)、todo_done int — 当天已完成待办数、emotion varchar(32) — 情绪(可空;M42 不产出,预留给 M45 情绪趋势)、summary_md text — 总结正文(Markdown;为空视为失败)、diary_md longtext — 日记正文(Markdown)、mood varchar(200) — 一句话情绪/状态(可空,只写明确表达)、diary_meta_json longtext — 日记元数据(结构/来源/守卫结果)、source_counts_json longtext — 素材计数(对话/待办/课程/事件/线头)、hindsight_used tinyint — 是否使用 Hindsight 长期背景、hindsight_refs_json longtext — Hindsight 背景引用(可空)、manual_edited tinyint — 人工是否编辑过(1=自动任务不得覆盖)、revision int — 当前版本号、data_complete tinyint — 生成时数据是否完整(0=可能迟到)、provisional tinyint — 是否临时稿(1=等待迟到数据复核)、generated_window_end datetime — 生成时的数据窗口末端、note_id bigint — 产出的私密笔记 ID(复用 module_note;笔记本身仅后台可达)、article_id bigint — 产出的文章草稿 ID(status=draft,绝不自动发布)、status varchar(16) — draft/note_only/drafted/ignored/failed(语义见文件头)、error varchar(512) — 失败原因;或跳过原因(ignored/failed 时非空)、model varchar(64) — 生成时的对话模型名(事后归因用,可空)、tokens int — 本次生成消耗的 token(prompt+completion)
索引:PRIMARY(id)、idx_digest_status_date(status,date)、uk_digest_date(date)
ai_diary_revision · 每日日记版本历史 · 约 20 行
列:date date — 日记日期、revision int — 版本号、diary_md longtext — 该版本正文、source varchar(32) — auto / manual / reconcile
索引:PRIMARY(id)、uk_diary_revision_date_rev(date,revision)
ai_digest_cursor · 每日总结增量水位(哪些会话行已被总结过) · 约 161 行
列:session_id varchar(64) — dsh 会话 ID(agent_turn.session_id)、last_line_no int — 已成功总结到的最大行号(agent_turn.line_no;只增不减)
索引:PRIMARY(id)、uk_digest_cursor_session(session_id)
ai_disagreement · V68 反谄媚:跨会话维护的分歧状态(不是观点清单) · 约 1 行
列:topic varchar(128) — 分歧的主题(一句话,可检索)、his_position varchar(512) — 他的立场(尽量用他的原话)、my_position varchar(512) — 我的立场(我说过的反对/保留意见)、status varchar(16) — 状态:open 未解决 / conceded 我被说服 / held 我坚持 / settled 已达成共识 / dropped 不提了、push_count tinyint — 已经提过几次(防复读机:提两次还没结果就该收口)、last_pushed_at datetime — 上次提起的时间(配合冷却)、source_ref varchar(128) — 来源定位(会话/记忆 id)
索引:PRIMARY(id)、idx_disagreement_pushed(status,last_pushed_at)、idx_disagreement_status(status,deleted)
ai_egress_log · AI 出网台账(每次出网一行计数:场景 + 各级条数 + 字节,绝不记正文) · 约 38986 行
列:scene varchar(64) — 出网场景:chat/embed 的 scene,或交付点标识(memory_search / instructions_recent / daily_brief_recent / agent_instructions 等)、channel varchar(16) — 出网通道:chat 对话 / embed 向量 / context 上下文注入或工具返回 / image 生图、provider_id bigint — AI 通道 id(channel=chat/embed 时有值)、level_public int — 本次出网内容里 public 级条数(构成不可知时记 0,不猜)、level_internal int — 本次出网内容里 internal 级条数、level_private int — 本次出网内容里 private 级条数(正常恒为 0;>0 = 拦截失效,告警信号)、blocked_count int — 被拦下(未出网)的 private 条数、bytes int — 本次实际送出的字节数(只记体量,不记正文)、blocked_bytes int — 被拦下的字节数、note varchar(255) — 判定说明(如 private_blocked:memory_search)
索引:PRIMARY(id)、idx_egress_create_time(create_time)、idx_egress_scene_time(scene,create_time)
ai_hs_ingest_cursor · Hindsight 增量摄取游标(PH6-5;与 ai_extract_cursor 分离) · 约 230 行
列:session_id varchar(64)、last_line_no int、last_hash char(64)、pending_operation_id varchar(64) — 已提交但尚未确认的 Hindsight operation ID、pending_line_no int — 该 operation 对应的待确认行号、pending_hash char(64) — 该 operation 对应最后一行内容哈希、pending_since datetime — 当前 pending operation 提交时间、operation_status varchar(16) — pending/processing/completed/failed/cancelled、retry_count int — 连续失败次数、content_format tinyint — 1=user-only 2=paired、next_retry_at datetime — 失败后的最早重试时间、last_error varchar(500) — 最近一次失败摘要(不含正文)、last_attempt_at datetime — 最近一次提交时间
索引:PRIMARY(id)、idx_hs_cursor_retry(operation_status,next_retry_at)
ai_hs_operation · Hindsight 异步 operation 日志 · 约 224 行
列:operation_id varchar(64) — Hindsight operation_id、business_key varchar(128) — 业务键,如 mem:123 / action:article:1、document_id varchar(200) — Hindsight document_id、operation_type varchar(32) — retain/delete/refresh、attempt_no int — 同一业务键的尝试序号、payload_hash char(64) — canonical payload SHA-256、content_hash char(64) — 正文 SHA-256、metadata_hash char(64) — metadata SHA-256、tags_hash char(64) — tags SHA-256、status varchar(16) — pending/submitted/completed/failed/cancelled/not_found/dead、next_retry_at datetime、last_error varchar(500)、created_at datetime、updated_at datetime
索引:PRIMARY(id)、idx_hs_op_business(business_key,attempt_no)、idx_hs_op_status(status,next_retry_at)
ai_hs_usage · 记忆使用计数(补偿 Hindsight 无 used_count) · 约 645 行
列:cosmos_id bigint、hit_count int、last_hit_at datetime
索引:PRIMARY(id)(无二级索引)
ai_kb_chunk · 知识库分段(分身记忆单元) · 约 714 行
列:document_id bigint — 文档 ID、chunk_index int — 分段序号、content text — 分段文本、embedding json — 向量(JSON 数组;MVP 内存余弦计算,预留向量库切换)、tokens int — 分段 token 数、is_public tinyint — 是否公开(冗余自知识库,检索层 SQL 硬过滤,防私有内容泄露)
索引:PRIMARY(id)、idx_chunk_deleted_time(deleted,update_time)、idx_document(document_id)、idx_public(is_public)
ai_kb_document · 知识库文档 · 约 150 行
列:kb_id bigint — 知识库 ID、title varchar(300) — 文档标题、source_type varchar(20) — 来源:upload / note / article / talk、source_id bigint — 来源内容 ID(自动同步时有效)、status tinyint — 0 待处理 1 已向量化 2 失败、chunk_count int — 分段数
索引:PRIMARY(id)、idx_document_deleted_time(deleted,update_time)、idx_kb(kb_id)、idx_source(source_type,source_id)
ai_knowledge_base · 知识库 · 约 7 行
列:name varchar(100) — 知识库名、description varchar(500) — 描述、is_public tinyint — 访客 AI 分身是否可检索、embed_model varchar(100) — 使用的 Embedding 模型
索引:PRIMARY(id)(无二级索引)
ai_mem_coverage · 覆盖率:回答"如果他不做,我们会不会知道"(v18 §2.2) · 约 158 行
列:day date — 日期、source varchar(16) — 来源:chat/manual/screenshot/device/voice/import、observed int — 当天该来源实到条数、system_used tinyint — 他当天是否用过系统(有对话或有事件)
索引:PRIMARY(id)、idx_day(day)
ai_mem_event · V67 生活事件(可聚合的度量,不是可检索的文本) · 约 10 行
列:kind varchar(24) — 事件类型:run/course/sleep/meal/photo/location/expense/health/other、occurred_from datetime — 发生时间(必填)、occurred_to datetime — 结束时间(可空;时长类才有)、place_name varchar(64) — 地点名(降精度后的,不存经纬度)、metric_num1 decimal(12,3) — 主度量(跑步=公里 / 睡眠=小时 / 消费=元)、metric_num2 decimal(12,3) — 次度量(配速 / 心率 / 次数)、metric_unit1 varchar(16) — 主度量单位、metric_unit2 varchar(16) — 次度量单位、note varchar(512) — 备注(人写的一句话)、extra json — 长尾信息(不参与任何聚合查询)、source varchar(24) — 来源:manual 手输 / device 设备 / image 截图 / import 导入、egress_level varchar(16) — V67 出网级别(与记忆的 privacy 正交):none 永不出网 / aggregate 只出聚合值 / full 原文可出网、hs_mirror_state varchar(16) — pending/mirrored/failed、hs_mirror_attempt int — 事件镜像尝试次数、hs_next_retry_at datetime — 事件镜像下次重试时间、hs_document_id varchar(128) — Hindsight document_id: cosmos:event:<id>、visitor_visible tinyint — V67 访客分身可见性(与 privacy 正交);默认 0
索引:PRIMARY(id)、idx_event_kind_num(kind,metric_num1)、idx_event_kind_time(kind,occurred_from)、idx_event_time(occurred_from)、idx_mem_event_mirror(hs_mirror_state,occurred_from)、idx_mem_event_mirror_retry(hs_mirror_state,hs_next_retry_at)
ai_mem_metric_schema · 度量语义映射(v18 §4.1):聚合只能引用 aggregatable=1 的槽 · 约 19 行
列:kind varchar(24) — 事件类型、slot tinyint — 槽位 1..4、name varchar(24) — 语义名:distance_km/pace_sec/hr_avg…、unit varchar(16) — 单位、aggregatable tinyint — 1=可进聚合 SQL / 0=只展示
索引:PRIMARY(id)(无二级索引)
ai_memory_archive · 结构化长期记忆(M41;向量走 ai_kb_chunk,本表只存结构化字段与来源) · 约 1397 行
列:type varchar(16) — 类型:fact 事实 / preference 偏好 / event 事件 / emotion 情绪 / relation 关系 / goal 目标、subject varchar(128) — 主语(可空;结构化三元组用,检索时做"同 subject 关系扩展")、predicate varchar(64) — 谓语(可空;同 subject+predicate 是 upsertFact 的冲突判定依据)、object varchar(512) — 宾语(可空)、text text — 自然语言文本(检索与展示的主字段,必填;也是向量化的输入之一)、confidence tinyint — 置信度 0-100:抽取任务取模型自评;MCP 显式写入默认 100("明确要求记住"视为可信)、importance tinyint — 重要度 0-100:检索重排加权 + 向量候选冷数据分层排序的依据、source_type varchar(16) — 来源类型:conversation 会话 / article 文章 / note 笔记 / talk 说说 / digest 每日总结 / manual 手工、source_id varchar(64) — 来源内容 ID(字符串而非数字:dsh 会话 ID 等非数字来源同样可存)、source_ref varchar(64) — 来源定位(形如 sessionId:lineNo):让"它为什么这么说"能回溯到原始会话行、source_scene varchar(16) — 来源场景:wechat=生活对话 / workbench=编码工作台 / other=未归类 / manual=非对话、valid_from datetime — 事实生效时间(可空;为空时按 create_time 参与 since/until 过滤)、valid_to datetime — 事实失效时间(superseded/rejected 时写入;NULL = 仍有效)、status varchar(16) — 状态:active 生效 / superseded 已被新事实取代 / rejected 已失效(人工否定或遗忘)/ pending 待人工确认、review tinyint — 1=待人工确认(中置信自动入库前的缓冲区),0=无需确认、used_count int — 被检索并交付给模型的累计次数(V61);0=从未被统计过,判定低效时需结合 create_time、last_hit_at datetime — 最近一次被检索命中的时刻(V61);NULL=从未命中、dormant tinyint — V63 淡出标记:1=长期未被使用,不参与自动注入但仍可检索;命中后自动唤醒、dedupe_key varchar(128) — 幂等键:type:sha256(归一化 subject|predicate|object|text) 前 32 位(规则见文件头)、privacy varchar(16) — 出网级别:public 可出网且可进公开产物 / internal 只出网到模型上下文(默认=今天的行为)/ private 不出网(不 embed、不进上下文,检索只回一句提示)、origin_class varchar(16) — 来源分级:owner 博主原话 / agent 助手自己的话或推断 / untrusted 注入块·工具结果·外部内容及一切判不出来的(fail-closed 落点)/ system 结构上确定是程序生成、provenance varchar(16) — 来源:told=他说的 / observed=我看到的 / inferred=我推的 / external=外部来的、fidelity varchar(16) — 保真:verbatim=原话 / paraphrase=转述 / summary=概括、verification varchar(16) — 核对:confirmed=他确认过 / unconfirmed、quote varchar(512) — 原话:仅当 provenance=told 且 fidelity=verbatim 时有值、valid_at datetime — V65 双时态:这件事在世界里从何时为真(NULL=未知/沿用 create_time)、invalid_at datetime — V65 双时态:从何时不再为真(改口/撤销时写入,不删除旧行)、change_kind varchar(16) — V65 改口类型:refine 细化 / revise 改口 / revoke 撤销 / NULL 无变化、superseded_by bigint — V65 改口链:被哪条新记忆取代(可回溯"这条怎么变成现在这样")、fidelity_zone tinyint — V66 保真区:1=存储永不压缩、不被上层替代(注入另算配额)、fidelity_level tinyint — V66 保真强度:100=永久 / 70=保真但可降格 / 0=普通、quote_budget tinyint — V66 每轮注入最多占几个名额(0=不占,仅他提起时用)、last_quoted_at datetime — V66 引用冷却:同一句原话 14 天内最多被主动引用一次、nuclear tinyint — V73 核心事件:1=永不淡出(与 fidelity_zone 正交:那个管"不被压缩",这个管"不被遗忘")、nuclear_note varchar(128) — V73 一句话记号(如「那晚他说撑不住」),供检索时人类可读地引用、archived_at datetime
索引:PRIMARY(id)、idx_memory_bi_temporal(status,invalid_at)、idx_memory_changed(change_kind,create_time)、idx_memory_dormant(status,dormant,used_count)、idx_memory_fidelity(fidelity_zone,status)、idx_memory_nuclear(nuclear,status)、idx_memory_provenance(provenance,status)、idx_memory_retention(status,deleted,update_time)、idx_memory_scene(source_scene,status,deleted)、idx_memory_source(source_type,source_id)、idx_memory_status_review(status,review)、idx_memory_type_status(type,status)、idx_memory_usage(used_count,last_hit_at)、idx_memory_valid_to(valid_to)、uk_memory_dedupe(dedupe_key)
ai_memory_procedure · V69 程序记忆:我们通常怎么办(一次不算流程) · 约 0 行
列:trigger_text varchar(200) — 触发条件(一句话,如「他说要发文章时」)—— 匹配靠它,不靠相似度、steps varchar(1000) — 步骤(有序,一行一步;这是"怎么做",不是"是什么")、why varchar(300) — 为什么这样做(他定的规矩 / 踩过的坑)—— 有理由的流程才容易被遵守、status varchar(16) — candidate 只见过一次(不注入)/ confirmed 已确认 / retired 已淘汰、evidence_count tinyint — 观察到几次;≥2 或他亲口确认才算 confirmed、last_used_at datetime — 上次生效的时间、use_count int — 生效过几次、source_ref varchar(128) — 来源定位(会话/记忆 id)
索引:PRIMARY(id)、idx_procedure_status(status,deleted)、idx_procedure_used(status,last_used_at)
ai_message · AI 消息 · 约 135 行
列:conversation_id bigint — 会话 ID、role varchar(20) — user / assistant / system、content longtext — 消息内容、tokens int — 消耗 token 数、extra_json json — 扩展(RAG 引用来源等)、feedback tinyint — 回答反馈:1 有用 / -1 没用 / NULL 未评价、turn_id bigint — 所属 turn、status varchar(16) — sent/streaming/done/failed/cancelled、error_code varchar(64) — 失败错误码
索引:PRIMARY(id)、idx_ai_message_turn(turn_id)、idx_conversation(conversation_id)
ai_narrative_chapter · V71 叙事章节:提取式(非生成式),必须承认证据密度 · 约 1 行
列:title varchar(128) — 章节标题(如「2026 年 10 月:把助理做成知己」)、period_start date — 覆盖起始日、period_end date — 覆盖结束日、summary varchar(2000) — 章节正文(提取式,不含臆测;必须写明"基于 N 天记录")、themes varchar(500) — 主要主题(按频次排序,逗号分隔)—— 来自 subject/predicate 的统计,不是猜的、mood_arc varchar(500) — 情绪弧(按时间排列的情绪记忆摘要;没有情绪记录时如实写"这段时间没有情绪记录")、key_events varchar(1000) — 关键事件(importance 高的条目)、covered_days smallint — 实际有记录的天数(不是时间跨度)、memory_count int — 支撑这条章节的记忆条数、density varchar(16) — thin / normal / rich、evidence_ids text — 支撑它的记忆 id(逗号分隔,供回溯)、status varchar(16) — draft / archived
索引:PRIMARY(id)、idx_chapter_period(period_end)、uk_chapter_period(period_start,period_end)
ai_open_loop · 未了线头:约定/悬念/未答问题,开场时自然带出(关系连续性) · 约 22 行
列:kind varchar(16) — 类型:promise 约定/承诺、question 未答的问题、thread 悬着的事、emotion 情绪尾巴、text varchar(512) — 一句话描述(脱离对话也能看懂,不要用"那件事"这类指代)、spoken_text varchar(512) — 可对人说的自然语言;为空时不得进入主动消息、due_at datetime — 时间锚(可空):约定/截止的具体时间、status varchar(16) — open 未了 / closed 已了 / dropped 已放弃、source_type varchar(16) — 来源:manual(AI 主动记)/ conversation(会话抽取)、source_id varchar(64) — 来源会话 id、source_ref varchar(64) — 来源定位(session:line),供人工回溯、mention_count int — 已被主动提起的次数、mention_budget int — 最多主动提起几次(用尽后不再主动提)、snoozed_until datetime — 主动暂停到该时刻(null=未暂停)、confidence tinyint — 置信度 0-100、closed_at datetime — 收口时间(closed/dropped 时写入)、stale_at datetime — 标记 stale 的时间(P0-5)
索引:PRIMARY(id)、idx_ai_open_loop_snoozed(status,snoozed_until)、idx_status_create(status,create_time)、idx_status_due(status,due_at)
ai_prompt_history · 助手提示词版本历史 · 约 0 行
列:section_key varchar(16) — 1/2/3/5/custom、content text — 保存后的内容;reset 时为 NULL、action varchar(16) — save/reset/restore、operator varchar(64) — 操作者(admin user id)
索引:PRIMARY(id)、idx_prompt_history_key_time(section_key,create_time)
ai_prompt_template · 提示词模板 · 约 12 行
列:name varchar(100) — 模板名、scene varchar(50) — 场景:avatar_persona 分军人设 / continue / polish / summary / title / custom、template text — 模板内容(支持 {变量} 占位)、variables varchar(500) — 变量名列表(逗号分隔)
索引:PRIMARY(id)(无二级索引)
ai_provider · AI 模型通道配置 · 约 0 行
列:name varchar(50) — 通道名(展示用)、type varchar(20) — 类型:new_api / deepseek / ollama、base_url varchar(300) — 接口地址、api_key varchar(500) — API Key(加密存储)、chat_model varchar(100) — 对话模型名、embed_model varchar(100) — Embedding 模型名、is_active tinyint — 是否当前启用(每类能力仅一条启用)、priority int — 优先级(故障切换顺序)
索引:PRIMARY(id)(无二级索引)
ai_ritual · V70 关系层:仪式与约定(proposed 不执行,只有 active 才到点注入) · 约 0 行
列:title varchar(64) — 仪式名(一句话,如「睡前道晚安」)、behavior varchar(500) — 具体做什么(给模型看的描述,不是给用户看的)、schedule_kind varchar(16) — daily 每天 / weekly 每周 / monthly 每月 / once 一次、schedule_spec varchar(64) — 时刻描述:daily=HH:mm;weekly=周几 HH:mm(1-7);monthly=几号 HH:mm;once=YYYY-MM-DD HH:mm、status varchar(16) — proposed 我提议的(不执行)/ active 已约定 / paused 暂停 / retired 不再做、last_done_at datetime — 上次做到的时间(用于判重:今天/这周/这月是否已做)、done_count int — 累计做到几次、source_ref varchar(128) — 来源(他说这句话的定位)
索引:PRIMARY(id)、idx_ritual_done(status,last_done_at)、idx_ritual_status(status,deleted)
ai_token_usage · AI token 用量记录 · 约 7669 行
列:provider_id bigint — 通道 ID、scene varchar(50) — 调用场景、prompt_tokens int — 输入 token、completion_tokens int — 输出 token、cost decimal(10,6) — 费用估算(元)
索引:PRIMARY(id)、idx_create_time(create_time)
扩展平台(24 张)
extension_approval · 高风险审批 · 约 1 行
列:installation_id bigint、version_id bigint、requested_capabilities_json json、manifest_checksum varchar(128)、requested_by varchar(64)、approved_by varchar(64)、status varchar(16) — pending/approved/rejected/expired、reason varchar(1000)、channel varchar(32)、session_ref varchar(128)
索引:PRIMARY(id)、idx_approval_status(status,create_time)、idx_approval_version(version_id)
extension_budget_ledger · 预算账本 · 约 26 行
列:installation_id bigint、period_type varchar(16) — day/month、period_key varchar(16)、messages int、prompt_tokens int、completion_tokens int
索引:PRIMARY(id)、uk_budget(installation_id,period_type,period_key)
extension_capability_call · Capability 调用审计 · 约 691 行
列:run_id bigint、seq int、capability varchar(64)、decision varchar(16) — allow/deny、input_hash varchar(128)、output_hash varchar(128)、bytes_in int、bytes_out int、status varchar(16)、duration_ms int、error varchar(1000)
索引:PRIMARY(id)、idx_cap_call_run(run_id,seq)、idx_cap_call_status(status,create_time)
extension_draft · 扩展草稿 · 约 23 行
列:package_key varchar(160)、base_version varchar(32)、manifest_json json、implementation_json json、code_text mediumtext、code_files_json json、status varchar(16) — editing/testing/ready/published、author varchar(64)
索引:PRIMARY(id)、idx_draft_key(package_key,status)
extension_effect · 副作用账本 · 约 19 行
列:run_id bigint、sequence int、capability varchar(64)、payload_json json、idempotency_key varchar(180)、status varchar(16) — pending/applying/applied/failed/skipped/abandoned、attempts int、max_attempts int、compensable tinyint、claimed_by varchar(128)、claimed_until datetime、next_retry_at datetime、result_json json、applied_at datetime、error varchar(1000)
索引:PRIMARY(id)、idx_effect_claim(status,next_retry_at)、idx_effect_status_time(status,create_time)、uk_effect_idem(idempotency_key)、uk_effect_run_seq(run_id,sequence)
extension_grant · 能力授权 · 约 92 行
列:installation_id bigint、version_id bigint、capability varchar(64)、scope_json json、scope_hash varchar(128)、approval_id bigint、risk varchar(16)、approved_by varchar(64)、status varchar(16)
索引:PRIMARY(id)、idx_grant_installation(installation_id)、uk_grant_version_cap(version_id,capability)
extension_installation · 扩展安装实例 · 约 9 行
列:package_id bigint、active_version_id bigint、status varchar(16) — pending/active/paused/disabled/retired、installed_by varchar(64)、installed_at datetime、disabled_reason varchar(500)
索引:PRIMARY(id)、idx_installation_status(status)、uk_installation_package(package_id)
extension_message · 统一消息账本 · 约 8 行
列:extension_key varchar(160)、installation_id bigint、run_id bigint、kind varchar(32)、target varchar(32)、slot varchar(32)、scheduled_at datetime、run_identity varchar(128)、title varchar(255)、content text、budget_class varchar(32)、dedup_key varchar(180)、status varchar(16) — pending/sent/failed/skipped、channel varchar(32)、sent_at datetime、error varchar(1000)
索引:PRIMARY(id)、idx_msg_inst_time(installation_id,create_time)、idx_msg_run(run_id)、idx_msg_status(status,create_time)、uk_msg_dedup(dedup_key)
extension_message_delivery · 消息通道投递 · 约 8 行
列:message_id bigint、channel_type varchar(32)、channel_id bigint、status varchar(16) — pending/sent/failed、attempts int — 本次投递尝试次数(失败行会被复用并 +1,不再每次重试插新行;2026-11-18 审查 #35)、next_retry_at datetime、sent_at datetime、error varchar(1000)、response_at datetime、response_text text
索引:PRIMARY(id)、idx_delivery_msg(message_id)、idx_delivery_retry(status,next_retry_at)
extension_package · 扩展包 · 约 9 行
列:package_key varchar(160) — 扩展稳定键、name varchar(128)、description varchar(1024)、origin varchar(16) — system/ai/user、owner varchar(64)、latest_version_id bigint、status varchar(16) — active/paused/retired
索引:PRIMARY(id)、idx_package_origin(origin,status)、uk_package_key(package_key)
extension_policy_decision · 策略决策 · 约 2787 行
列:run_id bigint、stage varchar(16) — before_run/before_effect、allowed tinyint、reason varchar(500)、policy_snapshot_json json、budget_snapshot_json json
索引:PRIMARY(id)、idx_policy_run(run_id,stage)
extension_run · 扩展运行记录 · 约 2719 行
列:installation_id bigint、version_id bigint、trigger_id bigint、scheduled_at datetime、run_identity varchar(128)、status varchar(16) — queued/running/succeeded/failed/partial/skipped/cancelled、attempt int、timeout_sec int、skip_reason varchar(500)、input_json json、output_json json、error varchar(1000)、model varchar(64)、prompt_tokens int、completion_tokens int、claimed_by varchar(128)、claimed_until datetime、heartbeat_at datetime、queued_at datetime、started_at datetime、finished_at datetime、next_retry_at datetime、cancel_requested tinyint、cancelled_at datetime、sources_json json、tool_calls_json json、session_id varchar(128)、dedup_key varchar(180)、dry_run tinyint
索引:PRIMARY(id)、idx_run_inst_time(installation_id,create_time)、idx_run_installation(installation_id,id)、idx_run_status(status,next_retry_at)、uk_run_dedup(dedup_key)、uk_run_identity(trigger_id,run_identity,attempt)
extension_run_event · 扩展运行日志 · 约 5509 行
列:run_id bigint、seq int、level varchar(8)、event_type varchar(64)、message varchar(1000)、data_json json
索引:PRIMARY(id)、idx_run_event(run_id,seq)
extension_secret · 扩展密钥 · 约 0 行
列:installation_id bigint、secret_key varchar(128)、encrypted_value text
索引:PRIMARY(id)、uk_secret_inst_key(installation_id,secret_key)
extension_state · 扩展 KV · 约 0 行
列:installation_id bigint、state_key varchar(128)、state_value mediumtext、state_version int
索引:PRIMARY(id)、uk_state_inst_key(installation_id,state_key)
extension_test_plan · dry-run 计划 · 约 0 行
列:draft_id bigint、run_id bigint、plan_json json、requested_hosts_json json、requested_private_json json、estimated_tokens int
索引:PRIMARY(id)、idx_test_draft(draft_id)
extension_trigger · 扩展触发器 · 约 9 行
列:installation_id bigint、trigger_key varchar(64)、type varchar(16) — schedule/event/webhook/manual/once、status varchar(16) — active/paused/completed/disabled、pause_reason varchar(20) — breaker/manual、config_json json、enabled tinyint、next_run_at datetime、prepare_lead_sec int、once_at datetime、last_run_at datetime、claimed_by varchar(128)、claimed_until datetime、catch_up_minutes int、max_attempts int、concurrency int、version_policy varchar(16) — follow/pin、pinned_version_id bigint
索引:PRIMARY(id)、idx_trigger_due(status,enabled,next_run_at)、idx_trigger_event(type,enabled)、uk_trigger_key(installation_id,trigger_key)
extension_version · 扩展不可变版本 · 约 23 行
列:package_id bigint、version varchar(32)、api_version varchar(32)、manifest_json json、implementation_json json、code_text mediumtext — script 源码、artifact_path varchar(512)、checksum varchar(128)、signature varchar(256)、signature_alg varchar(32)、signed_by varchar(64)、runtime_type varchar(16)、status varchar(16) — published/deprecated/retired、created_by varchar(64)
索引:PRIMARY(id)、idx_version_status(status)、uk_version_package(package_id,version)
extension_author_quota · AI 作者配额 · 约 1 行
列:author varchar(32)、drafts_per_day int、runs_per_hour int、tokens_per_day int
索引:PRIMARY(id)、uk_author_quota(author)
extension_capability · 扩展能力声明(P2-3 能力目录可扩展) · 约 1 行
列:capability_id varchar(96)、type varchar(16)、risk varchar(16)、data_class varchar(16)、egress tinyint、provider_package_key varchar(96)、status varchar(16) — pending/active/disabled、implemented tinyint — 1=实现已挂载、description varchar(255)
索引:PRIMARY(id)、uk_capability_id(capability_id)、idx_provider(provider_package_key)
extension_registry_entry · 本地包仓库索引(P1 预置) · 0 行
列:package_key varchar(64)、version varchar(32)、sha256 varchar(64)、path varchar(512)、capabilities_json json、risk varchar(16)
索引:PRIMARY(id)、uk_registry_key_version(package_key,version)
extension_repair_attempt · AI 自修台账 · 0 行
列:installation_id bigint、run_id bigint、signature varchar(128)、attempt int、patch_version_id bigint、outcome varchar(16) — success/failed/escalated、tokens int
索引:PRIMARY(id)、uk_repair_sig_attempt(installation_id,signature,attempt)、idx_repair_created(installation_id,create_time)
extension_spend_grant · 按天花费授权 · 0 行
列:installation_id bigint、period_key varchar(16) — Asia/Shanghai 的 YYYY-MM-DD、axis varchar(16) — SPEND/PRIVACY、tokens_granted int、approval_id bigint
索引:PRIMARY(id)、uk_spend_grant(installation_id,period_key,axis)
webhook_delivery · Webhook 重放防护 · 约 0 行
列:trigger_id bigint、delivery_id varchar(128)、nonce varchar(128)、timestamp bigint、payload_hash varchar(128)、status varchar(16)
索引:PRIMARY(id)、idx_webhook_delivery(trigger_id,delivery_id)、uk_webhook_nonce(trigger_id,nonce)
博客域(14 张)
blog_album · 相册 · 约 5 行
列:name varchar(100) — 相册名、cover varchar(500) — 封面、description varchar(500) — 描述、sort int — 排序
索引:PRIMARY(id)(无二级索引)
blog_article · 博客文章 · 约 64 行
列:title varchar(200) — 标题、content_md longtext — Markdown 原文、content_html longtext — 渲染后的 HTML(前台直出,省一次渲染)、cover varchar(500) — 封面图 URL、summary varchar(500) — 摘要(可 AI 生成)、category_id bigint — 分类 ID、is_top tinyint — 是否置顶、status tinyint — 0 草稿 1 发布 2 下架、publish_time datetime — 定时发布时间(到点自动发布)、visibility tinyint — 0 公开 / 1 仅管理员可见(前台完全不存在)、kb_id bigint — 指定知识库(NULL=按可见性自动分流)、view_count int — 阅读量、like_count int — 点赞数、comment_open tinyint — 是否开放评论、reward_open tinyint — 文章级赞赏开关、source_type tinyint — 0 原创 1 笔记导入、note_id bigint — 来源笔记 ID(source_type=1 时有效)、series_id bigint — 所属系列(NULL 不属于任何系列)、series_order int — 系列内序号(升序)、word_count int — 字数
索引:PRIMARY(id)、idx_admin_visibility(visibility,status,deleted)、idx_article_kb(kb_id)、idx_article_publish_time(publish_time,status,deleted)、idx_article_series(series_id,series_order,deleted)、idx_category(category_id)、idx_portal_list(status,visibility,deleted,is_top,create_time)、idx_status_time(status,create_time)
blog_article_history · 文章历史版本(回滚功能 M8 实现,先记录快照) · 约 34 行
列:article_id bigint — 文章 ID、version int — 版本号(递增)、title varchar(200) — 标题快照、content_md longtext — 内容快照
索引:PRIMARY(id)、uk_article_version(article_id,version)
blog_article_tag · 文章-标签关联 · 约 47 行
列:article_id bigint — 文章 ID、tag_id bigint — 标签 ID
索引:PRIMARY(id)、uk_article_tag(article_id,tag_id)
blog_category · 文章分类 · 约 11 行
列:name varchar(50) — 分类名、sort int — 排序(越小越前)
索引:PRIMARY(id)(无二级索引)
blog_comment · 评论 · 约 0 行
列:article_id bigint — 文章 ID(留言为空,见 blog_message)、parent_id bigint — 父评论 ID(楼中楼)、nickname varchar(50) — 评论人昵称、email varchar(100) — 评论人邮箱、website varchar(200) — 评论人网站、content text — 评论内容、is_admin tinyint — 是否博主回复、status tinyint — 0 待审 1 通过 2 拒绝、ai_flag tinyint — AI 审核:0 未审/正常 1 可疑 2 违规、ai_reason varchar(200) — AI 审核说明(可疑/违规原因)、ip varchar(50) — IP、ua varchar(500) — User-Agent、like_count int — 点赞数、is_top tinyint — 是否置顶:0 否 1 是
索引:PRIMARY(id)、idx_article(article_id,status)
blog_friend_link · 友链(支持访客申请) · 约 0 行
列:name varchar(50) — 站点名、url varchar(300) — 站点地址、avatar varchar(500) — 头像、description varchar(500) — 描述、status tinyint — 0 待审 1 通过 2 拒绝
索引:PRIMARY(id)(无二级索引)
blog_message · 留言板 · 约 0 行
列:parent_id bigint — 父留言 ID(博主回复时指向原留言)、nickname varchar(50) — 昵称、email varchar(100) — 邮箱、content text — 留言内容、is_admin tinyint — 是否博主回复、status tinyint — 0 待审 1 通过 2 拒绝、ai_flag tinyint — AI 审核:0 未审/正常 1 可疑 2 违规、ai_reason varchar(200) — AI 审核说明(可疑/违规原因)、ip varchar(50) — IP、ua varchar(500) — User-Agent
索引:PRIMARY(id)(无二级索引)
blog_page · 自定义页面 · 约 6 行
列:title varchar(100) — 页面标题、slug varchar(100) — 访问路径标识,如 about、content_md longtext — Markdown 原文、content_html longtext — 渲染后 HTML、sort int — 排序、status tinyint — 0 隐藏 1 展示、show_in_nav tinyint — 是否展示在导航
索引:PRIMARY(id)、uk_slug(slug)
blog_photo · 照片 · 约 1 行
列:album_id bigint — 相册 ID、url varchar(500) — 照片 URL、description varchar(500) — 描述、sort int — 排序
索引:PRIMARY(id)、idx_album(album_id)
blog_series · 系列专栏 · 约 0 行
列:name varchar(64) — 系列名称、slug varchar(64) — URL 标识、description varchar(500) — 系列简介、cover varchar(500) — 系列封面、sort int — 排序(升序)
索引:PRIMARY(id)、uk_series_slug(slug,deleted)
blog_snippet · 内容片段库(可复用 Markdown 块) · 约 0 行
列:title varchar(128) — 片段标题(用于检索与插入)、content_md text — 片段内容(Markdown)、category varchar(32) — 分类标签(自定义,如"署名/免责/工具链")、sort int — 排序(升序)、use_count int — 被插入次数
索引:PRIMARY(id)、idx_snippet_category(category,sort)
blog_tag · 文章标签 · 约 53 行
列:name varchar(50) — 标签名
索引:PRIMARY(id)(无二级索引)
blog_talk · 说说 / 短动态 · 约 9 行
列:content text — 说说内容、images json — 图片 URL 数组、is_top tinyint — 是否置顶、is_public tinyint — 是否纳入访客 AI 分身检索范围、status tinyint — 0 隐藏 1 展示、like_count int — 点赞数
索引:PRIMARY(id)(无二级索引)
系统域(13 张)
sys_api_key · 开放 API 密钥 · 约 6 行
列:name varchar(64) — 用途名称(如"移动端写作")、key_prefix varchar(16) — Key 前缀(展示用,便于识别)、key_hash varchar(128) — Key 的 SHA-256 哈希(不存明文)、scopes varchar(255) — 权限范围:read / write(逗号分隔)、enabled tinyint — 启用开关、last_used_time datetime — 最后使用时间
索引:PRIMARY(id)、idx_api_key_hash(key_hash)
sys_audit_log · 后台敏感操作审计日志 · 约 821 行
列:action varchar(64) — 动作标识,如 article.delete / config.save、module varchar(32) — 所属模块:blog/note/ai/system、target varchar(255) — 操作对象描述(标题/键名等)、detail varchar(1000) — 补充说明、ip varchar(64) — 操作来源 IP、ua varchar(500) — User-Agent、success tinyint — 是否成功:1 成功 0 失败
索引:PRIMARY(id)、idx_audit_action(action)、idx_audit_time(create_time)
sys_config · 站点配置(KV + JSON) · 约 172 行
列:config_key varchar(100) — 配置键,如 site.name / reward.enabled、config_value text — 配置值(JSON 字符串)、remark varchar(200) — 配置说明
索引:PRIMARY(id)、uk_config_key(config_key)
sys_file · 附件 · 约 270 行
列:file_name varchar(200) — 原始文件名、url varchar(500) — 访问 URL、storage_type varchar(20) — 存储类型:local / oss、size bigint — 文件大小(字节)、content_type varchar(100) — MIME 类型、folder_id bigint — 所属分组(NULL 表示未分组)、alt varchar(255) — 无障碍替代文本(图片 alt)
索引:PRIMARY(id)、idx_file_folder(folder_id,deleted)
sys_file_folder · 媒体库分组 · 约 1 行
列:name varchar(64) — 分组名称、sort int — 排序(升序)
索引:PRIMARY(id)、idx_file_folder_sort(sort,deleted)
sys_job_log · 定时任务执行日志 · 约 1770 行
列:job_name varchar(64) — 任务名、trigger_type varchar(16) — 触发方式:schedule/manual、status varchar(16) — 状态:success/fail/running、message varchar(1000) — 结果说明或失败原因、cost_ms bigint — 耗时(毫秒)
索引:PRIMARY(id)、idx_job_name_time(job_name,create_time)
sys_login_log · 登录日志 · 约 383 行
列:username varchar(32) — 登录用户名、ip varchar(50) — 客户端 IP、user_agent varchar(500) — User-Agent、status tinyint — 1 成功 0 失败、message varchar(200) — 失败原因等
索引:PRIMARY(id)、idx_username_time(username,create_time)
sys_mail_log · 邮件投递日志(失败队列数据源) · 约 30 行
列:mail_type varchar(32) — 类型:test/comment-reply/comment-audit/subscribe/article-notify/report/login-alert、to_addr varchar(255) — 收件人、subject varchar(255) — 主题、status varchar(16) — 状态:success/fail/pending、error varchar(1000) — 失败原因、payload text — 重试所需的最小载荷(JSON)、retry_count int — 重试次数
索引:PRIMARY(id)、idx_mail_status(status,create_time)
sys_search_log · 站内搜索日志(搜索词报告数据源) · 约 33 行
列:keyword varchar(128) — 搜索关键词、scope varchar(32) — 搜索范围:all/article/page/talk、result_count int — 命中结果数(0 用于选题挖掘)、ip varchar(64) — 来源 IP、visit_date date — 冗余日期,便于按天聚合
索引:PRIMARY(id)、idx_search_date(visit_date,deleted)、idx_search_keyword(keyword)
sys_subscriber · 邮件订阅者 · 约 0 行
列:email varchar(128) — 订阅邮箱、nickname varchar(64) — 称呼(可空)、status tinyint — 1 订阅中 / 0 已退订
索引:PRIMARY(id)、uk_email_deleted(email,deleted)
sys_user · 系统用户(单博主场景仅一行) · 约 1 行
列:username varchar(32) — 用户名、password varchar(100) — 密码(BCrypt 哈希)、nickname varchar(32) — 昵称、avatar varchar(500) — 头像 URL、email varchar(100) — 邮箱、token_version int — 令牌版本:自增即让此前签发的 JWT 全部失效、totp_secret varchar(255) — TOTP 密钥(AES-GCM 密文)、totp_enabled tinyint — 两步验证开关:1 开 0 关、totp_recovery varchar(1024) — 两步验证一次性恢复码(SHA-256 十六进制、逗号分隔;明文仅设置时下发一次)、totp_last_step bigint — 两步验证防重放:最近一次通过的动态码时间步
索引:PRIMARY(id)、uk_username(username)
sys_visit_log · 访问日志 · 约 906 行
列:ip varchar(50) — 客户端 IP、ua varchar(500) — User-Agent、path varchar(300) — 访问路径、referrer varchar(500) — 来源页、visit_date date — 访问日期(冗余,便于按天统计)
索引:PRIMARY(id)、idx_visit_date(visit_date)
sys_widget · 展示部件(区域+部件模型) · 约 17 行
列:zone varchar(40) — 区域标识:header-banner/home-top/sidebar/footer-left/footer-center/footer-right/article-before/article-after、type varchar(40) — 部件类型:text_html/link_list/tag_cloud/category_list/stat/latest_articles/search_box/profile_card、title varchar(100) — 部件标题(可为空)、config_json text — 部件参数 JSON(按 type 解释)、sort int — 区域内排序、enabled tinyint — 是否启用、device tinyint — 可见设备:0 全部 / 1 仅桌面 / 2 仅移动
索引:PRIMARY(id)、idx_zone_sort(zone,sort)
采集与助手(7 张)
agent_ingest_log · 会话摄取水位与最近错误 · 约 252 行
列:session_id varchar(64) — dsh 会话 ID、token_name varchar(64) — 摄取方令牌名(请求留痕:谁在什么时候摄取了哪个会话)、last_line_no int — 水位:已成功接收的最大行号(采集器只发 > 水位的行)、last_line_hash char(64) — 水位对应行的 sha256(对账水位未错位)、ingested_lines int — 累计接收行数(含重复跳过,反映采集器已投递进度)、status varchar(16) — ok / partial 有解析降级 / error 有错误、error varchar(1000) — 最近一次错误摘要(仅行号与异常类型,绝不含 payload 内容)、duration_ms int — 最近一次摄取耗时(毫秒)
索引:PRIMARY(id)、uk_ingest_session(session_id)
agent_session · dsh 会话索引(可自 ~/.dsh/sessions 重建) · 约 252 行
列:session_id varchar(64) — dsh 会话 ID(header 行 id,采集器上报)、cwd_slug varchar(191) — dsh 会话目录 slug(如 --root-code--,空格等特殊字符被 dsh 编码)、source varchar(32) — wechat/admin_chat/code/dsh_terminal/unknown、workspace_id bigint — 预留:博客工作区 ID(v1 不填充,供 M48+ 关联生活域)、model varchar(80) — 会话模型(model/selection 事件提取,可空)、started_at datetime — 会话开始时间(header createdAt 毫秒 epoch 换算,可空)、ended_at datetime — 最后事件时间(可空;采集中会持续推进)、turn_count int — turn/end 事件累计计数(增量累加)、raw_sha256 char(64) — 整份会话文件的 sha256(采集器上报,对账用,可空)、schema_version varchar(16) — 会话 schema 版本(header version,观测 4;更高版本不报错)、status varchar(16) — active 采集中 / ingested 已采完(预留 finalize)/ error 有解析错误
索引:PRIMARY(id)、idx_agent_session_source(source)、uk_agent_session(session_id)
agent_session_raw · dsh 会话 RAW 行(可自 ~/.dsh/sessions 重建) · 约 22416 行
列:session_id varchar(64) — dsh 会话 ID、line_no int — 行号(1 起,多帧解压后的物理行序)、line_hash char(64) — 该行原文的 sha256(幂等键的一半;服务端按收到文本重算)、payload longtext — JSON 行原文(逐字节保留,绝不改写、绝不丢弃)
索引:PRIMARY(id)、idx_raw_deleted_time(deleted,create_time)、uk_raw_line(session_id,line_no,line_hash)
agent_token · dsh 专用令牌 · 约 3 行
列:name varchar(64) — 令牌用途名(如 dsh-collector)、token_prefix varchar(16) — 明文前缀(展示用,便于识别是哪一把)、token_hash char(64) — 明文 token 的 sha256(不存明文;比对用常量时间)、scopes varchar(255) — 权限范围(逗号分隔;v1 仅 agent:ingest)、ip_allow varchar(255) — IP 白名单(逗号分隔;空=默认仅 127.0.0.1/::1 本机)、rate_limit int — 每分钟请求上限(0=不限)、expires_at datetime — 过期时间(空=不过期)、last_used_at datetime — 最后使用时间(识别僵尸令牌)、enabled tinyint — 启用开关:1 启用 0 停用
索引:PRIMARY(id)、idx_agent_token_hash(token_hash)、uk_agent_token_name(name)
agent_tool_call_log · MCP 工具调用审计(§18.4 / AD-16) · 约 39773 行
列:tool varchar(64) — MCP 工具短名(memory_search / daily_brief …)、args_digest char(64) — 参数规范化 JSON 的 sha256(判定"同一次调用",不落正文)、args_keys varchar(255) — 参数顶层键名(逗号分隔):只暴露调用形状,不暴露内容、result_bytes int — 返回文本字节数(结果预算是否生效可回查)、cost_ms int — 耗时毫秒(60s 超时预算是否逼近可回查)、ok tinyint — 1 成功 0 失败(含工具级 isError 与权限拒绝)、error varchar(512) — 失败原因(已截断)、caller varchar(64) — 调用方令牌名(agent_token.name)、ip varchar(64) — 来源 IP(应恒为 127.0.0.1)
索引:PRIMARY(id)、idx_create_time(create_time)、idx_tool_time(tool,create_time)
agent_turn · dsh 会话行解析视图(可重放重建) · 约 110184 行
列:session_id varchar(64) — dsh 会话 ID、line_no int — 对应 agent_session_raw.line_no、line_hash char(64) — 对应 agent_session_raw.line_hash;与 session/line 组成幂等唯一键、role varchar(16) — 消息角色(data.message.role / data.role:user/assistant/tool/system/developer)、ts bigint — 事件毫秒 epoch(顶层 time 原值;不换算为 DATETIME 以避免时区歧义)、content longtext — 消息文本(仅拼接 content[] 中 type=text 的块;完整原文见 RAW 表)、tool_calls_json longtext — 工具调用摘要 JSON(tool/call 的 {callId,name,arguments};assistant 内嵌 tool-call 块)、tokens int — 该事件 usage.totalTokens(仅 assistant/message 携带,可空)、kind varchar(16) — user/assistant/tool/system/unknown(unknown=系统事件、未识别类型或解析失败)、source_kind varchar(32) — raw 的 data.source.kind;空串=raw 在但没写 source;NULL=raw 缺失、source_rpc_id varchar(64) — raw 的 data.source.rpcId(用于区分微信侧/网页侧)
索引:PRIMARY(id)、idx_turn_deleted_role_ts(deleted,role,ts)、idx_turn_deleted_session_kind_ts(deleted,session_id,kind,ts)、idx_turn_kind_source(kind,source_kind)、idx_turn_ts(ts)、uk_turn_session_line_hash(session_id,line_no,line_hash)
agent_turn_attachment · agent_turn ↔ 附件 · 约 0 行
列:turn_id bigint、attachment_id bigint、role varchar(16)
索引:PRIMARY(id)、idx_turn_attachment_attachment(attachment_id)、uk_turn_attachment(turn_id,attachment_id)
日程域(5 张)
daily_course_session · 课程日课表(M165,按天记录) · 约 92 行
列:name varchar(64) — 课程名、teacher varchar(64) — 教师(可空)、place varchar(128) — 地点(可空)、session_date date — 上课日期(这一条课次属于哪一天)、start_time time — 开始时间、end_time time — 结束时间、color varchar(16) — 卡片色(#rrggbb,可空)、source varchar(32) — 来源:import(课表导入)/ manual(口述补录)、natural_key varchar(255) — 活跃课程自然键(日期#课程名#开始时间);删除行=NULL,供唯一索引使用、natural_key2 varchar(255) — 活跃课程自然键(日期#名称长度:名称#开始时间);删除行=NULL
索引:PRIMARY(id)、idx_course_session_date(session_date,start_time)、uk_course_active_natural_v2(natural_key2)
daily_holiday · 节假日与调休(M55 / V46):外部源刷新,覆盖域可自述 · 约 39 行
列:holiday_date date — 日期、is_off_day tinyint(1) — 1=放假 0=补班日(中国调休:本该休息却要上班)。判定只看这一列,不看 name、name varchar(64) — 节日名(仅展示用;补班日的取值未经核实,故不参与判定)、source_year int — 覆盖域:这一行来自哪一年的数据文件。判定的第一道闸门 —— 查不到覆盖域就判 UNKNOWN,绝不判"不是节假日"、source varchar(255) — 数据来源(URL),逐行留痕以便回溯每个答案的依据、fetched_at datetime — 拉取时刻;配合 status() 回答"数据是不是停更了"
索引:PRIMARY(id)、idx_holiday_year(source_year)、uk_holiday_date(holiday_date,deleted)
daily_reminder · 提醒投递计划(M38;DB 轮询投递,无 MQ) · 约 134 行
列:target_type varchar(16) — 目标类型:todo / course / custom、target_id bigint — 目标 ID(custom 可空)、remind_at datetime — 计划提醒时刻、channel varchar(16) — 投递通道:mail / inapp(邮件不可用时降级为 inapp=仅站内呈现,只写库不发送)、title varchar(255) — 提醒标题、content varchar(1000) — 提醒正文、status varchar(16) — 状态:pending / sent / failed / skipped、sent_at datetime — 实际投递时间、retry int — 重试次数(M38 只记一次失败不自动重试;重试链路随 M39 通知通道抽象)、error varchar(500) — 失败/跳过原因(超窗跳过、已完成取消、邮件失败等)、dedup_key varchar(128) — 幂等键(防重复投递的核心;构成规则见文件头)、locked_until datetime — 领取租约到期时间(P0-2)、locked_by varchar(64) — 领取实例标识(P0-2)、is_test tinyint — 1=通道测试记录,不计入日常提醒统计、source varchar(16) — plan / custom / test
索引:PRIMARY(id)、idx_reminder_claim(status,remind_at)、idx_reminder_daily(is_test,target_type,remind_at)、uk_reminder_dedup(dedup_key)
daily_todo · 待办(M38;"今日待完成"的唯一数据源) · 约 157 行
列:title varchar(255) — 标题、parent_id bigint — 所属父待办 id(NULL=顶层待办;仅一层:步骤的父必须也是顶层)、series_id bigint — 所属重复系列 id;NULL=单次待办/步骤(M168)、occurrence_override tinyint — 1=仅本次修改过;系列“今天及未来”编辑跳过该实例(M168)、step_no smallint — 第几步(1 起;仅步骤行有值,重排后按顺序重编号)、sort_no int — 同父内排序权重(相同则按 step_no;重排接口整体重写本列)、note varchar(1000) — 备注(可空)、due_date date — 截止日期、due_time time — 截止时刻(可空;为空表示"当天任意时间",不生成提前提醒)、priority tinyint — 优先级:0 普通 / 1 重要 / 2 紧急、status varchar(16) — 状态:todo / doing / done / dropped、done_at datetime — 完成时间(done 时写入,undo 时清空)、dropped_at datetime — 放弃时间(dropped 时写入,restore 清空)、drop_reason varchar(255) — 放弃/跳过原因:user_dropped / skipped_occurrence / series_stopped、remind_before int — 提前提醒分钟数(可空=用全局默认 daily.todo.default-remind-before)、repeat_rule varchar(64) — 重复规则(M38 先只存不解析,供后续重复任务使用)、source varchar(16) — 来源:manual / ai / paper / article、source_id bigint — 来源内容 ID(如论文转待办存 ai_paper.id;M43 补列,供去重与回指)、tags varchar(255) — 标签(逗号分隔)
索引:PRIMARY(id)、idx_todo_done(status,done_at)、idx_todo_due(due_date,status)、idx_todo_parent(parent_id,sort_no,step_no)、idx_todo_status_due(status,due_date)、uk_todo_series_occurrence(series_id,due_date)
daily_todo_series · 重复待办系列(规则;实例在 daily_todo) · 约 2 行
行数放大说明(2026-11-17 审查 #17 实测):新建一个「每天/每周」重复待办时, 系统会立即在
daily_todo里生成到今天 +60 天的实例(实测一个 daily 系列一次生成 61 行, 现网两个老系列各 72 行),之后DailyTodoSeriesJob(每天 03:10)把 active 系列滚动补到 today+60。 也就是说:每条重复待办 ≈ 60–72 行daily_todo,删系列时要一并清实例。 这是有意设计(日历要看得到未来),但会对"待办行数"的直觉产生很大偏差。
列:title varchar(255) — 标题(实例生成时的默认标题)、note varchar(1000) — 备注、due_time time — 默认截止时刻(可空=当天任意时间)、priority tinyint — 0 普通 / 1 重要 / 2 紧急、remind_before int — 提前提醒分钟数(空=全局默认)、repeat_rule varchar(64) — daily / weekdays / weekends / weekly:1,3,5、start_date date — 系列起始日期(首个实例日期)、end_date date — 系列结束日期;NULL=无限滚动生成、source varchar(16) — manual / ai / article、source_id bigint — 来源内容 id、tags varchar(255) — 标签(逗号分隔)、is_active tinyint — 1=生成中 0=已停止、materialized_until date — 已物化到的最后日期
索引:PRIMARY(id)、idx_series_active(is_active,materialized_until)、idx_series_deleted(deleted,is_active)、uk_series_source(source,source_id)
笔记域(5 张)
note_history · 笔记历史版本(预留) · 约 38 行
列:note_id bigint — 笔记 ID、version int — 版本号、content_md longtext — 内容快照
索引:PRIMARY(id)、idx_note(note_id)
note_note · 笔记 · 约 42 行
列:notebook_id bigint — 所属笔记本、kb_id bigint — 指定知识库(NULL=跟随笔记本/默认私人记忆库)、title varchar(200) — 标题、content_md longtext — Markdown 原文、content_text longtext — 纯文本(搜索用,不含 Markdown 符号)、is_star tinyint — 是否星标、is_top tinyint — 是否置顶、status tinyint — 0 回收站 1 正常、published_article_id bigint — 已发布为文章时的文章 ID
索引:PRIMARY(id)、ft_title_content(title,content_text)、idx_note_note_kb(kb_id)、idx_notebook(notebook_id)
note_note_tag · 笔记-标签关联 · 约 0 行
列:note_id bigint — 笔记 ID、tag_id bigint — 标签 ID
索引:PRIMARY(id)、uk_note_tag(note_id,tag_id)
note_notebook · 笔记本(树形) · 约 4 行
列:parent_id bigint — 父笔记本 ID(树形)、name varchar(100) — 笔记本名、kb_id bigint — 该笔记本下笔记的默认知识库(NULL=私人记忆库)、icon varchar(50) — 图标、sort int — 排序
索引:PRIMARY(id)、idx_parent(parent_id)
note_tag · 笔记标签(与文章标签独立) · 约 0 行
列:name varchar(50) — 标签名
索引:PRIMARY(id)(无二级索引)
通知与主动(3 张)
notify_channel · 通知通道(M39;通道抽象,§17.5.7) · 约 3 行
列:type varchar(16) — 通道类型:email / webhook / inapp(与 NotifySender#type 对应)、name varchar(64) — 展示名(后台可见)、enabled tinyint — 是否启用:1 启用 0 停用、priority int — 优先级:小=优先(IM 10 < 邮件 50 < 站内 100)、config_json text — 通道实例配置(JSON,整体密文入库:可能含 token/device_key 等敏感字段,读写走 CryptoUtil;webhook 参数优先取本字段、缺省回退 site.notify.webhook.* 配置键)
索引:PRIMARY(id)、idx_channel_pick(enabled,priority)
notify_log · 通知投递记录(M39;失败可自证与重试,无 MQ 靠 DB 轮询) · 约 214 行
列:channel_id bigint — 实际投递的通道行 id(inapp 兜底 / 无对应行时为 NULL)、channel_type varchar(16) — 实际投递通道类型:email / webhook / inapp、title varchar(255) — 标题(IM 推送的标题行)、content text — 正文(可空;各 IM 的 body 字段形态由 Sender 组装)、status varchar(16) — 状态:pending 投递中(幂等占位)/ sent 已送达(含站内兜底)/ failed 外部通道失败(可重试)/ skipped 重复拦截、error varchar(512) — 失败/跳过原因摘要(不记响应体正文,只记状态码与错误摘要)、retry int — 重试次数(NotifyRetryJob 扫 failed 且 retry<2 重投)、dedup_key varchar(128) — 幂等键(同一键只投一次;构成规则见文件头)、link_ids varchar(512) — 关联对象 id,逗号分隔;可空、target varchar(128) — 投递目标(收件人 / 设备号等,可空;仅审计展示用)、sent_at datetime — 送达时间
索引:PRIMARY(id)、idx_notify_channel(channel_type,status)、idx_notify_retry(status,create_time)、uk_notify_dedup(dedup_key)
proactive_log · 主动性预算与去重账本(M44;超限降级为静默记录,不静默失败) · 约 83 行
列:kind varchar(32) — 类型:morning_brief / evening_brief / care / open_loop / interview / weekly_review / reminder / custom(扩展 handler 写入的就是这些值)、date date — 归属日期(预算按天统计;与 kind 组合定位"当天是否已处理")、dedup_key varchar(128) — 幂等键:{kind}:{yyyy-MM-dd}(含 skipped——跳过也算处理过,当天不再重试)、status varchar(16) — 状态:sent 已发(扩展 handler 只写这一种);skipped / failed 是旧 Job 时期的行,扩展路径的跳过原因改看 extension_policy_decision 与运行日志、responded_at datetime — 首次收到用户原话的时刻(NULL=还没等到)、judged_at datetime — 判定时刻:超过观察窗口仍无回应时写入(NULL=尚未判定)、response_lag_minutes int — 从发出到回应的分钟数(仅回复时填写,用于看"它的话有没有被接住")、reason varchar(255) — 跳过 / 失败原因(budget / quiet_hours / no_facts / 投递错误摘要)、tokens int — 历史列:2026-11-18 起不再写入(主动润色 token 由微信桥侧记录),保留历史值
索引:PRIMARY(id)、idx_proactive_date(date,kind)、idx_proactive_judge(responded_at,judged_at,create_time)、uk_proactive_dedup(dedup_key)
会话(1 张)
chat_attachment · 聊天附件元数据(私密) · 约 2 行
列:session_id varchar(64) — DSH session / product conversation 关联、message_key varchar(128) — 微信 msg_id/svr_id;网页消息可空、owner_type varchar(32) — agent_session/ai_conversation/visitor、owner_id varchar(64) — 归属 ID、source varchar(32) — wechat/web/agent、kind varchar(16) — image/video/audio/file、original_name varchar(255)、mime varchar(128)、size bigint、sha256 char(64)、storage_key varchar(512)、status varchar(16) — stored/failed/expired
索引:PRIMARY(id)、idx_attachment_create(create_time)、idx_attachment_session(session_id)、idx_attachment_status(status)、uk_attachment_dedupe(owner_type,owner_id,message_key,sha256)
其它
flyway_schema_history