configure-pi-models-discovery skillA
configure-pi-models-discovery is agent-read markdown (skill) from maplezzk/pi-extensions: 配置与排查 models.json 的动态模型发现、缓存刷新、鉴权和离线回退。Use when adding discoverModels providers or refreshing model catalogs..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 配置 pi-models-discovery
## 诊断
读取实际 Pi agent 目录中的:
- `models.json`:provider 配置;
- `extensions/pi-models-discovery/cache.json`:启动缓存;
- `models.json.discovery-bak`:交互配置写回前的备份。
只处理带 `discoverModels: true` 的 provider。确认 `baseUrl`、`api`、可选 `apiKey`、headers/compat 以及服务的 `GET {baseUrl}/models` 响应。
## 修改
优先使用 `/config:model-discovery` 添加、删除或重新发现 provider;命令会备份并格式化重写 `models.json`,注释与原排版不会保留。手工修改时,provider 至少提供 `baseUrl`、`api`、`discoverModels: true`;修改后需要 `/reload`。
`apiKey` 可用字面量、`$ENV_VAR` 或 `${ENV_VAR}`;`!command` 不用于发现请求,会被跳过并警告。不要把密钥写入 Skill、仓库或回复。
## 思考等级
发现的模型默认声明 `thinkingLevelMap: { xhigh: "xhigh", max: "max" }`(对所有模型一刀切)。若某个模型不认 `xhigh` / `max`,用 models.json 的 `modelOverrides` 按 model.id 把它们置 `null`。
## 验证
- `/config:model-discovery-refresh` 强制联网刷新并更新缓存;旧命令名仅为兼容别名。
- 打开 `/model` 也会触发在线刷新。
- 逐个 provider 报告成功或失败。失败时可保留 `models.json` 中手写的 `models` 作为显式离线回退,但不能把缓存或静态模型冒充本次发现成功。Read the whole file at its exact version.
How to install
mdr add maplezzk/pi-extensions/configure-pi-models-discovery@git:20260920.5241ae4mdr add maplezzk/pi-extensions/configure-pi-models-discovery@sha256:5f1e3b031351fc46Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_kuoixwpfqwj36rbd)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260920.5241ae4 latest | 2026-09-20 | 5241ae4 | 1,677 B | A | view · diff |
| git:20260820.57a9863 | 2026-08-20 | 57a9863 | 1,435 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (1677 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
maplezzk/pi-extensions · 12 stars · license MIT · pushed 2026-09-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kuoixwpfqwj36rbd GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-models-discovery GET https://markdownregistry.com/api/v1/blob/5f1e3b031351fc4671cf4f0da0139ca4c4c3e54755a6ddfb43bdcf79321c7f1f
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.