Refine OpenClaw payloads and reorganize docs

2026-03-26 10:20:07 +08:00
parent cecf4d3ae7
commit 27fe1e8882
155 changed files with 8999 additions and 87 deletions
@@ -0,0 +1,38 @@
+# Outputs Layout
+
+`outputs/` 按“来源 + 阶段”分层，避免所有中间产物堆在根目录。
+
+## 目录约定
+
+- `outputs/prompts/`
+  - prompt 模板与调试输入
+- `outputs/reference/`
+  - 手工样例、固定参考输入、通用演示产物
+- `outputs/reference/extracted/`
+  - 参考提取结果
+- `outputs/reference/summary/`
+  - 通用摘要结果与 loop 调试产物
+- `outputs/reference/filter/`
+  - 通用过滤结果与上下文样例
+- `outputs/reference/candidates/`
+  - 通用 `article_candidate` 样例
+- `outputs/freshrss/`
+  - FreshRSS 实跑产物
+- `outputs/freshrss/raw/`
+  - greader 原始响应
+- `outputs/freshrss/items/`
+  - entry -> `item` 映射结果
+- `outputs/freshrss/extracted/`
+  - FreshRSS 文章提取结果
+- `outputs/freshrss/summary/`
+  - FreshRSS 摘要 loop 结果与调试文件
+- `outputs/freshrss/filter/`
+  - FreshRSS 过滤结果
+- `outputs/freshrss/candidates/`
+  - FreshRSS `article_candidate` 结果
+
+## 命名原则
+
+- 默认脚本输出应优先写入对应子目录，不再直接写 `outputs/` 根目录。
+- 同一条链路的调试文件放在同一阶段目录里，例如 `result.loop.json` 与 `result.loop.attempt-*.json`。
+- `reference/` 只放可复用的稳定样例，真实运行数据优先放 `freshrss/`。