StorageOps · Pi Coding Agent 扩展

Pi 的对象存储排查扩展

用你提供的日志、报错、配置和 trace,帮 Pi 排查 S3 兼容存储问题的 skills 和工具。

Python · Pi Coding Agent · S3-compatible · MIT

Pi Agent

Pi 先加载 skill,再调用工具

StorageOps 给 Pi 一条对象存储排查路径:skill 决定方法,扩展工具再安全地处理现场证据。

SKILL 16 组诊断 skills

Pi 可按需加载鉴权、协议兼容、性能、生命周期、迁移、一致性等对象存储领域的排查方法。

ROUTE detect_domain

判断优先排查方向,并提示 Pi 接下来该读取哪份 skill。

SAFE scan_secrets

在材料进入 Agent 上下文前,先脱敏凭据值。

TRACE capture_http_trace

通过受管的 httpmon helper 观察一条受限的只读存储命令。

输入:报错、命令、配置、脱敏日志 Pi:skills、工具与确定性辅助脚本
Pi 扩展16 组 skills4 个 Pi 工具不连接云账号

Pi 扩展与 skill pack

按需加载的对象存储技能

Pi 是运行时;StorageOps 提供对象存储 skills、四个调查工具和辅助脚本。带上报错、日志、配置片段或 trace,Pi 就能根据这些材料排查,而不连接你的云账号。

Pi 会加载什么、调用什么

技能决定排查方法,工具读取现场证据

Pi 是运行时。StorageOps 提供对象存储领域的知识和动作,让 Pi 能根据现场材料排查问题,但不会连接或修改你的云账号。

  1. 01

    先识别问题领域

    `detect_domain` 会从鉴权、签名、限流、迁移、网络等方向里给出优先级,并提示 Pi 加载下一份 skill。

  2. 02

    再加载对应 skill

    每份 skill 都定义了一类对象存储问题的排查方法,例如 SigV4、IAM、生命周期、复制或 Spark S3A。

  3. 03

    按需调用工具

    工具会脱敏、检索历史会话、解析输入材料;需要补充证据时,也可对一条只读命令采集 HTTP trace。

一次问题怎么处理

一次问题怎么处理

01

带上现场材料

先提供问题描述、原始报错、`@日志文件`、相关配置片段,或命令的 debug 输出。

02

让 Pi 选择路径

Pi 会加载合适的 StorageOps skill,再调用对应工具,不会把整份材料只当作普通文本来猜。

03

读取需要的证据

StorageOps 可以脱敏凭据、解析输入材料、检索历史会话;需要补充证据时,也能通过 httpmon 观察一条受限的只读命令。

04

由你完成修改

结果会区分可能原因、依据,以及仍需你手动确认或修改的部分。

适用问题

有明确排查领域的对象存储问题

AccessDeniedSignatureDoesNotMatchSlowDown校验和不匹配生命周期规则复制迁移读取结果过期

每份 skill 对应一类常见的 S3 兼容问题。Pi 会根据材料加载需要的能力,而不是走一套固定套路。

常见问题与用法

StorageOps 给 Pi 增加了什么?

它安装对象存储 skills、Pi 扩展和辅助脚本。Pi 仍是运行时,负责在排查中加载 skill 和调用工具。

4 个扩展工具分别做什么?

`scan_secrets` 脱敏凭据、`detect_domain` 归类问题、`search_memory` 检索已脱敏历史会话;`capture_http_trace` 通过 httpmon 观察一条受限命令的 HTTP trace。

它会访问或修改我的桶吗?

不会。StorageOps 不自建云账号会话,也不修改存储资源;若启用 trace,只观察你提供的那条受限命令。

什么时候选 Storage Agent?

已经使用 Pi、只想增加对象存储排查能力时,选择 StorageOps;需要完整桌面应用、内置工具、本地分析和确认流程时,选择 Storage Agent。 打开 Storage Agent

让 Pi 按对象存储的方法排查

打开仓库