d909d1bd1b
实现侧： - 上下文：任务范围拆分为 范围校验/范围授权；索引按可发现口径重建、索引新鲜度改对称差；依赖校验统一快照漂移说明。 - 知识方法：方法与材料读取口径统一；超限方法材料按可选省略，核对路径不再二次计费；删除无合同的读时重算。 - 任务运行：新增 context.usage/tool.denied 事件类型；连接池常驻并在装配生命周期内开关；调用结算与核对分列。 - 效果评测/审校修订/交付连载/作者经验/作品规划：凭据冻结、标定消费、导出补证、事实引文核对等收尾修复。 - 资源加载：能力正文不再夹带索引用的导航注记（该注记此前进入角色与技能的模型提示）。 - 元数据：受保护骨架与代码保护属性对齐；字段校验与内置结构口径同步。 - 基础设施：环境预检进入装配生命周期；数据库连接运行期字段不参与相等比较；索引指纹归一化 jsonb 浮点。 - 删除被替代实现：7 份旧提示词模板与空壳 资料来源 读取器。 用例侧： - 用例身份与导航元信息迁移；夹具补生命周期、同库暴露与模板封存； - 本轮定向修复：方法材料省略、事实引文、迁移回执、额度与暂停用例、慢用例超时预算等。
164 lines
6.3 KiB
Python
164 lines
6.3 KiB
Python
"""探索清单形状校验纯函数：顺序、身份、类型与来源绑定的确定性拒绝；离线不连库。"""
|
||
|
||
from dataclasses import replace
|
||
|
||
import pytest
|
||
|
||
from muse.上下文.接口 import 上下文错误, 探索条目, 校验清单, 记录探索
|
||
from muse.任务运行.接口 import 工具来源, 工具结果
|
||
|
||
范围 = {
|
||
"work_id": "work-a",
|
||
"as_of": 2,
|
||
"source_ids": ["doc-1", "plan-1", "fact-lin"],
|
||
"documents": [
|
||
{
|
||
"chapter_id": "ch-1",
|
||
"branch_id": "main",
|
||
"revision": 1,
|
||
"document_id": "doc-1",
|
||
"document_hash": "hash-doc-1",
|
||
"position": 1,
|
||
}
|
||
],
|
||
"directory_revision": 3,
|
||
"authorized_by": "author-a",
|
||
"run_purpose": "production",
|
||
"content_purpose": "generation",
|
||
"target_plan": {
|
||
"chapter_id": "ch-3",
|
||
"plan_id": "plan-1",
|
||
"revision": 1,
|
||
"content_hash": "hash-plan-1",
|
||
},
|
||
"facts": {"system_revision": 5},
|
||
}
|
||
|
||
读取结果 = 工具结果(
|
||
内容={"chapter_id": "ch-1", "text": "林深停在码头"},
|
||
来源=(
|
||
工具来源("doc-1", "1", "hash-doc-1", "visible-text-codepoints/v1:production:generation"),
|
||
),
|
||
)
|
||
|
||
|
||
def 条目(调用ID: str = "call-1", 工具名: str = "read_history_document", 参数: dict | None = None):
|
||
"""用真实读取结果形状构建顺序为 1 的清单条目；覆盖字段由用例自行 replace。"""
|
||
return 记录探索(
|
||
(),
|
||
调用ID,
|
||
工具名,
|
||
参数 if 参数 is not None else {"chapter_id": "ch-1", "revision": 1},
|
||
读取结果,
|
||
)[0]
|
||
|
||
|
||
def 顺序清单(*调用: tuple[str, str, dict]) -> tuple[探索条目, ...]:
|
||
"""按调用次序经记录探索构建顺序连续的合法清单。"""
|
||
清单: tuple[探索条目, ...] = ()
|
||
for 调用ID, 工具名, 参数 in 调用:
|
||
清单 = 记录探索(清单, 调用ID, 工具名, 参数, 读取结果)
|
||
return 清单
|
||
|
||
|
||
@pytest.mark.case_id(
|
||
"NC-ctx-replay-manifest-order",
|
||
environment="离线纯函数",
|
||
given="顺序不连续的探索清单",
|
||
when="校验清单",
|
||
then="CONTEXT_INPUT_INVALID 拒绝，顺序必须连续可核对",
|
||
contract="docs/系统架构/新版设计/模块设计/B09-上下文.md",
|
||
)
|
||
def test_顺序断裂拒绝__b7e0b1() -> None:
|
||
跳号 = (条目("call-1"), replace(条目("call-2"), 顺序=3))
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单(跳号, 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|
||
assert "顺序" in 异常.value.说明
|
||
倒序 = (replace(条目("call-1"), 顺序=2), replace(条目("call-2"), 顺序=1))
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单(倒序, 范围)
|
||
assert "顺序" in 异常.value.说明
|
||
|
||
|
||
@pytest.mark.case_id(
|
||
"NC-ctx-replay-manifest-duplicate",
|
||
environment="离线纯函数",
|
||
given="调用ID重复的探索清单",
|
||
when="校验清单",
|
||
then="明确拒绝，不猜测去重",
|
||
contract="docs/系统架构/新版设计/模块设计/B09-上下文.md",
|
||
)
|
||
def test_重复调用ID拒绝__b7e0b2() -> None:
|
||
重复 = (条目("call-1"), replace(条目("call-1"), 顺序=2))
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单(重复, 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|
||
assert "call-1" in 异常.value.说明 and "重复" in 异常.value.说明
|
||
|
||
|
||
@pytest.mark.case_id(
|
||
"NC-ctx-replay-manifest-types",
|
||
environment="离线纯函数",
|
||
given="顺序/版本等字段为布尔或类型混淆的清单",
|
||
when="校验清单",
|
||
then="明确拒绝，不用宽松类型顶替",
|
||
contract="docs/系统架构/新版设计/模块设计/B09-上下文.md",
|
||
)
|
||
def test_布尔与类型混淆拒绝__b7e0b3() -> None:
|
||
# 顺序是 bool 而不是 int：True 不能冒充 1
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单((replace(条目("call-1"), 顺序=True),), 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|
||
# 参数里的版本是 bool：JSON Schema 的 integer 不接受布尔
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单((条目("call-1", 参数={"chapter_id": "ch-1", "revision": True}),), 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|
||
# 条目本身不是探索条目对象：字典形状不能冒充
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单(({"call_id": "call-1", "tool": "read_history_document"},), 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|
||
|
||
|
||
@pytest.mark.case_id(
|
||
"NC-ctx-replay-manifest-binding",
|
||
environment="离线纯函数",
|
||
given="缺来源绑定或消费哈希非法的条目",
|
||
when="校验清单",
|
||
then="分别明确拒绝",
|
||
contract="docs/系统架构/新版设计/模块设计/B09-上下文.md",
|
||
)
|
||
def test_缺来源绑定与非法消费哈希拒绝__b7e0b4() -> None:
|
||
缺绑定 = (replace(条目("call-1"), 来源引用=()),)
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单(缺绑定, 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|
||
assert "来源绑定" in 异常.value.说明
|
||
非法哈希 = (replace(条目("call-1"), 消费哈希="不是十六进制"),)
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单(非法哈希, 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|
||
assert "消费哈希" in 异常.value.说明
|
||
|
||
|
||
@pytest.mark.case_id(
|
||
"NC-ctx-replay-manifest-valid",
|
||
environment="离线纯函数",
|
||
given="合法清单与空清单",
|
||
when="校验清单",
|
||
then="合法按序通过；空清单拒绝（探索必须非空）",
|
||
contract="docs/系统架构/新版设计/模块设计/B09-上下文.md",
|
||
)
|
||
def test_合法清单按序通过且空清单拒绝__b7e0b5() -> None:
|
||
清单 = 顺序清单(
|
||
("call-1", "query_work_plan", {}),
|
||
("call-2", "query_facts_as_of", {}),
|
||
("call-3", "read_history_document", {"chapter_id": "ch-1", "revision": 1}),
|
||
("call-4", "read_history_document", {"chapter_id": "ch-1", "revision": 1, "end": 6}),
|
||
)
|
||
assert [项.顺序 for 项 in 清单] == [1, 2, 3, 4]
|
||
校验清单(清单, 范围) # 不抛异常即通过
|
||
with pytest.raises(上下文错误) as 异常:
|
||
校验清单((), 范围)
|
||
assert 异常.value.错误码 == "CONTEXT_INPUT_INVALID"
|