Compare commits
2 Commits
c004e178e5
...
959bf3dc15
| Author | SHA1 | Date | |
|---|---|---|---|
| 959bf3dc15 | |||
| ce2de268f4 |
@@ -1,92 +1,78 @@
|
||||
# OpenClaw Master-Doc 主存储
|
||||
# OpenClaw Master-Doc · 产品文档主存储
|
||||
|
||||
> **创建时间**:2026-07-02
|
||||
> **最后更新**:2026-07-02
|
||||
> **创建人**:皮皮虾(OpenClaw 助手)
|
||||
> **老大指示**:未来新增的所有 md 都放这里 + 同步到 Gitea
|
||||
> **规则**:老大 2026-07-02 制定——**按平台分,只传对外产品,本地沉淀不进 Gitea**
|
||||
|
||||
---
|
||||
|
||||
## 这是什么
|
||||
|
||||
所有由 OpenClaw(皮皮虾)生成/编辑的 **md 文档** 的统一存储位置。
|
||||
所有由 OpenClaw(皮皮虾)生成的、**对外可交付的产品类 md 文档**的统一存储位置。
|
||||
|
||||
**核心规则**:
|
||||
- ✅ **所有** 新生成的 md 必须写到本目录
|
||||
- ✅ 写完后必须推送到 Gitea:`https://gitea.94kan.cn/houhuan/openclaw-md-store`
|
||||
- ❌ 不要把 md 散落在 `scripts/` `memory/` `drafts/` 等其它目录
|
||||
**核心原则**(老大定):
|
||||
- ✅ 对外产品(三平台素材、单独平台成稿)→ 进 master-doc/,同步到 Gitea
|
||||
- ❌ 中间产物(抽取原文、改写归档、调研报告、脚本草稿)→ 进 `master-doc-internal/`,**不传**
|
||||
|
||||
## 命名规范
|
||||
## 📂 分类目录
|
||||
|
||||
| 类型 | 命名格式 | 示例 |
|
||||
| 目录 | 说明 | 文件名格式 |
|
||||
|---|---|---|
|
||||
| Gitea 抽取原文 | `YYYY-MM-DD-gitea-抽取.md` | `2026-07-02-gitea-抽取.md` |
|
||||
| 改写归档 | `YYYY-MM-DD-改写归档.md` | `2026-07-01-改写归档.md` |
|
||||
| 三平台素材 | `三平台素材-{ID}-{主题}-{日期}.md` | `三平台素材-ID749-希腊身份-2026-07-02.md` |
|
||||
| 调研报告 | `{类型}-{关键词}-{日期}.md` | `抖音爆款调研-香港身份-2026-06-08.md` |
|
||||
| 原创脚本 | `原创口播脚本-{关键词}-{日期}.md` | `原创口播脚本-香港身份-2026-07-02.md` |
|
||||
| `三平台素材/` | 一个主题的公众号+视频号+抖音完整包(主交付) | `ID{N}-{主题}-{日期}.md` |
|
||||
| `公众号/` | 单平台,纯公众号成稿 | `公众号-{ID}-{主题}-{日期}.md` |
|
||||
| `视频号/` | 单平台,纯视频号成稿 | `视频号-{ID}-{主题}-{日期}.md` |
|
||||
| `抖音/` | 单平台,纯抖音成稿 | `抖音-{ID}-{主题}-{日期}.md` |
|
||||
|
||||
## 当前内容(2026-07-02 创建时)
|
||||
**注意**:对绝大多数主题,优先产出**三平台素材**(一个 md 同时含 3 个平台)+ 单独把每个平台内容也单独存一份。这样:
|
||||
- 客户/同事一眼看到完整三平台包
|
||||
- 想单平台投放时,直接拿对应那个平台的文件
|
||||
|
||||
| 文件 | 说明 |
|
||||
|---|---|
|
||||
| `README.md` | 本文件 |
|
||||
| `2026-07-01-gitea-抽取.md` | 7-01 抽取原文(3 条 S+A 精品) |
|
||||
| `2026-07-01-改写归档.md` | 7-01 改写后的归档 |
|
||||
| `2026-07-02-gitea-抽取.md` | 7-02 抽取原文 |
|
||||
| `三平台素材-ID749-希腊身份-2026-07-02.md` | 今日新生成:基于 ID=749 的公众号+视频号+抖音三平台素材 |
|
||||
| `原创口播脚本-香港身份-2026-07-02.md` | 6-08 调研配套的原创脚本 |
|
||||
| `抖音爆款调研-香港身份-2026-06-08.md` | 抖音爆款调研报告 |
|
||||
## 📐 命名规范(全 master-doc/)
|
||||
|
||||
## 同步到 Gitea 的方法
|
||||
```
|
||||
{平台或类型}-{ID}-{主题关键词}-{YYYY-MM-DD}.md
|
||||
|
||||
### 方法 1:git push(推荐)
|
||||
示例:
|
||||
三平台素材/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 commit -m "{新增|更新}:{文件路径} - {一句话说明}"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### 方法 2:Gitea API 单文件上传
|
||||
推送完成后,**告诉老大 Gitea 直链**(格式 `https://gitea.94kan.cn/houhuan/openclaw-md-store/src/branch/main/{path}.md`)。
|
||||
|
||||
```python
|
||||
import requests, base64
|
||||
content = base64.b64encode(open('file.md','rb').read()).decode()
|
||||
requests.put(
|
||||
'https://gitea.94kan.cn/api/v1/repos/houhuan/openclaw-md-store/contents/file.md',
|
||||
headers={'Authorization': 'token <TOKEN>'},
|
||||
json={'content': content, 'message': '新增', 'branch': 'main'}
|
||||
)
|
||||
```
|
||||
## 📋 写文件前的判断标准
|
||||
|
||||
## Gitea 仓库信息
|
||||
老大说"未来所有新增 md",但生成文件前问一句:
|
||||
|
||||
- **URL**: https://gitea.94kan.cn/houhuan/openclaw-md-store
|
||||
- **Owner**: houhuan
|
||||
- **凭据**: `/home/huan/.openclaw/secrets/gitea.env`
|
||||
> **"这份文档,客户/同事看到会尴尬吗?"**
|
||||
|
||||
## 后续 SOP(执行规则)
|
||||
|
||||
每次我(皮皮虾)生成新的 md 文件,必须:
|
||||
|
||||
1. ✅ 直接写到 `~/.openclaw/workspace/master-doc/` 下(不要写到 `memory/` `scripts/` 等其它位置)
|
||||
2. ✅ 文件名按上面的"命名规范"
|
||||
3. ✅ 写完后用 `git push` 同步到 Gitea
|
||||
4. ✅ 给老大 Gitea URL
|
||||
|
||||
**例外**(可以保留在原位置):
|
||||
- `MEMORY.md` / `SOUL.md` / `TOOLS.md` / `IDENTITY.md` / `USER.md` — 系统核心规则
|
||||
- `memory/YYYY-MM-DD.md` — 工作日志
|
||||
- `memory/lessons.md` / `memory/decisions.md` — 长期记忆
|
||||
- `knowledge/` — 知识库
|
||||
|
||||
## 历史归档
|
||||
|
||||
逐步迁移老文件:
|
||||
- 老的 `scripts/gitea-pickup/output/*.md` → `master-doc/`
|
||||
- 老的 `scripts/gitea-pickup/rewrites_*.md` → `master-doc/`
|
||||
- 老的 `drafts/*.md` → `master-doc/`
|
||||
- 老的 `memory/douyin-*.md` → `master-doc/`
|
||||
- 不会 → 放 master-doc/,同步 Gitea
|
||||
- 会 → 放 master-doc-internal/
|
||||
|
||||
---
|
||||
|
||||
*本规则由皮皮虾于 2026-07-02 创建,持续生效*
|
||||
*皮皮虾 2026-07-02*
|
||||
Reference in New Issue
Block a user