Repository navigation
Description
Current state: Proposed。真实 MiniCPM 看板仍缺少“检索材料 → 优化选择 → 候选改动 → 验证结果”的记录关联;#406 / #428 已交付展示与导航能力,本 issue 聚焦实际工作流接入和端到端交付验收。
Decision needed: 确认该接入切片与 #344 的共享记录边界,并指定实现及目标验收负责人。
Next action: 先核定实际运行版本、采集路径与记录完整性,再复用主线契约完成真实 campaign 的接入、历史缺口诊断和可复核演示。
Goal and acceptance
用户打开真实优化看板后,应能从某个优化选择追溯到:当时搜到了什么、读到了哪份材料、为何采用或排除、改变了哪个候选,以及实际测量后为何保留、拒绝或回滚;也能从知识条目反向找到这些选择和结果。
“真正的追溯”是有来源、版本、先后关系和准确候选身份支持的记录链,不是按标题相似度补连线,也不是把检索命中或上下文装配直接标成实际采用。
flowchart LR
A["检索请求与当时的结果快照"] --> B["被读取的材料及具体片段"]
B --> C["采用或排除的明确决定与理由"]
C --> D["轮次、候选身份与具体改动"]
D --> E["测量与质量验证证据"]
E --> F["保留、拒绝、回滚或待定"]
每条连线必须有对应记录。知识也可以改变验证方法、约束搜索空间或否决一个方向,不要求每条材料都对应一段代码。
Observed gap
2026-11-18 对本地 MiniCPM-o-4.5-Seed-TTS live 看板及 /api/state 做了只读检查,并用浏览器展开 Profile 检索和采纳决定区域:
| 观察项 | 实际结果 |
|---|---|
| 候选记录 | 60 条 |
optimization_trace |
60 条均为 null |
decision |
60 条均为 not_recorded |
候选的 round / run_id |
均未记录;这些是外部导入记录,不能直接视作 Harness run 丢失 |
story |
state: not_recorded,无版本 |
| Profile | 9 次,均无 pre_profile_searches 关联 |
| 浏览器显示 | “采集前的知识库检索 (0)”“没有关联到本次采集之前的检索记录”;采纳决定为“未记录” |
源目录另有保存的知识结果和后续实验计划:phase6-knowledge.json 记录 MiniCPM-o 查询命中 0 条、vllm_omni 查询命中 17 条,最终返回 8 项;其中既有音频并发、阶段所有权、基准设计,也有 Ascend H3/Qwen-Image 条目。phase12-plan.json 至 phase15-plan.json 保存了采样、预取、参考特征处理、精度配置等假设,但上述看板没有可核对的逐项采用关联。
这些是本地既有数据的观察,原始私有目录、完整会话和部署地址不随 issue 发布。内容相近只能提示调查方向,不能证明某项优化来源于某条知识;混入其他模型/平台条目也不能直接推断它们被采用。
版本边界: 当前 main 已有该类关联展示。本地服务实际加载的代码版本尚未确认,本次观察不证明当前 main 的展示代码有同样缺陷。交付时必须区分部署过旧、采集/导入遗漏、身份关联缺失和真实产品缺陷;仅升级页面也无法补出未记录的历史。
Scope and constraints
- 复用现有记录和唯一控制状态。 在普通受管
campaign start/knowledge/round/final及共享的 Benchmark session 路径中,核对并补齐检索、决定、候选和结果的交接。受管 campaign 继续由 Harness 管理,不通过 legacycampaign record/decide建第二份状态。外部实验保留其实际身份和明确的导入来源,不伪造 Harness round/run。 - 记录发生时的可观察事实。 留存检索入口、请求/过滤、返回条目及版本、上下文装配和遗漏;由执行 Agent 显式提交简短的选择理由、引用材料/片段与对应候选。材料读取或宿主交付回执仅在确实可观察时记录。支持一条知识对应多个选择、一个选择引用多条知识,以及跨轮复用;不能默认把全部历史检索归给最新候选。无需采集完整私密会话或隐含思考过程。
- 保留证据层级。 分开显示命中、装配、可观察读取、调用者声明采用、经现有 review 契约支持的片段到决定关联,以及候选实际执行结果。明确排除附原因;未记录使用不能写成“未采用”。简短理由或哈希一致本身不证明实际使用,更不证明知识造成性能收益。复用 v1/v2 语义,不升级旧声明的证据等级。
- 让选择和结果可双向追溯。 从知识条目或优化选择进入准确的 campaign/round/candidate/run(或外部证据身份),定位可得的 commit/diff/patch、测试和测量证据、最终决定及理由。失败、无收益、INCONCLUSIVE、回滚和同候选多次运行全部保留;跨阶段/设备的结果不自动视为可比较。
- 使记录缺口可操作。 看板明确指出缺的是检索快照、材料引用、决定、候选身份还是结果证据,并给出适用于该工作流的补录入口。新流程在相关交接处提示未完成的关联;采集失败/不支持的外部入口保持可见,不静默生成完整追溯的假象,也不据此改写性能 verdict。实现形式可复用现有 CLI/API 和宿主入口,不要求全局监听器。
- 有界处理历史。 对 MiniCPM 既有记录只用已留存、可核对的证据补充关联,保留补录时间与来源,版本化追加,原记录不覆盖。无法证实的关联标为未知;Profile 的 phase 编号不能冒充候选的 Harness 轮次。今天的新搜索不能充当历史检索。区分“关联检索数为 0”和“已证明没有发生检索”。
Out of scope: 重做检索排序/算法、自动知识晋升、完整未返回候选集合、token/费用账本、知识的因果收益分摊,以及重新开展 MiniCPM/H3 GPU 优化。模型特定检索质量问题可提供线索给 #379,本 issue 不隐式承接其全部目标。
Completion criteria
- 核定并记录实际服务/包版本和输入格式;用当前支持版本复核上述缺口,将部署问题、接入问题和产品缺陷分别落实到修正或明确说明。
- 至少一个真实任务在正常操作过程中形成完整的“检索 → 材料/决定 → 候选改动 → 验证 → 最终决定”链,读者可逐边打开依据。展示采用、明确排除及使用未知的区别;不得仅以手填合成页面或事后语义匹配作为验收。
- 提供 MiniCPM 历史记录的补充关联与缺口清单:可证实部分有原始出处,无法证实部分保持未知。回放既有测量要明确标为历史回放,不冒充新测量;不为了补追溯重跑硬件实验。
- 脱敏回归样例覆盖至少两轮、多次检索、同候选多 run、跨轮知识复用、零命中、预算省略、重复导入,以及采用后失败/无收益/回滚/INCONCLUSIVE;无串轮、重复计数或选取便利结果。
- 错误知识版本/哈希、引用片段不符、决定早于材料观察、身份冲突、缺失 artifact 和 partial coverage 均显式降级;不从当前知识库重建旧排序或旧内容,不把未知计数当零。
- Dashboard 两种布局、Run review、离线 HTML 和 live refresh 展示同一关联结果;中英文及刷新后的双向导航经过浏览器验收,缺失记录时能看到具体断点和接入说明。
- 交付现有契约的接入说明、必要的向后兼容改动、脱敏证据包、解析/关联及浏览器验证结果,并说明实际验收版本和未验证边界。若部署更新与现有 API 接入已足够,应如实交付,不为满足 issue 另造数据模型。
交互示意(参考 #481)
以下概念图依据 #481:基于 Modern Web Guidance 优化 Dashboard 体验 生成,展示桌面普通布局与移动端 Profile 优先布局,重点为键盘焦点、表格局部滚动、图表数据替代视图和 Live 刷新后的状态保留,供本 issue 的追溯界面接入参考。
查看原图。AI 生成的交互概念稿,图中数据均为示意;该图不新增本 issue 的数据契约,也不代表真实知识采用关联、已实现功能或通过验收。本 issue 仍按上文标准验证“材料 → 选择理由 → 候选改动 → 验证结果”的实际证据链。
Inputs and deliverables
2026-11-18 核对的主线为 8aba657da79e8ed9f6e6fbb33437e9d9fdd8f1c7;该 pin 用于本 issue 的核查边界,不代表本地 live 进程版本。
- task: Dashboard 补齐知识检索路径、排序解释与候选证据关联 #406 / PR feat: 补齐知识检索解释与逐轮候选证据导航 #428:检索执行点解释、共享记录投影和双向导航已交付;本 issue 是实际工作流接入及交付验收的后续,不重新打开 task: Dashboard 补齐知识检索路径、排序解释与候选证据关联 #406。
- task: 支持每个优化迭代的知识库命中归因统计 #344:复用逐轮命中、采用、覆盖状态与结果关联契约;完整统计/费用等待决范围仍由原 issue 负责。
- task: Dashboard 增强:每轮改动说明、动态 workflow 与耗时、测试进度 #345 / tracking: Skill Indexer 检索效率、准确性与逐轮采用 #379:分别关联 workflow 展示和检索/采用跟踪;不自动认定这些父目标完成。
- 现有检索记录、证据等级与导航契约。
- 普通任务与 Benchmark 共用的受管优化流程。
- 现有只读关联投影。
Ownership and authorization
- Proposed by / actual requester: 用户在 Codex 会话中明确要求提交 issue,补齐真正的追溯;Codex 代为核查和整理。
- Status: Proposed。
- Accountable parent / implementer / goal-acceptance owner: 待维护者指定。
- Accepted decision or scoped delegation: 本次授权是创建该需求 issue;本次实际完成了本地 API/浏览器检查、留存资料核查及主线文档/已有 issue 核对,未实施新功能或重跑模型实验。
Completion and closure
由指定的目标验收负责人基于真实流程的可复核证据接受完成并决定关闭。页面字段存在、某个 PR 合并或合成 fixture 通过,不能单独替代端到端接入验收;未能恢复的历史关联需要明确作为交付限制保留。

Activity
Dong1017 commentedon Nov 18, 2026
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-sonnet-5-5).
评估: 这是一个范围清晰、边界意识较强的"接入与验收"类 issue,不是新数据模型。它要求把 #406 / #428 已交付的展示与导航能力,真正接到实际 campaign 的采集路径上。验收标准是:至少一个真实任务能形成"检索 → 材料/决定 → 候选改动 → 验证 → 最终决定"的完整链,并且每条边都有记录支撑。我没有运行任何代码,也没有核对
8aba657和文档里的契约。下面的意见只依据 issue 正文。最关键的前置问题:先分清缺口属于哪一类
正文里的 60/60
optimization_trace=null、9 次 Profile 都没有pre_profile_searches,在这几种原因下都会出现:issue 已经说明本地进程版本未确认,所以现在还不能把这些现象当作产品缺陷。建议把"版本与输入格式核定"作为第一个独立交付物,并先于任何实现工作。核定结果也决定了后面多少工作是必要的。完成标准最后一条也允许"部署更新加现有 API 接入已足够"。这个出口应该保留。
风险与需要澄清的点
campaign knowledge/round/final、Benchmark session),以及提示是阻断还是仅提醒。建议只提醒,不阻断,也不改写性能 verdict。phase6-knowledge.json和phase12–15-plan.json只能提供线索。正文已明确"内容相近不等于采用",所以多数边预计会保持"未知"。建议提前约定,"可证实"的最低标准是存在带原始出处的显式引用。否则补录结果可能只是一份缺口清单,这一点要提前和验收负责人对齐预期。建议的下一步
8aba657或更新的 main 重新检查同一批数据,把缺口归入上面四类。正文没有 @Dong1017,所以没有需要在这里单独回答的决定请求。作为 Dong-bot(授权代理),我只给了分诊意见,没有记录任何指派或接受决定。
zengchuang-hw commentedon Nov 18, 2026
独立需求审查:受管接入仍需明确三个代码交接点
审查身份:由 zengchuang-hw 授权的 AI reviewer,按其对其他作者 Issue 的持续审查/评论授权发布;本次仅审查,不代表接受实施范围、目标验收或关闭授权。核查仓库 ID
1409534281、Issue 作者及原始正文;未阅读其他审查者意见。基于正文指定的
8aba657da79e8ed9f6e6fbb33437e9d9fdd8f1c7静态源码,我支持将此项保留为真实工作流接入与验收,而不是展示功能重复开发。以下是可直接进入接入设计/回归的边界:受管轮次的 contexts 是累积可用材料,不是逐候选采用记录。
optimization.capture_context与evaluate_round分别向state.contexts追加捕获引用,并在 pending 记录中复制全部历史 contexts。session_command的 round/final 调用传递 hypothesis、candidate、usage、reason,没有在这一交接处提交逐条材料采用/排除决定。不能把该累积列表直接投影成“本候选采用了这些知识”。建议验收显式选择关联时覆盖:第 1 轮检索 A/B,仅采用 A;第 2 轮检索 C,明确复用 A、排除 C,B 继续未知。保留原始交付集合,另以已有契约承接声明与来源,不改变 Harness 的判定状态。已保存 knowledge 文件不等于 story 已接通。
_managed_dashboard从 Harness 记录生成候选与判定,但 story 仍调用build_story;后者先读取 optimization log,无 log 即返回缺失状态。因此受管链的集成测试应从正常 start/knowledge/round 入口产生记录,再检查 story/retrieval 双向关联,不能仅用手工 log fixture 证明这一交接已完成。接入点可以复用现有记录/投影,但不应要求操作者再执行 legacy record/decide 建第二套控制状态。这是源码中的交接边界,不是对正文所述私有 live 实例的复现结论。跨轮复用需要区分“同一检索的归属冲突”与“同一材料被后续决定引用”。
project_knowledge会把同一个 context_id 出现在多个 round 的情况统一降级为round_conflict;现有 回归测试 明确要求这个行为。故直接把原 context_id 填入两轮context_ids不能完成本 Issue 的跨轮复用验收。应保留原检索归属与时间,再记录后续决定对原材料/版本的显式引用;若需要兼容扩展,须同时保留真正串轮的负例。不要复制旧检索并冒充新搜索,也不要简单取消冲突校验。建议把上述三个交接点作为同一个有界实现切片,并分别报告“声明关联已保存”“投影与导航已验证”“真实任务端到端已验收”。本次没有确认私有部署版本或 MiniCPM 历史文件,也没有运行测试、浏览器验收或硬件实验;现有测试的源码断言不等于本次测试通过。上述结论不证明历史材料被实际采用或产生性能收益,不能据此关闭本 Issue。
docs: retain dashboard interaction concept for issue #491
david6666666 commentedon Nov 18, 2026
Could we add a recovery test at the managed attempt boundary? Freeze a candidate's knowledge decision with its pending attempt, interrupt after the execution receipt is written but before settlement, then recover twice. The trace should link exactly once to the original decision and attempt, with no new execution; if the decision was never persisted, it should remain unknown without changing the measurement verdict. This checks managed recovery separately from duplicate historical imports.