AEP 会话证据

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install aep-session-evidence
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 aep-session-evidence。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AEP 会话证据可帮助 AI 助手保留创意或技术任务的执行过程，而不只是最终交付成果。它会将会话开始、决策、里程碑、AI 输出和中间产物记录为由哈希链接的结构化事件，从而创建一份可追溯的记录，说明谁在何时做了什么。
会话结束时，可以将累积的证据导出为 .aep 包，并使用 AEP 验证器进行检查。Openclaw Skills 用户可利用此工作流，让 AI 辅助流程可供审查且可检测篡改，同时默认仅以哈希形式保存敏感结果内容。

应用场景

用户开始新任务或要求助手开始工作时，启动证据轨迹。
随着工作推进，将重要决策、已批准的计划、里程碑、AI 生成的输出、审查结果和中间文件记录下来。
在交付任务、压缩上下文或用户要求收尾之前，保存会话。
列出项目的证据，检查某项会话操作是否已记录。
当流程来源记录很重要时，为 AI 辅助工作流创建可独立验证的记录。
将会话日志或中间产物附加到项目证据记录中。

工作原理

锚定会话： 创建或重复使用一个项目，并使用稳定的会话 ID 和简明的任务描述记录 session.start。
维护会话日志： 将关键问题、答案和决策追加到会话日志文件中，例如 session-log.md。
记录里程碑： 为 AI 生成、决策、里程碑、产物、审查或其他相关操作添加结构化事件。共享同一会话 ID 的事件会构成 prevHash 链。
附加支持性产物： 将会话日志或其他相关文件添加到项目中。如果希望验证时不出现孤立产物警告，请确保事件引用了这些产物。
结束并导出： 记录 session.end，并将累积的会话证据导出为 .aep 包。
验证软件包： 运行 aep validate，并将其 state 字段解释为 valid、inconclusive 或 invalid；使用 AEP 工具本身验证签名。

配置指南

在助手可以运行 AEP CLI 的环境中安装或配置 AEP CLI。此技能使用 read、write 和 exec 工具。提供项目 slug、一致的会话 ID 和所需密码。默认情况下，CLI 从 ~/.aep/.secret 读取密码；使用自定义 --data-dir 时，每条命令都要传入 --password。切勿将密码或密钥写入证据。
开始会话：
aep evidence session.start --project
--session-id
--action "Brief task description" --password --json 记录事件并附加会话日志：
aep evidence decision.made --project --session-id
--action "What was decided" --result "Key conclusion" --password --json aep artifact add session-log.md --project
结束会话、导出证据并进行验证：
aep evidence session.end --project --session-id
--action "Session ended" --password --output -session.aep --json aep validate -session.aep --json
查看会话历史记录，请运行 aep list-evidence --project 。会话结束时，默认行为是在记录和导出之前请求确认；明确配置的自动模式可以跳过确认。

数据架构

证据按项目和会话组织。每个事件都是结构化的，并通过稳定的会话 ID 与其会话关联；连续事件构成哈希链，可检测事件顺序或内容是否被更改。
记录或字段 用途
项目 slug 将项目的证据和产物归组。
sessionId 标识会话并锚定其事件链。整个会话期间应保持一致。
eventId 标识单个记录的事件。
事件类型 描述操作，例如 session.start、ai.generation、decision.made、milestone.reached、artifact.produced、review.passed 或 session.end；事件类型可以扩展。
操作和结果 记录发生的事情及其关键结果。默认情况下，结果仅保存为哈希。
prevHash 将事件链接成有序且可检测篡改的链。
会话日志 例如 session-log.md 的文件，用于保留关键问题、答案和决策；将其添加为项目产物。
.aep 包 导出的内容，其中包含会话累积的证据链，以供验证。
验证状态 验证器给出的权威 state：valid、inconclusive 或 invalid；无效结果的级别为 null。
证据从 L1 SelfSigned 开始。可选的 TSA 时间戳和链锚定可将保证级别提高至 L3/L4。未关联到事件的产物可能会产生 AEP-E012 孤立产物警告，并导致 inconclusive 状态。

高级特性

支持可扩展的事件类型，可用于常见 AI 生成、决策、里程碑、产物和审查事件之外的自定义工作流里程碑。
提供以确认优先的会话结束流程，并可选择由用户配置自动模式；明确拒绝后不要重复提示。
使用稳定的会话 ID 和
prevHash
链接，以便检测已记录事件的顺序或内容是否发生变化。
将累积的会话证据导出为
.aep
，并支持可选的 TSA 时间戳或链锚定，以提升保证级别。
默认将 --result 仅保存为哈希，以减少敏感内容暴露；只有符合项目数据分类规则时才应存储明文。
支持使用
aep list-evidence
查询证据历史，以及使用
aep project close
aep project archive
等项目生命周期命令。
签名检查需要使用 AEP 原生验证；将验证器的
state
字段作为权威结果。

name: aep-session-evidence allowed-tools:

• read
• write
• exec description: AEP 会话过程存证——让 AI 助手感知当前会话，在开始/里程碑/结束时把"确实发生过这样一个创作过程"固化成可独立验证的证据链。当用户提到"过程存证/会话存证/记录过程/结束存证/收工存证"，或检测到会话即将结束（用户说收工/就这样/告一段落、上下文接近压缩、任务交付）时使用。

AEP 会话过程存证（Session Evidence）

目标：证明「确实存在过这样一个创作过程」。最终产物可以不存，过程本身要存—— 谁在何时、基于什么输入、做了什么决策、产出了什么中间结果，全部变成哈希链上的结构化事件， 会话结束时封包成 .aep，任何人可独立验证。

一、会话感知信号（何时触发本技能）
信号 动作
用户开启一个新任务/说"开始吧" 建立（或复用）项目 → 记 session.start
完成一个重要里程碑（方案定稿/关键决策/阶段产出/重要文件生成） 记对应事件（见 §三 事件类型）
用户说"结束/收工/就这样/告一段落"，或任务交付、上下文即将压缩 先提醒，征询后（或按用户预设的 auto 模式直接）记 session.end 并导出封包
用户问"刚才那步有没有记录" aep list-evidence --project 查证

提醒优先，自动可选：默认在结束信号出现时向用户确认一次（"要不要把本次会话过程存证？"）； 用户明确说过"自动存证/不用问我"则跳过确认直接执行。绝不在用户明确拒绝后重复询问。

二、标准流程（三段式）

1. 会话开始（锚定）

# CLI（MCP 用 aep_request_evidence，project 必填）

aep evidence session.start --project
--session-id
--action "任务一句话描述" --password --json

--session-id 全程保持一致（prevHash 事件链的锚点）；建议 -- 同步建对话记录文件（如 /session-log.md），持续追加关键问答/决策 2. 里程碑（过程留痕） aep evidence --project --session-id
--action "做了什么" --result "关键结论/要点（默认仅存哈希）" --password --json

常用 event-type（自由扩展）：ai.generation（AI 产出）、decision.made（关键决策）、 milestone.reached（里程碑）、artifact.produced（中间产物落盘）、review.passed（评审通过）。 完整对话过程：把 session-log.md 用 aep artifact add --project 存为制品； 中间产生的临时结果可存可不存（用户已确认可不存），但日志文件本身要存。

3. 会话结束（封包 + 验真）

# 记结束事件并直接导出该会话的累积证据包（--output 即封包）

aep evidence session.end --project --session-id
--action "会话结束" --password --output -session.aep --json

# 七阶段验真（铁律：验签只用 AEP 工具本身）

aep validate -session.aep --json

# （可选）升级：--tsa 时间戳 / --chain 区块链锚定，或 aep attest chain

补锚

三、事件与判读
每次调用返回 eventId + sessionId；事件按 --session-id 形成 prevHash 链，事后不可篡改顺序与内容。
导出包随事件数增长；最终包包含全程事件链（L1 SelfSigned 起，加 TSA/链锚定可到 L3/L4）。
validate --json 的权威字段是 state（valid/inconclusive/invalid）；invalid 时 level 为 null。
查历史：aep list-evidence --project 。
四、注意事项
口令：自定义 --data-dir 时每个命令都要带 --password；默认目录自动读 ~/.aep/.secret。
敏感内容：--result 默认仅存哈希；若确认要存明文，遵循项目数据分级约定，密钥/口令绝不入证据。
制品接入事件链：artifact add 的制品若未与事件建立关系，validate 会给 AEP-E012「isolated Artifact」warning → state=inconclusive（部分确立，不是失败）。 消除：制品化后补一条引用它的事件；或接受 inconclusive 并向用户说明。
项目收尾：aep project close ；长期归档 aep project archive 。
占星术
PulseNetwork Robinhood Chain 兑换路线