变更记录
[1.8.1] - 2026-11-21
新增
- 新增
references/cross-device-sync.md:沉淀多台电脑共用 Magpie 配置的抽象同步方案,覆盖数据域取舍、WebDAV/S3/GitHub/一次性备份选择、信任边界、权威机与 follower 收敛、验收矩阵、超限 Skill 和常见网络/认证/路径故障分层;公开文档只使用占位端点,不包含个人环境信息。 - SKILL 工作方式表新增跨设备同步入口。
[1.8.0] - 2026-11-01
新增
- 增加输入开销与经济性排查:从网关分项核系统提示、工具、Skill、规则、文件、结果与对话,以质量、缓存和真实用量复核效果;Agent/Skill/编排规则的修改交对应维护方。补出站协议与断流的证据边界,不自动裁剪请求或改变在途任务。
- 新增有界只读效率分析 CLI:流式读取具名日志,分列 HTTP 状态、含错误信号的结果、实际尝试、调用种类、输入分项、缓存与延迟;拒绝覆盖私有回执,坏行和覆盖截断不伪装完整。
references/gateway-resilience.md:分查推理、模型目录、认证、额度采样和进程生命周期;加入双插件认证争写循环的离线复现机制,以及 MiniMax 多入口的登录、目录与额度排障顺序。scripts/gateway_guardian.sh:只读报告宿主 RSS、僵尸/孤立线索与过期缓存数量;默认status,兼容旧子命令名,不杀进程、不重启服务、不删缓存、不截断日志,DRY_RUN=0也不开放写操作。- SKILL 增加网关故障隔离和 MiniMax 排障入口。
- 新增有界、只读的
magpie_resilience.py:按宿主 PID/启动时间分段观察 RSS 与认证文件元数据,不读取凭据内容、不启动 CLI/网络/后台任务;输出私有回执及实际覆盖,失败不伪装成零。 - 增加宿主持续内存增长的分层取证参考:现场保全、共享宿主身份与事件对齐、候选/反证、离线复现和维护窗口边界;采样回执记录 UTC 时点,时长与预算继续采用单调时钟。
- 补官方/旧 fork 绑定收敛、更新通道与通知偏好、探测节流的本地缓解矩阵及定向恢复边界;宿主取消/超时问题附上游可复现 issue。
- 补 launchd 正常退出后无条件重拉的诊断与条件托管边界,明确只读 Guardian、任务感知维护和真正服务重启的区别;重载有运行 PID 的 job 不能当无中断配置操作。
修正
- 纠正网关诊断与全局协作的职责:撤回本 Skill 中的 worker 任务卡模板、上下文继承参数和原生宿主配置清单;这些由 Personal Agent 等 Agent 管理/编排层及全局/项目规则维护,不复制为第二套派工协议。
- 上下文观测保留独立 Skill 分项,兼容路由用量对象/列表;缺少缓存计数保留未知,避免误报零命中。
- 撤回“进程可跨操作系统重启存活”“PPID=1 且无监听即可清理”“终止主进程属于无中断滚动重启”等不准确结论。
- 不再以 registry 超时直接定因全部模型目录刷新;保留事件计数、内存观察与具体实现归因的证据边界。
- 旧巡检脚本的缓存删除不受 dry-run 保护,重启分支也缺少完整归属核验;当前版本收束为只读报告。运行副本须按哈希单独核验采用,文档更新不等于后台副本生效。
- 区分 provider/plugin 开关、静态备用目录/实时目录、额度未知/认证失效,以及分类器/worker 的实际调用;恢复验收保留观察窗口和未验证范围。
- 内存专项复核补宿主取消/目录超时的隔离复现与父进程退役时限;明确历史异常增长不等于已定位 Bun 堆泄漏,并撤回把换代后的小宿主当作旧宿主自行回收的因果口径。
[1.7.0] - 2026-10-27
新增
- 新增
references/cli-command-reference.md:完整 magpie 命令面(供应商、订阅、插件、agent 指向、子 agent、路由组与规则、网关 key 与预算、模型呈现与定价、共享 MCP/指令/搜索、维护命令)与magpie quota --json字段读数合同;命令面与字段合同整理自 magpie-community/plugins 的 magpie-setup 与 magpie-quota(MIT),按 MIT 兼容方式并入并重写。 - SKILL 工作方式表新增两条入口:查子命令写法/接入路径、查额度窗口与等待恢复,直接路由到命令参考与额度合同;纯命令语法与纯额度读数不再需要另装独立 Skill。
调整
- description 扩展为覆盖配置与额度完整能力,避免与官方 magpie-setup / magpie-quota 触发面重叠时漏接。
- 插件指南中「原生接入可用」的回退路径改为指向命令参考与接入验证步骤。
[1.6.0] - 2026-10-26
修复
- 适配原生 CLI 持久化时段时区:计划显式绑定本机时区与预期回读,保留原规则时区漂移检查;隔离 CLI 验证修改与恢复。
- 单供应商容量提示作为咨询级风险保留,不再单独阻断
--strict;结构与规则警告仍按严格门禁处理。 - 盘点账号输出统一为单次扫描内的匿名标签,去除昵称、邮箱片段、域名和上游半遮罩;映射仅留内存,盘点结果仍保存在私有状态中。
- 将配置复制指南移入 references,移除 Skill 内 README;复制示例拒绝覆盖既有私有配置并使用 0600 权限。
- 公开参考删除个人调用统计,保留核验方法;明确画像由 Agent 解释、盘点与设计校验不会自动生成嵌套路由。
- 设计校验器改用严格 JSON 解析,拒绝重复键;格式不符时停止语义检查并返回结构化错误。嵌套深度含入口最多 8 个组,叶子模型不计层数。
- 画像 schema 增加约束内
expensive_models清单,盘点脚本读取该规范字段并兼容历史私有格式。 - 设计校验器对非字符串成员和暂停目标 fail-closed,不再输出 traceback;账号顺序输出恢复未知/空/已设置三态。
- 根 README 与 Skill 发布分发套件索引对齐为 9 个成员、源码 v0.1.3;仓库根发布检查不再误报必需的
state/.gitignore。 - 修正路由治理 §2.8 的代理探测与继承边界:双路失败不证明必须代理,空 choice 仍继承 全局;账号与 CLI 子进程的显式 choice 优先,回环例外与系统透明转发另核。
- 改为先验证必须代理的 provider,再切全局直连;回退绑定本次字段与预期后态,避免断路 或覆盖并发修改。同步既有治理记录与历史观测证据边界,不改生产配置。
- 原始
TASKS.md、DECISIONS.md改为同目录本地维护记录,由 Skill 内 ignore 规则排除; 公开树不再发布摘要版。配置说明放入references/configuration.md,列出五类 example 的私有副本、用途、 schema 与最小复制/校验路径。
变更
- 新增智能路由设计:按用户已配置的 provider、账号池、模型能力与任务角色生成个性化路由草案;沉淀角色分层、资源映射、意图规则、子 Agent/辅助调用边界与设计检查矩阵,不写入任何个人模型或账号。
- 路由设计示例改为单一入口嵌套多个角色组:外层
order + turn负责角色层编排,内层组负责同层成员回退;补充 compact、轻任务、普通任务、困难升级与项目级终审的规则顺序示例。 - 从私有维护仓库迁入 legal-skills 公开目录;原始任务与决策记录迁入 Skill 同目录本地维护并由 ignore 排除, 公开层保留通用入口、参考、脚本、示例/schema、许可证与变更记录。
- 本机画像、集成信息、路由策略与可执行 policy 放在
config/*.local.*私有层; 观察、盘点、计划、回执与快照放在state/,均由随包 ignore 规则排除。 - 通用入口补公开主页;示例命令的网关端口改为
<port>,具体模型组示例改为泛化占位。
[1.5.0] - 2026-10-25
新增
- 子 Agent 指名覆盖观测(
references/subagent-override.md):记录 Codex 宿主上spawn_agent(model=...)的普通请求几乎总被写到统一默认组、ChatGPT backend 封印是 例外路径,以及subagent.to/subagent.kept的判读方法。统计口径区分组展开、 具体模型指名不一致和 provider 前缀差异,要求本地证据绑定实际读取截止时间。 references/subagent-models.md修正优先级口径:agent TOML 是持久指定入口;spawn 参数 不能当可靠机制,模型敏感任务必须回执实际 served model。同步修正references/inventory.md中「子 Agent 自动重入主入口意图分流」的相反口径。
[1.4.0] - 2026-10-25
新增
- 路由治理参考补出口代理的两层边界(
references/routing-governance.md§2.8):全局direct与空值(继续跟随环境变量与系统代理)不同;provider 级代理在onLAN判定前 返回,不受全局值影响;账号层登录态刷新走账号自己的代理。给出「先探测哪些出口真的 需要代理」「全局值影响登录类厂商 CLI 子进程与进程内签到请求」「provider 级代理可能 无 CLI 写入口」三条边界与「先改全局、后加 provider 代理」的可回退顺序。
变更
- 原 §2.8、§2.9 顺移为 §2.9、§2.10;同步
references/preflight.md的 交叉引用;证据边界补记 0.1.1371 的netproxy、provider/proxy、settings核对结果 与「登录类子进程与进程内签到未逐项实测」的未核实项。
[1.3.0] - 2026-10-24
新增
- 面向公开发布补齐自包含入门与接入能力:本地私有配置层、盘点/入门/操作/插件/隐私参考、 provider 接入边界与路由模板。
- 新增只读体检、盘点、公开发布检查和配置示例验证脚本,并补充离线回归。
- 新增 profile、inventory、integration、可执行 policy 与 route design 的示例/schema。
修复
- 明确
magpie_route.py inspect与magpie_inventory.py scan的输出字段边界,避免同名 schema 被误读为同一快照。 - 明确可执行 policy 与高层 route design 的边界,防止把设计模板直接喂给 plan。
- 公开检查补齐私有层泄漏、坏 UTF-8、符号路径、secret 样例与版本一致性门禁。
[1.2.0] - 2026-10-22
新增
- 路由治理参考补三处实测坑(
references/routing-governance.md):- 本机解析到回环的厂商域名会让全局代理被绕过;0.1.1307 源码解释
loopback例外、解析、 onLAN 直连与 provider 级代理 choice 的先后,排障时先核解析来源。 - 区分规则命中、目标不可用与分类器回退:
unready/then/instead、classified.error/fallback、tries/served分别断言,不把落点偏离直接归因于配置顺序。 - 强模型入组会被兜底消耗;顺序结论限定于
order的新 turn 重选路径,末位只是降低概率, 硬性不消耗用移除或pause。记录 0.1.1307 没有“规则未命中移出回退”的开关。 - 能力层必须显式接进唯一入口,并区分「组存在」与「外层会选到」;同一 provider/model 与固定 effort 经能力组和免费池重复进入会被折叠到首次出现位置,共享会改变默认落点。 单一候选休息会移到队尾并可能被探测,关闭或移除才无候选承接。
- 嵌套组的内外层 routing/rules 相互独立;外层
order不会改写内层smart。经外层请求 的会话保持由外层 affinity 控制,内层 stays 仅在直接请求内层组时生效;变更后需分别核对 直接请求与外层请求的两层tries。
- 本机解析到回环的厂商域名会让全局代理被绕过;0.1.1307 源码解释
[1.1.0] - 2026-10-21
新增
- 路由治理参考(
references/routing-governance.md):面向「只用组内一个入口」的统一入口落地。 含四类常见失败的定位表(额度耗尽/排队拒绝/掉登录/组被停用)、六个实测坑 (disabled无 CLI 开关、providerfallback每次调用整体替换、fallback可指向组、 普通模型可逗号并列但组目标需单独设置、stays存为affinity、GUI 与 CLI 同写配置)、 条件式建组/拆组判据、pattern 成员与三层order口径、smart/rotate/weight/manual路由语义、规则顺序与 classifier 依赖、计点层有界溢出和可回读止损、免费窗口迁移验收、 失败判据与最小回滚、嵌套组逐层验收,以及真实请求看 served model 的验证方法。 客户端边界另记录model_catalog_json静态快照的刷新义务,以及标题、摘要、输入预测、自动审批、记忆/压缩等辅助调用与路由组的 独立核验方法;未核实项明确标NOT_VERIFIED。
[1.0.2] - 2026-10-21
新增
- 子 Agent 模型指定参考(Codex/DSH):Codex 双入口与三级优先级(agent TOML 指定 >
[agents] default_subagent_model> 主会话模型)、ChatGPT backend 任务封印坑;DSH 请求级agentOptions、工具行配置级固定与继承父模型三层。 - 记录网关不分主/子角色的边界:统一与单独配置的仲裁都发生在客户端配置合并,子 Agent 按意图自动分流仍归 smart-split。
[1.0.1] - 2026-10-16
改进
- 增加跨harness通用smart-split维护合同,按任务意图、时段和默认顺序选择优先模型,不要求客户端预先绑定角色模型。
- 增加按用户确认的成本边界和客户端接入方式审查配置的规则,避免从组名推断设计错误。
- 区分强模型优先与强模型硬隔离、分类器失败与语义验收失败,明确当前有限变更脚本的适用边界。
[1.0.0] - 2026-10-16
改进
- 从公开仓库的忽略测试目录迁入 private-skills 独立仓库,以 magpie-optimizer 为唯一名称。
- 按根目录技能版本规范建立首个私有入库版本,保留完整测试版历史;运行逻辑沿用0.2.1。
- 通用源码和维护文档入库;个人用量、配置计划、密钥和运行证据仍保存在仓库外。
[0.2.1] - 2026-10-16
改进
- 按用户要求直接迁移到 magpie-optimizer,移除旧名称兼容目录和安装入口;更新当前指引与配置写入锁名。
- 历史版本记录和私有验收证据继续保留,日常发现和调用仅使用新入口。
[0.2.0] - 2026-10-16
新增
- 更名 magpie-optimizer,扩展为个人 AI 工作效能入口;保留 magpie-routing 兼容调用。
- 只读请求采集、较长等待、分页覆盖和首尾检查,按来源/会话/模型汇总;保留局部上下文与工具缓存的独立口径。
- 带事实、假设、行动和验证指标的诊断,不以占比阈值直接判定浪费。
- 既有分组有限变更、精确中间/最终后态恢复、逐条回读和漂移拒绝。
- 真实任务产物与验收哈希关联、重复任务/请求拒绝、每份验收成果的描述性比较。
修复
- 处理 Magpie 将 stays 保存为 affinity 的实际字段映射。
- 拒绝跨页重叠、虚假完整覆盖、未知来源归为网关及同一任务重复计入成果数。
- 窗口与计数矛盾时保留元数据告警,避免把异常比率当真实溢出。
待办事项
- 跨真实可比任务验证实际优化收益;当前效果比较工具只给描述性证据,不宣称因果收益。
- 持续监控和自动业务派发仍按具名授权另行接入。
[0.1.0] - 2026-10-15
新增
- 基于 Magpie CLI 的供应商、分组、启用状态和套餐额度盘点,输出字段白名单及私有文件。
- 按质量底线、额度期限、时段、并发、缓存与返工成本规划 token 使用,区分免费池、执行池与深度任务池。
- 新分组的可读配置计划、哈希及新鲜度检查、CLI 写入与逐条持久化回读;拒绝同名替换和配置漂移。
- 既有分组与供应商的原生命令操作合同、失败恢复边界及隔离测试。
待办事项
- 第一版脚本不自动编辑已有对象;真实平台推理、计费及多轮 Agent 稳定性分别保留验证边界。