Files

T

白夜 a5228600f4 v2.9.0: domain-level session + assertion-driven delivery + MCP v0.8.0

- Principle #5: no skipping degradation tiers (anti AI strategic surrender)
- Phase 0 step 4: start_reverse_session() zero-arg domain auto-detect
- Phase 0.5.-1: domain assertion reverify before fingerprint matching
- Phase 5: assertion-driven delivery (verify_against_session + add_assertion)
- Core weapon: MCP v0.8.0 (78 tools), domain session + assertion section
- Error handling: AI surrender degradation tier table (L1-L6)
- Experience rules: 40 -> 46 (domain persistence / reverify / assertion ROI)
- New: references/domain-session-guide.md
- New: CHANGELOG_v2.9.0.md
- Skip v2.8.0 (process-level session design rejected)

2026-04-18 10:00:19 +08:00

3.6 KiB

Raw Blame History

CHANGELOG v2.9.0 — 域级 Session 档案 + 断言驱动交付

日期：2026-04-22 MCP 版本：camoufox-reverse v0.8.0（78 个工具）

核心新增

1. 域级 Session 档案

每个目标域维护一份持久化 Session 档案（cases/_session_archives/<domain-hash>/），跨任务复用反爬类型判定、指纹基准、Cookie 归因结论，避免重复侦察。

session.json：核心元数据（反爬类型、工具链、hot_keys 快照、Cookie 归因摘要）
fingerprint.json：浏览器指纹基准快照
cookie-attribution.json：Cookie 归因结论缓存
assertions.json：断言集（通过/失败/跳过）
域名哈希化存储，已加入 .gitignore，不纳入版本控制

2. 断言系统

Session 档案的核心验证机制。每条断言描述一个可自动检测的技术事实，用于快速判断目标站点是否发生了技术变更。

8 种断言类型：script_exists / script_size_range / dispatch_loop_count / anti_crawl_type / cookie_names / sdk_fingerprint / hot_keys_stable / response_structure
Phase 0.5 前置 Reverify：断言全部通过则跳过重复侦察，直接进入 Phase 1
Phase 5 交付时自动更新断言集

3. 断言驱动交付（Phase 5 升级）

Phase 5 从"运行验证 + README"升级为断言驱动的结构化交付：

运行 main.js/main.py，确认输出正确数据
与浏览器实际数据交叉验证（≥ 5 次请求）
写入/更新域级 Session 档案（断言集 + 指纹快照 + Cookie 归因）
生成 README.md
主动询问用户是否沉淀经验到 cases/

4. 禁止未经梯度降级切换（第一原则第 5 条）

新增原则：遇到工具失败时，必须按降级梯度逐级尝试，禁止直接跳到最终方案。

降级梯度：

instrument_jsvmp_source(mode="ast")
  → instrument_jsvmp_source(mode="regex")
    → hook_jsvmp_interpreter(mode="transparent")
      → hook_jsvmp_interpreter(mode="proxy")  [仅行为型]
        → 纯 pre_inject_hooks 观察  [仅行为型/纯混淆]

5. AI 想放弃时的降级梯度表

错误处理新增降级梯度表，覆盖 6 种常见"想放弃"场景及对应的降级路径。

工作流变更

阶段	变更
Phase 0	新增步骤 4：启动域级 Session 档案（加载/创建）
Phase 0.5	新增前置步骤 0.5.-1：本域断言 Reverify
Phase 5	升级为断言驱动交付（写入 Session 档案 + 断言集）

SKILL.md 变更点

变更点	说明
frontmatter description	MCP 版本升至 v0.8.0（78 工具），新增 v2.9.0 描述
第一原则	新增第 5 条「禁止未经梯度降级切换」
Phase 0	新增步骤 4「启动域级 Session 档案」
Phase 0.5	新增 0.5.-1「本域断言 Reverify」前置步骤
Phase 5	替换为断言驱动交付
核心武器	工具总数 78，版本 v0.8.0，新增域级 Session 档案与断言小节
场景 10/11	MCP 操作清单追加 Session 相关步骤
错误处理	新增「AI 想放弃时的降级梯度表」
经验法则	扩充至 46 条（+41-46）
更新记录	追加 v2.9.0 条目

新增文件

文件	说明
`references/domain-session-guide.md`	域级 Session 档案完整指南
`CHANGELOG_v2.9.0.md`	本文件

修改文件

文件	说明
`SKILL.md`	10 个变更点（见上表）
`cases/README.md`	新案例沉淀工作流插入步骤 1.5（Session 档案归档）
`.gitignore`	追加 `cases/_session_archives/`

3.6 KiB Raw Blame History Unescape Escape