本层内容

模型档案契约与来源元数据。本层基于 feature/model-profile-data，属于现有 9 层模型接入改造 Stack。

• 业务代码：1998 行（新增 + 删除，限额 2000 行）。
• 测试代码：1809 行，不计入业务限额。
• 档案 TOML：0 行；其他说明/配置文件：3 行。
• 本层提交：c02d2cfe96dbd46daecf0ac2b3818fe5d2de8333。

主要文件区域：

• sdk/nexent/core
• frontend/package.json
• sdk/pyproject.toml

Stack 顺序

1. [WIP] 模型与提供商档案资料（仅档案与来源说明） #4118 — 模型与提供商档案资料（仅档案与来源说明）
2. [WIP] 模型档案契约与来源元数据 #4119 — 模型档案契约与来源元数据
3. [WIP] 档案组合与协议适配 #4078 — 档案组合与协议适配
4. [WIP] 出口规则与模型执行服务 #4082 — 出口规则与模型执行服务
5. [WIP] 历史配置桥接与模型出口结构 #4083 — 历史配置桥接与模型出口结构
6. [WIP] 模型出口管理与配置契约 #4120 — 模型出口管理与配置契约
7. [WIP] Agent 与会话统一模型参数 #4121 — Agent 与会话统一模型参数
8. [WIP] 共享会话控件与参数偏好 #4122 — 共享会话控件与参数偏好
9. [WIP] 模型添加、编辑与批量接入界面 #4097 — 模型添加、编辑与批量接入界面

请按上述顺序审阅与合入。完整 Stack 的最终文件树与已验收源码 dec8c396089d4a28f5ca524b918c2879ddbd60ad 一致；整体业务代码 15972 行、测试 22631 行、档案 TOML 4984 行。

本地验证证据摘要

• 分层检查：304 条依赖约束、8 层 SDK 导入检查、59 套 SDK 测试 / 1747 用例通过；后四层前端类型检查通过。
• 后端：24 套隔离测试 / 1211 用例通过，另 DAL 38 用例通过。
• 前端：Workbench 373 用例通过；相关组件 78 个不同用例有通过记录。组合运行曾出现 1 次超时，隔离复跑通过；全仓前端仍有记录在案的历史 13 个失败断言及 1 个收集失败。
• 升级迁移：以真实 v2.7.0 安装为起点核对 19 条模型记录，比较 14 条 LLM 的新旧实际请求体；4 条非 LLM 保持原配置，1 条无效地址单独隔离。核对原 Agent/会话数据并验证重复迁移不新增。
• 实际运行：旧 CodeAgent 会话、普通会话、Workbench、调试窗口与子 Agent 参数隔离均有真实模型/工具调用和 8 条 Langfuse 完整链路验收记录。
• 最终 Docker 容器页面/API 验收通过；Agent 参数弹窗已验证思考开关、程度、保存回显、取消修改和出口默认值隔离。
• 标准 AMD64 Docker 离线包已构建、拷回并校验，包含数据处理与轻量 Sandbox。运行验收使用 ARM64 VM；目标 AMD64 设备尚未实机安装。

上述容器验收覆盖完整产品源码；中间 PR 的证明范围是相应导入、单元测试、类型与依赖检查，并未逐个部署中间层容器。最后的 dec8c3960 仅增加 2 行测试替身修正，业务文件与容器及离线包源码 343072656 一致。

验证基线与合入边界

已验收基线：develop 377fe37a2a1b50d102eb599889dc9b73c89968ad。发布时上游 develop 为 54c102306ca902acb7158e3a177ed29cdad28694，后续新增内容尚待合入兼容性检查及相关回归。本轮同步的是已验收版本，保持现有 9 个 Draft PR。

验收范围为模型档案、出口、迁移与 Agent/会话参数；SPEC 中未来 NativeAgent 内核等未验收项目保持原状态。CI/Codecov 按用户要求不等待。

静态合并检查：与发布时最新 develop 合并时存在两处文本冲突：frontend/app/[locale]/newchat/ui/model-selector.tsx、sdk/nexent/monitor/monitoring.py。这两处属于验收基线之后的上游变更，需在合入前解决并完成相关回归。