docs: 添加 Agent Skill 到项目仓库

- 复制 reader-digest-flow skill 到 skills/ 目录（含 SKILL.md + references/） - README 新增 Agent Skill 章节说明供 Agent 使用的工作流
2026-07-28 18:38:54 +08:00
parent 7b791ac947
commit 5eb390e3ed
16 changed files with 2112 additions and 0 deletions
@@ -0,0 +1,55 @@
+# IMA COS 上传凭证处理（Hermes redact_secrets 兼容模式）
+
+## 问题
+
+Hermes 配置 `security.redact_secrets: true` 时，`create_media` API 返回的 `cos_credential.token` 字段在 `terminal()` 输出中被替换为 `***`。
+
+直接通过 `terminal()` 调用 `cos-upload.cjs` 会因 token 截断而失败（HTTP 403 InvalidAccessKeyId）。
+
+## 安全的工作流（execute_code + subprocess.run）
+
+不要用 `terminal()` 传递 COS 凭证。改用 `execute_code()` + `subprocess.run()` 模式：
+
+```python
+# Phase A: terminal() 中保存原始响应到文件
+result = terminal("""
+bash -c '
+set -a
+source /home/ubuntu/zhu/github/reader/.env
+set +a
+OPTS=$(printf "%s" "{\\"clientId\\":\\""$IMA_OPENAPI_CLIENTID"\\",\\\"apiKey\\":\\\""$IMA_OPENAPI_APIKEY"\\\"}")
+RESP=$(node /root/.hermes/skills/openclaw-imports/ima-skill/ima_api.cjs "openapi/wiki/v1/create_media" "{...}" "$OPTS" 2>/dev/null)
+echo "$RESP" > /tmp/create_media_raw.json
+echo "saved"
+'
+""")
+
+# Phase B: execute_code 中从文件读取凭证
+import json, subprocess
+with open("/tmp/create_media_raw.json") as f:
+    data = json.load(f)
+cred = data["data"]["cos_credential"]
+
+# Phase C: subprocess.run 直接调用，不经过 terminal()
+args = ["node", f"{SKILL_DIR}/knowledge-base/scripts/cos-upload.cjs",
+    "--file", FILE_PATH, "--secret-id", cred["secret_id"], "--secret-key", cred["secret_key"],
+    "--token", cred["token"], "--bucket", cred["bucket_name"], "--region", cred["region"],
+    "--cos-key", cred["cos_key"], "--content-type", "text/markdown",
+    "--start-time", cred["start_time"], "--expired-time", cred["expired_time"], "--timeout", "300000"]
+r = subprocess.run(args, capture_output=True, text=True, timeout=310)
+```
+
+## 对比：错误的做法（terminal 直接传递）
+
+```bash
+# ⛔ 这样不行！token 会被 redact_secrets 替换为 ***
+TOKEN=$(echo "$RESP" | jq -r '.data.cos_credential.token')
+node ... --token "$TOKEN" ...  # 会收到 HTTP 403
+```
+
+## 关键原则
+
+- `terminal()` 输出中的敏感字段会被自动脱敏，但不影响底层 JSON 文件写入
+- `execute_code` 中 `terminal()` 返回的 `output` 已经是脱敏后的文本
+- **唯一可靠的凭证源**是直接写入磁盘的原始 JSON 文件
+- `subprocess.run` 在 `execute_code` 中绕过脱敏，因为凭证在 Python 内存中直接被传递给子进程，不经过 Hermes 的 stdout 脱敏管道