核心用途
canonical-data-map 是 OpenClaw 希腊会计系统的单一数据源(Single Source of Truth),定义了完整的文件系统架构、目录结构、命名约定和数据格式标准。所有其他技能必须严格遵循此文档规定的路径和规范,禁止擅自引入新的顶级目录或偏离既定命名规则。
显著优点
1. 高度规范化:涵盖 16 个顶级目录(incoming, processing, clients, compliance, banking, ocr, efka, reports, exports, imports, dashboard, auth, backups, gdpr-exports, memory, system),每个目录都有明确的用途和子结构定义
2. 严格的命名标准:
- AFM 格式强制为
EL+ 9 位数字(如 EL123456789) - 文件名采用
{AFM}_{YYYY-MM}_{type}_{detail}.{ext}模式 - 禁用希腊字符和空格,强制 ASCII 安全
- 日期格式统一为 ISO 8601(存储)或 DD/MM/YYYY(显示)
3. 完善的版本管理:v1.1 新增 /data/memory/ 目录用于代理 episodic memory 和反馈循环
4. 明确的技能责任矩阵:清晰界定每个目录的写入所有者(Owner Skill)和读取权限
5. 强制性安全规范:
- 加密静态数据要求(AES-256-GCM)
- GDPR 合规的数据分类标签
- 10 年审计日志保留期
- 统一的审计事件 Schema
潜在局限
- 刚性约束:过于严格的规范可能限制边缘场景的灵活性
- 版本同步成本:任何目录结构调整都需要更新此文档版本
- 遗留路径兼容:存在大量 deprecated 路径需要维护别名映射
- 本地化限制:专为希腊会计系统设计,不适用于其他司法管辖区
适合人群
- 开发 OpenClaw 希腊会计系统的技能开发者
- 需要理解数据流向的系统架构师
- 审计合规团队进行技术审查
- 实施 Greek Accounting 工作流的 DevOps 工程师
常规风险
1. 数据泄漏风险:compliance/、clients/、efka/ 包含敏感 PII 和财务数据,必须加密
2. 处理数据污染:/data/processing/ 为临时空间,禁止作为最终数据源引用
3. 命名违规导致故障:AFM 格式错误或希腊字符入文件名可能引发下游技能错误
4. 权限越界:非 Owner Skill 写入受保护目录(如 client-data-management 独占的 clients/)
5. 审计缺失:未按统一 Schema 记录审计事件可能导致合规缺口