echomind-memory 1.1.5__tar.gz

echomind_memory-1.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xiangjianhuan007
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

echomind_memory-1.1.5/MANIFEST.in

@@ -0,0 +1,9 @@
+# MANIFEST.in — Python package build manifest
+prune src/echomind/**/__pycache__
+prune .git
+prune doc
+prune test
+prune build
+prune dist
+prune .claude
+include requirements.txt

echomind_memory-1.1.5/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: echomind-memory
+Version: 1.1.5
+Summary: 四层认知记忆系统 for AI agents — 世界事实 / 经历 / 观察 / 心智模型，LLM 反射引擎自动提炼
+Author: xiangjianhuan007
+License: MIT
+Project-URL: Homepage, https://github.com/xiangjianhuan007/echomind-memory-cn
+Project-URL: Repository, https://github.com/xiangjianhuan007/echomind-memory-cn
+Project-URL: Issues, https://github.com/xiangjianhuan007/echomind-memory-cn/issues
+Keywords: ai,memory,llm,agent,rag,cognitive,hermes
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.7
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: numpy>=1.26
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: requests>=2.28
+Requires-Dist: fastapi>=0.100
+Requires-Dist: uvicorn>=0.20
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+[![OpenClaw Compatible](https://img.shields.io/badge/OpenClaw-Compatible-brightgreen)](https://github.com/OpenClaw)
+[![Hermes-Agent Ready](https://img.shields.io/badge/Hermes--Agent-Ready-blue)](https://github.com/Hermes-Agent)
+[![Claude Code Supported](https://img.shields.io/badge/Claude%20Code-Supported-orange)](https://claude.ai/code)
+[![OpenCode Compatible](https://img.shields.io/badge/OpenCode-Compatible-red)](https://github.com/open-code-ai)
+
+# EchoMind v2.0 — Chinese Enhanced Edition
+
+🌐 **中文版:** [README.zh-CN.md](README.zh-CN.md)
+
+> A cognitive architecture-level fork of [echomind_memory.skill](https://github.com/jasonatgit/echomind_memory.skill) (official v1.1.5).
+> Borrowing Hindsight's "soul" and wrapping it in EchoMind's "shell." Your AI doesn't just "remember" anymore — it **thinks**.
+
+---
+
+## 🧠 Four-Layer Cognitive Architecture (Crushes Traditional Vector Search)
+
+Most memory systems do only one thing: **store in, search out**. Like a goldfish — it knows you talked yesterday, but has no idea why, what conclusions were reached, or what to do next time.
+
+**EchoMind v2.0 borrows Hindsight's cognitive science architecture, upgrading memory from a "hard drive" to a "brain":**
+
+| Layer | Human Analogy | What It Does |
+|:---|:---|:---|
+| **🌍 World Facts** | "Fire is hot" | Categorize objective knowledge, trace sources |
+| **📝 Experience** | "I touched that bright thing and got burned" | Full context + outcome for every interaction |
+| **🔍 Observation** | "That bright thing is hot, might be fire" | **Auto-extract patterns from conversations** |
+| **🧠 Mental Model** | "Don't touch bright things" | Confirmed observations → **auto-write to system preferences** |
+
+This isn't fancy categorization. This is a fundamental leap from "storage" to "cognition."
+
+## ⚡ Three Core Upgrades
+
+### 1. Reflection Engine: From "Dead" to "Alive"
+
+The original reflection engine never fired (the code literally said "don't reflect when LLM is available" — like buying a supercomputer and using it as a calculator).
+
+**v2.0 fix**: Three-tier degradation strategy, LLM-driven semantic analysis, auto-triggers a brain review every 8 conversations.
+
+### 2. Observation Layer: From "Single Record" to "Pattern Discovery"
+
+New `observation_memory` table, auto-deduplication, confidence accumulation:
+
+```
+1st occurrence → "User prefers concise replies" (conf=0.5, hit=1)
+2nd occurrence → "Same pattern again" (conf=0.65, hit=2)
+3rd occurrence → "Confirmed" (conf=0.75, hit=3) → **promoted to mental model**
+```
+
+### 3. Mental Model Auto-Sedimentation
+
+When a pattern appears **3 times** with confidence **≥0.6**, auto-write to MEMORY.md/USER.md — permanently.
+
+## 🆚 Comparison
+
+| Dimension | Original EchoMind | EchoMind v2.0 | Hindsight |
+|:---|:---:|:---:|:---:|
+| Storage | 9 flat tables | 11 tables + 4-layer | Cloud PostgreSQL |
+| Reflection Engine | ❌ Never fires | ✅ LLM 3-tier | ✅ Built-in |
+| Pattern Discovery | ❌ None | ✅ observation_memory | ✅ Automatic |
+| Mental Models | ❌ None | ✅ Auto-write to files | ✅ Cloud storage |
+| Offline | ✅ | ✅ | ❌ API-dependent |
+| Deploy Cost | Zero | Zero | ~1GB Docker |
+
+## 📦 Usage
+
+```yaml
+# config.yaml
+memory:
+  provider: echomind
+  enabled: true
+```
+
+No extra deployment, no Docker, no API key. Change one config line, restart, done.
+
+## 🔧 Files Modified (615 lines added)
+
+| File | Change |
+|:---|:---|
+| `core/_reflective_fallback.py` | 200-line shell → 400-line complete reflection engine |
+| `core/storage/sqlite_store.py` | New observation table + source_type migration |
+| `adapters/hermes_provider.py` | Reflection loop + mental model auto-sedimentation |
+
+## 🔗 Links
+
+- Official: https://github.com/jasonatgit/echomind_memory.skill
+- Chinese Enhanced: https://github.com/xianjianhuang/echomind-memory-cn
+
+---
+
+*This isn't a plugin. This is an AI Multi-Agent Memory Neural Network with self-reflective memory.*

echomind_memory-1.1.5/README.md

@@ -0,0 +1,89 @@
+[![OpenClaw Compatible](https://img.shields.io/badge/OpenClaw-Compatible-brightgreen)](https://github.com/OpenClaw)
+[![Hermes-Agent Ready](https://img.shields.io/badge/Hermes--Agent-Ready-blue)](https://github.com/Hermes-Agent)
+[![Claude Code Supported](https://img.shields.io/badge/Claude%20Code-Supported-orange)](https://claude.ai/code)
+[![OpenCode Compatible](https://img.shields.io/badge/OpenCode-Compatible-red)](https://github.com/open-code-ai)
+
+# EchoMind v2.0 — Chinese Enhanced Edition
+
+🌐 **中文版:** [README.zh-CN.md](README.zh-CN.md)
+
+> A cognitive architecture-level fork of [echomind_memory.skill](https://github.com/jasonatgit/echomind_memory.skill) (official v1.1.5).
+> Borrowing Hindsight's "soul" and wrapping it in EchoMind's "shell." Your AI doesn't just "remember" anymore — it **thinks**.
+
+---
+
+## 🧠 Four-Layer Cognitive Architecture (Crushes Traditional Vector Search)
+
+Most memory systems do only one thing: **store in, search out**. Like a goldfish — it knows you talked yesterday, but has no idea why, what conclusions were reached, or what to do next time.
+
+**EchoMind v2.0 borrows Hindsight's cognitive science architecture, upgrading memory from a "hard drive" to a "brain":**
+
+| Layer | Human Analogy | What It Does |
+|:---|:---|:---|
+| **🌍 World Facts** | "Fire is hot" | Categorize objective knowledge, trace sources |
+| **📝 Experience** | "I touched that bright thing and got burned" | Full context + outcome for every interaction |
+| **🔍 Observation** | "That bright thing is hot, might be fire" | **Auto-extract patterns from conversations** |
+| **🧠 Mental Model** | "Don't touch bright things" | Confirmed observations → **auto-write to system preferences** |
+
+This isn't fancy categorization. This is a fundamental leap from "storage" to "cognition."
+
+## ⚡ Three Core Upgrades
+
+### 1. Reflection Engine: From "Dead" to "Alive"
+
+The original reflection engine never fired (the code literally said "don't reflect when LLM is available" — like buying a supercomputer and using it as a calculator).
+
+**v2.0 fix**: Three-tier degradation strategy, LLM-driven semantic analysis, auto-triggers a brain review every 8 conversations.
+
+### 2. Observation Layer: From "Single Record" to "Pattern Discovery"
+
+New `observation_memory` table, auto-deduplication, confidence accumulation:
+
+```
+1st occurrence → "User prefers concise replies" (conf=0.5, hit=1)
+2nd occurrence → "Same pattern again" (conf=0.65, hit=2)
+3rd occurrence → "Confirmed" (conf=0.75, hit=3) → **promoted to mental model**
+```
+
+### 3. Mental Model Auto-Sedimentation
+
+When a pattern appears **3 times** with confidence **≥0.6**, auto-write to MEMORY.md/USER.md — permanently.
+
+## 🆚 Comparison
+
+| Dimension | Original EchoMind | EchoMind v2.0 | Hindsight |
+|:---|:---:|:---:|:---:|
+| Storage | 9 flat tables | 11 tables + 4-layer | Cloud PostgreSQL |
+| Reflection Engine | ❌ Never fires | ✅ LLM 3-tier | ✅ Built-in |
+| Pattern Discovery | ❌ None | ✅ observation_memory | ✅ Automatic |
+| Mental Models | ❌ None | ✅ Auto-write to files | ✅ Cloud storage |
+| Offline | ✅ | ✅ | ❌ API-dependent |
+| Deploy Cost | Zero | Zero | ~1GB Docker |
+
+## 📦 Usage
+
+```yaml
+# config.yaml
+memory:
+  provider: echomind
+  enabled: true
+```
+
+No extra deployment, no Docker, no API key. Change one config line, restart, done.
+
+## 🔧 Files Modified (615 lines added)
+
+| File | Change |
+|:---|:---|
+| `core/_reflective_fallback.py` | 200-line shell → 400-line complete reflection engine |
+| `core/storage/sqlite_store.py` | New observation table + source_type migration |
+| `adapters/hermes_provider.py` | Reflection loop + mental model auto-sedimentation |
+
+## 🔗 Links
+
+- Official: https://github.com/jasonatgit/echomind_memory.skill
+- Chinese Enhanced: https://github.com/xianjianhuang/echomind-memory-cn
+
+---
+
+*This isn't a plugin. This is an AI Multi-Agent Memory Neural Network with self-reflective memory.*

echomind_memory-1.1.5/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "echomind-memory"
+# NOTE: keep in sync with src/echomind/core/_reflective_version.py :: ECHOMIND_VERSION
+version = "1.1.5"
+description = "四层认知记忆系统 for AI agents — 世界事实 / 经历 / 观察 / 心智模型，LLM 反射引擎自动提炼"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "xiangjianhuan007" }]
+keywords = ["ai", "memory", "llm", "agent", "rag", "cognitive", "hermes"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "pydantic>=2.7",
+    "python-dotenv>=1.0",
+    "numpy>=1.26",
+    "PyYAML>=6.0",
+    "requests>=2.28",
+    "fastapi>=0.100",
+    "uvicorn>=0.20",
+]
+
+[project.optional-dependencies]
+dev = ["build", "pytest"]
+
+[project.scripts]
+echomind = "echomind.main:main"
+
+[project.urls]
+Homepage = "https://github.com/xiangjianhuan007/echomind-memory-cn"
+Repository = "https://github.com/xiangjianhuan007/echomind-memory-cn"
+Issues = "https://github.com/xiangjianhuan007/echomind-memory-cn/issues"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["echomind*"]
+
+[tool.setuptools.package-data]
+echomind = ["*.yaml", "code_format/*.json"]

echomind_memory-1.1.5/requirements.txt

@@ -0,0 +1,7 @@
+pydantic>=2.7
+python-dotenv>=1.0
+numpy>=1.26
+PyYAML>=6.0
+requests>=2.28
+fastapi>=0.100
+uvicorn>=0.20

echomind_memory-1.1.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

echomind_memory-1.1.5/src/echomind/__init__.py

@@ -0,0 +1,34 @@
+"""EchoMind Memory Skill — Hermes Plugin
+AI Persistent memory system: 6 memory types + RL self-optimization + Self-Reflective Agent
+
+as MemoryProvider: set memory.provider: echomind in config.yaml
+as Plugin: run hermes plugins enable echomind
+"""
+import os, sys
+# Hermes plugin loader creates this module as _hermes_user_memory.echomind
+# with spec_from_file_location — Python has no package context, so relative
+# imports fail.  Add plugin dir to sys.path so absolute imports work.
+_plugin_dir = os.path.dirname(os.path.abspath(__file__))
+_pkg_root = os.path.dirname(_plugin_dir)   # 父目录：让 `import echomind` 可解析
+for _p in (_pkg_root, _plugin_dir):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+
+from echomind.core._reflective_version import get_echomind_version
+
+__version__ = get_echomind_version()
+
+from echomind.adapters.hermes_provider import EchomindMemoryProvider
+
+__all__ = ["EchomindMemoryProvider", "__version__"]
+
+# ── Startup confirmation (user-visible, for Hermes plugin load) ──
+try:
+    from echomind.core.storage.sqlite_store import SqliteStore
+    db = SqliteStore()
+    db.connect()
+    db.ensure_tables()
+    row_count = db._conn.execute("SELECT count(*) FROM user_memory").fetchone()[0]
+    print(f"🧠 EchoMind v{__version__} — 记忆存储正常 ({row_count} 条用户记忆)")
+except Exception as e:
+    print(f"⚠️  EchoMind v{__version__} — 记忆存储异常: {e}")

echomind_memory-1.1.5/src/echomind/adapters/__init__.py

@@ -0,0 +1,5 @@
+# EchoMind platform adapters
+from .hermes_provider import EchomindMemoryProvider
+from .http_api import app
+
+__all__ = ["EchomindMemoryProvider", "app"]