yilunjiang/AgentLab
1
0
Fork 0
mirror of https://github.com/ThearchyHelios/AgentLab.git synced 2026-11-15 00:11:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Commit Graph

  • 9e5debfb33 合入文档重新梳理：README 中英各精简成介绍和索引（是什么、为什么用、主要功能、快速开始、部署、文档索引），细节按主题拆进 docs/zh-CN 与 docs/en（17 篇一一对应：问数据、工作流、证据与出具及复核套件、数据源、数据目录、工具、应用、评测与口径账本、定时与通知、部署、配置、PostgreSQL 与多进程、身份与安全、架构、开发、升级说明、常见问题），英文文档不含中文；代码和部署文档里指向 README 章节的地方改指新文档；新增 scripts/check-docs.py（英文文档中文字符、相对链接与锚点、中英对应） ThearchyHelios 2026-10-21 10:56:05 +08:00
  • 27175e2f5e 文档：「界面里的设置」表照设置页的实际页签改——偏好设置补上运行默认值、证据裁判、核查、口径账本、应用一节和界面主题；去掉不存在的「设置 → 应用」页签（应用那几项在偏好设置里，apps、identity-and-security 两篇里的说法一起改），补上「审计」页签；中英两边同步 ThearchyHelios 2026-10-21 10:55:41 +08:00
  • 1ad087c387 文档补充：复核套件逐项写清（双盲复算、反方审稿、审批质询、数字推演沙盘、运行对比），新增「查询区间里没有数据」一节，补全访问密钥到期提醒发到哪里；中英文同步 ThearchyHelios 2026-10-21 10:51:15 +08:00
  • 2714890d0d 文档重新梳理：README 精简成介绍和索引，细节按主题拆进 docs/zh-CN 与 docs/en（17 篇一一对应），英文文档不含中文 ThearchyHelios 2026-10-21 10:23:26 +08:00
  • baf239981e 合入：数据剖析可以同时剖析几张表（剖析设置加「同时剖析的表数」，1–3，缺省 1 即以前的一张做完再做下一张；每张表的查询仍一条一条发，同一时刻对业务库最多这么多条查询）。按任务里的顺序一张结束就开始下一张，进度、查询记录各落在自己那张表上；止损、停用后不再开始新的表，正在做的照常做完；停止时正在做的几张各自收尾、做完的项写进目录；一张表让任务出错时另几张按停止收尾；共享的行数只估一次；409 说法改成「已完成 x / y 张表」；设置表单、风险说明、预算和估算用时按并发写明张数；中英文 README 各补一句。验收：后端全量 14979 通过（变基到最新 main 后相关剖析测试 125 条重跑通过）；tsc；check-catalog-profile 217 项、check-copy 28 项全过 ThearchyHelios 2026-10-21 09:08:35 +08:00
  • f774e42463 数据剖析可以同时剖析几张表：剖析设置加「同时剖析的表数」（table_concurrency，1–3，缺省 1，即以前的一张做完再做下一张；上限 3 是给这个源上的分析留出连接池的临时连接），每张表的查询仍一条一条发，所以同一时刻对业务库最多这么多条查询。剖析任务的执行改成按设置开几个执行者，按任务里的顺序一张结束就开始下一张；进度、发过的查询各落在自己那张表上（不再记「正在做的那一张」）。每张表开始前照旧重读数据源：停用、关掉剖析或止损后不再开始新的表，正在做的几张照常做完（止损时剩下的项记止损的原因），都结束后再把没开始的记停下；止损的连续失败、超时比例按几张表的查询合起来算。停止、关停时正在做的几张各自收尾，做完的项照常写进目录，都收完才往上交（等的时候又被停止也等完）；一张表让任务整体出错（快照被改动、数据源没了、记结果写库出错）时，另几张按停止收尾、原因写这一句，本进程续不上租约的不写。同时要估同一张表的行数时只估一次（按表加锁，先来的没估成后来的自己估）。同源已有剖析时的 409 说法从「第 x / y 张表」改成「已完成 x / y 张表」。界面：设置表单多一格（单位「张」，提示写明业务库同时要应付几条查询、和分析共用连接），风险说明、卡片悬停、开始前的醒目一句在大于 1 时写明「同时剖析 N 张表、每张表的查询一条一条地发」，预算多一行，这次最多用时按几轮算。测试：同一时刻在途查询不超过设置、每张表仍一条一条发（1/2/3 三种）、几张一起显示进行中并按顺序开始、同时停止各自写进目录、止损后不再开始新表、停用时正在做的做完、一张出错另几张按停止收尾、共享行数只估一次；check-catalog-profile 加一节（预算、估算、说法、两行进行中、表清单）。验收：后端全量 14979 通过；止损那条并发测试单独跑 30 遍、整个剖析任务测试文件并行跑 15 遍都没有偶发；tsc；check-catalog-profile 217 项、check-copy 28 项全过 ThearchyHelios 2026-10-21 09:00:48 +08:00
  • 31f3af8bac 合入：README 默认改成英文版（README.md，中文版的完整翻译），中文版独立成 README.zh-CN.md（内容不变），两边顶上互相链接；中文提示里指向 README 章节的地方改指中文版 ThearchyHelios 2026-10-21 08:55:03 +08:00
  • 0d4ee79440 README.md 改成英文版（中文版 README.zh-CN.md 的完整翻译），作为仓库默认 README ThearchyHelios 2026-10-21 08:50:47 +08:00
  • aadc8d0115 中文 README 移到 README.zh-CN.md（内容不改，顶上加语言切换），中文提示里指向 README 章节的地方改指中文版 ThearchyHelios 2026-10-21 08:13:58 +08:00
  • 95415dcbf5 合入：交叉表支持按文字导入的指标（「高峰时段」一行写着「18-19」时落成文字列，规则起草按文字指标起草并要人确认，配方面板加「指标类型」）；堵上占位符陷阱（拒收含数字的占位符，「不是数字」的下一步按格子情况写，整行文字给「按文字导入这一行」修复按钮）。验收：配方相关测试 2195 条、新增 15 条全过；check-copy 通过；check-manage 718 项全过；真实文件本机重跑起草完整、按日 31 行、时段 527 行；泄露扫描干净 ThearchyHelios 2026-10-20 11:41:44 +08:00
  • 9e1ff11278 交叉表支持按文字导入的指标（如「高峰时段」一行写着「18-19」），堵上占位符陷阱：配方的 measures 分段加 text_measures（标签 → text / hour_range），落成文字列（时段存规范写法），空格、公式、占位符照块的取值规则，数字、日期、解析不了的时段报 value_not_text / value_not_hour_range；规则起草遇到无标题指标块里整行是文字的行（标签不带词表单位）按文字指标起草，并出卡片和问题要人确认（「不是」就去掉，回到按数字导入、试运行拒收），确认清单加 text_measure 项，前后对照报类型和存法变化；数值区不合格的格一行合成一条起草失败（不再一行 30 条）。陷阱：以前照「请添加占位符」把「18-19」加成占位符，整格静默存成空值、干跑照样通过——静态校验拒收含数字的占位符（placeholder_digits，重放和沿用现行配方的放行），value_not_number 的下一步按格子情况写：整行文字的提示改「指标类型」并给修复按钮 declare_text_measure，含数字的不再提示加占位符；标签带单位的拒按文字导入（text_measure_unit），文字列不能写单位（unit_on_text）。配方面板每个指标多一个「指标类型」下拉（数字 / 时段 / 文字）。默认值不进规范形式，已存配方的哈希不变。测试 tests/test_recipe_text_measures.py（合成夹具，假名）；check-manage 加指标类型三项 ThearchyHelios 2026-10-20 11:39:05 +08:00
  • c2ba06014e 合入「口径数字全为 0」的一组修正（部署上一份周报：取到访的那张表只存最新一天，查上周、上上周全是 0，口径卡算出一排 0 和 0%）：查询区间里表里没有数据时照实说——结果里整列是 0 或空时运行时现查（data/coverage.py：界在库里按运行当天算、表的范围现查 MIN / MAX，失败退回剖析，按列判），进查询结果和快照（no_data），口径卡按列标「区间内无数据」、写作目录照实交代、出具按缺口降档、复核记缺口并可按复核重来；助手搭图自查对工具节点写死的 SQL 同样检查、交回一轮修正，单日剖析的表加提示；双盲复算两边落在无数据的列上不判一致、无法复算带上盲算的理由；口径卡分母为 0 时提示写 None、发布检查提醒 else 0、「算不出来」和「缺少输入」分开说；指标清单按格式渲染（以前比率 0.0007 写成 0.0007%）；没配出具契约的成果在实例页印章上照实写缺口。验收：后端全量 14948 通过；方言容器集成测试 PostgreSQL / MySQL / MariaDB / Oracle 全过（含部署那种文字日期 + 现算上周的写法）；tsc、文案检查；相关 8 项浏览器检查 3922 项全过；泄露扫描干净 ThearchyHelios 2026-10-20 11:01:35 +08:00
  • 680ea4ecf8 覆盖检查：现查没成功（大表全表 MIN / MAX 超时、库一时连不上）也记 LIVE_TTL_S，期间同一张表直接退回剖析、取值观察，不再每次白等 PROBE_TIMEOUT_S 秒（测试 test_a_failed_probe_is_not_retried_for_a_while）；方言容器集成测试（scripts/dialect_it.py）加一段覆盖检查：只存当天的滚动表（DATE 列，MySQL / MariaDB 另有按文字 'YYYYMMDD' 存的），按运行当天现算的上周区间判成没有数据、区间包含当天只是别的条件筛空的不报，查询后和助手自查两个入口都核——PostgreSQL 16、MySQL 8.4、MariaDB 11、Oracle Free 23 全过 ThearchyHelios 2026-10-20 10:58:20 +08:00
  • b0556e36d6 覆盖检查现查到的表的范围在进程里记 5 分钟（按数据源、上传表格的快照、表、列认）：一张图里几个取数节点、助手自查几轮查同一张表，不再每次全表 MIN / MAX；查不成的、退回剖析的不记，过期了重新现查 ThearchyHelios 2026-10-20 10:40:57 +08:00
  • b6f7cc8378 应用实例页：成果没配出具契约时（印章上是「未声明出具契约」），本该降档的缺口照实写进印章的说明——口径卡里输入取自「查询区间里这张表没有数据」的列的指标、双盲复算的缺口（无法复算、审核人没采用原流程……）；配了契约的已经按缺口降档，不另写 ThearchyHelios 2026-10-20 10:39:53 +08:00
  • f87b07694d 助手搭图时就发现「查的区间里表里没有数据」：自查（GraphChecker）对工具节点写死的 SQL 按今天跑一遍覆盖检查（data/coverage.sql_gaps：不跑原 SQL，只跑算界和现查范围的两条小查询，SQL 里所有带时间谓词的表都查，按表去重、限时，异步查库，带模板的 SQL 不查）；完全不重叠的作为一条 sql_no_data 问题交回模型改一轮（换有这段数据的表，没有就在 done 的说明里照实告诉用户数据只到哪天），修正后仍在的不挡运行，作为提醒留在检查结果和交付的问题清单里（问数据流式、画布非流式都是）。look / db_schema 的剖析信息在日期范围最早和最晚是同一天时加一句「剖析时这张表的 X 只有一天的数据，可能每天整表重灌：算历史周期请换有历史的表」；助手节点手册写明按周期取数前先看表的日期范围，只有一天、最新日期早于要查的区间的表不能用来算这段时间 ThearchyHelios 2026-10-20 10:38:30 +08:00
  • a86991b57f 双盲复算：盲算触顶、按无法复算记时（_limit_text 那一路），把盲算交回的理由（渲染后的正文，已经过遮罩）截一段带进原因（「盲算已达每项最多查询次数（1 次）；盲算交回的理由：…」），审批卡、缺口说明上看得到它查到了什么，没有理由的照旧。原值所在的格子落在「查询区间里这张表没有数据」的列上时不派盲算、按无法复算记；盲算交回的格子落在这样的列上时不判一致、按无法复算记；原因都写「查询区间里这张表没有数据（…）」 ThearchyHelios 2026-10-20 10:33:34 +08:00
  • 6fa2e297db 口径卡、报告、出具、复核认「查询区间里这张表没有数据」：口径卡按输入的快照 id + 列认（cell()、按位置取的格、Agent 经 cite_fields 交来的字段，按列，同一条查询里有数的列不受影响；转抄的指标照抄），给指标标 no_data 并写明原因，清单注明「这段时间表里没有数据：不要当成 0 解读」，发一条 metric_no_data；有出具契约的成果按缺口降档（契约收来的指标，和报告直接引用的这样的格）。写作目录里这样的指标、查询格子里这样的列都写清，写作规则加一句（目录里有这样的项才加）。证据面板的指标标「区间内无数据」并写明原因，查询步骤列出这几列。复核把 query_no_data、metric_no_data 记成缺口（DEGRADED），归进新的 REBUILD：是缺口、却值得换一张有这段数据的表重建一次，should_retry 和 chat/turn.retry_after_review 都认，问数据据此给出「按复核重来」的指示 ThearchyHelios 2026-10-20 10:29:01 +08:00
  • 8ba95c0252 查询区间里这张表没有数据时，查询结果里照实说（新增 data/coverage.py，接在数据源查询工具上）：结果里有整列是 0 或空的数值列时，把 SQL 收窄到算出这一列的那一项（去掉别的选择项、分组、HAVING、排序、取行数，只分析不执行），认出它用到的实表和时间谓词；界是字面量的直接解析，按运行当天现算的（不含列的表达式）用同一个数据源跑一条 SELECT 界1, 界2…（Oracle 加 FROM DUAL）算出来；这一列在表里的实际范围现查 SELECT MIN(列), MAX(列)（每条 10 秒），超时或失败退回剖析、取值观察记下的范围并照实标「按 X 日的剖析」，都没有就不判。日期按常见写法归一（DATE / DATETIME、'YYYY-MM-DD'、'YYYYMMDD'、8 位整数），文本列对文本界写法要一样，认不出就不判；区间和范围完全不重叠才算没有数据，一列用到几段区间时每段都不重叠才算。探查走同一道只读守卫，遮罩列不探查不报值，总耗时有上限，出错不影响查询本身。结果和快照多一项 no_data（columns、table、column、window、data_range、basis、message），运行事件记一条 query_no_data；没查出问题不加这个键，快照和以前一字不差。可验证报告认得这个键 ThearchyHelios 2026-10-20 10:28:49 +08:00
  • 301bbd55f3 口径卡分母为 0 时算不出来就是空值，和「缺少输入」分开说；指标清单按格式渲染。助手节点手册讲口径卡的那段写明分母可能为 0 时写「… if 分母 else None」、不要写 else 0，附示例；画布校验加一条提醒 metrics.zero_for_undefined（按语法树认：条件表达式一边有除法、另一边是常量 0，两边对调、套在 round 里、嵌套的都认）。输入都齐、计算式自己交回空值的指标多记 undefined: true（状态仍是 missing_input，按状态认的地方和老运行不受影响），清单、写作目录、引用解析不了的原因、运行对比、证据面板都说「算不出来（这组输入下计算式没有值，比如分母为 0）」；推演把它当不带值的字段。指标清单（{{ nodes.卡.text }}）改用卡上渲染好的 rendered：比率 0.0007 显示成 0.07%、金额带千分位，和报告里 [[m:]] 一致；有值却显示不出来的照实说，不拼原值 ThearchyHelios 2026-10-20 10:04:53 +08:00
  • 8ce578042c 合入：工作流可以改名（画布顶栏、工作流列表各一个入口；服务端拦空名、超长、重名，内置模板不改名） ThearchyHelios 2026-10-20 08:19:32 +08:00
  • 3c5c9d3c15 工作流可以改名：画布顶栏名字旁边、工作流列表每一行多一个「重命名」，两处共用 canvas/WorkflowPicker.renameWorkflow——只改名字，不加版本、不碰图，画布上还没保存的改动原样留着（改的正是打开的这一张时只换它的名字）。服务端 PATCH /api/workflows/{id} 的名字以前原样写入：现在去掉首尾空白，空名 422、超过 200 字 422、和别的工作流同名 409；内置模板不许改名（启动时 seed_defaults 按名字补内置模板，改了名下次启动会再导入一份原名的），界面上也不给模板改名入口，要改就「以此模板新建」。测试 tests/test_workflow_rename.py ThearchyHelios 2026-10-20 08:18:55 +08:00
  • 3003f737a3 合入：助手把操作写成工具调用格式（DSML、<invoke>、<tool_call>……）时照操作读；起草时一个能落地的操作都没有就当场带纠正重写一次；报错按诊断照实说；提示词写明没有工具调用接口；画布失败轮次把原因和诊断记进 meta.cause ThearchyHelios 2026-10-19 22:48:39 +08:00
  • 626a423625 画布助手没完成的那一轮把原因和诊断记进 meta.cause，之前的轮次也摊开「怎么办」和诊断 ThearchyHelios 2026-10-19 22:48:23 +08:00
  • 6b68961c65 助手把操作写成工具调用格式时照操作读；一个能落地的操作都没有时当场纠正一次；报错按诊断照实说 ThearchyHelios 2026-10-19 22:48:23 +08:00
  • bbc1f3b34c 合入：切到账号密码登录时，已经有能用密码登录的管理员就不再要求建第一个管理员（设置页按 /api/auth/settings 的 local_admins、passwordless_admins 判断；从单点登录切过来同样） ThearchyHelios 2026-10-19 18:49:11 +08:00
  • fa951a2756 切到账号密码登录时，已经有能用密码登录的管理员就不再要求建第一个管理员：以前设置页只要从「未开启」切到账号密码登录就一律显示「第一个管理员」表单、一律提交 bootstrap（前端 needsBoot 只看切换方向），库里已经有设了密码的管理员也得再建一个。/api/auth/settings 现在带 local_admins（没停用、能用密码登录的管理员）和 passwordless_admins（没停用、还没设密码的）；设置页按它判断：有能登录的就提示「切换后用其中一个账号登录，保存后会回到登录页」、不提交 bootstrap；只有没设密码的管理员时照旧要建，并说清是谁没设密码、可以在用户列表里给他重设密码。从单点登录切到账号密码登录同样按这条判（以前不显示表单、后端却要求）。用户列表里新建用户、重设密码后，登录方式那一块重新判断。判据和后端 _local_admin_exists 同一个 ThearchyHelios 2026-10-19 18:48:22 +08:00
  • 5d5a29cfa6 合入前端依赖 source-map-js 1.2.1 → 1.2.2（Dependabot 高危告警，只更新锁文件） ThearchyHelios 2026-10-19 18:17:00 +08:00
  • 3470521f46 前端依赖 source-map-js 1.2.1 → 1.2.2（Dependabot 高危告警）：postcss、@tailwindcss/node 的间接依赖，两者的版本范围本来就允许 1.2.2，只更新锁文件，package.json 不变。验证：在干净的拷贝上 pnpm install --frozen-lockfile 装出 1.2.2，tsc、pnpm build 通过 ThearchyHelios 2026-10-19 18:14:05 +08:00
  • 7bf2595b23 合入部署实例一段问数据会话里查出的 9 条修正：复核按报告最后一次核对定档（首稿没过、重写后通过的不算缺口）；被随后改对的查询失败不再写进答案；「上周」这类相对日期按运行当天算，数据覆盖不到先照实说；整表引用行号超出截到最后一行；名字里的数字（和查询结果文本值一字不差的）不算裸数字；标识列（编码、编号、分组键）不加千分位（单元格显示规则 3 版，离线核对页同步）；指标后紧跟同一单位不再重复；前面写过表名时字段只显示列名；建图返回空时记诊断、重来附纠正，并修掉三处工具调用被静默丢弃的路径。验收：后端全量 14871 通过；相关 8 项浏览器检查 3922 项全过；tsc、文案检查；泄露扫描干净 ThearchyHelios 2026-10-19 18:10:12 +08:00
  • d6c22440df 名字里的数字涂白（_name_masks）先按数字串挡一道：名字一字不差出现、前后不紧挨着数字时，名字里的每一串数字在正文里都是完整的一串，正文里没有这串数字的名字不再逐个查找，快照行多时不拖慢组装和复核；放过的范围不变 ThearchyHelios 2026-10-19 17:50:17 +08:00
  • 29c44ce65a 助手一个操作都没给（copilot_empty）时看得出模型交回了什么，自动重来带一句纠正，格式跑偏的操作不再被静默丢掉：copilot_gen 新增 StreamDiagnosis，起草阶段记结束原因、正文（不算空白）和思考的字数、认出几行操作、原生工具调用的名字、跳过的行按原因数（不是完整的 JSON、不是 JSON 对象、缺 op、工具调用名字不认识、参数解析不了）、正文里写成文字的工具调用标记，只记长度个数和原因、不记原文；copilot_empty 的 error 带 detail（一句话）和 diagnostics（机读），问数据、画布、应用润色、蓝图四处一致，非流式的 502 也带上。重来时交给助手的原因换成按诊断给的纠正（只写了思考 / 什么都没输出 → 直接输出操作、要看表先写一行 look；格式跑偏 → 每个操作单独一行完整的 JSON；用了工具调用 → 这里不走工具调用），chat/turn.empty_retry_instruction 附在问题后面，不原样重发；诊断随 turn.retry 事件记下。原来静默丢掉的写法照常读：分成多行写的 JSON（以「{」开头读不成就往后攒）、和围栏写在同一行的操作、原生工具调用里名字是操作名的（参数就是操作的字段） ThearchyHelios 2026-10-19 17:43:13 +08:00
  • a92f590799 字段标记紧跟在同一张表名后面时只显示字段名（部署上的「取自 某表 的 某表.某列」）：[[c:表.列]] 前面紧挨着（隔空白、「的」「中的」「里的」）刚写过同一张表的名字——写成文字或 [[t:同一张表]] 都算，按 name_key 比，带库名的全名、末段都认，英文名前面还连着字母的不算——正文只显示列名，出处、证据标识照旧是那个字段，引用上记 short: true，复核照它核对显示的字；没有这一项的老文档照旧按全名核对。整篇组装、render_markers、流式渲染一致（流式渲染记着已放出正文的末尾一截）。写作规则（ENTITY_RULES）写一句 ThearchyHelios 2026-10-19 17:30:10 +08:00
  • ba4c604539 数字标记后面重复写的单字单位也去掉（部署上的「覆盖 8条 条产线」）：以前单字的单位后面紧跟着字时一律不动，现在只在它和后面的字连起来是一个更长的单位（人次、个月、台套、元/…，_LONGER_UNIT）时不动，让「人」对「人次」这样的不一致照旧露出来；「条产线」「人参加」照样去掉重复的那个字，流式渲染一致。写作规则加一条 UNIT_RULE（[[m:]]、[[v:]] 自带单位，后面不要再写一遍），助手节点手册讲 [[m:]] 的那一行也写明 ThearchyHelios 2026-10-19 17:23:32 +08:00
  • e9bb0afd4c 报告里标识列的数不分千位（产线编码 1203 不再写成「1,203」）：新增 engine/cell_format.plain_columns，按序看查询当时冻结的数据目录给源列标的度量类型（identifier / status / attribute 不分，flow / stock / ratio 分）、源列名像编码编号（CODE、ID、NO 整词或结尾、驼峰的 Id/No/Code、编码、编号、代码）、是分组键（列、别名、序号都认）而不是聚合；SUM、COUNT、AVG 这类聚合是量，MIN、MAX 按那一列判；判断不了的照旧分千位。只看查询快照和它指向的表结构快照（内容寻址），组装、流式渲染、写作目录、出口复核一致。单元格显示规则 3 版：真有格子因此改了写法的文档记 cell_display: 3、引用上记 plain；离线核对页认 3 版、照 plain 渲染（解析不了 SQL），老文档按记下的版本复核照旧分千位。样本里订单号（order_no）随之不分组，check-bundle 跟着改 ThearchyHelios 2026-10-19 17:19:23 +08:00
  • baf93ddfed 报告里照抄查询结果中文本格的名字（「冲压5线」「KX-205 线」）时，名字里的数字不再算裸数字：目录里每次查询的快照中、文本格里带数字的值（至少一个数字、至少一个不是数字的字，本身不是数也不是带单位的数），在正文里一字不差地出现、前后不紧挨着数字的那几段，查裸数字时涂白。组装和出口复核用同一条规则；只认快照里真有的值，不做模糊匹配，同一个数单独写出来照样要出处，数值格不受影响 ThearchyHelios 2026-10-19 17:06:08 +08:00
  • 8f6a90c8c2 整表标记 rows= 的结束行越界、起始行在范围内时截到最后一行（不加注），只有起始行越界才算解析不了；行数上限按截完的行数算。单元格显示规则升到 3 版：截行只影响组装（截完照样展开成一格格的单元格引用、按格复核），复核 3 版以前的文档时没展开的整表标记照老规矩判，老文档里那句「没有第 N 行」不会被当成文档被改过。文档的 cell_display 改记渲染得出这些格子的最低一版（只有日期时间被改写的照旧记 2，离线核对页不受影响） ThearchyHelios 2026-10-19 17:00:32 +08:00
  • 41b350b87c 相对日期一律按运行当天算：助手节点手册的搭图规则（画布、问数据共用）加第 6 条——「今天、昨天、上周、本月、去年」按运行当天算，SQL 用方言里取当天的写法、agent 先调 current_time，不用 MAX(日期) 去推「上周」，要说数据最新到哪天就另取一列；报告写作规则加一条（period_rule），告诉写作者今天是哪天、上周是哪几天：数据没覆盖问的那段时间时先照实说、写明数据最新到哪天，最近一段的数可以给但写具体起止日期，不叫它「上周」「本月」 ThearchyHelios 2026-10-19 16:53:46 +08:00
  • 5dfe2e7fd1 report.failed_queries 不再把「写错一条、下一条就改对了」当取数失败：同一个节点里，失败之后还有一条同一数据源的成功平台查询、读的表覆盖了失败那条的表（按 sql_semantics.facets 取表；失败那条解析不了就按同一数据源之后有成功的查询认），这次失败算已被替代，不进写作提示、不记 report_queries_failed；一次成功的都没有时照旧写「这次一次成功的查询都没有」 ThearchyHelios 2026-10-19 16:47:07 +08:00
  • 1e87504e5c 复核把「首稿没过、重写后已通过」当缺口：report_repair、report_rewrite 这类「改过一次」的信号按同一个报告节点最后一次 report.checked 定档——最终通过的（没有违规；裁判摘要里不再有证据不支持的句子）不进复核的异常清单，复核模型被别的信号叫起来时，说明里另起一节「已经处理好的」写「报告「x」首稿有 N 处没过核对，重写后已全部通过」，不再写成「核对仍未全部通过、可能不准」；最终没过的照旧记缺口。report_repair、report_rewrite 的日志带上处数 ThearchyHelios 2026-10-19 16:43:54 +08:00
  • 43909ea3f0 合入编排完善第 2 波（docs/design/orchestration-round §5）：应用库可移植到 PostgreSQL（AGENTLAB_DATABASE_URL，缺省仍是 SQLite；方言调整只装在应用库引擎上、两种库行为一致；迁移按方言；断点用 langgraph-checkpoint-postgres；python -m app.db copy-to-postgres 连断点一起搬、孤儿行与缺省值照实处理；数据目录文件先写临时文件再改名；bubblewrap 沙箱不再继承环境变量）；多进程协调（工作进程在库里登记、租约按库的时钟、卡住的进程自我隔离不再写、终态按属主写、运行事件 (run_id, seq) 唯一；跨进程停止；四类运行名额、交互留底其余可借；调度只由一个进程当班；实时流 LISTEN/NOTIFY 跨进程转发；花费账、额度、限流、锁、缓存失效进库；AGENTLAB_DATABASE_DIRECT_URL 与 PgBouncer 事务模式；版本不同的进程拒绝同连一个库；SQLite 单进程空闲不写库）；部署时 PostgreSQL 一起起（deploy.sh install --postgres、migrate-to-postgres 失败原样退回 SQLite、升级前自动备份、内置库按部署编号认、dev.sh --postgres、启动时等库就绪）；第 1 波与下一轮遗留收口（助手讲驳回出口、驳回去向的说法、子工作流在循环里的编号与外部写入幂等键、运行对比与反方审稿认子工作流、复核去重、问数据心跳不落库与事件日志清理、接手时重新核对身份、事件触发批量查询、多行查询行序不定、对账预选对照、口径凑不齐参数记日志）；.env.example 与 deploy/agentlab.env 补全配置项。验收：后端全量 SQLite 14803 通过、PostgreSQL 14808 通过；多进程端到端 10/10（含进程被冻住再恢复的两种情形）；tsc、文案检查；相关的 19 项浏览器检查 6830 项全过；泄露扫描干净 ThearchyHelios 2026-10-19 16:34:08 +08:00
  • 68da5795b8 合入 nr8/d 的复核修复 R-d1–R-d6（内置库按部署编号与记下的名字认、起不来的库容器回退后不再重启、卸载只删自己建的网络、升级备份含记录表、dev.sh 读 .env 的写法与数据目录、sudo 下的 ~ 按 SUDO_USER 展开） ThearchyHelios 2026-10-19 16:19:44 +08:00
  • 71b83195ac 复核 R-d6（sudo ./deploy.sh 时 DATA_DIR=~/… 展开成 /root 下）：有 SUDO_USER 时 ~ 按它的家目录展开（getent passwd 取，取不到退回 $HOME），「不能是家目录本身」也按它查；install、upgrade、migrate 开头打印展开后的绝对路径（DATA_DIR 用了 ~ 时注明 ~ 是哪个目录）。deploy/README 写一句（agentlab.env 已有的行没动）。假 docker 单测：SUDO_USER 的家目录、取不到时退回 $HOME ThearchyHelios 2026-10-19 16:15:21 +08:00
  • 49118eeef2 复核 R-d5（dev.sh 读 .env 不全）：认 KEY = value（等号两边有空格，和后端的 dotenv 一致）；放开发库密码的数据目录也照「环境变量 > backend/.env > .env」读 AGENTLAB_DATA_DIR，相对路径按后端的工作目录 backend/ 算，.postgres-dev 落在后端实际用的数据目录下。单测：等号带空格、export、行尾注释、backend/.env 优先、相对的数据目录 ThearchyHelios 2026-10-19 16:13:35 +08:00
  • 65d35f6c97 复核 R-d4（升级前的 SQLite 备份只拷了应用库和断点库）：填报的记录表 records/**/*.db 也用 SQLite 的备份接口拷进同一份备份，相对路径照旧，目录 0700、文件 0600；库在 PostgreSQL 时不做这份（记录表跟着整目录备份）。deploy/README 写清这份备份含什么、不含什么（上传原件和版本库、工件库、附件、知识库、沙箱工作区、.secret_key 要整目录备份），恢复步骤加上记录表 ThearchyHelios 2026-10-19 16:12:07 +08:00
  • 676c546cbb 复核 R-d3（卸载时不看网络是不是自己建的就删）：建网络时打上 agentlab.role=network 和这个部署的 agentlab.deployment 标签；卸载时标签和部署编号对得上才删，早先建的没有标签的按数据目录里记着的网络名认，都不是就只打印一句、不删。假 docker 单测：别人的同名网络、没标签又没记着的不删，自己的（含早先没标签的）删掉 ThearchyHelios 2026-10-19 16:10:25 +08:00
  • 8b5b7f86b2 复核 R-d2（起不来的库容器回退后还在一遍遍重启）：stop_pg 对在跑的和在重启的（restarting）都停；migrate-to-postgres 回退时先 docker update --restart=no 再停，再起库时（start_pg）恢复 --restart unless-stopped；./deploy.sh stop 用同一个函数一起好。假 docker 单测：镜像起不来、容器一直 restarting 时回退后停在 exited、重启策略是 no，换回能起的镜像重跑照常，stop 也停得下在重启的 ThearchyHelios 2026-10-19 16:09:19 +08:00
  • 35bb634460 复核 R-d1（认库是不是自己的不够严）：状态文件第一次记 migrating / builtin 时一并记下库的容器、数据卷、网络的名字和一个部署编号（app.ops state --container/--volume/--network，--get 取一项），库容器、数据卷带 agentlab.deployment=<编号> 标签（数据卷先 docker volume create 再起容器）。agentlab.env 的名字和记着的对不上就拒绝（install、upgrade、migrate、起停、状态、卸载都先核对），早先只记了模式的状态文件按当时的名字补记、照实打一行；库容器要标签和部署编号对得上（没编号的老容器看挂的密码文件是不是这个数据目录的）、挂的数据卷就是 POSTGRES_VOLUME，清空库之前数据卷还要带这个部署的编号（没编号的不清空）；卸载碰上别人的库容器只提示不删。假 docker 单测：同一台机器上两个部署，改名指向对方、老状态文件补记之后，对方的库不被清空、不被删、不被重建 ThearchyHelios 2026-10-19 16:07:03 +08:00
  • badcc2f6aa README：编排完善第 2 波的升级说明（缺省仍是 SQLite 单进程、新列与运行事件唯一索引、数据目录标记；应用库可换 PostgreSQL 与导入、deploy.sh 内置库与 migrate-to-postgres、dev.sh --postgres；PostgreSQL 下多进程、升级要先停全部进程；运行按类别排队与交互留底；升级前自动备份、restart 缺省只重启服务；bubblewrap 沙箱不再继承环境变量；循环里的子工作流编号与幂等键；问数据心跳不落库与事件日志清理、接手时重新核对身份；行序不定；驳回去向的说法） ThearchyHelios 2026-10-19 15:46:49 +08:00
  • af919a88aa 合入编排完善第 2 波（集成）：应用库可移植到 PostgreSQL（nr8/a）、第 1 波与下一轮遗留收口（nr8/l）、多进程协调（nr8/b）、部署时 PostgreSQL 一起起（nr8/d） ThearchyHelios 2026-10-19 15:45:16 +08:00
  • d117237bbc 配置模板补上 PostgreSQL 和多进程的几项：.env.example 的应用库一节分成应用库、连接池、PgBouncer、多进程、开发用 PostgreSQL 五组，补上 AGENTLAB_DATABASE_DIRECT_URL、AGENTLAB_DB_PGBOUNCER、AGENTLAB_DB_POOL_TIMEOUT、AGENTLAB_DB_POOL_RECYCLE、AGENTLAB_DB_STARTUP_TIMEOUT、AGENTLAB_WORKERS、AGENTLAB_WORKER_LEASE_S、AGENTLAB_WORKER_HEARTBEAT_S、AGENTLAB_SCHEDULER、AGENTLAB_SCHEDULER_TICK_S、AGENTLAB_BUILD 和 dev.sh --postgres 的 AGENTLAB_DEV_PG_*（都注释着，名字、缺省值照 core/config.py 和脚本）；dev.sh 的 AGENTLAB_DEV_PG_* 也认 .env / backend/.env（环境变量优先，和后端的配置同一个规矩，不 source）。deploy/agentlab.env 末尾再追加「外接 PostgreSQL 与多进程（可选）」一段（地址写宿主机网桥 172.17.0.1、放行容器网段，和内置库二选一；断点库、PgBouncer、直连地址、工作进程、租约、连接池、启动时等库），已有的行一行没动。deploy.sh：AGENTLAB_DATABASE_DIRECT_URL 也算外接的库（和内置互斥），只设直连地址不设 AGENTLAB_DATABASE_URL、内置库开 AGENTLAB_DB_PGBOUNCER、SQLite 时 AGENTLAB_WORKERS 大于 1 都在起容器之前照实拦下（migrate-to-postgres 在停服务之前查）。单测：这些 AGENTLAB_* 经 --env-file 进容器、几条拦截、模板两段的项和缺省值、dev.sh 从 .env 读设置，以及守卫——config.py 里应用库、连接池、多进程、调度几类配置每一项都要在 .env.example 里有 ThearchyHelios 2026-10-19 15:41:37 +08:00
  • e8743aa8c4 更新 agentlab.env 配置：将 HOST_PORT 修改为 8080，DATA_DIR 修改为 ~/agentlab_data ThearchyHelios 2026-10-19 15:30:45 +08:00
  • b52a67b18d 后台任务的 drain 不再空转：notify.service、eval.cleanup 的 drain 改用新增的 core/background.drain——做完了的任务直接从集合里摘掉，只等本事件循环上没做完的，别的循环上没做完的不等、循环关了的摘掉。以前 while _background: await gather(...) 碰上别的事件循环上做完、discard 回调永远不跑的任务，gather 立刻返回、不让出事件循环，在那里空转（CPU 打满、进程卡死）：PostgreSQL 全量里 test_personal_apps 的收尾两次卡在这里。单测在另一个线程里跑 drain、按线程等（空转时事件循环转不动，wait_for 救不了） ThearchyHelios 2026-10-19 15:29:00 +08:00
  • 39bc76494e 测试：随机名字不带数字——新增 tests/fixtures/names.letters（uuid4 的十六进制里数字换成字母，同 test_run_data_versions 的写法），dual_check_shop 的数据源名、盲算的调用编号，评测、应用说明检查、导入、遮罩、通知几处测试里拼进文本的随机名字都改用它（以前带着「330」「300」「48」这类数时撞上「文本里不许出现这个数」的断言）；test_eval_schedule 查通知里有没有数时先去掉 32 位编号和发送时间（随机的编号带过「310」）；test_null_not_null_values_fall_back_to_the_model_default 显式导入 app.db.models（单独跑时 schedules 还没登记进元数据，KeyError）。deploy.sh 注明内置库不用 copy-to-postgres 的 --direct-url ThearchyHelios 2026-10-19 15:16:54 +08:00
  • 27237623c5 合入 nr8/b 的 45513c90（复核 R-b7–R-b15 和 R-b12 的尾巴：租约按库的时钟、隔离用计入休眠的钟、PostgreSQL 单进程墙钟跳变不再隔离自己、Fenced 只对绑定世代的执行抛、隔离后等不到重新登记的运行照实收尾、续租任务不退出、换身份后收拾旧身份、quota.take 交回日期、check_pgbouncer 同一主机端口（本机回环规范化）也拒绝、copy-to-postgres 抽出 checkpoint_conninfo 加 --direct-url、版本指纹算进 requirements.lock、run_events 重号记进设置）；没有冲突，README、db/base.py、db/to_postgres.py 自动合并：to_postgres.main 里 nr8/b 的 --direct-url 和这边连不上时一句话报错的分支都在 ThearchyHelios 2026-10-19 15:13:42 +08:00
  • 45513c90b7 R-b12 的尾巴：check_pgbouncer 判同一个主机端口时把主机名规范化——localhost、127.x.x.x、::1 都算本机回环，IP 按地址比（::ffff:10.0.0.5 和 10.0.0.5 相同），解析不成 IP 的按字面（小写）比、不查 DNS。补测试：localhost 对 127.0.0.1、127.0.0.1 对 ::1、IPv4 映射地址同端口都拒绝，本机另一个端口、名字不同的放行 ThearchyHelios 2026-10-19 15:09:10 +08:00
  • c0f7aae8ad 复核 R-b15（隔离后等不到重新登记的运行原因记错、任务没摘）：_drive 里 fence.ready() 等不到时照实收尾——排队中的（一步都没执行过）收成失败，写明「本进程隔离后没能重新登记，这次运行没有开始执行」并记 run.failed；要接着执行的（继续、批了审批）收成中断、断点完好可继续运行；条件更新，状态、属主变了（别的进程先接手）就不动；执行任务从 run_manager._tasks 里摘掉。补测试：隔离后新身份一直没登记上，新发起的运行收成失败、原因写对、run.failed 记下、任务摘掉 ThearchyHelios 2026-10-19 15:08:39 +08:00
  • eb9af51abb 复核 R-b14（PostgreSQL 单进程墙钟一跳就隔离自己）：取得到计入休眠的钟（SLEEP_AWARE）时 stale() 只看它，墙钟只在取不到时当后备（两只里走得多的那只）；两只钟对不上（jumped）不再直接隔离，先续一次租——续租那一句按库的时钟核对「自己的租约还没过期」，以它为准：续上了只记一条日志照常，续不上才隔离。README「多进程」补一句：库服务器自己的时钟往前跳超过一个租约时所有进程一起隔离、怎么恢复，往回跳时真没了的进程要多等，本机墙钟跳了不隔离。补测试：墙钟往前往后跳一小时不算续晚了、只算对不上，计入休眠的钟走过两个租约照样算，取不到时墙钟当后备；PostgreSQL 单进程墙钟 ±1 小时续租照常续上、不隔离，真过期仍隔离；执行到一半墙钟 ±1 小时，运行照常跑完、世代不变（改前的写法往前跳那条不过） ThearchyHelios 2026-10-19 15:07:17 +08:00
  • 68c1f4143e 复核 R-b13（版本拦截与零碎）：preflight 报错列出全部活着的、版本不同的进程，各标明心跳在走还是停着、等租约过期（以前只点名先看到心跳的那个，人停掉它再起还会被另一个拦下）；源码指纹把依赖锁文件 requirements.lock 的内容也算进去，只升了依赖也算版本不同，锁文件取不到时换成几个关键包的版本，Docker 镜像里留一份锁文件；存量库 run_events 撞了号时把结果记一次（settings 表 cluster:run_events_seq_duplicates，记下撞号的那几处，最多 200 处），之后启动不再整表 GROUP BY、只按索引核对那几处还撞不撞，都处理掉了才再数一遍、建唯一索引、删掉记录。隔离后换身份那几条日志写出新旧完整身份已在 R-b9 那一笔里改了。README「升级」一段跟着补一句。补测试：一个心跳在走、一个心跳停着，报错两个都列出、各标状态；锁文件变了指纹跟着变、取不到时用包版本；撞号第一次整表数、第二次只核对不扫、处理掉之后建上索引并删掉记录 ThearchyHelios 2026-10-19 14:45:54 +08:00
  • d55ae68e7d 复核 R-b12（直连地址其实还是 PgBouncer、搬断点走了事务模式）：check_pgbouncer 除了没给直连地址，直连地址和应用库地址连的是同一个主机端口（规范化之后比，端口不写按 5432）也拒绝启动，报错说清直连要绕过 PgBouncer；copy-to-postgres 搬断点抽成 checkpoint_conninfo：给了断点库地址用它，否则进目标库、给了直连地址就走直连，命令行加 --direct-url，不给而目标就是应用库时用 AGENTLAB_DATABASE_DIRECT_URL。补测试：同一个主机端口（大小写、用户、参数不同）拒绝、同主机另一个端口放行；搬断点缺省走直连、单给的断点库地址优先、目标是别的库不套用应用库的直连地址 ThearchyHelios 2026-10-19 14:42:33 +08:00
  • ed3bb943df 复核 R-b11（跨零点退回额度退到第二天那一行）：quota.take 交回占在了哪一天（本地日期），占不到交回 None；出具、按需视图发起失败时按这个日期退回——23:59:59 占、00:00:01 失败，退的是前一天那一份，第二天的不动。补测试：跨零点占了两份、退回前一天那一份，前一天归零、第二天那份不动 ThearchyHelios 2026-10-19 14:40:11 +08:00
  • 19ffa1fa17 测试：隔离之后重新登记、收拾旧身份的两条用虚构的旧身份（不拿本进程真的身份当旧身份收拾，免得删到同一个测试进程里前面留下的、属主是它的行） ThearchyHelios 2026-10-19 14:40:10 +08:00
  • 1e6f0554fe 复核 R-b10（隔离换身份后旧身份的名额、请求没人收拾）：要名额时把当时的身份记在 holder 上，放的时候按它删，换了身份也删得到；新身份登记上之后收拾旧身份（tidy_retired）——它的执行都已停下、写不了了，不必等它的租约过期：删掉它的登记（发 gone，别的进程马上按属主不在了接手它认领的运行、任务）、它占着的运行名额和同源队的位置，交出它拿着的当班租约，发给它的请求转到新身份名下照办，照实记一条日志；停止请求对不在本进程执行的运行也照停止的规矩办（cancel 自己看属主：转给正在执行它的进程、属主不在了就接手放弃、停在断点上的收成 cancelled）。补测试：拿着名额时换了身份照样放得掉（改前的写法这条不过）；新身份登记上之后旧身份的登记、名额、队里的位置、当班租约都收拾掉，转过来的停止请求把停在断点上的那次运行收成 cancelled ThearchyHelios 2026-10-19 14:36:19 +08:00
  • ba22b82b3d 复核 R-b9（Fenced 打到不该打的地方）：check() 续晚了谁问到都隔离，但只对绑定了世代的执行（运行的一段执行、后台任务）抛 Fenced，HTTP 处理、调度那一拍、进程间请求问到时只隔离不抛；调度循环、心跳、办进程间请求也接住 Fenced；续租的任务不再因为一下出错就退出——续租、隔离之后重新登记都包住，照实记日志、退避着重试（最长一个租约时长）。隔离时马上换身份（之后新建的行记新身份），新身份登记上之前心跳不争当班、不接手，新开始的运行、后台任务在 fence.ready() 上等（最多一个租约时长，等不到就不开始，那几行由别的进程按属主不在了处理，这边同时放弃这个一直没登记上的身份、再换一个）。日志写出新旧完整身份。补测试：没绑定的调用者只隔离不抛、绑定在隔离之前的抛、新身份登记上之前 ready 等着；调度循环被 Fenced 打到一拍之后照常；重新登记先被版本守卫拦、再碰上库连不上，续租任务都不退出，登记上之后照常续租 ThearchyHelios 2026-10-19 14:33:45 +08:00
  • d6ecaaa7a3 复核 R-b8（隔离时 asyncio 记一条回调异常）：断点写入的守卫改成协程包装、在协程里查 fence——LangGraph 在节点的完成回调里调 aput_writes 拿协程交给后台任务，以前同步包装在回调里就抛 Fenced，每次隔离都打一条「Exception in callback … FuturesDict.on_done」加 traceback；现在异常留在写断点的那个任务里，由 LangGraph 照常收走。补测试：卡住被接手那一条里 asyncio 不记回调异常、不记没人取的任务异常（改前的写法这条不过） ThearchyHelios 2026-10-19 14:29:12 +08:00
  • 7fcce90f95 复核 R-b7（休眠、时钟偏差下隔离失灵）：租约改用库的时钟——续租、登记写 lease_until = 库的 clock_timestamp() + 租约，判活、清理过期登记、版本守卫看谁活着都比库的时钟，调度当班的租约同样按库的时钟接班、续租，本地判还当不当班改看计入休眠的单调钟，机器之间墙钟差多少都不起作用；隔离改用计入休眠的钟（Linux CLOCK_BOOTTIME，macOS clock_gettime(CLOCK_MONOTONIC)，取不到退回 monotonic），并且一律同时比墙钟，两只钟里走得多的那只说过了一个租约就算续晚了；续租时两只钟差出一个租约（墙钟跳了、休眠没计）也隔离；续租那一句带上「库里自己的租约还没过期」的条件，过期了或者登记不见了就不再续这个身份、隔离换身份（以前登记不见了是用旧身份重新登记）。补测试：单调钟不走而墙钟过了两个租约、墙钟往回拨，都算续晚了；本机墙钟快一小时，别的进程照样活着、当班租约抢不走；库的时钟过了自己的租约时续租不续、隔离一次 ThearchyHelios 2026-10-19 14:27:32 +08:00
  • 11d3b24592 测试：conftest 把 AGENTLAB_SECRET_KEY、AGENTLAB_SCHEDULER 挪到任何 app.* 导入之前（PostgreSQL 分支先导入 app.db.base 装连接池，settings 那一刻就定下来了，以前单独跑 test_schedule_events_api.py 在 PostgreSQL 上 scheduler_on 是 True）；test_trigger_options 按名字（q）查要核对的那几个对象，不再指望一页 100 个装得下同一个库里别的测试建的工作流和数据源 ThearchyHelios 2026-10-19 14:06:20 +08:00
  • 322ba5969b 合入 nr8/b 之后的配合：启动时先等库再做版本检查（cluster/version.preflight 是第一次连库，放在等库之前的话库的容器晚一步起来服务就直接崩），单测核对先后；deploy/README 多进程一段写明内置 PostgreSQL 是直连、不用 AGENTLAB_DATABASE_DIRECT_URL，upgrade 先停掉旧容器（全部工作进程）、备份、再起新版本，正合不许新旧版本同时运行的拦截 ThearchyHelios 2026-10-19 14:06:20 +08:00
  • 5318c33f57 合入 nr8/b 的 ac8b194c（复核 R-b1–R-b6、交互留底的运行名额、先占额度再出具、直连地址 AGENTLAB_DATABASE_DIRECT_URL 和 AGENTLAB_DB_PGBOUNCER、不许新旧版本混跑、prod.sh 和 Docker 入口问 python -m app.cluster workers、镜像带构建号）；没有冲突，README、config.py、db/base.py 自动合并 ThearchyHelios 2026-10-19 14:01:07 +08:00
  • c842b536f6 内置 PostgreSQL 的四条取舍：agentlab.env 模板末尾追加注释掉的「内置 PostgreSQL（可选）」一段（POSTGRES_IMAGE、POSTGRES_CONTAINER、DOCKER_NETWORK、POSTGRES_VOLUME、BACKUP_KEEP，缺省值写在注释里，已有的行一行没动）；升级前的备份收紧权限——backups/ 起每一层目录 0700、备份文件 0600，属主同数据目录（SQLite 的在 umask 077 下先以 0600 建空文件再交给备份接口写，pg_dump 在 umask 077 下写、目录由 app.ops backup-dir 建和收紧），恢复步骤里写清哪一步要 sudo、内置库的恢复改成在以 10001 运行的临时容器里读备份（不用 sudo）；restart 缺省只重启服务（库停着时先把库起来），restart --postgres 连库一起重启，没用内置库时加 --postgres 照实报错；离线包缺省带 PostgreSQL 镜像不变，deploy/README 写清多出约 160 MB、导入后约 0.7 GB；deploy/README 加「首次在 Linux 上切换前的检查」（docker 版本、属主、权限、磁盘空间、整目录备份）。单测核对权限位、restart 两种用法、模板里的注释和 deploy.sh 的缺省值一致 ThearchyHelios 2026-10-19 13:58:00 +08:00
  • 320fd69af2 镜像大小照实写：内置 PostgreSQL 的镜像导出约 160 MB、导入后约 0.7 GB（postgres:16.15，arm64 上量的） ThearchyHelios 2026-10-19 13:47:38 +08:00
  • ac8b194ca8 评测时限不算排队（续）：within 看得更勤（不超过时限的 1/20），一段的头尾有一头在暂停就整段不算——以前一段只看尾巴，拿到名额后的头一段整段算进去，PostgreSQL 全量满载时那条测试偶发超时；测试改成排 2 秒、时限 1 秒，给拿到名额之后的几次写库留够余地 ThearchyHelios 2026-10-19 13:46:09 +08:00
  • 237850f6c9 部署说明：deploy/README「用 PostgreSQL」改成三种放法（缺省 SQLite、内置 PostgreSQL、外接 PostgreSQL）各自的用法和数据在哪里，内置的怎么起、能改的几项、备份和恢复（pg_dump / pg_restore 的完整步骤）、从 SQLite 切过来的六步和出错时的样子、SQLite 库文件什么时候能删、卸载；包里多了 postgres-image.tar，升级前自动备份、升级时自动迁移，停止和卸载按顺序管两个容器。仓库 README：离线包一段补内置 PostgreSQL，「用 PostgreSQL」补启动时等库和「和库一起起」（deploy.sh install --postgres / migrate-to-postgres、dev.sh --postgres），快速开始提一句 --postgres ThearchyHelios 2026-10-19 13:43:52 +08:00
  • 9e6a6db406 deploy.sh 带内置 PostgreSQL：install --postgres 在旁边再起一个 PostgreSQL 容器（镜像小版本固定 postgres:16.15、可用 POSTGRES_IMAGE 改；同一个 docker 网络、端口不对外；数据在 docker 数据卷；密码第一次自动生成在数据目录的 .postgres/、0600，按 POSTGRES_PASSWORD_FILE 和 PGPASSFILE 传，不进镜像、日志和 docker inspect；agentlab.env 什么都不用填）。用过一次的数据目录记在 .postgres/state，之后 install / upgrade / start 不用再加。start、restart 先起库等 pg_isready 再起服务，stop 先停服务再停库，status 显示两个容器，logs --postgres 看库的，uninstall 连库的容器和网络一起删、数据卷和数据目录留着。和外接 PostgreSQL（agentlab.env 里的 AGENTLAB_DATABASE_URL）互斥，照实报错；已有 SQLite 库的数据目录不许 install --postgres（指向 migrate-to-postgres），别的数据目录留下的数据卷不拿来用。upgrade 先停旧服务、自动备份（SQLite 用备份接口拷到 backups/sqlite/，内置库 pg_dump 到 backups/postgres/，各留最近 BACKUP_KEEP 份），备份没做成就把旧服务起回来不升级；POSTGRES_IMAGE 换了时库的容器按新镜像重建、起不来就换回原来的。新增 migrate-to-postgres：停服务 → 备份 → 起库 → copy-to-postgres 先 --dry-run 再正式导入、核对 → 记下已切换 → 按内置库起服务；记下之前哪一步出错都退回 SQLite（服务原样恢复、库的容器停掉、状态记成 migrating），重跑先清空上次导了一半的再导，已切过的什么都不做，不是这个数据目录留下的数据卷不清空。容器、网络、数据卷、端口等可用 DEPLOY_<名字> 环境变量盖过（测试、并排部署）。package-docker.sh 把同一个标签的 PostgreSQL 镜像导出成 postgres-image.tar 一起打包（--no-postgres 不带），标签只在 deploy.sh 里定一处。单测用假的 docker（tests/fake_docker.py）核对先后顺序、生成的参数、互斥和各条回退 ThearchyHelios 2026-10-19 13:43:52 +08:00
  • bf74423651 dev.sh 加 --postgres：起（已经有就复用、停着就起）一个本地开发用的 PostgreSQL 容器，端口只开在 127.0.0.1（缺省 55432），数据在 docker 数据卷，密码第一次自动生成在数据目录的 .postgres-dev/ 里，后端按 PGPASSFILE 读、照它设 AGENTLAB_DATABASE_URL；容器名、端口、数据卷、镜像可用 AGENTLAB_DEV_PG_* 改，同名容器不是这个脚本起的、端口和已有容器的不一致都照实报错。不加就和原来一样：SQLite，不用 docker ThearchyHelios 2026-10-19 13:43:33 +08:00
  • 93cd32bc97 启动时等库：PostgreSQL 还连不上（和库的容器一起起、库还在初始化）时按退避重试（1、2、4、5、5… 秒），每次照实打一条「应用库还没就绪」，最多等 AGENTLAB_DB_STARTUP_TIMEOUT（缺省 90）秒再把最后一次的错抛出去；密码不对、库不存在这种等也没用的（SQLSTATE 28、3D、42 类）立刻抛；SQLite 不等。新增 python -m app.ops（部署脚本在容器里以镜像用户调的几件小事，只用标准库）：内置 PostgreSQL 的密码文件和 pgpass（0600，已有就沿用，密码不打印）、数据目录用哪种库的状态（sqlite / builtin / migrating）、SQLite 库的一致备份（备份接口，含 -wal 里的）和只留最近 N 份。copy-to-postgres 连不上目标库、库报错时一句话说清楚、退出码 1，不再甩一屏调用栈 ThearchyHelios 2026-10-19 13:43:32 +08:00
  • 94fd36027b 测试：隔离那两条先等 slow 前面那一步的断点落库再装「卡住、被接手」——LangGraph 存断点和下一步并行，PostgreSQL 全量满载时 slow 已经开始、断点还在写，一隔离那次写入就被拦下，接手的一边找不到断点（偶发「没有可继续的断点」） ThearchyHelios 2026-10-19 13:42:10 +08:00
  • 451c05aacb 文案检查：应用库、断点库地址写错时报错里给的地址示例（postgresql+asyncpg://用户:密码@主机:5432/库名 等）登记进 copy-allow.json——://、:、@ 是地址语法，用户照着改环境变量，不能换成全角 ThearchyHelios 2026-10-19 12:35:04 +08:00
  • bf9e4d4811 测试：额度并发那条同时占的个数降到 10（不超过连接池直接能给的连接数）——全量 -n auto 时 SQLite 的池子各测试共用，排队等连接会把池子的队列绑到前一个测试的事件循环上，这条偶发报 bound to a different event loop ThearchyHelios 2026-10-19 13:35:17 +08:00
  • 5b24480268 版本守卫拒绝启动的那句话改掉「混跑」（check-copy：「跑」不作动词）：不支持新旧版本同时运行，先停掉这些进程再启动新版本 ThearchyHelios 2026-10-19 13:33:07 +08:00
  • 62089f2849 复核「另外两处」：评测每题的时限、算期望的时限都不算排队等运行名额的那一段（within 代替 asyncio.wait_for，作答那次运行在 slots 里还排着队时不走表；算期望的运行排着队时把截止时刻往后挪），满载时不再被记成超时、触发止损；同源队（SourceLanes）跟发名额一样，拿这个源的咨询锁之前备好「哪些别的属主确实不在了」，持锁期间只用持锁的那条连接，拿锁之后才出现的属主这一次当活着。slots 加 waiting(run_id, here=)：本进程里的直接看、不查库。补测试：排队 0.8 秒、时限 0.3 秒照样答完不记超时（改前的写法这条不过）；within 暂停的那几段不算、不暂停照样超时；同源队持锁期间不查「谁还活着」、没了的进程照样让位、拿锁之后才出现的属主不删 ThearchyHelios 2026-10-19 13:31:46 +08:00
  • f3ff5b9c18 复核 R-b5、R-b6：转发运行事件、读缓存失效通知都从游标往回留一小段重读（运行 64 条、缓存 200 条），按发布过的 seq / 处理过的 id 去重——号先取后提交、号大的先提交时，号小的那一条后到也照样转、照样失效，不越过回放已经发过的那一段；合成之后超长的正文增量按字切成几条（二分找每段最长的前缀，不切坏 UTF-8），不再截掉。补测试：号小的后提交照样转出来、不重复；缓存失效 id 大的先到、小的后到都处理；超长增量切开拼回来一字不少 ThearchyHelios 2026-10-19 13:24:44 +08:00
  • 5578cf137d 复核 R-b4（prod.sh、Docker 入口读不到 .env 里的配置）：新增 python -m app.cluster workers——照后端自己的配置（环境变量和 .env 一起读）说起几个工作进程，SQLite 而大于 1 时照实报错、退出码 2；prod.sh 只在命令行给了 --workers 时写进环境变量，进程数一律问后端，Docker 的入口同样问它。补测试：SQLite 而大于 1 拒绝、PostgreSQL 照给的数 ThearchyHelios 2026-10-19 13:23:02 +08:00
  • 5f7100906f 复核 R-b3（SQLite 单进程多出来的写库）：SQLite 时守卫已经确认只有本进程——登记只写一次、不续租约、本进程直接当班（不写库）、接手只在启动时做，心跳只做本进程自己攒着的活；运行的名额在 SQLite 下放在进程里（规矩同一套：优先级、类别上限、交互留底，只是不落库），一段运行不再为要名额多写三次库。顺带（复核「另外两处」之二）：PostgreSQL 发名额持着全站的锁时不再另取连接查「谁还活着」，拿锁之前备好，不认识的属主这一次当活着。补测试：SQLite 空闲十来拍心跳、要一次名额放一次，PRAGMA data_version 不变（名额落库的写法这条不过）；库里的名额行那两条只在 PostgreSQL 上跑 ThearchyHelios 2026-10-19 13:22:05 +08:00
  • 96bb372ef3 复核 R-b2（单进程下周期整理退回判定中的待办）：当班进程隔一会儿的那一次接手（trust_mine）不论有没有别的进程，停在 resolving 的待办只收拾停了两个租约时长以上的，启动时又没有别的进程的那一次照旧全收拾；顺带把其余周期调用的整理过一遍——结果未知的写入只补停了两个租约时长以上的（收尾和安排核实之间的不碰），问数据没有任务行的老轮次只在启动时整理（老页面开的轮次建图时也是这个样子）。补测试：判定到一半当班进程来一次，待办照样记已处理、那一票不撤回（改前的写法这条不过） ThearchyHelios 2026-10-19 13:18:23 +08:00
  • 35ab097b45 复核 R-b1（卡住但没死的进程被当成没了）：续租约挪到单独的任务、专用连接（不走连接池，不被同一拍别的活拖住）；进程间请求另起任务办，不在心跳里等收尾；新增 cluster/fence 自我隔离——离上次续上租约超过一个租约时长，或者这段执行属于上一次隔离之前，执行在写事件、写断点、开审批、发外部写入、后台任务写库之前就停手（Fenced 是 BaseException，节点里的 except Exception 拦不住），续租时发现续晚了就隔离：停掉手上的运行和后台任务、不写终态，换一个身份重新登记；运行收尾先占住那一行、属主不是自己就不写；别的进程按租约过期再多等一个租约时长才算不在了（两边中间留一段）；run_events 的 (run_id, seq) 改成唯一索引（存量库先数重复，有就照实记日志、这一次不建，不让启动失败）。补测试：卡住期间被接手之后不盖终态、不写事件、序号不重；被接手的那次在别处接着跑完只结束一次、后面那一步只跑一次；收尾按属主写；撞号被库拒绝；多进程端到端加 6b、6c（真 SIGSTOP / SIGCONT） ThearchyHelios 2026-10-19 13:15:56 +08:00
  • 75ab3678cb 代码里拦住新旧版本混跑（用户拍板）：新增 cluster/version——代码版本（包版本 + 构建号 AGENTLAB_BUILD 或 git 提交 + app/ 下源码指纹，比较按源码指纹）、库结构版本（各表各列加迁移清单的哈希），进程登记时一并记下（cluster_workers 两列，add-only 迁移）。PostgreSQL 时补列之前先看一眼（preflight）：库里还有活着的、版本不同的进程，心跳在走就拒绝启动、照实写明是哪几个进程什么版本、要先停掉再升级，心跳停着的（强杀留下的）等租约过期再起；登记那一下在事务级咨询锁里再查一遍，两个不同版本同时启动只有先登记上的起得来。Docker 镜像带上构建号；README 写明升级步骤。补测试：版本不同的活进程被点名拒绝、同版本照常加入、过期的不算、只比源码指纹；PostgreSQL 上心跳在走的拒绝、心跳停着的等过期、登记时再拦一次 ThearchyHelios 2026-10-19 13:04:07 +08:00
  • d68ca9774f 加直连地址 AGENTLAB_DATABASE_DIRECT_URL 和 PgBouncer 事务模式开关 AGENTLAB_DB_PGBOUNCER（用户拍板）：依赖会话状态的连接——收发进程间通知的那一条（LISTEN）、跨进程的锁（会话级咨询锁，另建一个直连的小池子）、断点库（缺省）——走直连地址，普通查询走 AGENTLAB_DATABASE_URL，不设就全用同一个；开关打开时普通地址不用客户端连接池、关掉 SQLAlchemy 和 asyncpg 的预备语句缓存、预备语句用随机名字（照 SQLAlchemy 文档），事务级咨询锁照常成立；开关打开却没给直连地址时拒绝启动。README 写三种部署（直连、PgBouncer 会话模式、事务模式加直连地址）和要配的 server_reset_query，照实说没在真的 PgBouncer 上跑过。补测试：地址解析和规范化、断点库缺省走直连、事务模式关掉的几样、LISTEN 和跨进程锁走直连、事务模式没给直连地址拒绝启动 ThearchyHelios 2026-10-19 13:01:21 +08:00
  • 01af07b193 出具、按需视图的每日上限改成先占额度再发起（用户拍板）：新增 cluster/quota——额度记在库里（rate_counters 按名字 + 本地日期一行），占一份是一句带条件的 UPDATE（没到上限才加一），两种库上都是原子的，这一天第一次占按库里已有的记录起算，发起被拒或出错就退回。出具去掉全站一把锁，只留同一（运行、工作流、版本）的去重锁，几份不同的出具可以同时发起；按需视图的锁缩回按缓存键（视图 + 参数）去重，每日上限改用这个应用的额度。补测试：20 个协程同时占正好到上限、按已有记录起算、退回再占；两个进程同时占正好到上限；三份不同的答案同时出具正好到上限、多出来的回 429 ThearchyHelios 2026-10-19 12:57:26 +08:00
  • 6ed782a84b 运行名额改成给交互留底、其余可借（用户拍板）：交互留底缺省全站上限的 1/4、至少 1、至多全站上限减 1，应用、定时、系统三类合起来永远用不到留底；三类各自的上限缺省 = 全站上限 − 留底（设置里可调小），没人问数据时评测能开满；交互上限缺省 = 全站上限；等名额照旧按优先级、同级先来先得。存着的设置原样存、缺省按全站上限和留底现算；留底不小于全站上限时 422。设置页「运行并发」加「给交互留底」一项，写明留底和借用是什么，README 同步。补测试：缺省值、空闲时系统类借满到 全站 − 留底、留底不借给应用类、问数据一来马上拿到留底；多进程端到端加 5b（评测借满时问数据拿留底、不等评测跑完） ThearchyHelios 2026-10-19 12:53:28 +08:00
  • 319b787688 合入 nr8/l 的 e1ff1c90（问数据事件日志清理不给时间时按当前时间算） ThearchyHelios 2026-10-19 12:48:42 +08:00
  • 2935ac5d67 合入 nr8/a 的 3403a0b2（文案检查：地址示例的半角标点登记进 copy-allow.json） ThearchyHelios 2026-10-19 12:48:13 +08:00
  • e1ff1c9070 问数据事件日志的清理那一拍不给时间时按当前时间算：调度循环的 process_due 不一定给 now，chat/log.purge_tick、purge 以前拿 None 去减保留期就报错（多进程端到端里查出）。补测试 ThearchyHelios 2026-10-19 12:37:30 +08:00
  • 3403a0b2cc 文案检查：应用库、断点库地址写错时报错里给的地址示例（postgresql+asyncpg://用户:密码@主机:5432/库名 等）登记进 copy-allow.json——://、:、@ 是地址语法，用户照着改环境变量，不能换成全角 ThearchyHelios 2026-10-19 12:35:04 +08:00
  • e6a3ee8f95 转发运行事件时跳过不认识的事件种类（回放照样读得到）；test-multiprocess.sh 不带参数时 macOS 的 bash 3.2 报 args 未定义，参数直接原样交给 pytest ThearchyHelios 2026-10-19 12:30:30 +08:00
  • 09907b21f1 README：prod.sh 那一句照多进程改；多进程一节补连接数（每个进程多一条收发通知的连接，咨询锁持锁期间占一条；PgBouncer 事务模式下 LISTEN 和会话级咨询锁不成立，多进程建议直连） ThearchyHelios 2026-10-19 12:23:07 +08:00
  • 4e3623885b 合入 W2-a 的复核修复（nr8/a：导入的 NOT NULL 补值与孤儿行、收尾 dispose、sslmode 换算、PostgreSQL 写入去 NUL、不分大小写搜索 contains_ci、json_eq 两库同语义、JSON 守卫、用户可见列表补决胜键、bubblewrap --clearenv、部署脚本与原子写的几处、README 连接数预算） ThearchyHelios 2026-10-19 12:21:38 +08:00
  • 89cd135174 补多进程协调的单测（两种库）：别的进程用库里的行装出来（登记着的同伴、从没登记过的已经没了的进程）——谁还活着、名额按优先级先给交互类、一类到了上限不挡别的类、没了的进程占着的名额收回而活着的同伴的不碰、同源队几个进程共用且跳过没了的进程的位置、接手运行只碰属主不在了的（升级前没记属主的照不在了处理）、停止和记事件交给活着的属主、属主不在了的停止直接接手放弃、当班到期交接、同一本每日账并发记不越过上限、SQLite 第二个进程（以及 AGENTLAB_WORKERS 大于 1）拒绝启动；评测说明里的并发一段照现在的名额说 ThearchyHelios 2026-10-19 12:14:39 +08:00
  • 4a80936c38 多进程的跑法和说法：prod.sh 加 --workers（AGENTLAB_WORKERS，SQLite 时大于 1 先拦下），Docker 入口按 AGENTLAB_WORKERS 起 uvicorn --workers，dev.sh 写明开发时单进程；README 把各处「单进程前提」改成实话——SQLite 单进程（第二个进程拒绝启动），PostgreSQL 可多进程，新增「多进程」一节：怎么起、配置项、认领和租约与各类接手规矩、跨进程停止、运行并发的四类与缺省、调度当班、实时流、进程里的账和缓存（哪些进了库、哪些留在进程里及其影响）、多台机器的条件（共享存储同一路径、对时、NFS 上 SQLite 文件的实话）、升级要停掉全部进程、多进程端到端测试；deploy/README 补多进程。按需视图的锁改成按应用取（每日上限几个键之间也数得准），出具的锁改成全站一把（每日上限是全站的） ThearchyHelios 2026-10-19 12:08:17 +08:00
  • 1ab500dfbd README「用 PostgreSQL」按复核补全：SSL 的写法（sslmode= 自动换、证书走 PGSSLROOTCERT 等环境变量、别的 libpq 参数启动时报错）、没装 [postgres] 的提示、每个进程的连接数预算（应用库最多 30、断点池最多 20，max_connections=100 时起几个进程怎么算、怎么调）、孤儿行和 NOT NULL 空值导入时怎么处理、NULL 排序补写的范围和列表的决胜键、JSON 按类型比、文本列的 NUL、不分大小写的搜索看建库的区域设置、记录表 records/*.db 原地写要停服务或用 SQLite 备份接口拷；.env.example 补 SSL 的写法 ThearchyHelios 2026-10-19 12:07:31 +08:00