chore: update term configs, skill docs and Python 3.10 compat

- term_change_log: record watch term add history
- term_watchlist: add initial watch terms from cleanup review
- term_aliases: minor update
- filter_context.personal: reorganize interest keywords
- keyword-cleanup-review skill: clarify JSON as formal artifact, markdown as temp review copy
- openclaw_delivery: add Python <3.11 UTC import compat
- daily-keyword-index-design: update suggestion artifact semantics
This commit is contained in:
root
2026-04-14 09:51:57 +08:00
parent c0194647d8
commit a06f2a1d08
7 changed files with 253 additions and 38 deletions
+55 -6
View File
@@ -9,7 +9,7 @@ description: 审查和整理本仓库的每日关键词索引和频率统计。
## 工作流程
1. 构建精简的审查数据包:
1. 构建精简的审查数据包(临时工作文件):
```bash
python skills/keyword-cleanup-review/scripts/build_review_bundle.py
@@ -21,15 +21,32 @@ python skills/keyword-cleanup-review/scripts/build_review_bundle.py
- `--top 50`
- `--output outputs/term_index/review/keyword-cleanup-bundle.json`
2. 阅读生成的数据包和建议模式:
2. 阅读建议模式:
- `outputs/term_index/review/keyword-cleanup-bundle.json`
- `skills/keyword-cleanup-review/references/suggestion-schema.md`
3. 生成两份输出:
3. 运行 suggestions 生成脚本:
- 一份简短的供人工审阅的 Markdown 报告
- 一份符合模式的 JSON 建议文件
```bash
python scripts/generate_term_cleanup_suggestions.py ^
--bundle outputs/term_index/review/keyword-cleanup-bundle.json
```
默认生成:
- 一份符合模式的 JSON 建议文件(正式建议产物)
如需人工审阅展示稿,再显式加:
```bash
python scripts/generate_term_cleanup_suggestions.py ^
--bundle outputs/term_index/review/keyword-cleanup-bundle.json ^
--emit-markdown
```
这时才会额外生成:
- 一份简短的供人工审阅的 Markdown 报告(临时展示稿)
4. 严格保持边界:
@@ -78,10 +95,41 @@ Markdown 输出应:
- 分类别名、停用词、兴趣关键词和关注词建议
- 用简短、具体的句子解释理由
说明:Markdown 主要用于人工临时审阅,不必默认当作长期资产保留。
JSON 输出应遵循:
- `references/suggestion-schema.md`
说明:JSON 是 review / apply 之间的唯一正式建议产物,应优先保留。
## 产物保留策略
长期保留:
- `data/term_index/daily/*.json`
- `data/term_index/term_stats.json`
- `configs/filter_context.personal.json`
- `configs/term_watchlist.json`
- `configs/term_aliases.json`
- `configs/term_stopwords.json`
- `configs/term_change_log.json`
短期保留:
- `outputs/term_index/review/term-cleanup-suggestions-YYYY-MM-DD.json`
临时产物:
- `outputs/term_index/review/keyword-cleanup-bundle.json`
- `outputs/term_index/review/term-cleanup-suggestions-YYYY-MM-DD.md`
默认执行口径:
- bundle 只作为运行时工作文件,默认只保留当前最新一份
- Markdown 只作为人工展示层,优先按需生成,不默认长期归档
- JSON suggestions 是 review / apply 之间唯一正式建议输入
## 仓库说明
当前仓库行为:
@@ -98,5 +146,6 @@ JSON 输出应遵循:
- 脚本:
- `scripts/build_review_bundle.py`
- `scripts/generate_term_cleanup_suggestions.py`
- 参考文档:
- `references/suggestion-schema.md`