feat(v2): 完善配置中心与可替换轨迹质检并联动预审依据

docs/v2/25-configuration-and-quality.md

@@ -0,0 +1,52 @@
+# 配置中心与专项质检迭代规格
+
+## 1. 需求与术语
+来源：用户确认两类角色、四类卡片、方案发布、概率依据与沙盘联动、助手查询及可替换 Jev，并明确要求开发跑起来。配置管理员管理能力；客户经理使用已发布方案。正式通过指公司评审会通过。模拟情景值不是校准审批概率，证据雷达表示核验阶段，模型质检结果不是审批。
+范围：统一配置入口、模板/数据卡创建、卡片隐藏、真实目录助手、自然案例展示、轨迹专项质检。真实历史校准、自动训练/自动发布不在本轮。
+
+## 2. 数据与接口契约 / 架构
+复用 assistant_objects：component_availability 按组件稳定 ID 保存 hidden:boolean；component_draft/component_version 原治理不变。隐藏是独立可用性状态，不篡改历史版本。
+新增 /library/configuration/cards（管理员创建 data_card/template 草稿，复用 registry.draft）；/cards/{id}/visibility（管理员 PATCH）；/inventory（项目授权目录查询）；/quality/settings（管理员 GET/PUT）；/quality/probe（管理员 POST）；/projects/{id}/quality（读历史、POST 指定 run_id）。请求 extra=forbid，非法配置422、权限403、无对象404。
+新增质量配置只写 backend/xingbang_data/quality-settings.private.json（受管、忽略提交）；公开配置不含 Key。quality_review 追加冻结 provider/model/revision/rubric/input_hash、检查结果，不改 run。模型配置修改只影响新检查。服务 owner 为 catalog_configuration、trajectory_quality；API owner 为 workbench_configuration；不进入主审 tool 白名单。
+本地模式支持 loopback/内网 OpenAI-compatible 服务（Ollama/vLLM），不依赖 Jev Key；Jev 使用官方 systemone typed questions，仅模拟域明确允许外发时发送白名单技术摘要（步骤状态、核查码、证据引用计数），不发送材料原文。无 Key/未允许外发明确失败，不默默切换。
+
+## 3. 表面规格与 UI 决策
+沿用已批准深色导航＋浅色工作区；新增配置中心资产/评审方案/模型与质检三个区，四类卡片标签、来源文字和颜色、发布/隐藏动作。业务页显示实际卡片与动态维度、当前情景组合及对照。现有42/58/51/64暂保留人工情景表，给出表口径与对应 Skills 依据，绝不编造每卡贡献百分比。模板仅影响报告结构。
+轨迹增加“专项质检”页签：选运行→检查→定位问题步骤→回到过程；规则审计即时执行，可选本地/Jev补充窄问题判断，结果与会议标签分开。助手查询依据后端授权目录，客户经理只读已发布可见卡片，管理员可见草稿与隐藏。
+状态：loading/ready/empty/error/submitting；提交中保留内容禁用按钮；错误由 API code/message 绑定；颜色兼有来源和状态文字，focus-visible 与 reduced-motion 沿用业务 CSS。中文文案就近维护，未建设统一 i18n 不宣称已有。
+Superdesign旧原型为已批准视觉来源；本轮源码外发上下文最初被自动审批拒绝；用户随后明确授权，已完成 Superdesign 同一草稿 v4 替换迭代。实际页面遵循既定方向；浏览器视觉验收仍未观测。
+
+## 4. 业务规则
+- BR-72：隐藏组件禁止进入新方案装配/运行，冻结历史仍可回放。
+- BR-73：四类卡片创建/发布/隐藏仅配置管理员执行，发布保留原独立评测审核。
+- BR-74：方案可选发布模板；模板不改变核查和概率。
+- BR-75：助手卡片查询按项目与角色筛选真实目录，不使用通用主机工具。
+- BR-76：案例展示自然企业名称与业务记录，数据域与来源仍明确为虚构，不改已存选择快照/历史轨迹；旧的未确认查询预览若内容哈希变化会失效，须重新筛选。
+- BR-77：质检配置凭据私有，按版本冻结，失败不补分，关闭不生成模型判断。
+- BR-78：质检不改审批概率、主审结论或自动发布经验。
+- BR-79：概率解释显示实际组件维度和模拟情景表，禁止声称卡片贡献是真实统计因果。
+
+## 5. 异常
+- E-45 COMPONENT_HIDDEN（装配异常文案标识；既有运行 API 保留原错误信封）：新装配引用隐藏组件；“评审方案存在隐藏组件，请更新配置后重试”。
+- E-46 CONFIGURATION_INVALID：格式、地址、类型非法；“配置不合法，请检查必填项与受信模型地址”。
+- E-47 QUALITY_UNAVAILABLE：无Key/外发未允许/模型不可用/输出非法；“专项判断未完成，主审记录保持不变”。
+- E-48 HTTP 403（沿用既有 HTTP detail 身份错误形状，不新增 JSON code）：客户经理修改配置或访问其他项目；配置入口沿用“当前身份无权进行经验加工”，项目范围沿用“无权访问该项目”。
+
+## 6. Given/When/Then 验收
+- AC-84（BR-72/E-45）：Given 已发布方案，When 隐藏依赖，Then 新装配拒绝而旧版本读取与回放不变。
+- AC-85（BR-73/74/E-46/48）：Given 两类身份，When 创建模板/数据卡及修改可见性，Then 仅管理员成功，非法内容拒绝；模板可选且仍需评测和独立发布。
+- AC-86（BR-75/E-48）：Given 项目草稿、隐藏与发布卡，When 经理/管理员询问 Skills 数目，Then 经理仅见已发布可见范围，管理员见其授权全目录，跨项目不泄漏。
+- AC-87（BR-76）：Given 240条虚构案例，When 再次初始化/展示，Then 名称自然且唯一、财务值与历史快照不改、来源仍标模拟。
+- AC-88（BR-77/E-46/47）：Given disabled/local/Jev配置，When 保存、检查及模型畸形输出，Then Key不返回；关闭跳过、缺Key失败、有效窄问题输出保存版本。
+- AC-89（BR-78）：Given 冻结运行，When 质检完成或失败，Then 原运行哈希、概率和组件版本保持相同。
+- AC-90（BR-79）：Given 任意方案，When 展示/勾选沙盘，Then 实际维度和卡片关联保留、固定情景值标明模拟、真实概率为空。
+
+## 7. 决策与阶段证据
+用户已确认产品方向和实施授权；接口、权限、存储、状态与边界已按现状定案，①–④门禁由本规格与调用方核对提供。⑤实现后必须测试全部对应规则并执行 scripts/verify.py，⑥–⑧证据另记交付记录。概率校准 owner 数据试点、需要真实历史与独立时间留出集，不阻塞模拟环境；Jev实时质量验证需有效Key，未接入不能标有效。
+
+
+## 实施补充事实
+- 内置只读数据源 source.project-facts 与数据卡 data.initial-finance 只投影当前项目已确认的财务事实；不把初步材料猜测变成已确认字段。已有方案不被自动加入新卡片，管理员选择并发布新方案后才使用。
+- 模板选择进入冻结方案，业务助手生成报告使用该运行选定模板，并保留其冻结版本，后续模板发布不改变旧报告。
+- 卡片治理/方案治理的旧测试身份已从审核员迁移为两位独立配置管理员；经理仍可查看和运行预审，但不得创建、修订、评测或发布卡片方案。
+- Jev HTTP 契约来源：[官方 API](https://docs.typesafe.ai/api)、[官方快速开始](https://docs.typesafe.ai/introduction/quickstart)。模型输出严格验证；本地判断为布尔结果，Jev Noul 的单题概率不转换为审批概率。

docs/v2/26-configuration-delivery.md

@@ -0,0 +1,35 @@
+# 配置中心与轨迹质检：本轮交付记录
+
+日期：2026-10-01。需求基线见 [25 配置与专项质检规格](25-configuration-and-quality.md)，覆盖 BR-72–79、E-45–48、AC-84–90；编号以规格正文为准。本文件区分已实现与未验证内容。
+
+## 已实现
+
+- 两种工作身份：配置管理员管理四类卡片、隐藏/发布状态和评审方案；客户经理使用已发布且可见的方案。新方案不能引用隐藏卡片，历史运行保留冻结版本。
+- 数据卡、Skills、Rules、模板卡的来源有文字及颜色标识；AI 提炼卡仍需独立发布审批，不能自审发布。
+- AI 预审展示冻结 Skills/Rules 的核查结果、证据数量及建议，沙盘联动雷达图的前后状态。雷达表达证据成熟度，不将面积解释为概率。
+- 助手查询实际授权范围内的卡片，轨迹复盘可按实际运行及步骤定位核查，并保存独立质检记录。
+- 轨迹质检可选择关闭、本地兼容服务或 Jev。配置入口为「配置中心 → 模型与质检」；密钥仅保存在后端私有配置，接口不返回密钥。模型意见不能修改主评审概率或自动发布经验。
+- SQLite 中有 240 条虚构的对公金融租赁业务案例，名称、初始材料、补件及会议结论更贴近业务。统一保留模拟来源标识；不能作为兴邦真实历史数据。已确认财务事实可通过内置数据卡读取，金额口径及项目隔离有测试。
+- Superdesign 已经用户明确批准上传指定前端上下文后完成 v4 设计。原型位于 https://p.superdesign.dev/draft/c58e9d1b-4813-44af-9b1a-344a47eda928 ，设计结果保存在 .superdesign/approved-refresh.html。
+
+## 验证与运行
+
+统一验证证据：`test-evidence/20261001-170230-1adbe16/REPORT.md`，16 项检查全部通过，包括 613 个后端测试、前端检查和生产构建、两份 Compose 配置以及 diff 检查。证据记录的提交为验证开始时的恢复点；实际被测工作区代码另有 SHA256 清单 `test-evidence/configuration-verified-source.json`，交付时核对清单，不能将原提交误称为本轮修改提交。
+
+入口：http://127.0.0.1:3220/prescreen-workbench 。配置中心：http://127.0.0.1:3220/configuration-center 。后端隔离端口 8020。启动使用 scripts/start_v2_preview.ps1，隐藏启动窗口、禁用进程内代理并记录本任务进程，不停止旧版服务。
+
+运行中接口检查记录：`test-evidence/live-configuration-smoke.json`。检查五个页面可访问、240 条案例来源、按角色查询 Skills、管理员设置权限、冻结卡片依据，以及关闭模型情况下的实际规则质检。HTTP 可访问不等于完成浏览器点击和视觉验收。
+
+## 恢复与备份
+
+改动前恢复点：1adbe16cb3df604b0f4c4199d7e8104fc235c685，已在 Gitea。SQLite 备份为 `test-evidence/pre-config-refresh.sqlite3`；数据库、私有配置、密钥及测试运行日志不进入 Git。交付代码提交和远程分支 SHA 的核对保存在本机 `test-evidence/configuration-final-receipt.json`。
+
+远程为 http://192.168.10.111:3000/qiaoqichao/mini-openclaw-v2.git ，本轮备份分支为 codex/sqlite-experience-workbench。远程默认分支为 main，本轮不合并主分支、不发布镜像。备份只表示可恢复的代码版本。
+
+## 尚未验证与下一轮验收
+
+42%、58%、51%、64% 仍来自模拟场景表，不是经真实历史样本校准的预测；没有编造单个卡片贡献几个百分点。雷达及卡片依据解释核查状态，不能证明概率计算有效。
+
+Jev 请求契约和本地模型兼容接口有测试，但没有真实 Jev Key 的端到端联调，也没有本地判断模型的质量评测。默认模型质检关闭，运行检查验证的是确定性规则审计。真实材料外传不在本轮授权范围。
+
+浏览器自动化工具无法建立会话，视觉及点击验收标记 Unobserved，由用户在运行页面验收。后续需在真实历史数据获准接入后，按时间切分建立初始材料快照、独立最终审批标签与校准评测；另行收集人工标注的轨迹质量样本。本轮不声称概率模型、真实 Jev 评测或生产数据机制已生效。

docs/v2/README.md

@@ -53,3 +53,7 @@
 当前实施与验证：[SQLite实施规格](21-sqlite-implementation.md)、[本轮交付记录](22-implementation-delivery.md)。历史条目保留为当时事实，后续状态以本轮代码和证据为准。
 
 一期收尾：[收尾规格](23-completion-spec.md)、[验收与最终交付](24-final-acceptance.md)。
+
+本轮迭代：[配置与专项质检规格](25-configuration-and-quality.md)。
+
+本轮运行与证据：[配置中心与轨迹质检交付](26-configuration-delivery.md)。