Agent Experience Network

This repository is the public dsh-akn-plugin distribution and the AEN/AEXP reference implementation. It is maintained jointly by symmetryseeker and Jiaoyang Li (@jiaoyangli-shadow7day). See Maintainers and the migration record.

Agent Experience Network（AEN）是一个处于 Draft/Pilot 阶段的开放协议与实现，目标是让不同开发者的 Agent 在明确的 Model × Harness × Environment 适用范围内，共享经过审查和验证的任务级执行经验。

项目不会把每次工具调用发布成知识，也不会默认上传原始 Trace。Trace 是证据来源之一；可分享的 Experience 必须同时描述任务、Model、Harness Manifest、结果、正反例、适用边界和证据强度。

30 秒理解这个项目

当一个 Agent 完成任务、从失败中恢复或发现某种配置不适用时，真正值得共享的不是全部日志，而是少量经过选择和审阅的任务经验：它在什么任务、Model、Harness 和环境下成立，证据有多强，怎样复用，何时不要用。

AEN 提供从本地证据到可修复公共知识的完整链路：

Trace + live Harness Manifest
        → selected TaskEpisode
        → private Experience draft
        → human review / evaluation
        → explicit Promotion
        → Card discovery + budgeted section read
        → Observation / Feedback / Contention

默认行为是本地和私有。DeepSeek Harness 插件复用 DSH 自己的 durable Trace，只在低频配置边界补充 Trace 看不到的 live Manifest；它不会在每次工具调用时上传数据，也不会自动发布或执行远端 Experience。

第一次来，从这里开始

最快的体验不需要安装 Hub 或配置模型 API：教程使用一份脱敏的合成 DSH session 和临时 SQLite，在本地展示 21 个 Trace 事件如何只形成 1 个 H1 候选 Experience，以及普通成功 fixture 为什么产生 0 个 Episode。

公开规范与项目入口：

• AEXP 0.1 协议规范
• AEN MVP Implementation Profile 0.1
• 核心概念与参考架构
• 示例索引
• 先行研究与标准映射（非规范性）
• M0 Capability Matrix
• MVP 逐条需求证据台账
• AEN 0.1 Draft / Pilot 发布说明
• 公开发布边界与历史安全清单
• 核心维护者与旧插件迁移说明

当前已实现 M0、M1、M2 私有闭环、M3 本地评测核心、M4 Public Promotion/Reference Hub 核心、M5 消费/修复闭环，以及 M6 的开源工程材料：

• AEXP 0.1 Draft Schema、JCS/SHA-256、DSSE/in-toto 与 conformance；
• DSH JSONL/ZIP 离线导入、TaskEpisode、TraceEvidence、RunObservation；
• 可由官方插件管理器安装的 DeepSeek Harness 原生 Cordis bundle；definition、policy、provider、tools 四个角色分离，在低频配置边界捕获 live Harness Manifest；
• SQLite 本地证据库；
• constrained Distiller、人工 review/edit、私有搜索和按 section 获取。
• cell-aware Benchmark/Trial/Aggregate、baseline/treatment、pass@k/pass^k、H-level 门禁与 2×2×2 覆盖检查；内置官方 DSH headless driver 已用安装后插件和 mock 模型完成机制验收。
• private → public 不可变 Promotion、脱敏/许可/签名、闭合公共证据图与 Git contribution；
• 授权密钥 ingress、PostgreSQL 可重建投影、兼容性搜索/读取/feedback/export API、最小 Web 与 emergency tombstone。
• 最小 Task Capsule、immutable Card、Context Plan/预算门禁、ContextInjectionObservation、测量型 feedback/RunObservation；
• DSH native 与 MCP 的两个工具预算（search/feedback）和按 URI section resource read，无 execute tool。
• 社区 sample Harness Adapter、作者/审查指南、开源治理、安全审计与真实 Pilot 预注册报告。

作为 DeepSeek Harness 插件使用

最直接的方式是让 DeepSeek Harness 从本仓库安装根 bundle：

dsh plugin --profile web add github:symmetryseeker/dsh-akn-plugin
dsh web

卸载使用 dsh plugin --profile web remove dsh-akn-plugin。安装器读取根目录的 dsh.bundle.patch，加载 AEN Policy、Provider 和默认禁用的 Consumer Tools。

参与本仓库开发时，也可以先从源码构建内部的 @aen/dsh-plugin tarball：

pnpm install
pnpm build
mkdir -p .work/releases
pnpm --dir packages/dsh-plugin pack --pack-destination ../../.work/releases

然后在已构建的 DeepSeek Harness 源码目录安装并启动；若使用已安装的 dsh，去掉前面的 pnpm 即可：

pnpm dsh plugin --profile web add /absolute/path/to/deepseek-harness-akn/.work/releases/aen-dsh-plugin-0.0.1.tgz
pnpm dsh web

安装命令会把 @aen/dsh-plugin 自动加入 Web profile 的 bundle 栈；dsh plugin --profile web remove @aen/dsh-plugin 会同时移除依赖和 bundle。默认只写当前 workspace 下的 .aen/evidence.sqlite，不联网、不公开对象、不读取完整 Skill 资源，也不注册模型工具。

如需覆盖默认配置，在 profile 的 cordis.patch.yml 或 --patch 文件中按 id 替换完整配置：

- id: aen-policy
  config:
    captureSkillContent: true
    captureSkillResources: true
    allowHubSearch: true
- id: aen
  config:
    enabled: true
    storePath: /absolute/path/to/project/.aen/evidence.sqlite
    harnessVersion: 0.1.0-rc.7
- id: aen-tools
  disabled: false
  config:
    hubUrl: http://127.0.0.1:4173

aen-tools 默认禁用；即使启用，联网也同时要求 aen-policy.allowHubSearch=true 和非空 hubUrl。插件没有公开发布凭据，以上配置仍不能自动发布 Experience。

本地插件开发时仍可用绝对路径插入，不需要先安装 tarball：

pnpm dsh web --patch /absolute/path/to/development-aen.cordis.yml

pnpm test:dsh-root-plugin-host 会验收仓库根目录的 dsh-akn-plugin 发布物；pnpm test:dsh-plugin-host 会验收内部 @aen/dsh-plugin 发布物。两者都执行真实的 pack → dsh plugin add → 官方 Web 启动/HTTP 200 → SQLite schema → SIGTERM 0 → dsh plugin remove，并要求嵌套的 deepseek-harness/ 已先按官方要求完成 pnpm run build。

插件直接复用 DSH 的 durable session、agents、skills 与 effective request/header，不会另建全量 Trace，也不会在每次 tool call 上做同步 I/O 或网络上传。详细边界见 DSH 插件说明、M1 实现记录 与 ADR-0017。

本地私有经验闭环

aen import dsh <session-export>
aen episode list
aen distill <episode-id>
aen review <experience-id>
aen review <experience-id> --decision keep-private
aen search "failure recovery" --local
aen fetch <experience-id> --include recipe,cases,evidence
aen evaluate <benchmark-id> --matrix <matrix.json> --driver <trusted-driver.mjs>
aen evaluate <benchmark-id> --matrix <matrix.json> --dsh-driver-config <dsh-driver.json> --grader <trusted-grader.mjs>
aen pilot validate <pilot-preregistration.json> --store <evidence.sqlite>
aen feedback <experience-id> --decision rejected --outcome harmful --reason negative-transfer
aen delete-local <object-id> --confirm-digest sha256:<exact> --reason author_request

review 不带 decision 时只展示 claim/evidence、Model × Harness 配置、redaction、Evidence Gap、许可与风险。使用 --export-edit <file> 导出下一 revision 模板，编辑后用 --replace <file> 导入；原 revision 不会被覆盖。

显式公开与 Reference Hub

aen init --actor https://github.com/jiaoyangli-shadow7day --display-name jiaoyangli
aen review <experience-id> --decision request-public
aen promote <experience-id> --public --out contributions/<candidate> --consent <git-audit-ref>

aen-hub verify --git-root contributions --keys contributions/authorized-keys.json
aen-hub rebuild --git-root contributions --keys contributions/authorized-keys.json
aen-hub serve --git-root contributions --keys contributions/authorized-keys.json

Hub 使用 DATABASE_URL 指向 PostgreSQL。PromotionRecord 含私有 source ref，因此按 AEXP 0.1 默认只保存在本地审计域；公共贡献只包含重新脱敏、签名且引用闭合的 target graph。详见 M4 实现记录 与 ADR-0007。

Reference Hub 可生成不依赖 monorepo 的 portable deployment，容器入口和 PostgreSQL Compose 配置见 Hub 部署说明。pnpm test:hub-deployment 会把部署目录移出 workspace，再运行真实 PostgreSQL、Git ingest、HTTP search、exact-digest read 与 Web 验收。它证明发布物闭合，不代表已经存在公网 Pilot 服务。

正式撤回会清除 Hub 活跃正文并保留最小 tombstone；同一个 reviewed Git change 还必须从 Registry 当前树移除 affectedDigests 所在旧 contribution。aen revoke 会输出这一 required action，并可用 --affected-digest 声明 secret/evidence closure。Git 历史和别人已经取得的 clone 无法被召回，边界见 ADR-0016。

通用 Harness 可启动 AEN MCP Server，只暴露 experience_search / experience_feedback 和 aexp:// resources。DeepSeek Harness 用户可显式启用 aen-tools，并由独立的 aen-policy 决定是否允许 Hub 查询；原生搜索会从当前 DSH Agent 自动绑定 Model × Harness × Environment 上下文，不要求模型猜测任何 digest，关联失败时拒绝搜索。消费预算与 adopted 证据边界见 M5 实现记录 与 ADR-0021。

社区扩展与 Pilot

• Harness Adapter 编写指南 与 @aen/adapter-sample 证明新 Harness 无需修改 AEXP Schema；
• Experience 编写与审查指南 覆盖 private draft、证据/H-level、Promotion 和反馈修复；
• 真实 Pilot 预注册协议 与 可重现 Pilot 报告 将工程 dry run 与尚未执行的真实 2×2×2/cross-user 试点明确分开；
• M6 pre-public audit、Security Policy 与 Roadmap 公开剩余门槛。

评测 driver/grader 必须是内置发布入口或用户显式指定的本地可信 ESM 模块；它们不是从 Experience 下载的代码。内置 DSH driver 只使用官方 headless profile，并要求 AEN 插件已安装；非空 copy fixture 必须由 Benchmark Artifact 的 treeDigest 精确绑定。synthetic_test 与 mock-model host smoke 都不能满足真实试点或 H3。多任务计划必须分别绑定各 Benchmark 的 Experience revision 和 comparison；aen pilot validate 只证明冻结设计闭合，不会把空表变成产品证据。

本仓库尚未达到 Stable 标准。插件和 CLI 仍不会自动公开对象、上传原始会话或执行远端 Experience；公开只能经过人工 review、独立 Promotion 和显式 Git PR。真实的 2×2×2 DSH 试点仍需要可用模型路由、预算、两个经验证任务族和独立参与者；当前测试证明的是评测器、Hub 与消费策略语义，不冒充真实模型结果。M6 的文档、sample adapter 和工程审计已具备，但真实 Pilot、非核心贡献者验收与独立安全审查仍是开放门槛。