StorageOps · Pi Coding Agent 扩展

在 Pi 里排查对象存储

给 Pi 的 skills 和工具。用你的日志和 trace 排查。不接云账号。

PythonPi Coding AgentS3-compatibleMIT

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
个 Pi 扩展工具
4

Pi 仍是运行时

装在 Pi 上

不加第二个 Agent,不做云控制台,不接云账号。

先脱敏

凭据值在进入 Agent 上下文前脱敏。

不改存储

最多受限 trace 一条命令;改动由你来做。

skill 定方法,工具读证据

Pi 是运行时。StorageOps 补上对象存储领域的知识和工具。

  1. 1

    带上材料

    原始报错、@日志文件、配置片段或 debug 输出。

  2. 2

    识别领域

    detect_domain 给出优先方向,提示 Pi 读哪份 skill。

  3. 3

    加载 skill

    SigV4、IAM、生命周期、复制、Spark S3A;再由工具读证据。

有明确领域的存储故障

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

skill 包覆盖常见的 S3 兼容故障。Pi 只加载与眼前材料相符的那部分。

开始使用

需要 Node.js 22.19+ 和 Python 3.11+。缺少 Pi Coding Agent 时,storageops install 会一并安装。第一次诊断前先配置模型密钥。

  1. 安装 StorageOps

    python3 -m pip install storageops -i https://pypi.org/simple
  2. 把技能和工具装进 Pi

    storageops install
  3. 跑一次诊断

    storageops --print 's5cmd sync reports 429 SlowDown; diagnose likely cause'

常见问题

它是另一个 Agent 吗?

不是。StorageOps 是对象存储 skills、一份 Pi 扩展和辅助脚本。Pi 仍是运行时;StorageOps 不会再加一个 Agent,也不是云控制台。

需要接入云账号吗?

不需要。它根据你提供的日志、报错、配置和 trace 排查,不收取云凭证,也不自建云账号会话。

会改动我的存储吗?

StorageOps 不修改存储资源。trace 会经 httpmon 运行你提供的那一条命令:已知的存储命令必须只读,但未知命令同样会被执行,所以只交给它没有副作用的命令。

什么时候改用 Storage Agent?

已经使用 Pi、只想增加对象存储排查能力时,选择 StorageOps;需要完整桌面应用、内置只读工具、本地分析,并跨任务记住发现的问题时,选择 Storage Agent。 打开 Storage Agent

StorageOps