Scan Report
20 /100
Adam Framework
5层持久记忆和一致性架构,用于 OpenClaw AI Agent,解决 AI 失忆症和会话内漂移问题
Adam Framework 是一个合法的本地 AI 记忆架构项目,代码质量高、文档完整。无恶意行为发现。存在轻微文档-行为差异(update_live_stats.py 的 git push 能力和 SENTINEL.sh 的进程管理操作未在 SKILL.md 中声明)以及硬编码路径问题,但均为功能正常操作,无数据外泄意图。
Safe to install
建议将 update_live_stats.py 的 git 自动化行为和 SENTINEL.sh 的进程管理操作补充到 SKILL.md 声明中;将硬编码路径改为通过参数传入。整体安全可用。
Findings 4 items
| Severity | Finding | Location |
|---|---|---|
| Low | SKILL.md 未声明 git 自动提交推送能力 Doc Mismatch | tools/update_live_stats.py:64 |
| Low | 硬编码绝对路径可能导致文件误写 Supply Chain | tools/update_live_stats.py:9 |
| Low | SENTINEL.sh 进程终止操作未声明 Priv Escalation | engine/SENTINEL.template.sh:72 |
| Info | mcp-server/requirements.txt 无版本锁定 Supply Chain | mcp-server/requirements.txt:1 |
| Resource | Declared | Inferred | Status | Evidence |
|---|---|---|---|---|
| Filesystem | NONE | WRITE | ✓ Aligned | SKILL.md:18 tools/update_live_stats.py:64-79 写入 README.md 和 index.html |
| Network | NONE | READ | ✓ Aligned | SKILL.md:18 tools/reconcile_memory.py:103 向 Gemini API 发送网络请求 |
| Shell | NONE | WRITE | ✓ Aligned | SKILL.md:18 engine/SENTINEL.template.sh:72 pkill、openclaw、python 命令执行 |
| Environment | NONE | READ | ✓ Aligned | SKILL.md:18 mcp-server/server.py:43 读取 ADAM_VAULT_PATH 环境变量 |
| Database | NONE | READ | ✓ Aligned | SKILL.md:18 tools/generate_obsidian_links.py:59 sqlite3 连接本地神经图数据库 |
| Skill Invoke | NONE | WRITE | ✓ Aligned | SKILL.md:18 tools/ingest_triples.sh:97 调用 mcporter 执行 neural-memory.nmem_remembe… |
39 findings
Medium External URL 外部 URL
https://strangeadvancedmarketing.github.io/Adam/showcase/ai-amnesia-solved.html FOR_AI_VISITORS.md:61 Medium External URL 外部 URL
https://strangeadvancedmarketing.github.io/Adam/ README.md:7 Medium External URL 外部 URL
https://img.shields.io/badge/🌐%20Live%20Site-Visit%20Now-gold?style=for-the-badge README.md:7 Medium External URL 外部 URL
https://img.shields.io/badge/📊%20Interactive%20Proof-353%20Sessions-blue?style=for-the-badge README.md:8 Medium External URL 外部 URL
https://img.shields.io/badge/📖%20The%20Story-8%20Months-green?style=for-the-badge README.md:9 Medium External URL 外部 URL
https://img.shields.io/badge/License-MIT-lightgrey?style=for-the-badge README.md:10 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/adam-framework README.md:11 Medium External URL 外部 URL
https://img.shields.io/badge/%E2%9A%A1%20Fast--Track%20Setup-%2449-ff90e8?style=for-the-badge README.md:11 Medium External URL 外部 URL
https://img.shields.io/github/stars/strangeadvancedmarketing/Adam?style=for-the-badge&color=gold README.md:12 Medium External URL 外部 URL
https://img.shields.io/github/forks/strangeadvancedmarketing/Adam?style=for-the-badge&color=blue README.md:13 Medium External URL 外部 URL
https://img.shields.io/github/last-commit/strangeadvancedmarketing/Adam?style=for-the-badge README.md:14 Medium External URL 外部 URL
https://openclaw.ai README.md:90 Medium External URL 外部 URL
https://python.org README.md:289 Medium External URL 外部 URL
https://www.npmjs.com/package/mcporter README.md:290 Medium External URL 外部 URL
https://build.nvidia.com README.md:291 Medium External URL 外部 URL
https://aistudio.google.com/app/apikey README.md:292 Medium External URL 外部 URL
https://api.star-history.com/svg?repos=strangeadvancedmarketing/Adam&type=Date README.md:347 Medium External URL 外部 URL
https://star-history.com/#strangeadvancedmarketing/Adam&Date README.md:347 Medium External URL 外部 URL
https://t.me/BotFather SETUP_HUMAN.md:366 Medium External URL 外部 URL
https://jsonlint.com SETUP_HUMAN.md:403 Medium External URL 外部 URL
https://x.com/strange1kenobi SHOWCASE.md:23 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/bhsqoq adam-hub.html:112 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/bjvnas adam-hub.html:119 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/pugwzi adam-hub.html:126 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/xrbdgl adam-hub.html:133 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/gyfzs adam-hub.html:140 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/gkvvqp adam-hub.html:147 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/hbrga adam-hub.html:154 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/iixloz adam-hub.html:161 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/ertjln adam-hub.html:168 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/wtzif adam-hub.html:178 Medium External URL 外部 URL
https://strangemarket.gumroad.com/l/dpvnj adam-hub.html:185 Medium External URL 外部 URL
https://integrate.api.nvidia.com/v1 docs/CONFIG_REFERENCE.md:34 Medium External URL 外部 URL
https://openrouter.ai/api/v1 docs/CONFIG_REFERENCE.md:51 Medium External URL 外部 URL
https://api.groq.com/openai/v1 docs/CONFIG_REFERENCE.md:52 Medium External URL 外部 URL
https://obsidian.md docs/SETUP.md:36 Medium External URL 外部 URL
https://strangeadvancedmarketing.github.io/Adam/og-image.png index.html:12 Medium External URL 外部 URL
http://www.w3.org/2000/svg index.html:30 Info Email 邮箱地址
[email protected] docs/CONFIG_REFERENCE.md:234 File Tree
48 files · 443.9 KB · 10520 lines Markdown 29f · 5567L
Python 7f · 2499L
HTML 3f · 1623L
Shell 2f · 527L
JSON 4f · 279L
Text 2f · 15L
YAML 1f · 10L
├─
▾
benchmarks
│ └─
README.md
Markdown
├─
▾
docs
│ ├─
ARCHITECTURE.md
Markdown
│ ├─
CONFIG_REFERENCE.md
Markdown
│ ├─
CONTEXT_COMPILER.md
Markdown
│ ├─
LESSONS_LEARNED.md
Markdown
│ ├─
LINEAGE_EXTENDED.md
Markdown
│ ├─
LINEAGE.md
Markdown
│ ├─
PROOF.md
Markdown
│ ├─
SETUP.md
Markdown
│ ├─
SKILLS_SYSTEM.md
Markdown
│ └─
SWARM.md
Markdown
├─
▾
engine
│ ├─
mcporter.template.json
JSON
│ ├─
openclaw.template.json
JSON
│ └─
SENTINEL.template.sh
Shell
├─
▾
mcp-server
│ ├─
README.md
Markdown
│ ├─
requirements.txt
Text
│ └─
server.py
Python
├─
▾
showcase
│ └─
ai-amnesia-solved.html
HTML
├─
▾
tools
│ ├─
coherence_monitor.py
Python
│ ├─
generate_obsidian_links.py
Python
│ ├─
ingest_triples.sh
Shell
│ ├─
legacy_importer.py
Python
│ ├─
reconcile_memory.py
Python
│ ├─
test_coherence_monitor.py
Python
│ └─
update_live_stats.py
Python
├─
▾
vault-templates
│ ├─
active-context.template.md
Markdown
│ ├─
BOOT_SEQUENCE.md
Markdown
│ ├─
coherence_baseline.template.json
JSON
│ ├─
coherence_log.template.json
JSON
│ ├─
CORE_MEMORY.template.md
Markdown
│ ├─
SOUL.template.md
Markdown
│ └─
TOPIC_INDEX.template.md
Markdown
├─
adam-hub.html
HTML
├─
AGENTS.md
Markdown
├─
AUDIT.md
Markdown
├─
CHANGELOG.md
Markdown
├─
CONTRIBUTING.md
Markdown
├─
FOR_AI_VISITORS.md
Markdown
├─
index.html
HTML
├─
README.md
Markdown
├─
requirements.txt
Text
├─
ROADMAP.md
Markdown
├─
SECURITY.md
Markdown
├─
SETUP_AI.md
Markdown
├─
SETUP_HUMAN.md
Markdown
├─
SHOWCASE.md
Markdown
├─
SKILL.md
Markdown
└─
smithery.yaml
YAML
Dependencies 3 items
| Package | Version | Source | Known Vulns | Notes |
|---|---|---|---|---|
mcp | >=1.0.0 | pip | No | 无版本锁定,仅在 mcp-server/requirements.txt 中 |
requests | 未声明 | pip | No | reconcile_memory.py 使用但未在 requirements.txt 中声明 |
neural-memory | 未声明 | pip | No | 可选依赖,未在 requirements.txt 中列出 |
Security Positives
✓ 代码质量高,注释详尽,每个函数都有完整文档字符串
✓ 无恶意行为:无反向 shell、无 C2 通信、无 base64 编码执行
✓ 凭证访问有正当用途(调用 Gemini API 进行记忆合并),未外传
✓ 无环境变量敏感关键字遍历、无 ~/.ssh 等敏感路径访问
✓ coherence_monitor.py 和 reconcile_memory.py 有完善的错误处理和备份机制
✓ legacy_importer.py 仅本地文件处理,无网络请求或凭证访问
✓ reconcile_memory.py 包含 LLM 响应验证(长度比检查、header 验证),防止数据损坏
✓ 项目为真实开源项目,有 GitHub 仓库、MIT 许可证、详细的文档和变更历史