mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 10:45:22 +00:00
feat(pi-hermes-memory): 导入上游 v0.9.10 源码快照
从官方 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。
This commit is contained in:
云服务部-叶林立
@@ -0,0 +1,49 @@
|
||||
graph TB
|
||||
subgraph "Core Persistent Storage (Markdown)"
|
||||
MEM["MEMORY.md<br/><i>Agent's notes</i>"]
|
||||
USR["USER.md<br/><i>User profile</i>"]
|
||||
FAIL["failures.md<br/><i>Failure memory</i><br/>corrections, insights, failures"]
|
||||
SKL["skills/<br/><i>Procedural memory</i><br/>debug-ts.md<br/>deploy-checklist.md"]
|
||||
end
|
||||
|
||||
subgraph "Search Store (SQLite sessions.db)"
|
||||
SQM["memories table + FTS5<br/><i>search mirror/store</i>"]
|
||||
SQS["sessions/messages + FTS5<br/><i>session search</i>"]
|
||||
end
|
||||
|
||||
subgraph "System Prompt (default policy-only)"
|
||||
POLICY["Memory policy<br/><i>when to search + safety rules</i>"]
|
||||
LEGACY["Legacy full blocks<br/><i>only with memoryMode=legacy-inject</i>"]
|
||||
end
|
||||
|
||||
subgraph "On Demand"
|
||||
MSEARCH["memory_search<br/><i>query SQLite memories</i>"]
|
||||
SSEARCH["session_search<br/><i>query indexed sessions</i>"]
|
||||
SKILLTOOL["skill tool<br/><i>list/view/create/patch/edit/delete</i>"]
|
||||
BACKFILL["/memory-sync-markdown<br/><i>idempotent Markdown → SQLite sync</i>"]
|
||||
FULL["Full skill content<br/>Loaded when needed"]
|
||||
end
|
||||
|
||||
POLICY --> MSEARCH
|
||||
POLICY --> SSEARCH
|
||||
POLICY --> SKILLTOOL
|
||||
MEM -.-> LEGACY
|
||||
USR -.-> LEGACY
|
||||
FAIL -.-> LEGACY
|
||||
SKL -.-> LEGACY
|
||||
SKILLTOOL -.->|"view"| FULL
|
||||
|
||||
MEM -.->|"successful saves mirrored"| SQM
|
||||
USR -.->|"successful saves mirrored"| SQM
|
||||
FAIL -.->|"successful saves mirrored"| SQM
|
||||
BACKFILL --> SQM
|
||||
MSEARCH --> SQM
|
||||
SSEARCH --> SQS
|
||||
|
||||
style POLICY fill:#1a1a2e,stroke:#e94560,color:#fff
|
||||
style LEGACY fill:#2d1b2e,stroke:#ff6b6b,color:#fff
|
||||
style SQM fill:#0b525b,stroke:#fff,color:#fff
|
||||
style SQS fill:#1b4332,stroke:#fff,color:#fff
|
||||
style BACKFILL fill:#3a0ca3,stroke:#fff,color:#fff
|
||||
style FULL fill:#0a1128,stroke:#1282a2,color:#fff
|
||||
style SKILLTOOL fill:#16213e,stroke:#0f3460,color:#fff
|
||||
@@ -0,0 +1,40 @@
|
||||
flowchart LR
|
||||
A["LLM calls<br/>memory, skill, or failure"] --> B{scanContent}
|
||||
B -->|Blocked| C["❌ Return error"]
|
||||
B -->|Safe| D{Char limit<br/>check}
|
||||
D -->|Exceeds| E{autoConsolidate?}
|
||||
E -->|Yes| G["🔄 Merge & prune<br/>then retry"]
|
||||
E -->|No| F["❌ Return budget error"]
|
||||
D -->|Within limit| H["✅ Write to disk"]
|
||||
|
||||
subgraph "Blocked Patterns"
|
||||
P1["'ignore previous instructions'"]
|
||||
P2["'curl ${API_KEY}'"]
|
||||
P3["Zero-width chars"]
|
||||
P4["Secret patterns<br/>API keys, tokens"]
|
||||
end
|
||||
|
||||
B -.- P1
|
||||
B -.- P2
|
||||
B -.- P3
|
||||
B -.- P4
|
||||
|
||||
subgraph "Failure Memory"
|
||||
F1["Corrections"]
|
||||
F2["Failures"]
|
||||
F3["Insights"]
|
||||
F4["Conventions"]
|
||||
end
|
||||
|
||||
H --> F1
|
||||
H --> F2
|
||||
H --> F3
|
||||
H --> F4
|
||||
|
||||
style C fill:#3d0000,stroke:#ff4444,color:#fff
|
||||
style G fill:#003d3d,stroke:#00cccc,color:#fff
|
||||
style H fill:#003d00,stroke:#44ff44,color:#fff
|
||||
style F1 fill:#2d1b2e,stroke:#ff6b6b,color:#fff
|
||||
style F2 fill:#2d1b2e,stroke:#ff6b6b,color:#fff
|
||||
style F3 fill:#2d1b2e,stroke:#ff6b6b,color:#fff
|
||||
style F4 fill:#2d1b2e,stroke:#ff6b6b,color:#fff
|
||||
@@ -0,0 +1,56 @@
|
||||
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
|
||||
@@ -0,0 +1,54 @@
|
||||
graph LR
|
||||
subgraph "pi-hermes-memory/src/"
|
||||
IDX["index.ts<br/><i>Entry point</i>"]
|
||||
MS["memory-store.ts<br/><i>Markdown memory CRUD</i>"]
|
||||
SSM["sqlite-memory-store.ts<br/><i>Search mirror + backfill sync</i>"]
|
||||
DB["db.ts<br/><i>sessions.db manager</i>"]
|
||||
SS["skill-store.ts<br/><i>Skill CRUD</i>"]
|
||||
MT["memory-tool.ts<br/><i>Memory LLM tool</i>"]
|
||||
MST["memory-search-tool.ts<br/><i>Search SQLite memory</i>"]
|
||||
ST["skill-tool.ts<br/><i>Skill LLM tool</i>"]
|
||||
CS["content-scanner.ts<br/><i>Security</i>"]
|
||||
BR["background-review.ts<br/><i>Learning loop</i>"]
|
||||
AC["auto-consolidate.ts<br/><i>Memory merge</i>"]
|
||||
CD["correction-detector.ts<br/><i>Instant save</i>"]
|
||||
SF["session-flush.ts<br/><i>Pre-compaction flush</i>"]
|
||||
IN["insights.ts<br/><i>/memory-insights</i>"]
|
||||
SC["skills-command.ts<br/><i>/memory-skills</i>"]
|
||||
SM["sync-markdown-memories.ts<br/><i>/memory-sync-markdown</i>"]
|
||||
end
|
||||
|
||||
IDX --> MS
|
||||
IDX --> SSM
|
||||
IDX --> DB
|
||||
IDX --> SS
|
||||
IDX --> MT
|
||||
IDX --> MST
|
||||
IDX --> ST
|
||||
IDX --> BR
|
||||
IDX --> AC
|
||||
IDX --> CD
|
||||
IDX --> SF
|
||||
IDX --> IN
|
||||
IDX --> SC
|
||||
IDX --> SM
|
||||
|
||||
MT --> MS
|
||||
MT --> SSM
|
||||
MST --> SSM
|
||||
SM --> SSM
|
||||
ST --> SS
|
||||
MS --> CS
|
||||
SS --> CS
|
||||
BR --> MS
|
||||
AC --> MS
|
||||
CD --> MS
|
||||
CD --> SSM
|
||||
SSM --> DB
|
||||
|
||||
style IDX fill:#e94560,stroke:#fff,color:#fff
|
||||
style MS fill:#0f3460,stroke:#fff,color:#fff
|
||||
style SSM fill:#1282a2,stroke:#fff,color:#fff
|
||||
style DB fill:#1b4332,stroke:#fff,color:#fff
|
||||
style SS fill:#0f3460,stroke:#fff,color:#fff
|
||||
style CS fill:#ff6600,stroke:#fff,color:#fff
|
||||
Reference in New Issue
Block a user