Index of every page on this site: llms.txt
All skills
cat-xierluo avatar

/magpie-optimizer

@5fb69a0
Run it yourself

用 Magpie 配置并优化 AI 工作效能:接入供应商、订阅与插件,配置模型路由组与意图规则,管理网关、可见性、共享 MCP 与搜索;盘点额度与套餐,诊断 Token 消耗与限流,把每次调整关联真实任务验收效果。

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/magpie-optimizer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencescli-contract.md

≈1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

CLI 与变更边界

基于本机 Magpie 0.1.1237 核对。配置默认 ~/.config/magpie/providers.json,尊重 XDG_CONFIG_HOME。网关本机地址从实际 settings 或 magpie models 查明,不硬编码端口。文件中有密钥,读取仅在进程内做比较与 allowlist 投影,不打印原件。

只读调查

  • magpie --version、magpie group --help、magpie group rule --help。
  • magpie groups、magpie models、magpie group <id>。
  • magpie quota --json:可访问平台刷新用量;raw 中包含账号,不直接输出。
  • magpie usage today、magpie usage 7d:只摘聚合,用量来源可能重叠。
  • magpie provider account-concurrency <provider>、magpie provider queue <provider>、magpie provider rpm <provider>:省略修改值为查询。前者可能输出私有账号,只保留限制值。
  • 已装插件初始化可能下载其运行时。希望零联网时使用离线 inspect;不自动执行 sync、update、plugin install 或 quota reset。

注意:该版本 magpie provider <子命令> --help 可能只返回总帮助,exit 0 不能证明能力;必要时在临时 HOME+XDG_CONFIG_HOME+XDG_CACHE_HOME、MAGPIE_NO_ACCOUNTS=1 下验证参数并检查实际文件。环境隔离要通过子进程 env 实现,不更改当前 shell 的 HOME。不要复制真实认证到测试目录。

原生写入

下列是已核对语法,尖括号由实际对象替换,不直接执行模板:

magpie group set <id> models=<完整列表> routing=order stays=auto
magpie group rule add <id> pause=<组内模型> time=14:00-18:00
magpie group rule add <id> use=<组内模型> time=18:00-23:00
magpie group rule rm <id> <规则序号>
magpie group rule mv <id> <原序号> <目标序号>
magpie provider account-concurrency <provider> <account-or-key-id> 1
magpie provider queue <provider> 2 15
magpie provider rpm <provider> <已确认的每分钟上限>

修改已有对象先保留目标的完整 JSON 与 CLI 只读状态到私有 0600 文件(不导出 provider key),锁定变更字段。models= 替换整个列表,models+=/models-= 是增删。组成员 off 与 provider off 是独立状态,不能只看组 members。规则 rm 的序号每删一条都会变化,批量删除按倒序,并逐步回读。

账号并发是跨模型/分组共享的上限。off 或 0 表示不限,不能当“停用”。已设置的账号 override 可能覆盖供应商默认。实际可承受并发由限流表现确认,不能用多建组绕过。

普通 use 规则仅把目标提到前面,其他成员仍能 fallback;manual 路由不自动失败回退。pause 是硬排除,优先保护避峰成本但可能中断缓存。不要把 free 与付费项放在同一自动回退组后称“只用免费”。意图分类器本身也消耗额度,第一版建议显式按任务选组。

group add 同名替换:随附脚本拒绝此情况,只创建 mpr-*。修改旧组通过上面的人工审核流程执行,脚本不自动接管。

凭证、失败与恢复

不把 providers.json 完整内容放进报告、测试或 Git,不调用 provider key 写入示例凭证。一次变更不得顺带打开关闭的供应商、重置卡、切换登录或改所有 Agent 默认模型。

随附脚本预览时记录全配置 SHA-256,应用时严格核对;不是 Magpie 内部事务锁。GUI 及其他写入者应暂停配置编辑,后台正常推理无需停止。检测到漂移或 CLI timeout 时,不自动补偿、重放或整文件回滚,先确认实际落盘。

恢复新组:确认没有 Agent、其他组或规则引用,检查它仍是本次创建后的内容,再明确执行 magpie group rm <id>,回读剩余组和 Agent 配置。新组已被使用或有人追加修改时先保留;不能盲删。恢复旧组:仅用原生 CLI 恢复本次变更字段和规则,保留他人新配置。

应用成功后,先回读配置,再在授权内做代表性真实请求,检查 usage 的实际 served provider/model。新增组可供下次会话选择,但不自动切换当前任务;各客户端是否需要新会话按其实际行为验证。

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts18d3 checks · Risk SAFE
  • Gen Agent Trust Hub18d

    This skill provides a robust and security-conscious framework for managing AI model routing and telemetry via the Magpie CLI. It includes extensive defensive measures such as local-loopback-only network enforcement, restricted file permissions (0600), comprehensive credential redaction logic, and a self-auditing suite to prevent secret leakage.

  • Socket18d

    No alerts

  • Snyk18d

    Risk: LOW · No issues

Signed by skilld at 5fb69a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated yesterday
Other metadata
metadata
{
  "version": "1.8.1",
  "author": "杨卫薪律师(微信ywxlaw)",
  "homepage": "https://github.com/cat-xierluo/legal-skills"
}

README badge

README badge for cat-xierluo/legal-skills/magpie-optimizer