root
5eb390e3ed
- 复制 reader-digest-flow skill 到 skills/ 目录（含 SKILL.md + references/） - README 新增 Agent Skill 章节说明供 Agent 使用的工作流
56 lines
2.3 KiB
Markdown
56 lines
2.3 KiB
Markdown
# 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 脱敏管道
|