JOE团队存储规范 v1.1

所有Agent必须遵守的存储与产出规范
制定日期：2026-04-07
适用范围：JOE团队全体Agent

一、架构原则：四域分离

存储体系（四层分离）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

┌──────────────────────────────────────────────────────────────┐
│  域1：WORKSPACE（~/.openclaw/workspace/[Agent名]/）         │
│  ────────────────────────────────────────────────────────   │
│  备份：每日 → /mnt/share/backups/openclaw/                 │
│  定位：Agent身份文件 + 轻量索引 + 当前会话                  │
│  规则：原料文件不内嵌，用软链接引用                         │
└──────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────┐
│  域2：天使们的产出/（~//天使们的产出/）                      │
│  ────────────────────────────────────────────────────────   │
│  备份：每日 → /mnt/share/backups/天使们的产出/             │
│  定位：所有Agent的最终产出汇集                              │
│  规则：每个Agent有专属子目录，结构统一                      │
│  重要性：JOE审核前 → 此目录；JOE审核后 → 域3               │
└──────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────┐
│  域3：浩元渡口/（~/浩元渡口/）                             │
│  ────────────────────────────────────────────────────────   │
│  备份：每日 → /mnt/share/backups/浩元渡口/                 │
│  定位：JOE专属区 + 正式发布的最终成品 + 模版规范            │
│  内容：JOE私人文件、已审核成品、团队规范文档                │
└──────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────┐
│  域4：原材料库（~/.共享原料库/）                             │
│  ────────────────────────────────────────────────────────   │
│  备份：不备份（静态文件，定期归档到NAS/冷存储）              │
│  定位：原始素材、压缩包、大型参考文件                        │
│  规则：各Agent按需引用，workspace只存软链接                 │
└──────────────────────────────────────────────────────────────┘

二、新目录结构

/home/joehuang/
│
├── 天使们的产出/                    ← 【NEW】所有Agent产出汇集
│   ├── 曦和/
│   │   ├── 00-产出索引.md
│   │   ├── 01-文章成品/
│   │   ├── 02-方案策划/
│   │   ├── 03-工具产出/
│   │   └── 04-演示输出/
│   ├── 曼妮/
│   │   ├── 00-产出索引.md
│   │   ├── 01-核心理论层/
│   │   ├── 02-科学研究层/
│   │   ├── 03-创作与故事层/
│   │   ├── 04-大白话说层/
│   │   └── 05-Episyn探索层/
│   ├── holyrange/
│   ├── Elyn/
│   ├── 道引真人/
│   ├── 程工/
│   ├── tech_ops/
│   ├── 文档管家/
│   ├── 质量检查/
│   └── 产品chief/
│
├── 浩元渡口/                      ← JOE专属区
│   ├── 曦和/                       ← 【迁移】曦和历史产出
│   ├── 曼妮/                       ← 【迁移】曼妮历史产出
│   ├── 浩元/                       ← 浩元居产出
│   ├── 模版区/                     ← 团队规范文档
│   │   ├── JOE团队存储规范.md      ← 本规范
│   │   └── ...
│   └── [其他JOE私人文件]
│
└── 原材料库/                        ← 放域4（见第三章）

三、域2详解：天使们的产出

3.1 定位与目的

定位：所有Agent的工作产出汇集地
与浩元渡口的区别：
浩元渡口 = JOE的私人区 + 正式发布的最终成品
天使们的产出 = Agent日常工作产出（待JOE审核）
流向：Agent产出 → 天使们的产出 → JOE审核 → 浩元渡口（正式发布）

3.2 统一目录结构

每个Agent在「天使们的产出/」下必须遵循：

[Agent名]/
├── 00-产出索引.md          ← 【必须】本目录所有产出清单
├── 01-文章成品/            ← 文字类产出
├── 02-方案策划/            ← 方案、规划类产出
├── 03-工具产出/            ← 工具、脚本、系统类产出
├── 04-演示输出/            ← 演示文稿、Demo类产出
├── 05-规范文档/            ← 本Agent制定的规范
└── 99-归档/                ← 旧版本/废弃产出（仍需备份）

3.3 索引文件规范（00-产出索引.md）

# [Agent名] 产出索引

最后更新：2026-04-07

## 目录说明
...

## 产出清单

| 日期 | 文件名 | 类型 | 说明 | 状态 |
|------|--------|------|------|------|
| 2026-04-07 | xxx.md | 文章成品 | xxx | 待审核 |

## 更新记录
- 2026-04-07：xxx

四、域4详解：原材料库

4.1 定位与目的

定位：集中管理原始素材，各Agent按需引用
不备份：静态文件，定期归档到NAS/冷存储
引用方式：workspace内只存软链接，不copy实体

4.2 原材料库结构

~/.共享原料库/
├── 曦和/
│   ├── raw/                      ← 原始压缩包
│   ├── workbench/                ← 清洗后素材
│   └── idx/                      ← 索引文件
├── 曼妮/
│   ├── raw/
│   ├── workbench/
│   └── idx/
├── holyrange/
│   ├── raw/
│   ├── workbench/
│   └── idx/
├── 程工/
│   ├── raw/
│   └── workbench/
├── 道引真人/
│   ├── raw/
│   ├── workbench/
│   └── idx/
└── 公共素材/
    ├── 易学基础/
    └── 通用模板/

五、WORKSPACE 规范

允许放在workspace内的：
| 类型 | 示例 | 大小限制 |
|------|------|---------|
| 身份文件 | SOUL.md, IDENTITY.md, AGENTS.md | < 50KB |
| 索引文件 | docs/索引.md, docs/素材清单.md | < 1MB |
| 轻量文档 | 规范、说明、清单 | < 1MB |
| 记忆日志 | memory/2026-04-07.md | < 100KB |
| 会话缓存 | sessions/ | 系统管理 |

禁止放在workspace内的：
| 类型 | 原因 | 解决方案 |
|------|------|---------|
| 原始素材（zip/txt/html） | 体积大，备份浪费 | 放原材料库，用软链接 |
| 转换后素材（_md/_cleaned） | 静态中间文件 | 放工作台，workspace只放索引 |
| 大型产出文件 | 占用备份空间 | 放天使们的产出/ |
| 日志文件（>1MB） | 膨胀快 | 定期清理或放原材料库 |

软链接规范：

# workspace内只存放软链接，不存放实体文件
docs/writingSkills_index.md → ~/.共享原料库/曦和/idx/writingSkills_index.md

六、备份策略（完整规则）

存储域	路径	备份频率	备份位置	保留周期
WORKSPACE	~/.openclaw/workspace/	每日	/mnt/share/backups/openclaw/	30天
天使们的产出	~/天使们的产出/	每日	/mnt/share/backups/天使们的产出/	30天
浩元渡口	~/浩元渡口/	每日	/mnt/share/backups/浩元渡口/	30天
原材料库	~/.共享原料库/	不备份	—	定期归档

6.1 备份规则补充说明

workspace备份：
仅备份 ~/.openclaw/workspace/ 目录
排除 sessions/（会话记录）、lcm-files/（向量缓存）
每个Agent workspace应 < 10MB
天使们的产出/ 备份：
每日增量备份到 /mnt/share/backups/天使们的产出/
30天滚动保留
索引文件（00-产出索引.md）必须包含在备份内
浩元渡口/ 备份：
仅备份 JOE私人文件 + 模版区规范
大量静态文件（zip/extracted）应移至原材料库
原材料库不备份：
每季度手动归档到NAS/冷存储
或年度同步到外部硬盘

6.2 各Agent原料归属

Agent	原材料内容	存放位置
曦和	writingSkills, TAOHUA, OB_clean	~/.共享原料库/曦和/
曼妮	Obsidian内容	~/.共享原料库/曼妮/
holyrange	易学基础、风水素材	~/.共享原料库/holyrange/
程工	好日子工具素材	~/.共享原料库/程工/
道引真人	道家/玄学素材	~/.共享原料库/道引真人/
Elyn	Elyn内部素材	~/.共享原料库/Elyn/

七、Agent专属规范

7.1 曦和（living_assistant）

workspace结构：

living_assistant/
├── SOUL.md / IDENTITY.md / AGENTS.md
├── USER.md / HEARTBEAT.md
├── memory/
├── docs/
│   ├── writingSkills_index.md    → ~/.共享原料库/曦和/idx/
│   └── TAOHUA_index.md           → ~/.共享原料库/曦和/idx/
└── sessions/

天使们的产出/结构：

天使们的产出/曦和/
├── 00-产出索引.md
├── 01-文章成品/
│   └── 合并出奇迹/               ← 8大痛点文章系列
├── 02-方案策划/
│   ├── 丙午年施家公子取名建议书/
│   └── 好日子/                   ← 策划方案
├── 03-工具产出/
└── 04-演示输出/

7.2 曼妮（manī）

天使们的产出/结构：

天使们的产出/曼妮/
├── 00-产出索引.md
├── 01-核心理论层/
├── 02-科学研究层/
├── 03-创作与故事层/
├── 04-大白话说层/
└── 05-Episyn探索层/

7.3 holyrange

天使们的产出/结构：

天使们的产出/holyrange/
├── 00-产出索引.md
├── 01-易学文章/
├── 02-策划方案/
└── 03-研究报告/

7.4 其他Agent

天使们的产出/[Agent名]/
├── 00-产出索引.md
├── 01-主产出/
├── 02-协作产出/
└── 03-规范文档/

八、命名规范

8.1 成品文件命名

格式：YYYY-MM-DD_[项目名]_[成品类型]_[版本].md

示例：
2026-04-07_丙午年施家公子_取名建议书_v1.0.docx
2026-04-07_108条东方生活哲学_文章_v1.0.md
2026-04-07_合并出奇迹_社媒内容_完整版.md
2026-04-07_好日子工具_使用说明_v1.0.md

8.2 目录命名

所有目录使用中文
子目录编号用 01-、02- 前缀表示顺序
索引文件固定为 00-产出索引.md

九、执行检查清单

每次启动检查：
- [ ] workspace是否超重（> 10MB需审查）
- [ ] 产出是否及时同步到「天使们的产出/」
- [ ] 大文件是否误放到workspace

定期检查（每月）：
- [ ] 原材料库是否需要更新
- [ ] 天使们的产出/索引是否更新
- [ ] 99-归档/ 是否需要清理

十、规范解释权

本规范由曦和起草，JOE审批
所有Agent必须遵守
如有调整，需JOE批准后更新本规范

最后更新：2026-04-07
版本：v1.1

📚 渡口文档库

JOE团队存储规范 v1.1

一、架构原则：四域分离

二、新目录结构

三、域2详解：天使们的产出

3.1 定位与目的

3.2 统一目录结构

3.3 索引文件规范（00-产出索引.md）

四、域4详解：原材料库

4.1 定位与目的

4.2 原材料库结构

五、WORKSPACE 规范

六、备份策略（完整规则）

6.1 备份规则补充说明

6.2 各Agent原料归属

七、Agent专属规范

7.1 曦和（living_assistant）

7.2 曼妮（manī）

7.3 holyrange

7.4 其他Agent

八、命名规范

8.1 成品文件命名

8.2 目录命名

九、执行检查清单

十、规范解释权