75 Commits

Author	SHA1	Message	Date
ThearchyHelios	8ed74bbe97	合入期 2 变化三分法（前端）：运行对比页（摘要、指标表、效应拆分、维度归因、查询与模板差异），运行详情加「与上一次对比」 ... # Conflicts: # frontend/src/types.ts # scripts/check-all.mjs	2026-10-05 12:50:04 +08:00
ThearchyHelios	4b972b4f43	定时任务前端复核修正（第 2 轮）：错过已跳过的悬停不再替服务端认定是超出补发宽限，没有记原因时不指向不存在的原因 ... 服务端把两种没有补发的触发都记成 kind=misfire、status=skipped_misfire：一是超出补发宽限，二是在宽限内恢复时 积压的那几次（只发起最近一次，更早的不补）。触发类型「定时」的悬停却一律写「错过后已超出补发宽限」，积压那条的 原因写的是「积压的触发不补，只发起最近一次」，同一行给出两个互相矛盾的原因，而这条明明是在宽限以内被跳过的。 - 触发类型的悬停改成不点明原因：「按计划应在此时触发，错过后没有补发，原因见本条记录」；本条没有记原因时去掉 「原因见本条记录」。 - 结局悬停的兜底说明（本条没有记原因时用）一起改：错过已跳过不再写「超出补发宽限」，两种原因都适用；发起失败 不再写「到点」（手动立即运行也会发起失败），也不再写「原因见本条记录」（用到兜底时本条恰好没有原因）。 - check-schedules 的触发历史夹具按服务端的原话各放一条积压不补、超出宽限的跳过，外加错过已跳过、发起失败各一条 没有记原因的；断言整行连同各处悬停只说本条记的原因，不说另一种，不指向不存在的原因。修复前这几项红 5 项。	2026-10-05 11:05:42 +08:00
ThearchyHelios	defd118ea6	定时任务前端复核修正（第 1 轮）：时区检查改成真能拦住，服务端会拒的组合当场拦下，修几处时序问题 ... - check-schedules：浏览器本机时区改成 America/Los_Angeles，和夹具里的 Asia/Shanghai、America/New_York 都不同。列表的下次运行和上次触发、触发历史 20 行、预览 5 个时刻，都改为比对按定时任务时区写出的原文；假预览照真服务端那样按所选时区排时刻。把页面改成按本机时区显示的变异会让 6 项变红。原先恒为真的「只读」断言改为真正检查写请求。 - 测试消息的结果：服务端的 message 只是补充说明时接在结局后面，已经是整句时不再套一层，状态码只写一次（webhookTestText）。 - 正式运行 + 工作流没发布、必填输入没填、填了已发布版本里没有的字段：照服务端保存时的核对规则当场拦下（新建总查；修改只在改了工作流、运行类别或输入时查），说明写在对应那一项下面。保存被拒、服务端指明 run_class 或 misfire_grace_s 时，说明也写在那一项下面。 - 保存被 422 拒绝后，改了被指出的那一项，字段下的说明和底部的「保存失败」就收起；名称框的 aria-invalid 和 aria-describedby 也把服务端的说明算进去。 - 时序：列表和详情页在写操作成功时作废还在路上的读，晚到的刷新不再把开关盖回旧值。详情页先开触发历史再切到设置时，版本对齐到表单所基于的那一份。保存途中又改了别的字段时，只保留途中改的那几项，替换过的 Webhook 地址不再以明文留在输入框里。 - 其他：预览时间改用 parseServerTime 解析；换工作流时，自动填的名称跟着换；开关遇到 409 用前端自己的说明，服务端原话放进详情；错过且超出宽限、没有补发的触发，类型写「定时」而不是「补发」；记录页的「定时」标记让读屏念出是哪个定时任务发起的。 - 未达标：记录页的「定时」标记在整行的按钮里面，键盘到不了。键盘能到的入口要加在运行详情的页头，或者把整行改成「打开运行」按钮和链接并排的结构，这两处都不在本包的文件范围内，留给集成时处理。	2026-10-05 10:26:22 +08:00
ThearchyHelios	c7a9116424	运行对比页复核修正（第 1 轮）：照服务端的实际输出改查询编号、无法比较的原因、读不到的基准和未保存工作流的说法 ... - 查询区不再拿服务端的 (node_id, ordinal) 当键和编号：配上的一对取本次的序号、落单的基准查询取基准的序号， Agent 换了查询先后时两者会撞上，React 报键冲突，「第 N 条」重复或缺号。改按同一节点在列表里出现的先后编号， 键是「节点:第几」。 - 「拆分或原因」一栏：无法比较、新增、移除的指标，服务端只把原因放在 reasons 里，这一栏原来只剩「—」，现在写 reasons 的第一句。不能拆的「为什么没拆」也写进展开的明细，窄屏上那一格横着滚也看不全。服务端有意不做维度归因 的几类，写明为什么不做。检查夹具改成服务端的实际形状（decomposition_note 为 null）：原来那一项是靠编出来的字段 通过的。 - 换基准下拉：当前的基准读不到时单列一项，写短 id 和「记录不存在」或「无法读取」，不再显示成另一次运行被选中、 选它又没反应。本次的记录读不到时写明原因并给重试，不再一直停在「正在读取」。运行卡读取失败也给重试，记录不存在 的照实写。 - 不属于已保存工作流的运行（没保存过，或工作流已删除）：「与上一次对比」不可点并写明原因，对比页也不再叫人去上方 选基准。服务端对这两种运行都不比。 - 错误说明：409 按机读码分「尚未结束并封存」和「封存核对不一致」，去掉界面上没有的「封存凭证条」。基准不存在时 提示在上方另选。找不到默认基准时，下拉里有能选的运行才说「可在上方选择」。 - 菜单查找基准超过 300 毫秒就挂一条提示；离开运行详情时取消请求，晚到的答复不再把人拽到对比页。 - 一边的 SQL 拿不到时不做逐词比较，另一边不再整条标成「独有」。SQL 注释整段算一个词，注释里的撇号不再吞掉后面的 语句。 - 分类、结构的悬停说明照服务端的分类口径改写；查询按「条」计数，和「第 N 条」一致。 - check-compare 按服务端的实际输出补上这些场景，并加段过滤 COMPARE_ONLY；check-all 里 compare 的耗时估计按实测 改为 45 秒。	2026-10-05 10:16:15 +08:00
ThearchyHelios	a0837cc82c	运行对比页复查修正：互换时不重取运行列表，拆分句的总变化为 0 时写「0」，展开控件只指向在场的明细 ... - 互换、换了本次之后，新的运行记录还在路上时沿用上一次知道的工作流：下拉不再先退回「正在读取」、再把同一工作流 的运行列表取一遍（能比的两次运行本来就是同一个工作流）；check-compare 补这一项 - 口径变了、数值却碰巧没变（两效应正好抵消）时服务端不给变化量的写法，拆分那句话的总变化写「0」，不再写成 「两者之和等于总变化 无变化」 - 指标展开、查看 SQL 的按钮只在明细展开时才带 aria-controls，不指向页面上不存在的元素；参数前后两个值之间的箭头 对读屏补一句「改为」	2026-10-05 09:06:18 +08:00
ThearchyHelios	72da2e178a	运行对比页对齐服务端的实际输出：变化百分比按百分数写，归因、遮罩、差异说明照服务端给的显示 ... 对照运行对比后端的实现核过一遍字段的写法： - delta_pct 服务端已经乘过 100（12.5 是 +12.5%），占比 share 仍是小数（0.4 是 40%），两处分开格式化；原先把 delta_pct 也当小数，会写成「+1250.0%」 - 维度归因服务端只给前 10 项、另有几项写在 note 里，照写；归不了因（查询结果截断、度量列遮罩、快照读不出来）时 给空的 rows 和一句说明，只写说明、不画空表；万一多给了仍只列 10 项并写明另有几项 - 约定之外服务端顺带给的几项按可选字段用上：输入的 masked（两边写「已遮罩」，不标变了）、查询的 differences （结构变了差在哪，列在并排的 SQL 上面）和 problem（快照读不出来、与哈希不一致）、模板配置项的 labels（按节点 类型翻好的叫法，键名放进悬停提示；没给或对不上时照写键名） - 找默认基准时的 404 分两种：本次这条运行不存在（机读码 run_not_found）写「运行记录不存在」，其余写「未找到 可作为基准的运行」 - check-compare 的夹具照服务端的写法改，补上述几种情形；菜单入口另查「问到基准之后才跳」（先跳到只带本次的地址、 再让对比页去找，原先查不出来）；check-all 登记实测耗时	2026-10-05 08:58:34 +08:00
ThearchyHelios	e8cc4bd88b	定时任务页：列表、新建与编辑、触发历史、Webhook 设置与测试 ... 占位页换成真页面。/schedules 是列表，/schedules/new 新建，/schedules/:id 是详情（设置、触发历史两个标签，?tab=history 直接打开触发历史）；App 里只有带 id、不带 id 两条路由，「new」在页面里认。 列表每行写名字、工作流、频率的中文说法、下次运行（相对时间加按定时任务时区的绝对时间，悬停写时区，本机时区不同时另给本机时间）、上次触发（发起了的链到那次运行、写运行现在的状态；跳过、发起失败写结局，悬停写原因），右边启用开关（role=switch，点了就带版本 PATCH，409 时说服务端的原话并重新载入）、立即运行（发起了给「查看运行」直达，跳过、被拒照实说原因）、编辑、删除（站内确认框写清后果）。空态说明定时任务是什么、怎么建；老服务端没有接口时说暂不支持，不露 Not Found。列表 30 秒原地刷新一次。 表单：工作流可搜索（combobox，名字空着时用工作流名填上，新建时按发没发布替人选运行类别）；频率五种预设生成 cron，切到自定义时带上当前预设的 cron；右侧（窄屏在频率下面）预览接下来 5 次触发，停手 400ms 再问、新请求作废旧请求，非法时清掉上一次的时间、把服务端的说明写在出错那一项下面并标 aria-invalid；时区默认本机、列常用时区和偏移；运行类别写清正式运行要已发布、每次按当时的发布版本发起；输入按运行类别取字段（正式运行取已发布版本的），每个字段可点变量插在光标处，旁边写按下次触发渲染出的结果；重叠策略和补发宽限；Webhook 的格式、地址、签名密钥、订阅事件、发送测试消息（只测已保存的设置，改了没保存时不让测），保存过的地址只显示 url_hint、可替换或删除，密钥只说「已设置」、可替换或清除；通知里运行链接用的服务访问地址读写设置的 notify 组。 保存只交改了的字段并带版本，409 时表单不动、给「重新载入」（有改动先确认）；保存的这段时间里人又改了，留着新改的；有未保存的修改时离开先问。详情页的开关和表单各记版本：开关前后没有别人插进来时表单跟着用新版本，页头是在别人改过之后刷新出来的，表单照旧带旧版本、保存时由服务端说清。 触发历史 20 条一页、加载更多带 before 往后接（去重，从头重取时作废还在路上的那一页），写计划时间、类型（定时 / 手动 / 补发）、结局（已发起 / 上次未结束已跳过 / 错过已跳过 / 发起失败）、原因、运行链接和每条通知的结果。	2026-10-05 08:56:41 +08:00
ThearchyHelios	4deffd62f7	定时任务前端底座：接口约定的类型、api.schedules、页面用的纯函数和文案 ... types.ts 末尾一段写定时任务的接口约定（Schedule、Fire、预览、变量、立即运行、触发历史、Webhook 测试），字段名和形状照前后端共用的约定，不各自发挥；运行列表的 schedule_id 用同名接口合并补在这一段，不去改上面 Run 的定义。 api/schedules.ts 挂上全部接口：列表、详情、新建、修改（只带改了的字段和读到的版本）、删除、预览（可取消，丢掉过时的请求）、变量、立即运行、触发历史分页、发送测试消息。 pages/schedules/model.ts 是不碰 React 的纯函数： - 频率预设和 cron 互转：每天 / 每周（连着三天以上写区间）/ 每月 / 每隔几小时（只给 24 的约数，*／5 在跨天处会断）/ 自定义；填得不完整时返回空串，不拿猜出来的频率顶上；认不出的 cron 一律算自定义、原文照放 - 按定时任务自己的时区写时间（Intl 取各段再拼中文，周几、偏移照算），本机时区另给；距下次运行先取整再判档 - 表单和请求体互转：修改时和打开时的表单比，只交改了的字段（cron 写法不同但人没动不算改）；Webhook 按约定地址省略即不改、空串即删除，密钥省略即不改、空串即清除，交 Webhook 时格式和事件总是一起交 - 表单的问题按字段给出，写在对应的输入框下 terms.ts 的 SCHEDULE_TEXT 写全定时任务页的文案；占位页的两条先留着，换成真页面时删掉。「钉钉」是 Webhook 的产品名，会被「钉住」那条规则误报，在 copy-allow.json 里登记一条例外并写明理由。	2026-10-05 08:56:02 +08:00
ThearchyHelios	e6c77ea4ee	运行对比页（前端）：两次运行的指标变化按数据、口径、模板与 SQL 拆开讲 ... - 运行详情「更多」加「与上一次对比」：先问 compare/base 找默认基准再跳到对比页；没封存、还在运行的不给点； 找不到基准时留在原页，提示服务端给的原因，并可去对比页手动选择基准 - 对比页（/runs/compare?target=…&base=…）：顶部两次运行（名字、时间、类别与版本、定时来源、未封存标记，可点进 各自详情）、互换、换基准下拉（运行列表接口按工作流取，未封存的列出但不能选）；摘要条八类的个数照服务端的 summary，点一类只看这一类；指标表用服务端渲染值，能严格拆分的并列口径效应和数据效应、画两截条形，并写明两者 之和等于总变化，不能拆的写服务端给的原因；展开看变化说明、输入对比、维度归因前 10 项（没有占比时写原因）； 查询区标结构状态，只参数变列出字面量，结构变并排两条 SQL 逐词标出各自独有的部分；模板区写版本、变化的节点和 配置项；说明照实列出 - 加载、找基准、409（未封存或封存核对不一致）、422（不是同一工作流）、404、找不到基准、空对比都写清楚；请求按 「本次 + 基准」取，换基准、互换时丢掉过时的答复，开发模式的 StrictMode 下同一份对比也只请求一次 - 窄屏表格在自己的框里横向滚动（指标名一栏钉住，展开的明细按可见宽度排），深浅色下分类标签、差异高亮对比度都 在 4.5 以上 - check-compare.mjs 换成真检查：page.route 假接口覆盖入口、摘要、分类、拆分、归因、SQL 并排、换基准与互换、 过时答复、各类错误、窄屏和深浅色	2026-10-05 08:43:32 +08:00
ThearchyHelios	26595b70f7	合入期 1 数字推演沙盘：证据面板里改口径卡的输入、排除查询结果的行，即时看指标和报告引用处的新值；推演只读、不写运行记录，醒目标注推演非出具；口径卡的容器型输入此后另存完整值 ... # Conflicts: # scripts/check-all.mjs	2026-10-05 07:53:42 +08:00
ThearchyHelios	633af950db	数字推演复核修正（第 1 轮，界面）：整份结果在推演区里勾行，只让用到的行可勾，勾完结果就在手边，加载中和失败后不摆上一次的答复 ... - 整份结果、数组字段作输入时，输入下面给「勾选要排除的行（共 N 行）」，按页取整份快照来勾：证据链里没有它的查询步骤、 或者查询步骤只给前后 2 行时也勾得全 - 查询步骤里的勾行表格只让这个指标用到的行可勾（row_span），别的行禁用并说明没用到，勾了也不发请求 - 勾行表格底下带推演结果（旧值 → 新值或原因）和「回到推演结果」；勾完、答复回来后各把它带进视野一次（答复回来时上面 的内容会变高，把表格往下挤） - 推演的请求和答复提到片段那一层，推演区和查询步骤共用一份；答复回来之前随改动变的部分变淡、标为忙，请求失败时结果、 排除标记、报告中会变的地方、下游口径卡都不显示，不拿上一次的答复充数 - 整个指标推演不了（口径卡没记输入）时只说原因，不再同时写「无可推演」和「无变化」，也不画勾选框 - 快照读不出来的输入写「查询快照无法核对，不显示原值」；没有能改的输入、也没有能勾的行时说一句为什么 - check-whatif 补对应检查：整份结果勾行、上下文行不能勾、勾完结果整个在视野里、封存核对未通过、加载中和失败后、整个 指标推演不了、窄屏里的勾行表格；ESTIMATE 按实测改成 28 秒	2026-10-05 05:43:17 +08:00
ThearchyHelios	e7c8d2a1f3	可验证报告复核修正（第 1 轮）：运行信息拿已核对的事件对照，报告徽标连同数字一起算，遮罩判定宁严勿宽，各分支在浏览器里有确定的检查 ... - 页面核对加 ⑥ 运行信息：运行结果看封存范围内最后一条结束类事件的类型，运行类别看运行开始事件记下的运行参数， 出具档位认最后一条出具判定（不再信元信息指的那一条）；页面显示事件里的值，元信息写得不一样算不通过、计入总览。 工作流名、版本、起止时间、节点名称绑不进封存，单列一组写明取自运行记录，封存说明里也写明要到系统里一并对照 - 报告标题旁的徽标连同正文里的数字一起算，旁边写分项：重算全部哈希的伪造只在 ⑤ 露馅，徽标不能还写着通过。 分块条目多时不通过和无法核对的都列在外面，有无法核对的显示「部分无法核对」和分项计数；⑤ 改叫「数字与取值」并分开数， 读屏分别读作数字、取值，「显示格式由服务端渲染」只附在带出处的数字上；无出处数字的说法改成未使用引用标记 - 服务端不会给出的状态算不通过：被引用的工件不在清单里、非查询快照标着遮罩、工件既没内容也没说明；报告文档导出时 已不在服务端，总览不再是绿色的通过，写「有 N 份报告未能核对」，报告处写明是服务端已没有这份文档 - 认 json.dumps 写出的裸 NaN / Infinity，没被改过的文件不再误判不通过；哈希对得上但读不懂的照实写「无法核对」， 和哈希不一致分开说 - 宽屏打开出处面板时正文让出右边一栏，表格里右对齐的数字不再被面板盖住；补上斜体（不用后行断言，较早的 Safari 也能执行） - 封存哈希、运行 ID、工作流名直接写进页面，不执行脚本时写「尚未核对」而不是一直「正在核对」；脚本挪进 head， 执行后核一遍页面顶部写出的封存哈希和数据里核对用的一致 - 成果节点和运行结束事件的规范字符串，只在封存范围内每次数据源查询都对得上无遮罩的快照（或确实没交回数据）时才给： 升级前的运行从工具快照认出查询快照，协作团队成员的查询认不出就按带遮罩算，数据源现在设了遮罩的按工具名就挡 - 封存核对不一致的 409 改成一句固定的话，不再叠冒号、让人去本来就在的记录页；失败结束的运行在页面封存说明和导出提示里 写明之后继续运行会重新封存；记录页上左边写着「已封存」却不能导出时，原因写在屏幕上 - tests/bundle_samples.py 用虚构数据真实生成九份样本页（遮罩快照、两份报告、早期运行、失败结束、两条出具判定、 服务端缺文件、裸 NaN、别的运行的文档），check-bundle 断网打开逐项断言，在上面篡改引用链、运行信息、拿掉被引用的口径卡， 量宽屏面板，看不执行脚本的样子；把核对改成恒通过、徽标不看数字等七种改坏法都会变红。pytest 补遮罩判定的三种形状、 事后设遮罩（去掉接线即变红）、页面静态内容和样本页本身	2026-10-05 05:30:50 +08:00
ThearchyHelios	cf038c95f5	证据面板加数字推演：指标步骤上「推演」，改输入、勾掉查询结果里的行，看这个数和报告怎么变 ... - run/WhatIf.tsx：推演区。顶上醒目横幅「推演，非出具：不会写进运行记录，也不会改动报告」，运行未封存另行提示； 旧值 → 新值和变化量（比率、百分数写「个百分点」）、推演代入式、输入（数值可改：停顿 450 毫秒或回车、失焦才提交， 写的不是数提示并保留上次的结果，Esc 退回）、不支持推演的输入和原因、报告中会变的地方（可定位）、可能受影响的 下游口径卡、恢复原值；加载、失败（可重试）、空态都有。新改动来了旧请求直接丢掉，答复按请求体缓存 - EvidencePanel.tsx：MetricPart 挂「推演」开关和推演区；QueryPart 只在推演时把结果窗口换成带勾选框的表（WhatIfRows）， 勾掉的行划掉、遮罩列照旧写「已遮罩」。草稿按（运行、报告、口径卡、指标）认，同一个指标的几处引用之间来回切不清空 - 接口 api.whatif.run、推演相关类型（types.ts 末尾独立一段）、WHATIF_TEXT 文案 - 预览用例 ?syn=whatif / whatif-rail 和 check-whatif.mjs（54 项，用 page.route 假接口）：请求体、防抖、回车、排除行、 恢复原值、收起、不支持的输入、遮罩列、加载 / 失败 / 未封存、390px 与 360px 右栏不横向溢出、深浅色横幅对比度	2026-10-05 04:04:30 +08:00
ThearchyHelios	d85b634f75	记录页封存凭证条加「导出可验证报告」：已结束且已封存的运行可下载，不可用时说明原因 ... - api.bundle.download 取文件和服务端给的文件名（优先 RFC 5987 的 filename*，没有再看 filename），下载照 EvidencePane 的写法 - 按钮只在运行结束且已封存时可用；运行中、等待审批、接着跑（留着旧封存）、没有封存清单时禁用，悬停和读屏都说明原因； 服务端回 409（封存核对不一致等）时提示原因 - 文案进 BUNDLE_TEXT；预览用例 dev/fixtures/bundle.tsx（已封存、运行中、等待审批、未封存、接着跑）给 check-bundle 用	2026-10-05 03:58:13 +08:00
ThearchyHelios	90dac0992b	复核套件骨架（前端）：节点库加双盲复算、反方审稿（把关类，图标、配色、空配置，说明和卡片写明尚未生效，检查器照常打开）。路由加 /runs/compare（排在 /runs/:runId 前，标签页标题写「运行对比」）和 /schedules、/schedules/:id，都是页头加「功能开发中」的占位页；导航和命令面板在设置前加「定时任务」，快捷键 ⌥8，设置仍是 ⌥7；八个导航项在 480px 高的窗口里放不下，矮窗口的导航项从 40px 收到 36px。请求层从 api/client.ts 拆到 api/http.ts，client.ts 原样转出原有导出并加转请求函数；schedules、compare、bundle、inquiry、whatif 各一个空的命名空间文件，从 http.ts 取请求函数、挂到 api 上，不和 client.ts 互相导入。terms.ts 给各包占好文案块（RUN_COMPARE_TEXT 和配方对照的 COMPARE_TEXT 分开）。审批卡留两个插槽：payload.kind 为 dual_check 时的 DualCheckApproval，报告核对概况后面的 ChallengeSummary，都先返回 null。预览页自动收 dev/fixtures/*.tsx 导出的 cases，?syn= 先查这里再走原有用例。check-shell 跟着改导航项和快捷键的断言，check-copy 的 for_model 检查把 http.ts 和 client.ts 合起来看	2026-10-04 23:40:20 +08:00
ThearchyHelios	46330dfd96	模型不在价格目录里时运行金额写「金额无法估算」，不写 $0：真实运行里 token 记到了上百万，金额却是 $0，看着像没花钱。llm.end 发出时，用了 token、模型却不在价格目录里的标 unpriced（目录里标 0 价的本地模型不算）；运行用量按 llm.end 数出 unpriced_calls，成功的运行也补上（状态里的用量分不出 0 是免费还是没价）。运行详情、画布运行面板、航迹的金额：一分都没估出来写「金额无法估算」，估出一部分写「≥ $x」，悬停说几次调用不在价格目录中。check-trace 补断言；流式用量测试和注释里的真实调用次数换成概括说法	2026-10-04 12:27:38 +08:00
ThearchyHelios	fa842a7bec	交给人工审批的报告，探索运行也在节点里裁判结论句：审批人批准前就能看到判了几句、几句证据相矛盾。按需裁判要等运行封存之后才能判，封存前放开会动证据清单的完整性约束，所以这种报告改在节点里当场判，和正式运行同一条路；没有审批的探索运行照旧按需判，不在节点里花钱。审批节点审哪几份报告的认法抽成 reviewed_report_ids，审批卡和报告节点共用，两边说的「要人审」对得上。审批卡上没开裁判的探索报告改写「这份报告没有开启结论句裁判……开启后，交给审批的报告会在批准前判完」；开了裁判却没在节点里判的老运行另给一句。助手指引、出口契约注释、前端类型注释同步；审批暂停时按需裁判仍拒绝，测试改成只看点击不多一次调用	2026-10-04 12:03:14 +08:00
ThearchyHelios	ee0700eca6	合入 FA：结构化抽取截断重试、写作清单按模型窗口定预算并按来源均衡、缺失断言交回重写、日期时间按可读格式显示	2026-10-04 11:43:21 +08:00
ThearchyHelios	4e1adec205	审批卡标明运行类别、附上审的报告的核对概况：真实运行里审批说明写着「批准后才会正式出具」，那却是一次探索运行；报告里一句结论和证据相矛盾，审批人批准时完全不知道。人工审批的卡上加一行运行类别和批了会怎样（探索运行写「批准后输出，这是探索运行，不是正式出具」，正式运行写从已发布版本发起）；human 节点挂起时，上游直接连着的、或标题和说明里引用了正文（nodes.<id> 或报告的 assign_to）的报告撰写节点各带一份核对概况（payload.reports：同 report.checked 的 stats、结论句策略、裁判摘要、报告文档工件 id），卡上写「N 个数字都有出处」和结论句的核对状态（节点里判过的写判了几句、几句证据相矛盾；没开裁判或探索运行写「结论句尚未核对」），并给查看逐段证据的入口，点数字打开证据面板。check-stream 补断言	2026-10-04 11:29:04 +08:00
ThearchyHelios	546d0e9326	没有数据目录的大库：助手「参考了 N 张表」那一行提示先起草目录。真实运行里的大库一张目录都没有，挑表和 SQL 检查都用不上目录，用户也不知道该先去起草。服务端 context 操作的每个数据源多带 source_id 和 catalog_tables（去掉驳回项后还有内容的表数）；前端 copilotContext 在要挑表的大库 catalog_tables 为 0 时给出下一步「这个数据源还没有数据目录，起草后挑表和 SQL 检查会更准」，入口直达 /data/catalog/:sourceId（几个库时点名，老服务端不给目录表数时不提示）。check-decode、check-stream、check-chat 补断言	2026-10-04 11:28:49 +08:00
ThearchyHelios	799c80b97e	清单有省略时不许断言「没有数据」：写作规则加一条，核对认出缺失断言交回重写一次，仍有的只标注 ... 一次真实运行里写作者只看到上百次查询里的前二十来次，却写出「某类数据缺失、本轮没有查到任何结果」这样的断言，可那个 Agent 实际查到了上百条记录。 - 写作规则：清单有省略、或有来源的结构化结论为空时，不得断言没有查到、不存在、缺失、没有数据，只能写「本报告未覆盖」并说明依据不足 - 组装文档：清单有省略时按一组明确的说法认出缺失断言（没有查到、未查询到、查不到、没有任何记录、数据为空、数据缺失、不存在相关记录、暂无数据等；「不存在明显差异」「不代表没有数据」这类不算，代码块不查），记新违规 absence_claim，带 span、所在片段和原句 - 和句中的 [[see:]] 一样归入 REWRITE_ONLY：交回重写一次，重写后仍有的只标注、不判失败；只剩这几类时不再按最多重写次数反复重写。仍有时报告节点发 report_absence_claim（带 count、texts），运行复核算作缺口 - 证据面板的违规清单标「缺失断言」并写明为什么依据不足，时间线给 report_absence_claim 专门的一行，文案在 terms.ts；check-decode、check-evidence 补断言 - 没展开的查询的摘要在没有表结构快照时从查询快照里的 SQL 认表名 - 回归测试：合成的门店、会员、卡券、活动库真跑「4 个 Agent 并行查库 → 报告」（查询次数虚构、分布悬殊），覆盖抽取截断重试、两次截断记空值、清单均衡和缺失断言的重写	2026-10-04 11:28:23 +08:00
ThearchyHelios	ab9d45c428	数据目录 F2b：剖析报告和目录页读结构化字段，不再从原话里认——服务端最小改动：码值候选的结论带 pending（还有几个含义待填写），关系的结论带 cardinality_checked；报告里「N 个含义待填写」读 pending，基数写「已用数据核实」或「子表一侧未核实」读 cardinality_checked，挑表时跳过的空表读 empty_tables 列出来；表详情的关联关系标出基数已核实；剖析说明不带日期后，码值弹窗的说明后面按这一项的 updated_at 写时间；补后端测试和检查脚本的断言（假答复的 summary 不再写待填写）	2026-10-04 03:06:14 +08:00
ThearchyHelios	88c63bfd41	合入集成分支 feat/data-catalog（d897981，含 F2a 的证据面板、时间线和服务端修复）：自动合并，没有冲突；catalog_profile._relation_finding 两边的改动（F2b 的 previous_status、F2a 的 cardinality_checked 写在关系上）互不重叠	2026-10-04 02:52:28 +08:00
ThearchyHelios	ac4ea030a8	数据目录 F2b / B3：发布前检查里 SQL 检查的问题带上和证据面板同一个级别标识（错误 / 提醒），并说清两个发布级别拦不拦：错误级在已发布级别只提醒、不拦，受管级别会拦下；结论那句话里点出其中几处是 SQL 检查的错误级问题，不再和「没指定模型」这类提示一个样；检查脚本的伪造门禁补上没有口径卡的图；补检查脚本的断言	2026-10-04 02:36:26 +08:00
ThearchyHelios	6263725c2a	降档时报告页顶部写明出具档位和原因（B5）：出具声明和 issuance 事件另带结构化的 sql_checks（哪次查询、问题、受影响的引用、对应的缺口），证据页签在报告上方放出具横幅，SQL 检查导致的降档单列一块写在显眼处、不在其余缺口里重复；不是完整出具时「N 个数字都有出处」不再画成绿色	2026-10-04 02:33:15 +08:00
ThearchyHelios	ec818d5b69	数据目录 F2b / B12：合并查询连好上游就自动带出输入——查询节点连到合并查询时加成一行，和连线同一步撤销；别名按查询的主表起（visits、orders，去掉库名、引号和注释），取不到再按标题里的英文，都没有用 q1、q2，不再用节点 id；重名加序号、避开 SQL 关键字；连线时还没选工具的，选上后检查器给「带出连着的 N 个查询节点」一次补齐；手动「添加输入」也按主表起；补检查脚本的断言	2026-10-04 02:30:36 +08:00
ThearchyHelios	a5a68488f0	数据目录 F2b：助手「建议更新数据目录」卡片补上服务端对一项的说明（新增的关联关系没写基数、又推算不出来时 PatchChange 带的 note），写在那一项下面；解析时保留 note；补检查脚本的断言	2026-10-04 02:19:38 +08:00
ThearchyHelios	46c3fd3093	A6 扇出检查只在一对多确有其事时报错误：关系人工确认过，或数据剖析在数据上核实过子表一侧的键不唯一（关系上记 cardinality_checked，子表太大没核对的不算）才给 error；只凭外键结构推出的一对多降为 warning，说法改成「可能重复计算」，下一步写确认关联表里每个键只有一行、或先汇总再关联；人工编辑提交里带的 cardinality_checked 不作数；级别说明「结果必然有误」改为不夸大的说法；2B、F1 的测试按新规则更新：外键 + verified → warning，剖析核实过 → error，人工确认 → error	2026-10-04 02:19:26 +08:00
ThearchyHelios	0df5e7d4af	A2 模型起草一项都没写进去时不再算成功：认出没有 tables 外壳的单个表对象；结构化输出是空壳（只有表名、没有可用字段）时改走纯文本再问一次；某张表最终没有可用内容记 model_error「模型没有给出这张表的可用内容」；起草结果每张表多一个 model_items（模型给了几项可用内容），界面据此区分「和现有目录一致」与「模型没给内容」；「没有变化」改为只说起草出的内容与现有目录一致，另加「目录没有更新」一句；假模型能模拟空壳、单个对象、某条路不可用三种实测回复	2026-10-04 02:19:26 +08:00
ThearchyHelios	15d5caf19f	运行时间线：查询那一行用 SQL 检查清单列出 tool.end 带来的检查结果，副标题数一下错误和提醒；并行的两个查询节点用同一个工具时按「节点 + 工具名」配对，结果不再配错节点（A1）；指标所依据的查询没通过检查那一行读结构化字段（受影响的指标、问题、检查结果），「打开设置」改为「打开「取数」的 SQL」，落到来源查询节点的 SQL 那一栏而不是口径卡（B2）；口径卡不完整、合并查询的警告也改读字段，不再按中文原话解析；助手自查的 SQL 检查问题和证据面板共用 lib/sqlcheck 的读法，关系编号不再丢失	2026-10-04 02:18:45 +08:00
ThearchyHelios	0c65b4bea6	助手「参考了哪些表」展开后，按需求挑过表的数据源排在最前面（请求里点名的库不再压在一串小库后面）；带字段的表和只提供了表名的表分开数：标题写「参考了 26 张表的字段」，副标题写「另有 206 张表只提供了表名」	2026-10-04 02:18:14 +08:00
ThearchyHelios	b328341a86	数据目录 F2b / B9：在目录页改过目录（编辑保存、确认、驳回、填码值）之后，表头也说「已保存。N 个已发布模板引用这张表，下次正式运行时会提示数据目录有变化」，和助手卡片保存后同一句；带「查看模板」跳到影响面一栏，可收起，没有模板引用时不说；补检查脚本的断言	2026-10-04 02:15:23 +08:00
ThearchyHelios	1483af474c	数据目录 F2b / B8：确认含义还空着的码值时先说清楚——「确认本列推断」原本一键确认，「确认本表全部推断」和单项「确认」也一样，码值里有含义待填写时问一句「有 N 个码值的含义待填写，确认的是取值清单」，确认后这些码值仍显示「含义待填写」、还能填写；补检查脚本的断言	2026-10-04 02:11:31 +08:00
ThearchyHelios	163f3b96b3	数据目录 F2b / B7：剖析报告里关系的结论按实际变化说——原本就是已验证、这次照样核实的写「仍为已验证，覆盖率 x」，从推断升上来的才写「升为已验证」，已验证降回推断的写「降为推断」；服务端最小改动：关系结论多带 previous_status（剖析前的状态），summary 同步写「仍为有确证」；补后端测试和检查脚本的断言	2026-10-04 02:09:47 +08:00
ThearchyHelios	31305a352d	数据目录 F2b / B6：剖析报告里点「填写含义」，填完（保存或取消）回到报告，不用重新剖析：刚填的一列改写成「含义已填写」、按钮换成「修改含义」，焦点落在下一列还有待填写的「填写含义」上，一列接一列地填；正在编辑这张表时说一声再回报告；补检查脚本的断言	2026-10-04 02:06:47 +08:00
ThearchyHelios	b9ce058848	数据目录 F2b / C1：清单筛选「全部已确认」改为「没有待确认项」，「有未确认项」改为「有待确认项」，概览、顶部摘要、排序同步改写——「已确认」专指人工确认，只有已验证项的表不再说全部已确认；悬停写明已验证的项由外键约束或数据剖析核实、不需要逐项确认；补检查脚本的断言	2026-10-04 02:00:48 +08:00
ThearchyHelios	bba57972c2	合并查询的列追不到逐格来历时，证据面板也看得到输入查询的 SQL 检查：合并步骤的每个输入带上它自己的检查结果（不带给模型的那句），界面在输入下面列出级别、规则名和说明；集中加上证据面板和运行时间线要用的文案	2026-10-04 01:59:26 +08:00
ThearchyHelios	48ac7dbc92	数据目录 F2b / B10：顶部摘要点进来只列运行中查询过的表，和摘要同一个口径——摘要说「4 张还没有目录」，清单就是那 4 张；清单上挂「只看运行中查询过的表」标签，可取消；筛选按钮的数字按同一口径算；补检查脚本的断言	2026-10-04 01:54:14 +08:00
ThearchyHelios	37d2f1d1d4	合入完整性修复 F3：Agent 查库的模板也记目录版本并提醒「可能涉及」，只探查了部分表时清单、目录页和助手上下文都说明，升级入口接上 SQL 检查，截断判定和工具节点遍历各收成一处	2026-10-04 01:28:59 +08:00
ThearchyHelios	9c02833544	数据目录 F3 / B4 界面：目录页顶部说明「这个数据源共有 N 张表，只探查了前 200 张」，写明为什么只取了这些、其余的助手也看不到，下一步回到数据源卡片换 schema 或缩小范围后重新探查；助手「参考了哪些表」那一行截断了的库写「共 N 张，只探查了 200 张」；补检查脚本的断言	2026-10-04 01:25:19 +08:00
ThearchyHelios	3ece89872b	数据目录 F3 / B1 界面：运行横幅、时间线和版本历史把 Agent 可能查询的表和直接引用分开说——直接引用写「有变化」，可能涉及写「Agent 可能查询的表有变化」并另起一组；版本历史按新的发布记录两组列出，发布之后才建目录的表也列；补发布记录两种写法的单测和三个检查脚本的断言	2026-10-04 01:24:50 +08:00
ThearchyHelios	b078d08ffe	数据目录 F1-A4：码值项加「已列全」标记（complete: true），只有人工明确勾选、或剖析整表统计（没有只看前若干行）得到的码值才有；码值不在码值表中的检查只认标了它的码值表，给模型的话改为提示核对取值，不再叫它照目录里的码值改。以前经对话只补了 status=9 表示作废，之后 status = 1 就被报提醒，模型还可能把对的 SQL 改错。提案补充码值时沿用原有的标记、自己不能标；目录页的码值编辑和填写含义弹窗加「已列出全部取值」勾选，表格里标「已列全」，检查脚本跟上	2026-10-04 01:13:13 +08:00
ThearchyHelios	fd3ec43662	数据目录 F1-A2：在目录页去掉外键约束、命名推断、数据剖析、模型起草得出的关联关系改为驳回、保留编号，只有人工添加的才真正删除；改了两端的旧关系同样驳回。以前删掉的推断关系下次起草又加回来，关系图按表结构现推也会带回来，照样驱动 SQL 检查和助手挑表。表结构推得出的人工关系（人工改过基数的外键关系）去掉时也只驳回。编辑界面上这类关系不给「删除」只给「驳回」（保存时等同单项驳回，可撤销），检查脚本跟上	2026-10-04 01:07:35 +08:00
ThearchyHelios	cece781b5a	合入集成分支（阶段 2A 数据剖析、4B 剖析与 SQL 检查界面及修正）到 4A：两边功能都保留 ... 冲突的解法： - 后端 api/catalog.py：同时导入 catalog_impact 和 catalog_profile、SnapshotTampered；data/catalog.py：__all__ 取两边的并集重排。 - 2A 放宽了码值校验（含义可以为空，剖析写进来的是「含义待填写」）：目录修改提案的码值补充改为含义为空的码不覆盖已有含义、 只在原来没有这个码时加进去，补了测试；卡片和过程里的码值把空含义写成「含义待填写」，和目录页同一个说法。 - 前端 types.ts、terms.ts：两边各在同一处追加了新段落，按顺序都留下（提案、影响面、目录版本在前，剖析、码值、SQL 检查在后）， 没有重复的键；client.ts、decode.ts、CatalogPage.tsx、TableDetail.tsx 的导入取并集。 - check-catalog.mjs：影响面和剖析、保存数据源三条假路由都留下，各节和最后核对真库数量的逻辑不变。 - 4A 的测试数据源改用 tests/fixtures/sources.py 的 drop_source 删除，顺带作废连接池。	2026-10-03 12:35:47 +08:00
ThearchyHelios	71cc07e31a	检查跟上数据剖析和 SQL 检查：数据目录覆盖剖析设置、确认与进度、报告、各类 409、含义待填写；证据、解码、助手面板和发布前检查各加 SQL 检查的展示与定位；文案补齐 409 的下一步，码值的填写入口收窄	2026-10-03 12:21:42 +08:00
ThearchyHelios	bfa391e344	数据目录阶段 4A 发布与运行：发布时记下模板 SQL 用到的表的目录版本，正式运行时目录有变化就发提醒事件、不拦运行，运行详情和时间线显示提醒，版本历史显示发布时的目录版本及之后的变化	2026-10-03 12:11:14 +08:00
ThearchyHelios	e30d28a0d6	数据目录阶段 4A 摘要提示：目录页顶部写明运行中查询过的表里还有几张有推断项未确认、几张没有目录，点击切到对应筛选并按使用次数排序	2026-10-03 11:55:45 +08:00
ThearchyHelios	958e096e56	数据目录阶段 4A 影响面：新增接口列出引用某张表的已发布和受管模板，区分直接引用和可能涉及、合并查询按输入追溯，表详情和保存纠正后都显示	2026-10-03 11:52:49 +08:00
ThearchyHelios	5d7b652149	证据面板和运行时间线显示 SQL 检查：查询步骤列出级别、中文规则名、说明、涉及的表和列与 SQL 片段，指标步骤在未通过时加标识和原因，时间线把指标所依据的查询未通过 SQL 检查说成一行并给出下一步	2026-10-03 11:49:42 +08:00
ThearchyHelios	6ce01f0b0d	数据目录页加数据剖析：选范围、确认预算后开始，进行中写已用时长并说明无法中途停止，报告列出查询用量、停止原因、每张表的关系核实、码值候选、业务日期提议和跳过的项；各类 409 写明下一步，未开启的就地打开设置；码值含义为空时显示「含义待填写」并可逐个填写	2026-10-03 11:45:51 +08:00