docs: sync reader-digest-flow skill with Hermes version (absolute path, extract_failed handling, rerun include_read)

skills/reader-digest-flow/SKILL.md

@@ -123,6 +123,7 @@ Hugo 发布选择与知识沉淀选择相互独立。询问用户哪些文章值
 3. 轮询 `get_article_summary_job_status`，成功后读取 `get_article_summary_job_result`；
 4. 只使用现有 `article.plain_text`，不重新抓取原 URL；
 5. 使用返回的 `written_paths` 定位结果并检查 Markdown 内容。
+6. **`extracted_path` 必须传绝对路径**（前缀 `/home/ubuntu/zhu/github/reader/`）：summary-mcp 工作目录是 `/root/.hermes`，相对路径会报 `extracted_path does not exist`。同一工具连续 3 次失败会触发 MCP 冷却（约 45-60s，报 `MCP server 'reader' is unreachable`），等待冷却后再重试，不要循环重试同一调用。
 
 异步 MCP 不可用时才使用项目 CLI fallback。不要因为内容较短而引入原文之外的知识。
 
@@ -131,8 +132,9 @@ Hugo 发布选择与知识沉淀选择相互独立。询问用户哪些文章值
 上传前按需读取：
 
 - 格式规则：`references/ima-format-quickref.md`
-- API 和上传步骤：`references/ima-upload-api.md`
+- API 和上传步骤：`references/ima-upload-api.md`（含 `-200` 版本拦截修复）
 - 凭证定位：`references/ima-credential-chain.md`
+- 批量上传脚本：`scripts/ima_upload_one.py`（Python 编排，规避中文文件名 bash 引号问题）
 
 硬规则：
 
@@ -154,6 +156,12 @@ Hugo 发布选择与知识沉淀选择相互独立。询问用户哪些文章值
 
 `reader-digest-flow` 不直接编辑 `term_aliases.json`、`term_stopwords.json` 或兴趣配置。简要路由见 `references/keyword-engine-maintenance.md`。
 
+## 环境坑位（本机部署）
+
+- **MCP 相对路径陷阱**：`summary-mcp` 服务工作目录是 `/root/.hermes`，不是 reader 项目根。MCP 返回的 `output_dir`/`artifact.path` 是相对路径，直接传给 `start_article_summary_job(extracted_path=...)` 会报 `extracted_path does not exist`。传入前必须拼绝对路径前缀 `/home/ubuntu/zhu/github/reader/`。
+- **提取失败不等于运行失败**：`status_counts.extract_failed` 的条目（`CONTENT_EXTRACTION_FAILED`，`retryable=false`）跳过即可并如实汇报；失败文章常是推广/活动等低价值内容，不因此自行重跑。`linked_run_status=partial` 时先读 run-report 的 item 级 `error` 确认原因。
+- **用户要求"重新跑一批"**：候选质量低（用户主动提出）时重跑，应 `include_read=true` 并调高 `limit`（如 10），否则默认 `include_read=false` 会拉回同一批未读文章。重跑是新 Run，候选编号体系重新建立，汇报时提醒用户按新列表选择。
+
 ## 停止与人工介入
 
 出现以下任一情况时停止自动流程并报告：
@@ -167,11 +175,12 @@ Hugo 发布选择与知识沉淀选择相互独立。询问用户哪些文章值
 
 ## Reference 路由
 
-- `references/flow.md`：具体 MCP 调用序列、候选映射、Hugo 发布和 IMA 主步骤。
+- `references/flow.md`：具体 MCP 调用序列、候选映射（含 extracted_path 绝对路径、候选≠文件名顺序）、Hugo 发布和 IMA 主步骤。
 - `references/content-extraction.md`：FreshRSS 内容来源与 `plain_text` 质量判断。
 - `references/public-digest-example.md`：可直接参考的 Hugo 最终页面结构。
 - `references/feishu-format-notes.md`：Feishu 输出格式限制。
 - `references/ima-format-quickref.md`：IMA Markdown 格式规则。
-- `references/ima-upload-api.md`：IMA Markdown 文件上传 API。
+- `references/ima-upload-api.md`：IMA Markdown 文件上传 API（含 `-200` 版本拦截修复）。
 - `references/ima-credential-chain.md`：IMA 凭证与知识库配置定位。
 - `references/keyword-engine-maintenance.md`：关键词治理 Skill 路由。
+- `scripts/ima_upload_one.py`：单篇 Markdown 上传 daily 知识库的完整 Python 脚本（preflight→重名→create_media→COS→add_knowledge）。