mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 18:55:22 +00:00
云服务部-叶林立
312bb2ba5a
从官方 Git 仓库导入 chandra447/pi-hermes-memory 在 tag v0.9.10 （df624056a2e8c68bc89ba0a81e1c120856ec9665，2026-10-02）的源码快照。 本次仅导入源码，尚未接入组合包：package.json、加载顺序、依赖与权限策略 均未改动。 - 原样导入 src/、tests/、docs/、scripts/、README、CHANGELOG、PLAN、 AGENTS 与 LICENSE；该快照共 156 个上游文件。 - 剔除嵌套 .git、上游 .github 工作流、.ralph/、.claude/、node_modules、 覆盖率与构建产物。 - 新增中文 UPSTREAM.md，记录来源，以及启用前必须完成的待决事项： 在 pi-compaction 之前注册加载顺序、better-sqlite3 版本与根 allowScripts 对齐、strip-ansi 解析确认。 - 说明选择 tag 而非 main 的原因：导入时上游 main 已领先至 24fcd8ad26fc27badb8d7dbaf8034645de07b893（2026-10-11），选 tag 是为 对应一个已发布、可复现的版本。 尚未接线。启用前还需反转 tests/extension-load.test.ts 中"不得加载 Hermes"的断言，并同步 pi-tool-search 分组、权限策略与文档。 验证：快照 156 个上游文件全部导入，目录内仅多出 UPSTREAM.md 一份； 已确认与上游 main 内容存在差异，证明取的是 tag 而非 main。
57 lines
2.3 KiB
Plaintext
57 lines
2.3 KiB
Plaintext
sequenceDiagram
|
|
participant User
|
|
participant Pi
|
|
participant Extension
|
|
participant MD as Markdown (~/.pi/agent/...)
|
|
participant SQL as SQLite (sessions.db)
|
|
|
|
Note over Pi,SQL: ── Session Start ──
|
|
Pi->>Extension: session_start event
|
|
Extension->>MD: loadFromDisk() — MEMORY.md + USER.md + failures.md + skills/
|
|
Extension-->>Extension: Load searchable memory stores
|
|
|
|
Note over Pi,SQL: ── System Prompt Context ──
|
|
Pi->>Extension: before_agent_start event
|
|
Extension-->>Pi: systemPrompt + compact memory policy
|
|
Note right of Pi: Default mode does NOT inject full Markdown memory
|
|
opt memoryMode = legacy-inject
|
|
Extension-->>Pi: systemPrompt + legacy memory blocks
|
|
end
|
|
|
|
Note over Pi,SQL: ── Agent Loop (memory add) ──
|
|
User->>Pi: "Remember I prefer vim"
|
|
Pi->>Extension: tool_call (memory, add)
|
|
Extension->>Extension: scanContent() security check
|
|
Extension->>MD: Atomic write to USER.md
|
|
alt Markdown save success
|
|
Extension->>SQL: best-effort sync to memories table
|
|
Extension-->>Pi: success (plus warning only if sync fails)
|
|
else Markdown save fails (limit/validation)
|
|
Extension-->>Pi: fail (no SQLite-only fallback)
|
|
end
|
|
|
|
Note over Pi,SQL: ── User Correction ──
|
|
User->>Pi: "No, don't use npm — use pnpm"
|
|
Extension->>Extension: isCorrection() = true
|
|
Extension->>Pi: pi.exec("pi -p", correctionPrompt)
|
|
Extension->>MD: Save [correction] failure memory
|
|
Extension->>SQL: best-effort correction sync
|
|
|
|
Note over Pi,SQL: ── Search + Backfill ──
|
|
Pi->>Extension: memory_search(query)
|
|
Extension->>SQL: FTS5 search memories
|
|
SQL-->>Extension: results
|
|
Pi->>Extension: /memory-sync-markdown
|
|
Extension->>MD: scan global + project Markdown files
|
|
Extension->>SQL: idempotent Markdown → SQLite import
|
|
|
|
Note over Pi,SQL: ── Background Learning ──
|
|
Pi->>Extension: turn_end (10 turns or 15 tool calls)
|
|
Extension->>Pi: pi.exec("pi -p", reviewPrompt)
|
|
Note right of Pi: Review can save memories/failures/skills
|
|
|
|
Note over Pi,SQL: ── Session End ──
|
|
Pi->>Extension: session_shutdown event
|
|
Extension->>Pi: pi.exec("pi -p", flushPrompt)
|
|
Note right of Pi: final chance to save durable learnings
|