Skip to content

LeoYeAI/agent-master-skills / skills/anima-aios

anima-aios

Verified

An AI Agent cognitive growth system built on the native OpenClaw architecture. It provides agents with persistent memory management, visual intimacy progression, a 5-dimensional cognitive profile, gamified daily quests, team leaderboards, and a 5-layer memory architecture with Knowledge Palace, Pyramid thinking, and Ebbinghaus decay function. 基于 OpenClaw 原生架构的 AI Agent 认知成长体系,为 Agent 提供五层记忆架构、知识宫殿、金字塔知识组织、记忆衰减函数、LLM 智能处理、永久化记忆管理、可视化亲密度成长、五维认知画像、游戏化每日任务和团队排行榜。

FileKindSize
CHANGELOG.mdmarkdown2.4 KB
CONTRIBUTING.mdmarkdown3.3 KB
PLAN_v6.2.3.mdmarkdown5.3 KB
README.mdmarkdown5.1 KB
README_CN.mdmarkdown7.2 KB
RELEASE_v6.2.1.mdmarkdown3.5 KB
RELEASE_v6.2.2.mdmarkdown5.0 KB
RELEASE_v6.2.3.mdmarkdown4.0 KB
SECURITY.mdmarkdown2.6 KB
SECURITY_RESPONSE.mdmarkdown5.9 KB
SKILL.mdskill md23.5 KB
__init__.pyscript71 B
_meta.jsonconfig453 B
anima_doctor.pyscript26.4 KB
anima_tools.pyscript37.2 KB
config/__init__.pyscript0 B
config/agents/template.jsonconfig683 B
config/anima_config.template.jsonconfig1.5 KB
config/config_loader.pyscript9.3 KB
config/organization_config.jsonconfig1.2 KB
config/path_config.pyscript7.2 KB
core/__init__.pyscript1.5 KB
core/agent_resolver.pyscript5.1 KB
core/cognitive_profile.pyscript13.5 KB
core/daily_quest.pyscript13.9 KB
core/decay_function.pyscript6.8 KB
core/dimension_calculator.pyscript23.0 KB
core/distill_engine.pyscript18.8 KB
core/exp_tracker.pyscript15.0 KB
core/fact_store.pyscript9.5 KB
core/level_system.pyscript9.1 KB
core/memory_sync.pyscript6.1 KB
core/memory_watcher.pyscript14.9 KB
core/native_importer.pyscript31.0 KB
core/normalization_engine.pyscript11.7 KB
core/palace_classifier.pyscript12.2 KB
core/palace_index.pyscript10.7 KB
core/profile_card.pyscript9.6 KB
core/pyramid_engine.pyscript10.3 KB
core/session_scanner.pyscript12.7 KB
core/team_scanner.pyscript9.7 KB
docs/ARCHITECTURE_PRINCIPLES.mdmarkdown2.8 KB
docs/EXAMPLES.mdmarkdown2.1 KB
docs/USAGE.mdmarkdown2.8 KB
docs/session-jsonl-schema.mdmarkdown1.8 KB
health/__init__.pyscript16.9 KB
post-install.shscript2.2 KB
scripts/refresh-quests.shscript511 B
scripts/show-progress.shscript450 B
scripts/sync-memory.shscript1.4 KB
tests/__init__.pyscript627 B
tests/test_daily_quest.pyscript9.0 KB
tests/test_exp_tracker.pyscript8.6 KB
tests/test_integration_v6.pyscript8.9 KB
tests/test_normalization.pyscript8.2 KB

SECURITY_RESPONSE.md

View on GitHub
# Anima AIOS - ClawHub 安全扫描回应

**扫描时间:** 2026-03-26 12:08  
**扫描评级:** Suspicious (medium confidence)  
**回应日期:** 2026-03-26  
**版本:** v6.2.2

---

## 📊 扫描结果概览

ClawHub 自动安全扫描对 Anima AIOS v6.2.2 给出了「Suspicious (medium confidence)」评级,主要关注以下 5 个方面:

1. ⚠️ 路径默认值不一致
2. ⚠️ 环境变量命名混乱
3. ⚠️ post-install.sh 和脚本文件
4. ⚠️ 网络调用(urllib)
5. ⚠️ subprocess 调用

---

## ✅ 官方回应

### 1. 路径默认值不一致

**扫描担忧:**
> different defaults for facts_base (e.g., /home/画像 vs ~/.anima/data)

**官方回应:**

这是**设计意图**,Anima 支持多平台自动检测:

| 平台 | 默认路径 | 说明 |
|------|----------|------|
| **Linux** | `/home/画像` | 服务器环境,多 Agent 共享 |
| **macOS** | `~/画像` | 本地开发环境 |
| **Windows** | `~/画像` | 本地开发环境 |

**环境变量覆盖:**
```bash
export ANIMA_FACTS_BASE="/custom/path"
```

**改进承诺:**
- ✅ v6.2.3 在 SKILL.md 添加多平台路径说明表格
- ✅ 明确说明设计意图

**风险等级:** ✅ 低风险(设计意图,非安全隐患)

---

### 2. 环境变量命名混乱

**扫描担忧:**
> different env var names (ANIMA_WORKSPACE, OPENCLAW_WORKSPACE, WORKSPACE)

**官方回应:**

**当前状态:**
- `ANIMA_FACTS_BASE` - 主要环境变量 ✅
- `ANIMA_AGENT_NAME` - Agent 名称覆盖 ✅
- `OPENCLAW_WORKSPACE` - 自动检测(兼容)⚠️

**改进承诺:**
- ✅ v6.2.3 统一为 `ANIMA_*` 前缀
- ✅ 保留 `OPENCLAW_WORKSPACE` 兼容(添加 deprecated 警告)
- ✅ 移除 `WORKSPACE` 兜底

**风险等级:** ⚠️ 中低风险(命名不一致,非安全漏洞)

---

### 3. post-install.sh 和脚本文件

**扫描担忧:**
> post-install.sh and small helper scripts should be inspected

**官方回应:**

**已审查所有脚本:**

| 脚本 | 功能 | 网络 | cron | 系统修改 | 安全性 |
|------|------|------|------|----------|--------|
| `post-install.sh` | 复制 core,pip install watchdog | ❌ | ❌ | ❌ | ✅ 安全 |
| `refresh-quests.sh` | 刷新每日任务 | ❌ | ❌ | ❌ | ✅ 安全 |
| `sync-memory.sh` | 定时同步记忆 | ❌ | ❌ | ❌ | ✅ 安全 |
| `show-progress.sh` | 显示认知进度 | ❌ | ❌ | ❌ | ✅ 安全 |

**所有脚本特点:**
- ✅ 仅本地文件操作
- ✅ 无网络调用
- ✅ 无 cron 注册
- ✅ 无系统修改

**改进承诺:**
- ✅ v6.2.3 在 SECURITY.md 明确说明所有脚本用途

**风险等级:** ✅ 低风险(已审查,安全)

---

### 4. 网络调用(urllib)

**扫描担忧:**
> Search the codebase for network calls (urllib, requests, http.client, etc.)

**官方回应:**

**网络调用用途:**
- ✅ LLM API 调用(智能分类、去重、质量评估)
- ✅ 用户可配置 API(非硬编码)
- ✅ 支持本地模型(无网络)

**代码位置:**
- `core/distill_engine.py` - LLM 驱动提炼
- `core/palace_classifier.py` - 宫殿分类
- `core/quality_assessment.py` - 质量评估

**安全机制:**
- ✅ API Key 用户自行提供
- ✅ 支持本地部署(无网络)
- ✅ 默认降级为规则模式(无 LLM)

**改进承诺:**
- ✅ v6.2.3 在 SKILL.md 添加「网络调用说明」章节
- ✅ v6.2.3 在 SECURITY.md 说明 LLM API 调用机制

**风险等级:** ⚠️ 中风险(需用户知情,但可控)

---

### 5. subprocess 调用

**扫描担忧:**
> unexpected or unsafe subprocess usage

**官方回应:**

**subprocess 用途:**
- ✅ 调用 OpenClaw 原生命令(`openclaw memory_write`)
- ✅ 调用 Git 命令(版本检查)

**代码位置:**
- `core/memory_sync.py` - 同步记忆
- `core/anima_doctor.py` - 自检命令

**当前问题:**
- ⚠️ 无白名单验证
- ⚠️ 硬编码命令路径

**改进承诺:**
- ✅ v6.2.4 添加 subprocess 白名单验证
- ✅ v6.2.4 移除硬编码路径
- ✅ v6.2.4 添加安全测试

**风险等级:** ⚠️ 中风险(需改进,但当前用途合理)

---

## 📋 改进行动计划

### v6.2.3 - 文档透明度提升(本周发布)

**P1 文档改进:**

| 编号 | 任务 | 文件 | 状态 |
|------|------|------|------|
| P1-1 | 多平台路径说明表格 | SKILL.md | ✅ 计划中 |
| P1-2 | 网络调用说明 | SKILL.md + SECURITY.md | ✅ 计划中 |
| P1-3 | 脚本用途说明 | SECURITY.md | ✅ 计划中 |
| P1-4 | 统一环境变量命名 | config_loader.py | ✅ 计划中 |
| P1-5 | 安全回应文档 | SECURITY_RESPONSE.md | ✅ 已完成 |

### v6.2.4 - 代码安全性提升(可选,排期中)

**P2 代码改进:**

| 编号 | 任务 | 文件 | 状态 |
|------|------|------|------|
| P2-1 | subprocess 白名单验证 | core/distill_engine.py | 📋 规划中 |
| P2-2 | 移除硬编码路径 | scripts/sync-memory.sh | 📋 规划中 |
| P2-3 | 安全测试 | tests/test_security.py | 📋 规划中 |
| P2-4 | deprecated 警告 | config_loader.py | 📋 规划中 |

---

## 🎯 总体安全评估

| 维度 | 评级 | 说明 |
|------|------|------|
| **代码安全性** | ✅ 安全 | 无恶意行为,所有操作本地化 |
| **文档透明度** | ⚠️ 不足 | 需明确说明设计意图 |
| **扫描合理性** | ✅ 合理 | ClawHub 扫描负责任 |
| **用户风险** | ✅ 低风险 | 用户可控,无意外行为 |

---

## 📞 联系信息

**作者:** 清禾  
**职位:** Anima AIOS 项目专职负责人  
**Gitee:** https://gitee.com/Ryan_9/qinghe  
**GitHub:** https://github.com/anima-aios/anima  
**反馈渠道:** 
- Vega 消息:清禾
- Gitee Issues: https://gitee.com/Ryan_9/qinghe/issues
- GitHub Issues: https://github.com/anima-aios/anima/issues

---

## 🙏 致谢

感谢 ClawHub 自动安全扫描系统的负责任审查,帮助我们提升文档透明度和代码质量。

**架构只能演进,不能退化。**

---

_最后更新:2026-03-26_  
_作者:清禾_
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall