@alan512/experienceengine 0.1.2 → 0.2.0

package/README.zh-CN.md

@@ -1,93 +1,313 @@
 # ExperienceEngine
 
-[English README](./README.md)
+[English README](./README.md) | 简体中文
 
-ExperienceEngine 是一个面向编程 Agent 的本地经验介入层。
+ExperienceEngine 是一个面向编程 Agent 的治理层。它复用真实执行经验，但不会把 memory 变成噪声堆积。它只会在相关时注入简短、任务相关的 guidance，并持续记录这次介入到底是帮到了还是干扰了结果。
 
-它会从真实编码任务中学习简短、任务相关的经验，在后续相似任务中注入这些经验，并记录这次介入到底是帮到了还是干扰了结果。
+**Memory 做加法，ExperienceEngine 做治理。**
 
-当前已验证的宿主：
-- `OpenClaw`：runtime / plugin 集成
-- `Claude Code`：hooks + MCP 交互
-- `Codex`：MCP-first runtime 与交互
+当前支持的宿主：`OpenClaw`、`Claude Code`、`Codex`
 
-## 它能做什么
+## 10 秒理解
 
-ExperienceEngine 不是通用记忆库，也不是 context engine 的替代品。
+没有 ExperienceEngine：
+- agent 会在相似仓库里重复犯同样的 SQLite migration 错误
 
-它主要做 4 件事：
-- 从宿主 Agent 捕获任务、工具和结果信号
-- 把有价值的经验压缩成短小的 `strategy` 或 `warning` 节点
-- 判断当前任务是否值得注入经验
-- 根据真实 `helped` / `harmed` 结果更新节点状态
+有 ExperienceEngine：
+- 它会注入一条提示，例如：`先执行 migration，再打开数据库连接`
+- 后续你可以把这次介入标记为 `helpful` 或 `harmful`
+- 这条经验会据此进入 active、降温或退役
 
-## 它和 Memory 有什么不同
+```text
+任务信号 -> 提炼经验 -> 检索 -> 短提示注入 -> 反馈 -> 治理
+```
+
+<details>
+<summary>宿主里的示例对话</summary>
+
+```text
+用户：修一下这个仓库里的 SQLite 启动失败问题。
+
+ExperienceEngine：
+  Hint: 先执行 migration，再打开数据库连接。
 
-大多数 agent memory 系统解决的是：
+宿主 agent：
+  我会先补 migration，然后再重试启动。
 
-- 记住哪些事实
-- 记住哪些用户偏好
-- 下次会话该带上哪些仓库上下文
+用户：
+  为什么这条 ExperienceEngine 提示会命中？
 
-ExperienceEngine 解决的是另一层问题：
+宿主 agent：
+  它匹配到了这个仓库里过去一次相同的 SQLite 启动失败，以及当时成功的 migration-first 修复路径。
 
-- 什么时候该让历史经验介入
-- 该注入哪条 `strategy` 或 `warning`
-- 这次介入到底有没有帮到任务
-- 这条经验是否应该继续保留、降温或退役
+用户：
+  把刚才那次 ExperienceEngine 介入标记为 helpful。
 
-简单说：
-- memory 更像“记住事实和偏好”
-- ExperienceEngine 更像“治理可复用的编码经验”
+宿主 agent：
+  已记录。之后遇到类似任务时，这条经验会更容易再次命中。
+```
 
-## 当前能直接使用的能力
+</details>
 
-当前仓库已经实现并可用：
-- `OpenClaw`、`Claude Code`、`Codex` 三个宿主接入
-- 基于 MCP 的主交互面，以及 CLI fallback
-- 基于本地 embedding 的检索
-- 快速查看与反馈：
-  - `ee inspect --last`
-  - `ee helped`
-  - `ee harmed`
-- 本机共享目录的 `Experience Pack` 工作流：
-  - `draft`
-  - `review`
-  - `publish`
-  - `rollback`
-- 面向宿主文件的编译与部署：
-  - `AGENTS.md`
-  - `CODEX.md`
-  - `CLAUDE.md`
-  - GitHub agent profile markdown
+![`ee inspect --last --verbose` 示例输出](./docs/assets/readme/inspect-last-example.svg)
 
 ## 快速开始
 
-从源码目录启动：
+最快的宿主安装路径：
+
+- `OpenClaw`
+  - `openclaw plugins install @alan512/experienceengine`
+  - `openclaw gateway restart`
+  - `ee init`
+- `Codex`
+  - `ee install codex`
+  - `ee init`
+- `Claude Code`
+  - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
+  - `/plugin install experienceengine@experienceengine`
+  - `ee init`
+
+`ee init` 用于在宿主安装完成后初始化共享的 ExperienceEngine 状态。
+
+如果你需要更详细的宿主安装说明、fallback 路径、ready 状态说明或 operator 工作流，跳转到 [完整安装与运维说明](#完整安装与运维说明)。
+
+## 适合谁用
+
+以下情况适合使用 ExperienceEngine：
+- 你会在相似仓库或相似工作流里反复使用 coding agent
+- 你想要的是**短小、介入式 guidance**，而不是泛化的 memory recall
+- 你关心历史经验到底是**帮到了还是害了**
+- 你希望过时 guidance 能自动降温或退役，而不是越积越多
+
+以下情况不适合：
+- 你只想要一个个人笔记型 memory
+- 你想要通用文档 RAG
+- 你的工作流几乎不重复
+- 你希望系统默认记住所有东西
+
+## 宿主支持矩阵
+
+| 宿主 | 安装路径 | 日常交互 | 成熟度 |
+|---|---|---|---|
+| `OpenClaw` | 原生插件安装 | 宿主原生 | 当前最完整 |
+| `Claude Code` | marketplace 插件，保留 `ee install claude-code` fallback | MCP + plugin hooks | 已支持 |
+| `Codex` | `ee install codex`，保留原生 MCP fallback | MCP 原生 | 已支持 |
+
+## 为什么要做这个
+
+Coding agent 会重复犯同类错误，通常不是因为模型不够聪明，而是因为之前的执行经验没有被**以可治理的方式**复用。
+
+ExperienceEngine 的目标不是通用 memory 累积，而是**介入治理**。
+
+## 为什么不是 Memory / RAG
+
+| 问题 | Memory 系统 | ExperienceEngine |
+|---|---|---|
+| 跨会话保存事实和偏好 | 可以 | 不是核心目标 |
+| 捕获失败 -> 修复 -> 成功的经验路径 | 部分支持，通常依赖人工 | 可以，来自真实任务信号 |
+| 知道一条回忆到底有没有帮助 | 通常不行 | 可以，逐次记录 |
+| 自动退役过时或有害 guidance | 通常不行 | 可以，内建 cooling / retired 生命周期 |
+| 保持提示短小、任务相关 | 不是核心目标 | 是 |
+| 通用文档检索 | 常见适用场景 | 不是核心目标 |
+
+## 它在 Agent Loop 里的位置
+
+从高层看，ExperienceEngine 围绕 agent loop 的位置是这样的：
+
+```text
+用户任务
+  -> before_prompt_build：检索并注入匹配经验
+  -> agent 推理 + 工具调用：捕获失败、重试、修正和结果
+  -> task finalize：把候选信号提炼成可复用经验
+  -> helped / harmed：提升、降温或退役节点
+```
+
+ExperienceEngine 工作在 context 层，不会修改宿主模型权重。
+
+## 经验生命周期
+
+```text
+任务信号
+  -> candidate
+  -> active
+  -> cooling
+  -> retired
+```
+
+每条经验都根据真实任务结果演化，而不是按时间粗暴清理。帮到任务的经验会被强化，反复有害的经验会被降温或退役。
+
+## 现在能做什么
+
+- 在相似编码任务里复用短 guidance
+- 查看某条 hint 为什么命中
+- 把最近一次介入标记为 helpful 或 harmful
+- 查看 active、cooling、retired 等生命周期状态
+- 在 `OpenClaw`、`Claude Code`、`Codex` 三个宿主中使用
+
+### 底层实现
+
+- MCP 原生交互面，加上 CLI / operator fallback
+- 支持 API 与本地回退的语义检索
+- 宿主 agent 内可直接查看和反馈经验，CLI fallback 包括 `ee inspect --last`、`ee helped`、`ee harmed`
+
+如果你想看 ExperienceNode 结构和治理字段，见：
+
+- [Experience Model Overview](./docs/development/experience-model.md)
+
+## 当前状态
+
+- Stable：核心经验生命周期、inspect/helped/harmed loop、宿主集成、CLI/operator fallback
+- 当前最顺滑的路径：`OpenClaw` 原生插件安装
+- 仍在演进：retrieval 调优、provider 策略、更高级的宿主 UX
+- 如果你想最快拿到第一份顺滑体验，建议先从 `OpenClaw` 开始
+
+## 什么叫第一次真正成功
+
+安装并初始化后，第一次真正体现价值的信号通常是：
+
+- ExperienceEngine 在真实任务里注入了一条短 hint
+- 宿主能解释为什么这条 hint 会命中
+- 你对最近一次介入的反馈，会影响后续复用
+- `ee inspect --last` 能看到最近的介入和相关节点状态
+
+## 前置条件
+
+安装宿主前，请先确认对应宿主 CLI 已能在当前机器正常工作：
+
+- `openclaw`
+- `claude`
+- `codex`
+
+**ExperienceEngine 不会替你安装这些宿主 CLI。** 它只会接入一个已经可用的宿主环境。
+
+OpenClaw 说明：
+- 需要本机已有可正常工作的 OpenClaw，且支持原生插件安装
+- 下面的 OpenClaw 路径默认要求 `openclaw plugins install` 和 `openclaw gateway restart` 可用
+
+通用包要求：
+- 发布包要求 Node.js `>=20`
+
+## 完整安装与运维说明
+
+### 按宿主安装
+
+ExperienceEngine 现在不再把 `ee` CLI 当成适用于所有宿主的统一首要安装入口。
+
+请先从宿主自己的安装路径接入：
+
+- `OpenClaw`
+  - 宿主原生插件安装：
+    - `openclaw plugins install @alan512/experienceengine`
+  - 安装后，在开始真实任务前先重启 gateway：
+    - `openclaw gateway restart`
+- `Codex`
+  - EE 托管安装：
+    - `ee install codex`
+  - 原生 / 手工 fallback：
+    - 如果你需要直接 MCP wiring，可参考后面的高级示例
+  - 无论走哪条路径，首次接入后都建议在仓库里开启一个新的 Codex 会话，让 MCP 配置和 `AGENTS.md` 指令块生效
+- `Claude Code`
+  - 宿主原生 marketplace 安装：
+    - 先添加 GitHub marketplace：
+    - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
+  - 再安装插件：
+    - `/plugin install experienceengine@experienceengine`
+  - 如果你需要显式 hooks + MCP wiring，仍可使用：
+    - `ee install claude-code`
+  - 安装后建议开启一个新的 Claude Code 会话，让插件 hooks 和 bundled MCP 配置生效
+
+无论哪个宿主，整体流程都是一样的：
+
+1. 通过宿主路径安装 ExperienceEngine
+2. 执行一次 `ee init` 初始化共享状态
+3. 重启或新开宿主会话，直到仓库变成 `Ready`
+4. 日常检查和反馈优先留在宿主内部完成
+5. 需要验证、修复或深度排障时，再退回 `ee` CLI
+
+### 共享初始化
+
+`ee init` 属于 ExperienceEngine 的共享初始化，不是某个宿主自己的安装步骤。
+
+- 第一次接入任意宿主后执行一次，用来配置：
+  - distillation provider / model / auth
+  - embedding 模式 / provider
+  - 共享 provider secret
+- 后续再接入其他宿主，会复用同一个 ExperienceEngine home、配置和共享 secret
+
+安装完成后，ExperienceEngine 应该把用户引导到下一步状态：
+
+- 如果宿主 wiring 已完成，产品至少是 `Installed`
+- 执行完 `ee init` 后，进入 `Initialized`
+- 宿主或仓库完成 reload 并能开始真实任务后，进入 `Ready`
+
+最小共享初始化示例：
 
 ```bash
-pnpm install
-pnpm build
-node dist/cli/index.js doctor codex
+ee init distillation --provider openai --model gpt-4.1-mini --auth-mode api_key
+ee init secret OPENAI_API_KEY <your-api-key>
+ee init embedding --mode api --api-provider openai --model text-embedding-3-small
+ee init show
 ```
 
-如果已经作为命令安装，可直接使用：
+如果你更想用 Gemini 或 Jina 做 embedding，可以沿用同样的 `ee init embedding` 流程，只替换 provider 和 model。
+
+### 日常使用与 Operator 使用
+
+日常使用时，优先直接问宿主 agent，例如：
+
+- “ExperienceEngine 刚刚注入了什么？”
+- “为什么那条 ExperienceEngine 提示会命中？”
+- “把刚才那次 ExperienceEngine 介入标记为 helpful 或 harmful。”
+
+OpenClaw 还支持这些 readiness / silence 问题：
+
+- “ExperienceEngine 这里 ready 了吗？”
+- “这个仓库里的 ExperienceEngine 还在 warming up 吗？”
+- “刚才为什么 ExperienceEngine 没有注入？”
+
+对于 `OpenClaw`、`Codex`、`Claude Code`，常规 review / feedback 路径都应优先留在宿主内部完成。
+只有宿主侧路径不可用，或者你需要显式 operator 控制时，再退回 CLI。
+
+当你需要显式运维、验证或排障时，可以用：
 
 ```bash
-ee doctor codex
+ee init
+ee doctor <openclaw|claude-code|codex>
+ee status
+ee maintenance embedding-smoke
 ```
 
-## 前置条件
+### Ready 与 Value 状态
+
+ExperienceEngine 把 onboarding 和 value 拆成两层：
+
+- `Setup state`
+  - `Installed`
+  - `Initialized`
+  - `Ready`
+- `Value state`
+  - `Warming up`
+  - `First value reached`
+
+这不是一条严格线性阶梯。一个仓库可以已经 `Ready`，但还处于 `Warming up`。
 
-在安装任一 adapter 前，请先确认对应宿主 CLI 已经能在当前机器正常工作：
+`First value reached` 只应该在真实任务里已经出现可见价值时才成立。仅仅显示 onboarding 文案或 warm-up 提示，不算 first value。
 
-- `openclaw`：用于 OpenClaw adapter
-- `claude`：用于 Claude Code adapter
-- `codex`：用于 Codex adapter
+## 安装模型
 
-ExperienceEngine 不会替你安装这些宿主 CLI。它只会把自己接入一个已经可用的宿主环境。
+ExperienceEngine 明确拆分：
+- 宿主安装
+- 共享初始化
+- operator 工作流
 
-## 按宿主安装
+宿主仍然是主交互面。
+`ee` 仍然是显式的 operator 面，用于 setup、验证、修复、状态查看和维护。
+
+## 高级按宿主命令（仅限 Operator / 开发者）
+
+大多数用户可以跳过这一节，直接使用上面的宿主安装路径。
+
+如果你是运维者、开发者，或者确实想显式控制某个宿主，仍可使用：
 
 ```bash
 ee install openclaw
@@ -95,12 +315,23 @@ ee install claude-code
 ee install codex
 ```
 
+<details>
+<summary>Codex 原生 / 手工 MCP fallback 示例</summary>
+
+```bash
+codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceengine -- npx -y @alan512/experienceengine codex-mcp-server
+```
+
+</details>
+
 说明：
-- `OpenClaw` 走 plugin/runtime 集成，管理面更多依赖 CLI fallback
-- `Claude Code` 会同时安装 hooks 和共享 MCP server
-- `Codex` 会安装共享 MCP server
-- `ee install ...` 和 `ee doctor ...` 现在会检查 `npm/pnpm` 是否使用非官方 registry；受管模型下载默认建议使用 `https://registry.npmjs.org`
-- `ee install ...` 成功后还会主动说明冷启动预期：采集会立刻开始，但正式经验通常需要同仓库内几次相似任务后才会出现
+- `OpenClaw` 走 plugin/runtime integration，而不是 `src/adapters/`
+- `Claude Code` 会安装 hooks 和共享 ExperienceEngine MCP 服务
+- `Codex` 会安装共享 ExperienceEngine MCP 服务
+- `ee install ...` 与 `ee doctor ...` 会在 `npm` / `pnpm` 使用非官方 registry 时给出提示，因为受管模型下载在 `https://registry.npmjs.org` 下最稳定
+- 成功执行 `ee install ...` 后，也会提醒冷启动预期：capture 会立刻开始，但 formal experience 一般需要在同一仓库里出现几次相似任务后才会形成
+
+这些命令属于 operator fallback，不是默认公开安装路径。
 
 ## 数据目录
 
@@ -117,10 +348,30 @@ ee install codex
 - 受管本地 embedding 模型缓存，默认位于 `~/.experienceengine/models/embeddings`
 - 受管备份与导出快照
 
+## Embedding 默认行为
+
+当前默认行为：
+
+- `embeddingProvider = "api"`
+- provider 优先级：OpenAI -> Gemini -> Jina
+- 如果没有任何 API provider 可用，会自动回退到受管本地 embedding
+
+常用环境变量：
+
+- `EXPERIENCE_ENGINE_EMBEDDING_PROVIDER=local`
+  - 强制完全本地 embedding
+- `EXPERIENCE_ENGINE_EMBEDDING_API_PROVIDER=openai|gemini|jina`
+  - 强制指定某个 API embedding provider
+
 ## 用户手册
 
 完整用户文档见：
 
 - [ExperienceEngine 用户手册](./docs/user-guide.md)
 
-用户手册里包含安装、宿主差异、首次验证、pack 工作流、compiler/deploy 命令、维护命令和故障排查说明。
+用户手册里包含安装、宿主差异、首次验证、维护命令和故障排查说明。
+
+## 许可证
+
+本项目采用 MIT License。
+详见 [LICENSE](./LICENSE)。

package/dist/adapters/claude-code/session-store.d.ts

@@ -12,4 +12,5 @@ export declare const loadClaudeSession: (sessionId: string, options?: SessionSto
 export declare const rememberClaudePromptContext: (context: HostPromptContext, options?: SessionStoreOptions) => void;
 export declare const appendClaudeToolResult: (result: HostToolResult, options?: SessionStoreOptions) => void;
 export declare const clearClaudeSession: (sessionId: string, options?: SessionStoreOptions) => void;
+export declare const findClaudeSessionByCwd: (cwd: string, options?: SessionStoreOptions) => ClaudeStoredSession | null;
 export {};

package/dist/adapters/claude-code/session-store.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { resolveExperienceEnginePaths, resolveProductStateDir } from "../../config/path-resolver.js";
 const sanitizeSessionId = (sessionId) => sessionId.replace(/[^a-zA-Z0-9_.-]+/g, "_");
@@ -11,6 +11,15 @@ const resolveSessionDir = (options = {}) => {
     return join(resolveProductStateDir(paths), "sessions");
 };
 const resolveSessionPath = (sessionId, options = {}) => join(resolveSessionDir(options), `${sanitizeSessionId(sessionId)}.json`);
+const listClaudeSessionPaths = (options = {}) => {
+    const dir = resolveSessionDir(options);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir)
+        .filter((entry) => entry.endsWith(".json"))
+        .map((entry) => join(dir, entry));
+};
 export const loadClaudeSession = (sessionId, options = {}) => {
     const filePath = resolveSessionPath(sessionId, options);
     if (!existsSync(filePath)) {
@@ -53,4 +62,18 @@ export const clearClaudeSession = (sessionId, options = {}) => {
     const filePath = resolveSessionPath(sessionId, options);
     rmSync(filePath, { force: true });
 };
+export const findClaudeSessionByCwd = (cwd, options = {}) => {
+    const matches = listClaudeSessionPaths(options)
+        .map((filePath) => ({
+        filePath,
+        mtimeMs: statSync(filePath).mtimeMs,
+        session: JSON.parse(readFileSync(filePath, "utf8"))
+    }))
+        .filter((entry) => entry.session.promptContext?.cwd === cwd)
+        .sort((left, right) => right.mtimeMs - left.mtimeMs);
+    if (matches.length !== 1) {
+        return null;
+    }
+    return matches[0]?.session ?? null;
+};
 //# sourceMappingURL=session-store.js.map

package/dist/adapters/claude-code/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../src/adapters/claude-code/session-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../src/adapters/claude-code/session-store.ts"],"names":[],"mappings":"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"}

package/dist/adapters/codex/action-registry.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import type { ExperienceNodeType, ExperienceState } from "../../types/domain.js";
+export type CodexActionCategory = "inspect" | "state" | "admin" | "maintenance";
+export type CodexActionRiskLevel = "low" | "medium" | "high";
+export type CodexActionDefinition = {
+    id: string;
+    title: string;
+    summary: string;
+    category: CodexActionCategory;
+    riskLevel: CodexActionRiskLevel;
+    requiresConfirmation: boolean;
+    inputSchema?: z.ZodTypeAny;
+    examplePayload?: Record<string, unknown>;
+    handler: (args: Record<string, unknown>) => Promise<unknown>;
+};
+type RegistryDeps = {
+    interactionSurface: {
+        inspectRecent: (args?: {
+            mode?: "all" | "injected";
+            limit?: number;
+        }) => Promise<unknown>;
+        inspectNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        listNodesByState: (args: {
+            state: ExperienceState;
+        }) => Promise<unknown>;
+        listNodesByType: (args: {
+            nodeType: ExperienceNodeType;
+        }) => Promise<unknown>;
+        inspectLearningSummary: () => Promise<unknown>;
+        coolNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        retireNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        feedbackNode: (args: {
+            nodeId: string;
+            feedback: "helped" | "harmed";
+        }) => Promise<unknown>;
+        disableScope: (args?: {
+            cwd?: string;
+        }) => Promise<unknown>;
+        enableScope: (args?: {
+            cwd?: string;
+        }) => Promise<unknown>;
+    };
+    operationalSurface: {
+        checkUpdate: (adapter: "openclaw" | "claude-code" | "codex") => Promise<unknown>;
+    };
+    operationalActions: {
+        planOperation: (args: {
+            adapter: "openclaw" | "claude-code" | "codex";
+            operation: "install" | "repair" | "upgrade";
+        }) => unknown;
+        executePlannedOperation: (args: {
+            planId: string;
+            confirmationToken: string;
+        }) => unknown;
+    };
+    stateArtifacts: {
+        listBackups: () => unknown;
+        planOperation: (args: {
+            operation: "backup" | "export";
+        } | {
+            operation: "import";
+            importPath: string;
+        } | {
+            operation: "rollback";
+            backupId: string;
+        }) => unknown;
+        executePlannedOperation: (args: {
+            planId: string;
+            confirmationToken: string;
+        }) => unknown;
+    };
+};
+export type CodexActionRegistry = ReturnType<typeof createCodexActionRegistry>;
+export declare const createCodexActionRegistry: (deps: RegistryDeps) => {
+    list: () => CodexActionDefinition[];
+    get: (id: string) => CodexActionDefinition | undefined;
+};
+export {};