AEP Session Evidence (过程存证)
AEP 会话过程存证——让 AI 助手感知当前会话,在开始/里程碑/结束时把"确实发生过这样一个创作过程"固化成可独立验证的证据链。当用户提到"过程存证/会话存证/记录过程/结束存证/收工存证",或检测到会话即将结束(用户说收工/就这样/告一段落、上下文接近压缩、任务交付)时使用。
AEP 会话过程存证(Session Evidence)
目标:证明「确实存在过这样一个创作过程」。最终产物可以不存,过程本身要存—— 谁在何时、基于什么输入、做了什么决策、产出了什么中间结果,全部变成哈希链上的结构化事件, 会话结束时封包成
.aep,任何人可独立验证。
一、会话感知信号(何时触发本技能)
| 信号 | 动作 |
|---|---|
| 用户开启一个新任务/说"开始吧" | 建立(或复用)项目 → 记 session.start |
| 完成一个重要里程碑(方案定稿/关键决策/阶段产出/重要文件生成) | 记对应事件(见 §三 事件类型) |
| 用户说"结束/收工/就这样/告一段落",或任务交付、上下文即将压缩 | 先提醒,征询后(或按用户预设的 auto 模式直接)记 session.end 并导出封包 |
| 用户问"刚才那步有没有记录" | aep list-evidence --project <slug> 查证 |
提醒优先,自动可选:默认在结束信号出现时向用户确认一次("要不要把本次会话过程存证?"); 用户明确说过"自动存证/不用问我"则跳过确认直接执行。绝不在用户明确拒绝后重复询问。
二、标准流程(三段式)
1. 会话开始(锚定)
# CLI(MCP 用 aep_request_evidence,project 必填)
aep evidence session.start --project <slug> \
--session-id <稳定会话ID> \
--action "任务一句话描述" --password <pw> --json
--session-id全程保持一致(prevHash 事件链的锚点);建议<slug>-<日期>-<序号>- 同步建对话记录文件(如
<workdir>/session-log.md),持续追加关键问答/决策
2. 里程碑(过程留痕)
aep evidence <event-type> --project <slug> --session-id <同上> \
--action "做了什么" --result "关键结论/要点(默认仅存哈希)" --password <pw> --json
常用 event-type(自由扩展):ai.generation(AI 产出)、decision.made(关键决策)、
milestone.reached(里程碑)、artifact.produced(中间产物落盘)、review.passed(评审通过)。
完整对话过程:把 session-log.md 用 aep artifact add <file> --project <slug> 存为制品;
中间产生的临时结果可存可不存(用户已确认可不存),但日志文件本身要存。
3. 会话结束(封包 + 验真)
# 记结束事件并直接导出该会话的累积证据包(--output 即封包)
aep evidence session.end --project <slug> --session-id <同上> \
--action "会话结束" --password <pw> --output <slug>-session.aep --json
# 七阶段验真(铁律:验签只用 AEP 工具本身)
aep validate <slug>-session.aep --json
# (可选)升级:--tsa 时间戳 / --chain 区块链锚定,或 aep attest chain <pkg> 补锚
三、事件与判读
- 每次调用返回
eventId+sessionId;事件按--session-id形成 prevHash 链,事后不可篡改顺序与内容。 - 导出包随事件数增长;最终包包含全程事件链(L1 SelfSigned 起,加 TSA/链锚定可到 L3/L4)。
validate --json的权威字段是 state(valid/inconclusive/invalid);invalid 时 level 为 null。- 查历史:
aep list-evidence --project <slug>。
四、注意事项
- 口令:自定义
--data-dir时每个命令都要带--password;默认目录自动读~/.aep/.secret。 - 敏感内容:
--result默认仅存哈希;若确认要存明文,遵循项目数据分级约定,密钥/口令绝不入证据。 - 制品接入事件链:
artifact add的制品若未与事件建立关系,validate 会给 AEP-E012「isolated Artifact」warning → state=inconclusive(部分确立,不是失败)。 消除:制品化后补一条引用它的事件;或接受 inconclusive 并向用户说明。 - 项目收尾:
aep project close <slug>;长期归档aep project archive <slug>。
- Downloads
- 300All time
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.0
- License
- MIT-0
