Compare commits

...

2 Commits

Author SHA1 Message Date
皮皮虾(OpenClaw) 959bf3dc15 Merge branch 'main' of https://gitea.94kan.cn/houhuan/openclaw-md-store 2026-07-02 08:52:31 +00:00
皮皮虾(OpenClaw) ce2de268f4 重构:按平台分类(老大指示)
- 建分类目录:三平台素材/公众号/视频号/抖音
- 移动三平台素材 md 到正确分类
- 删除中间产物(已迁移到 master-doc-internal/)
- 重写 README:分类说明 + 命名规范
2026-07-02 08:52:04 +00:00
2 changed files with 51 additions and 65 deletions
+51 -65
View File
@@ -1,92 +1,78 @@
# OpenClaw Master-Doc 主存储 # OpenClaw Master-Doc · 产品文档主存储
> **创建时间**:2026-07-02 > **最后更新**:2026-07-02
> **创建人**:皮皮虾(OpenClaw 助手) > **创建人**:皮皮虾(OpenClaw 助手)
> **老大指示**:未来新增的所有 md 都放这里 + 同步到 Gitea > **规则**:老大 2026-07-02 制定——**按平台分,只传对外产品,本地沉淀不进 Gitea**
---
## 这是什么 ## 这是什么
所有由 OpenClaw(皮皮虾)生成/编辑的 **md 文档** 的统一存储位置。 所有由 OpenClaw(皮皮虾)生成的、**对外可交付的产品类 md 文档**的统一存储位置。
**核心**: **核心**(老大定):
-**所有** 新生成的 md 必须写到本目录 -对外产品(三平台素材、单独平台成稿)→ 进 master-doc/,同步到 Gitea
- ✅ 写完后必须推送到 Gitea:`https://gitea.94kan.cn/houhuan/openclaw-md-store` - ❌ 中间产物(抽取原文、改写归档、调研报告、脚本草稿)→ 进 `master-doc-internal/`,**不传**
- ❌ 不要把 md 散落在 `scripts/` `memory/` `drafts/` 等其它目录
## 命名规范 ## 📂 分类目录
| 类型 | 名格式 | 示例 | | 目录 | 说明 | 文件名格式 |
|---|---|---| |---|---|---|
| Gitea 抽取原文 | `YYYY-MM-DD-gitea-抽取.md` | `2026-07-02-gitea-抽取.md` | | `三平台素材/` | 一个主题的公众号+视频号+抖音完整包(主交付) | `ID{N}-{主题}-{日期}.md` |
| 改写归档 | `YYYY-MM-DD-改写归档.md` | `2026-07-01-改写归档.md` | | `公众号/` | 单平台,纯公众号成稿 | `公众号-{ID}-{主题}-{日期}.md` |
| 三平台素材 | `三平台素材-{ID}-{主题}-{日期}.md` | `三平台素材-ID749-希腊身份-2026-07-02.md` | | `视频号/` | 单平台,纯视频号成稿 | `视频号-{ID}-{主题}-{日期}.md` |
| 调研报告 | `{类型}-{关键词}-{日期}.md` | `抖音爆款调研-香港身份-2026-06-08.md` | | `抖音/` | 单平台,纯抖音成稿 | `抖音-{ID}-{主题}-{日期}.md` |
| 原创脚本 | `原创口播脚本-{关键词}-{日期}.md` | `原创口播脚本-香港身份-2026-07-02.md` |
## 当前内容(2026-07-02 创建时) **注意**:对绝大多数主题,优先产出**三平台素材**(一个 md 同时含 3 个平台)+ 单独把每个平台内容也单独存一份。这样:
- 客户/同事一眼看到完整三平台包
- 想单平台投放时,直接拿对应那个平台的文件
| 文件 | 说明 | ## 📐 命名规范(全 master-doc/)
|---|---|
| `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` | 抖音爆款调研报告 |
## 同步到 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 ```bash
cd ~/.openclaw/workspace/master-doc cd ~/.openclaw/workspace/master-doc
git add -A git add -A
git commit -m "新增:文件名" git commit -m "{新增|更新}:{文件路径} - {一句话说明}"
git push origin main 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(执行规则) - 不会 → 放 master-doc/,同步 Gitea
- 会 → 放 master-doc-internal/
每次我(皮皮虾)生成新的 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/`
--- ---
*本规则由皮皮虾 2026-07-02 创建,持续生效* *皮皮虾 2026-07-02*