SuperAPI AI 工具集

voicestudio-maintainer

部署与运维

查看项目

更新于 10-15 20:35

技能介绍

用途:面向 debpalash/VoiceStudio 仓库的维护工作流,覆盖 issue 分诊、PR 审查、CI 诊断与经明确授权的发布准备。安装该技能不授权合并、发布、关闭 issue 或联系贡献者。

主要能力与做法:先阅读目标仓库的 AGENTS.md、CLAUDE.md、贡献指南与发布文档,其政策优先于本工作流。分诊时先检查现有代码与 PR,避免重复修复,复用贡献者成果并保留署名;尽量复现报告行为,区分已确认故障与诊断,在 PR 中记录限制。修复采用最小完整改动,测试可观察行为,不以源码文本断言代替端到端测试。保留本地改动,必要时用隔离 worktree。重跑前先读 CI 失败与评审意见,先诊断再重试,不用管道成功掩盖失败门禁。保持用户文档与所需翻译同步。

审查与授权落地:对照当前 main 审查 diff、机器人发现与必需检查,在 PR 分支解决实质问题后再落地,不先合并再承诺跟进。授权合并前确认必需检查通过、head 未变、PR 可合并;落地后检查 main 自身运行,立即调查回归。

发布准备:准备 CI 或打包与发布不同,未授权不得打标签、升版本、启用发布或切发布。使用仓库的版本来源、变更日志格式、支持平台与分发渠道;授权发布后核验实际产物、发布说明、更新元数据与注册渠道。

VoiceStudio 路由:Electron 开发与打包见 electron/README.md、electron/package.json、.github/workflows/;后端契约见运行中的 /openapi.json、backend/api/ 与定向测试;发布渠道与版本归属见 docs/RELEASING.md 与 CLAUDE.md,不得从修复请求推断版本升级。保留本地优先、跨平台、模型安装同意、合成音频标记与本地化要求。

开发命令(仓库根目录):bun install;bun run setup:api;bun run dev;bun run typecheck;bun run test;bun run check:electron;bun run dist(本地安装包,发布禁用)。

限制:Tauri 外壳已移除,不要恢复;其 v0.5.3 更新源为不可变兼容资产。不要为品牌清理重命名内部 omnivoice 包、环境键或数据路径。应用版本来自根 package.json,无明确版本任务不得升级。后端测试使用 CI 依赖与空临时 HF_HUB_CACHE、HF_HUB_OFFLINE=1。现有 CI 失败是阻塞项而非豁免。