更新:README 完整版(master-doc SOP + 命名规范)

2026-07-02 08:43:35 +00:00
parent 4febf401f6
commit c9ebbd8440
1 changed files with 91 additions and 2 deletions
@@ -1,3 +1,92 @@
-# openclaw-md-store
+# OpenClaw Master-Doc 主存储

-OpenClaw 助手生成的所有 md 文档主存储(master-doc 同步源)。规则:未来所有新增的 md 都先写到 master-doc/ 再推到这里。
+> **创建时间**:2026-07-02
+> **创建人**:皮皮虾(OpenClaw 助手)
+> **老大指示**:未来新增的所有 md 都放这里 + 同步到 Gitea
+
+## 这是什么
+
+所有由 OpenClaw(皮皮虾)生成/编辑的 **md 文档** 的统一存储位置。
+
+**核心规则**:
+- ✅ **所有** 新生成的 md 必须写到本目录
+- ✅ 写完后必须推送到 Gitea:`https://gitea.94kan.cn/houhuan/openclaw-md-store`
+- ❌ 不要把 md 散落在 `scripts/` `memory/` `drafts/` 等其它目录
+
+## 命名规范
+
+| 类型 | 命名格式 | 示例 |
+|---|---|---|
+| 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` |
+
+## 当前内容(2026-07-02 创建时)
+
+| 文件 | 说明 |
+|---|---|
+| `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 的方法
+
+### 方法 1:git push(推荐)
+
+```bash
+cd ~/.openclaw/workspace/master-doc
+git add -A
+git commit -m "新增:文件名"
+git push origin main
+```
+
+### 方法 2:Gitea API 单文件上传
+
+```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 仓库信息
+
+- **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/`
+
+---
+
+*本规则由皮皮虾于 2026-07-02 创建,持续生效*