qiaoqichaoandClaude Code
2e7e19471c
覆盖 AC-50/51/52（BR-48/49、E-28）。审计确认的 P1-3 缺口"历史提炼与卡片 不在实时 API 调用图上"由此关闭：提炼、候选治理、卡片进方案全部有真实调用方。 后端： - contracts：新增 E-28 EXTRACTION_UNAVAILABLE（运行级，不进 HTTP 信封）与 KnowledgeExtraction 记录类型。契约层强制"失败不得带候选"， AC-50「模型不可用⇒不产生候选」是类型约束而不是文档约定。 - services/experience_extraction.py（新）：真实提炼入口。模型不可用或调用失败 → 记 E-28 且 candidate_id 为空；不产半成品候选。传输纪律同 assistant_model （禁进程内代理、零重试），且 tools=[] 使"越权读材料"在结构上不可能。 自然语言修订同样必须真实调用模型，没有"把中文猜成条件"的回退路径。 - services/knowledge_cards.py：新增 current_draft/revise/list_cards 与 registry_conditions。修订只产草稿、保留 origin 与来源、升版本记 parent_version； test_cases 纳入可改字段——它是 component_evaluation 对自定义 Skill 的发布门禁， 不开放则提炼出的候选永远卡在评测门外。 - services/project_assistant.py：enqueue 改用 review_plan.assemble()， 让 T06-b 的依赖预检（E-19 可定位文案）与维度解析不再被绕过。 - api/prescreen.py：case-timeline、knowledge-extractions、knowledge-candidates （创建/修订/状态机）、review-plans（装配/状态机）。角色门禁与既有 /components 入口一致；id 与数据域由服务端生成；按 id 的路由一律在 run() 内 查归属，否则 KeyError 会变成 500 而不是 404。 - component_registry/review_plan：下沉 current_draft/version_key 与 list_plans。 前端： - 新增 /experience-center 独立入口（BR-50）与 ExperienceCenter 组件； AgentNav 增加「历史经验加工」。 - originBadge 此前零调用方、.origin-* 无任何 CSS——守卫只 grep 库文件字符串， 于是"测试通过但功能不存在"。本批补齐消费方与样式，并用左边框样式区分四种来源， 保证去色仍可区分（AC-42/BR-48）。 - 守卫语义按 AC-55 调整：由"禁止新建路由"改为"禁止重复页面" （面板不得搬到独立路由、已合并页必须保持重定向），并新增 experience-center-ui 守卫（已登记 verify.py，共 12 项检查）。 测试：新增 36 项（提炼 15 / 候选治理 15 / 卡片到运行 6），全量 unittest 无回归； 两次同项目运行对照证明卡片确实改变了核查结果，且 basis_ids 指向 卡片id@版本。 未闭合（记录在 17 的剩余缺口）：真实模型提炼尚未实测（需端点）； 界面未经浏览器点击验证；例外边界未进入可求值语言；规则类候选不在本批。 Co-Authored-By: Claude Code <noreply@anthropic.com>
兴邦智审 v2：开发文档入口
版本：0.2 · 2026-09-29 · 状态：用户已确认产品方向，工程规格待评审。
产品方向：评审经验驱动的 AI 预审。主审 Agent 综合判断，可切换专项判断模块（Jev 官方服务 / 本地开源模型）承担局部判断，确定性程序执行计算和规则；历史评审过程是核心经验来源。当前没有兴邦真实历史数据，演示不能宣称真实审批通过概率。
当前工作边界
原版源码恢复点已保存；已制作独立 Superdesign 交互原型，本轮补齐三模块闭环与开发交接。未创建独立 v2 代码目录、未实施新版 API / Jev / 历史过程提炼、未部署或覆盖现有服务。迁移仍是后续任务，见实施计划；不能把现有名字含 v2 的旧模块误认为本轮新版已完成。
备份基线：4d5a420671cb073a56335bd617e7d0812b8179a9，Gitea codex/backup-before-ai-prescreen-v2-20260928；已通过远程 SHA 比对。此前主线：b10093f9d8a949c6a6f8f8ed6d5b9c1bb044b569。详情见交付记录。
新开发者先读
先读 三模块闭环 理解产品，再读 开发交接与任务包 选择一个小任务。Claude Code 从根 CLAUDE.md 导入统一规则；可使用用户配置的 DeepSeek，编码模型与产品运行模型独立。
阅读顺序
| 文档 | 用途 |
|---|---|
| 流程适配 | 如何执行同事提供的八阶段规范 |
| 三模块闭环 | 历史经验加工、卡片装配预审、轨迹与真实评审反馈 |
| 开发交接与任务包 | T00–T13、最小阅读包、Claude/DeepSeek提示词与当前进度 |
| 交付纠偏规格 | 四批交付口径、四项禁止的"假接通"方式、BR-45 |
| 四批交付记录 | 每批的页面入口、操作步骤、实际结果、证据位置与剩余缺口 |
| URD | 用户、产品目标、功能、分期与产品验收 |
| 需求规格 | 七段规格、BR/E/AC 可追溯规则 |
| 架构 | 已有能力、目标边界、职责与 ADR |
| 详细设计 | 候选接口、数据契约、状态、失败处理 |
| 专项判断模型切换 | 无 Jev Key 的本地路径、统一契约、能力差异与切换验收 |
| 概率与沙盘联动 | 演示概率、可追溯依据与即时情景对照；真实概率校准边界 |
| 交互原型 | Superdesign 视觉方向、演示范围与原型验收 |
| UI Spec | 页面骨架、状态、权限和演示交互 |
| 设计契约 | 已观察视觉来源、语义 token 提案及缺口 |
| 实施计划 | 核心代码迁移与分批交付 |
| 验证方案 | 自动化、专家盲测和概率验证边界 |
| 部署与 Gitea | 当前真实入口、备份恢复和 v2 隔离要求 |
| 数据试点与展示 | 争取历史数据开放的演示脚本与试点方案 |
| 决策与未决项 | 已接受方向、候选决策、owner 与到期阶段 |
| 本次交付记录 | 备份证据、检查结果和未完成事项 |
阶段状态
- ① 用户已确认公司评审会通过为目标、初始材料介入、P0模拟数据、三模块闭环和可替换专项判断；规格、真实制度与标签映射仍待审阅。
- ②–④ 为支持需求评审提前记录的候选设计，不视为阶段门禁完成。
- ⑤–⑧ 文档描述未来实施、验证、交付和经验沉淀方式；本轮仅更新文档并执行文档检查；此前的原型和备份证据各自保存，不能推断本轮已远程备份。
- 现有基线测试结果仅证明旧版状态，不证明 v2 功能已经实现。
下一步
从 T00 完成首个实施切片的契约、依赖白名单、隔离路径和门禁审阅；随后按 T01–T11 分批实现模拟闭环。Jev接入可选，Laya须按任务验证。真实数据/概率留到T13，不能因文档完备就宣称已接通或已校准。