Imported from liudaac/hermes-agent-java (AGENTS.md). Install upstream with npx skills add liudaac/hermes-agent-java. Copyright stays with the author.

AGENTS.md - Your Workspace

多租户隔离实施进度

Phase 1: 租户基础设施 ✅ 已完成

时间: 2025-04-25
状态: 编译通过 ✅

已创建组件：

支撑子系统（基础实现）：

租户目录结构：

~/.hermes/tenants/
├── {tenantId}/
│   ├── config/           # 配置
│   ├── workspace/        # 文件沙箱
│   │   ├── sessions/     # 会话工作区
│   │   ├── uploads/      # 上传文件
│   │   ├── generated/    # 生成文件
│   │   ├── cache/        # 缓存
│   │   └── temp/         # 临时文件
│   ├── memories/         # 记忆
│   ├── sessions/         # 会话持久化
│   ├── skills/           # Skills
│   │   ├── private/      # 私有
│   │   └── installed/    # 安装
│   ├── logs/             # 日志
│   └── state/            # 运行时状态
├── _shared/skills/       # 共享 Skills
└── _system/
    └── tenants.json      # 租户注册表

Phase 2: 文件沙箱隔离 ✅ 已完成

时间: 2025-04-26
状态: 编译通过 ✅ | 测试通过 ✅ (10/10)

实现内容：

安全特性：

路径验证流程 (11 层检查):
1. 空路径检查
2. 规范化路径
3. 路径遍历检测 (.., ~)
4. 符号链接检查
5. 硬链接检查
6. 目录深度检查
7. 沙箱边界检查
8. 白名单检查
9. 黑名单检查
10. 文件存在性和权限检查
11. 文件类型和大小检查

测试覆盖：

• 沙箱内路径允许
• 路径遍历拒绝
• 符号链接控制
• 会话工作区创建/清理
• 存储使用统计
• 禁止文件类型
• 空/Null 路径处理
• 存储配额检查

Phase 3: 配置与记忆隔离 ✅ 已完成

时间: 2025-04-26
状态: 编译通过 ✅

TenantConfig 实现：

TenantMemoryManager 实现：

配置继承链：

系统默认值
    ↓ (深度合并)
租户配置文件 (config.yaml)
    ↓ (覆盖)
运行时修改
    ↓ (环境变量展开)
最终配置值

记忆存储格式：

# MEMORY.md
条目内容 1
§
条目内容 2 (带标签)
§
条目内容 3
§

Phase 4: Skill 隔离管理 ✅ 已完成

时间: 2025-04-26
状态: 编译通过 ✅

实现内容：

存储结构：

skills/
├── private/        # 租户私有创建
├── installed/      # 从 Registry 安装
└── index.json      # 本地索引

完整实施路线图

AI 组织原生化 (org module) 🆕

时间: 2026-06-07 状态: 编译通过 ✅ | 测试通过 ✅ (29/29)

已交付模块

预定义 Agent 模板

架构概览

┌─────────────────────────────────────────────────────────────┐
│                    Multi-Tenant Gateway                      │
├─────────────────────────────────────────────────────────────┤
│  TenantManager                                                │
│  ├── TenantContext (tenant-1)                                │
│  │   ├── TenantConfig                                        │
│  │   ├── TenantFileSandbox                                   │
│  │   ├── TenantMemoryManager                                 │
│  │   ├── TenantSkillManager                                  │
│  │   ├── TenantSessionManager                                │
│  │   ├── TenantToolRegistry                                  │
│  │   ├── TenantQuotaManager                                  │
│  │   └── TenantAIAgent(s)                                    │
│  ├── TenantContext (tenant-2)                                │
│  └── ...                                                      │
└─────────────────────────────────────────────────────────────┘

This is your workspace. Make it yours.