moeacgx/newapi-mao/2026-09

任务插件开发技能提炼

目标与范围

根据 Jev 连续出现的路由、模型别名、响应包裹和 Token 统计遗漏，建立仓库级 .agents/skills/task-plugin-development/，覆盖新插件、官方同步、宿主兼容与问题修复。 本项只增加开发规范和技能，不修改主程序、现有插件、价格、生产配置或两个现有修复 PR。

来源与方案

2026-09-24 核对官方插件仓库固定提交 b42cc99a6bd1998d0cc1581270bd46798ce00ad6， 参考 TypeSafe、Alibaba、Doubao、Sora、Kling、SunoAPI、Google、Vertex AI 共八类插件， 以及官方 API v1、类型声明、索引规范和仓库发布规则。 本地主分支基线 b6476c6c8c6fcc5c3b7725545fb3b16ba117a625； 本地 Token 修复仍为 PR #270，配套 Cloudflare 插件修复仍为 PR #7，不能写成已上线能力。

技能采用入口、官方模式参考、按任务选择的验收矩阵三层结构。 在 AGENTS.md 增加准确触发入口，并从开发文档索引及插件专题链接，避免仅存文件而无人使用。 遵守源仓库差异：官方禁止仓库内插件测试，本地插件仓库允许测试；官方不可变版本和索引生成规则 不能与本地 retired 索引、目录布局混淆。官方示例仍需要实际宿主验证，不能直接当作正确答案。

验证计划

检查技能元数据、UTF-8、相对链接、固定源码引用、Markdown 格式及 git diff。 使用独立代理在模拟问题上试用技能，只读分析；检查能否识别日志断链、别名身份、宿主能力缺口， 且不会把模拟结果当作生产证明或把调用成功当作交付完成。

验证结果

• 技能元数据与脚手架校验通过，UTF-8 无 BOM、入口及参考文档相对链接和新增仓库链接通过。
• 两个独立只读试用分别覆盖同步 Token/别名问题、异步视频安装/积分问题；

均区分插件和宿主修改层次、真实路由与脚本回放、按次售价与供应商用量，未把模拟结果当上线证明。

• 试用反馈已落实：修正路由文件名及 retainResult 生命周期措辞；补充安装错误原字节编译、

每请求关联节点/hash、字段存在性、按任务选择计费测试、原始用量与额度饱和隔离。

• .335 代码核对确认：编译器已认识 query/dynamic 与 usageProfiles，原生非 submit 仍返回 501；

按次插件返回倍率只作校验，不用于连乘。技能显式区分声明、执行与完整验收。

• 新技能和工作记录的 Markdown/YAML 格式检查及 git diff --check 通过；

未运行无关应用构建或推理请求，因为本项只改开发流程文档。

• 没有运行时行为或跨项目 API 合同变化；未合并、发版或部署。