# OpenClaw Master-Doc · 产品文档主存储

> **最后更新**:2026-07-02
> **创建人**:皮皮虾(OpenClaw 助手)
> **规则**:老大 2026-07-02 制定——**按平台分,只传对外产品,本地沉淀不进 Gitea**

---

## 这是什么

所有由 OpenClaw(皮皮虾)生成的、**对外可交付的产品类 md 文档**的统一存储位置。

**核心原则**(老大定):
- ✅ 对外产品(三平台素材、单独平台成稿)→ 进 master-doc/,同步到 Gitea
- ❌ 中间产物(抽取原文、改写归档、调研报告、脚本草稿)→ 进 `master-doc-internal/`,**不传**

## 📂 分类目录

| 目录 | 说明 | 文件名格式 |
|---|---|---|
| `三平台素材/` | 一个主题的公众号+视频号+抖音完整包(主交付) | `ID{N}-{主题}-{日期}.md` |
| `公众号/` | 单平台,纯公众号成稿 | `公众号-{ID}-{主题}-{日期}.md` |
| `视频号/` | 单平台,纯视频号成稿 | `视频号-{ID}-{主题}-{日期}.md` |
| `抖音/` | 单平台,纯抖音成稿 | `抖音-{ID}-{主题}-{日期}.md` |

**注意**:对绝大多数主题,优先产出**三平台素材**(一个 md 同时含 3 个平台)+ 单独把每个平台内容也单独存一份。这样:
- 客户/同事一眼看到完整三平台包
- 想单平台投放时,直接拿对应那个平台的文件

## 📐 命名规范(全 master-doc/)

```
{平台或类型}-{ID}-{主题关键词}-{YYYY-MM-DD}.md

示例:
  三平台素材/ID749-希腊身份-2026-07-02.md        (主交付·三合一)
  公众号/公众号-ID749-希腊身份-2026-07-02.md       (单平台·公众号)
  视频号/视频号-ID749-希腊身份-2026-07-02.md       (单平台·视频号)
  抖音/抖音-ID749-希腊身份-2026-07-02.md           (单平台·抖音)
```

## 📥 当前内容(2026-07-02)

| 文件 | 主题 | 状态 |
|---|---|---|
| `三平台素材/ID749-希腊身份-2026-07-02.md` | 希腊身份(希腊黄金签证 25 万欧) | ✅ 已生成 |

## 🔗 Gitea 仓库

🌐 **[houhuan/openclaw-md-store](https://gitea.94kan.cn/houhuan/openclaw-md-store)**

## 🚫 不传 Gitea 的沉淀区

`~/.openclaw/workspace/master-doc-internal/`(内含抽取原文/调研/草稿,本地留存)

## 🛠 推送命令

```bash
cd ~/.openclaw/workspace/master-doc
git add -A
git commit -m "{新增|更新}:{文件路径} - {一句话说明}"
git push origin main
```

推送完成后,**告诉老大 Gitea 直链**(格式 `https://gitea.94kan.cn/houhuan/openclaw-md-store/src/branch/main/{path}.md`)。

## 📋 写文件前的判断标准

老大说"未来所有新增 md",但生成文件前问一句:

> **"这份文档,客户/同事看到会尴尬吗?"**

- 不会 → 放 master-doc/,同步 Gitea
- 会 → 放 master-doc-internal/

---

*皮皮虾 2026-07-02*