Home / maplezzk / pi-extensions · packages/pi-models-discovery/SKILL.md · GitHub

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

Latest version
mdr add maplezzk/pi-extensions/configure-pi-models-discovery@git:20260920.5241ae4
Exact content
mdr add maplezzk/pi-extensions/configure-pi-models-discovery@sha256:5f1e3b031351fc46

Pin 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_kuoixwpfqwj36rbd.svg)](https://markdownregistry.com/a/art_kuoixwpfqwj36rbd)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.5241ae4 latest2026-09-20 5241ae4 1,677 BA view · diff
git:20260820.57a98632026-08-20 57a9863 1,435 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • 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

GitHub

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.

More from maplezzk/pi-extensions

AGENTS.md agents
maplezzk/pi-extensions · AGENTS.md
git:20260922.961f354 · audit A · 12 stars
configure-pi-auto-goal skill
maplezzk/pi-extensions · packages/pi-auto-goal/SKILL.md · 配置与排查 pi-auto-goal 的提前停止判定、判定模型、干预上限与催促文案。Use when configuring or diagnosing premature-stop judgement.
git:20260922.a62090b · audit A · 12 stars
configure-pi-clean-mode skill
maplezzk/pi-extensions · packages/pi-clean-mode/SKILL.md · 配置与排查 pi-clean-mode 的配置面板、折叠单位、耗时头、自动展开与快捷键。Use when configuring clean mode, opening its settings panel, or diagnosing…
git:20260922.73feb1a · audit A · 12 stars
configure-pi-distill skill
maplezzk/pi-extensions · packages/pi-distill/SKILL.md · 配置与排查 pi-distill 的模型、压缩阈值、重试、工具开关和审计卡片。Use when configuring pi-distill or diagnosing output distillation.
git:20260820.57a9863 · audit A · 12 stars
configure-pi-dynamic-workflows skill
maplezzk/pi-extensions · packages/pi-dynamic-workflows/SKILL.md · 配置与排查 pi-dynamic-workflows 的执行后端和异步模式。Use when configuring workflow backend, async mode, or subagent integration.
git:20260820.57a9863 · audit A · 12 stars
configure-pi-extensions-i18n skill
maplezzk/pi-extensions · packages/pi-extensions-i18n/SKILL.md · 配置 Pi 扩展共享语言并排查 locale 优先级、持久化设置和 catalog。Use when changing zh-CN/en-US/auto language behavior.
git:20260919.b3f1f59 · audit A · 12 stars
configure-pi-extensions-tool-display skill
maplezzk/pi-extensions · packages/pi-extensions-tool-display/SKILL.md · 配置与排查 Pi 工具展示宿主、内建/自定义工具 override、输出模式和 diff 视图。Use when changing pi-extensions-tool-display rendering.
git:20260820.57a9863 · audit A · 12 stars
configure-pi-interactive-subagents skill
maplezzk/pi-extensions · packages/pi-interactive-subagents/SKILL.md · 配置与排查 interactive subagents 的终端复用器、Herdr split/tab 和状态面板。Use when configuring subagent mux behavior.
git:20260918.137b800 · audit A · 12 stars
configure-pi-metrics skill
maplezzk/pi-extensions · packages/pi-metrics/SKILL.md · 启用与排查 pi-metrics 的耗时、TPS、TTFT、token 和成本遥测。Use when configuring or diagnosing Pi session metrics.
git:20260920.81cdf04 · audit A · 12 stars
configure-pi-naming skill
maplezzk/pi-extensions · packages/pi-naming/SKILL.md · 配置 Pi 统一 /rename、首条消息命名和终端目标归属。Use when configuring pi-naming.
git:20260914.d76b5b5 · audit A · 12 stars
configure-pi-nested-skills skill
maplezzk/pi-extensions · packages/pi-nested-skills/SKILL.md · 配置与排查 pi-nested-skills 的技能根目录、递归发现、别名调用和补全。Use when configuring nested skill roots, aliases, discovery, or completion.
git:20260907.3bd68af · audit A · 12 stars
configure-pi-notifications skill
maplezzk/pi-extensions · packages/pi-notifications/SKILL.md · 配置与排查 pi-notifications 的外部通知命令、argv 参数、超时和一次性失败提示。Use when configuring or diagnosing Pi external notifications.
git:20260907.3bd68af · audit A · 12 stars

Every file in maplezzk/pi-extensions

Browse by kind, by grade A, or by owner.