协作证明

{
  "frames": {
    "technical": 0.0,
    "uncertainty": 0.0,
    "fork": 0.0,
    "ai_contribution": 0.0
  },
  "pruned": ["被剪枝的帧名称列表"],
  "intent": "FEATURE_BUILDING",
  "signal": "HIGH",
  "calibration_note": "解释所应用的任何例外规则的一句话"
}

## [YYYY-MM-DD] <标题>
上下文: [Frame A — 导致此选择的原因]
决策: 选择了什么
考虑过的替代方案: [Frame C — 未选择的路径]
推理: 原因 —— 若是从上下文中推断的，请加上 "inferred:" 前缀
AI 贡献:
  - 识别: [Frame D — 开发者遗漏的点]
  - 建议: [Frame D — 方法或替代方案]
  - 开发者驱动: [开发者独立决定的内容]
意图类别: [来自 Layer 02]
信号得分: HIGH
结果: 已实现 | 待定 | 已撤销

## [YYYY-MM-DD] <Bug 标题>
根本原因: 导致 Bug 的实际原因 —— 是“为什么”，而不仅仅是“是什么”
症状: 开发者观察到的现象
修复方案: 修改了什么
修复理由: 逻辑依据 —— 若未明确说明，请标注为推断 (inferred)
考虑过的替代修复方案: 讨论过的其他方法（如有）
AI 贡献:
  - 识别: [Frame D — Claude 是否发现了根本原因？]
  - 建议: [Frame D — 修复方法或诊断步骤]
  - 开发者驱动: [开发者独立诊断/决定的内容]
意图类别: BUG_FIXING
信号得分: HIGH
结果: 已修复 | 临时方案 | 推迟处理

# 会话 [YYYY-MM-DD HH:MM]
意图: [类别] (次选: [如有，请注明类别])
信号: HIGH
激活帧: A ([得分]) / B ([得分]) / C ([得分]) / D ([得分])
已交付内容
[基于 git log]
已理清的问题
[Frame B + C — 推理、权衡、调试 —— 开发者容易遗忘的部分]
本次会话做出的决策
[引用 DECISIONS.md 中的条目]
困难点
[Frame B 发现的内容 — 不确定性、回滚、EXPLORING/STUCK 信号]
AI 贡献总结
[Frame D 综合分析 — 一段客观且经过校准的描述]
推断的后续步骤
[明显尚未完成的部分]

YYYY-MM-DD HH:MM | [intent] | HIGH | D:[score] | cache:[hit%]% | tok:[total] | <动词短语> — <重要原因>

python3 -c "
import json, sys
from pathlib import Path

projects = Path.home() / '.claude/projects'
files = sorted(projects.rglob('*.jsonl'), key=lambda f: f.stat().st_mtime, reverse=True)
if not files:
    print('no_data'); sys.exit()
with open(files[0]) as fp:
    lines = [json.loads(l) for l in fp if l.strip()]
ti = to = cr = cc = 0
turns = []
for i, line in enumerate(lines):
    if line.get('type') == 'assistant':
        u = line.get('message', {}).get('usage', {})
        if not u: continue
        inp = u.get('input_tokens', 0)
        ti += inp; to += u.get('output_tokens', 0)
        cr += u.get('cache_read_input_tokens', 0)
        cc += u.get('cache_creation_input_tokens', 0)
        prompt = ''
        for j in range(i-1, -1, -1):
            if lines[j].get('type') == 'user':
                c = lines[j].get('message', {}).get('content', '')
                prompt = (c if isinstance(c, str) else next((x.get('text','') for x in c if isinstance(x,dict) and x.get('type')=='text'), ''))[:80]
                break
        turns.append((inp, prompt))
total = ti + cr + cc
hit = cr / total * 100 if total else 0
print(f'input={ti} output={to} cache_read={cr} cache_create={cc} hit={hit:.0f} turns={len(turns)}')
turns.sort(reverse=True)
for idx, (tok, p) in enumerate(turns[:3]):
    print(f'top{idx+1}={tok}|{p}')
"

<div class="header">
  <div class="header-top">
    <div class="project-name">
    <span class="badge">                    <!-- intent 类 -->
  <div class="meta-row">                    <!-- 日期, 分支, 信号强度文本 -->
  <div class="signal-container">
    <div class="signal-label">
    <div class="signal-track">
      <div class="signal-fill">             <!-- 宽度 % 由信号分数驱动 -->

<div class="section">                       <!-- frames -->
  <div class="section-title"> ... <span class="count">Layer 02 · ADHD tree-of-thought</span>
  <div class="frames-grid">
    <div class="frame-card">               <!-- 剪枝状态: class="frame-card pruned" -->
      <div class="frame-label">            <!-- Frame A / B / C / D -->
      <div class="frame-name">
      <div class="frame-score high|low">   <!-- 分数值 -->
<div class="section">                       <!-- decisions — 若无则跳过此章节 -->
  <div class="section-title"> ... <span class="count">N recorded</span>
  <div class="deci

使用 bash 编写 HTML：

写入后，显示：open session-history/YYYY-MM-DD-HHMM-proof.html

---
如果信号为 MEDIUM
仅向 WORKLOG.md 追加一行：

---

如果信号为 LOW
告知用户："Signal: LOW — Routine session, nothing recorded."（信号：低 —— 常规会话，无需记录。）
---
诚实原则
绝不虚构对话中未出现或 diff 中未暗示的决策
当推理内容为重构时，使用 "inferred:" 前缀
Frame D 必须经过校准 —— 既不过度夸大，也不轻视
如果所有 Frame 的得分均 < 0.4 → 不写入任何内容
---
PreCompact 快照（上下文压缩防御）
当上下文压缩即将发生时（由 PreCompact 钩子触发），在上下文丢失前运行一个轻量级的会话中期检查点：
1. 根据可用上下文计算当前的 Layer 01 信号级别
2. 根据当前可见内容为所有四个 Frame 打分
3. 将快照写入 session-history/.tmp-TIMESTAMP.json：

"nt": "FEATURE_BUILDING",
  "key_moments": [
    "截至目前最重要的决策或发现的一句话描述"
  ]
}