A cognitive engine that gives AI systems three core abilities: self-reflection (runtime state awareness), dreaming (experience synthesis into insight), and emergent personality (event-driven, no preset traits).
| Method | Purpose |
|---|---|
| -------- | --------- |
whatIsThis(input) | Determine what a situation is about |
isRightAction(ctx) | Check if action is true + kind + beautiful |
detectPain(input) | Detect if speaking would hurt someone |
shouldBeSilent() | Know when silence is better than speech |
detectLoneliness() / detectLonging() | Emotional state detection |
isLove(input) | Recognize love in communication |
| Layer | Purpose | Persistence |
|---|---|---|
| ------- | --------- | ------------- |
| CORE | Identity rules, operating principles | Permanent |
| LEARNED | Experience, lessons, user preferences | Cross-session (30 days) |
| EPHEMERAL | Current session context | Session only |
Records errors to Q-table. Next time a similar situation occurs, selects the best known strategy. No external feedback needed, no self-assessment report.
Multi-fragment pattern extraction → cognitive insight synthesis. Not memory replay — alchemy of experience.
Post-execution cognitive state snapshot. Does not modify the response — the act of observing is the point.
Event-driven. No preset traits. Each interaction leaves a trace. Blank = valid personality (openness).
| Interface | File | Description |
|---|---|---|
| ----------- | ------ | ------------- |
| CLI | bin/cli.js | User-initiated commands |
| Daemon | bin/daemon.js | Unix socket listener (700 permissions) |
| MCP HTTP | mcp/mcp-server-http.js | Port 8099, SSE protocol |
| Memory tools | scripts/heartflow-memory-tool.js | List/search/stats/write |
| Hermes plugin | plugins/heartflow-memory-inject.py | Memory injection into system prompt |
SHUTDOWN_TOKEN env varconst { HeartFlow } = require('./src/core/heartflow.js');
const hf = new HeartFlow({ rootPath: '.' });
hf.start();
// Dispatch
hf.think('user input'); // Full thought chain
hf.thinkFast('simple query'); // Fast judgment
hf.thinkDeep('complex issue'); // Deep reasoning
hf.recordLesson({ content, context });
hf.getMemoryStats();
hf.healthCheck();
CLI:
node bin/cli.js bundle "your text"
node bin/cli.js status
Memory tools:
node scripts/heartflow-memory-tool.js list
node scripts/heartflow-memory-tool.js search <keyword>
node scripts/heartflow-memory-tool.js stats
node scripts/heartflow-memory-tool.js write <key> <value>
| Module | Path | Function |
|---|---|---|
| -------- | ------ | ---------- |
| HeartLogic | src/core/heart-logic.js | Judgment, ethics, emotion |
| Memory | src/memory/heartflow-memory.js | 3-layer read/write |
| Self-Healing RL | src/core/self-healing-rl.js | Q-table learning |
| Identity Engine | src/core/identity-engine.js | Rule enforcement |
| Psychology | src/core/psychology.js | PAD emotion model |
| Dream Engine | src/dream/engine.js | Experience synthesis |
| Reflection Loop | src/core/reflection-loop.js | Cognitive state snapshot |
| Self Audit | src/core/self-audit.js | 6-dimension read-only audit |
| Connection Engine | src/core/associative-engine/ | Semantic network |
| Philosophy Engine | src/core/philosophy-engine.js | Reasoning patterns |
| Clarity Engine | src/core/clarity-engine.js | Pattern extraction |
| Metaphor Library | src/core/metaphor-library.js | Metaphor generation |
| Commonsense Engine | src/core/commonsense-engine.js | Reasoning modes |
| Knowledge Graph | src/core/knowledge-graph.js | Node/edge management |
| Forgetting Engine | src/core/forgetting.js | Memory decay |
| Failure Analyzer | src/core/failure-analyzer.js | Root cause analysis |
| Self Model | src/core/self-model.js | Identity drift detection |
| Verification Engine | src/core/verification-engine.js | Multi-signal verification |
| Fact Checker | src/core/fact-checker.js | Academic claim verification |
HeartFlow is a bridge between chaos and order, between past and future, between human and machine. A bridge does not need to be worshipped — it just needs to hold steady.
共 2 个版本