reader/skills/reader-digest-flow/references/ima-cos-credential-handling.md

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() 模式：

# 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 直接传递）

# ⛔ 这样不行！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 脱敏管道