开发者文档

面向要在本地开发 Serpent、或成为项目贡献者的人：环境搭建、架构、测试、打包与贡献流程。这些页面随 main 发布，不是 docs/internal/ 里的切片日志或内部规格。

开发者文档分两部分：

第一部分：软件开发

面向参与 Serpent 本身开发的开发者：架构、源码构建、测试规范。

• 环境搭建——依赖、首次构建、开发环境
• 构建与打包——package / make / 发布流水线 / 签名
• 架构——进程模型、目录结构、关键设计
• 测试——测试体系与运行方式
• 新增媒体格式支持——从共享注册表到导入、预览、过滤、协议和验收
• 分支与开发工作流——分支策略、开源贡献流程与维护者工作纪律
• 贡献指南——开源协作、Pull Request 与代码门禁要求
• 贡献者名单——已被项目接受并合并的贡献列表

其他软件文档（内部记录仅仓库 dev 分支，网站不发布）：

• 开发流程——切片流程与质量门禁
• 领域模型 / 术语表
• 架构决策记录——ADR-0000 起
• 实施规格——切片规格

第二部分：扩展开发

面向编写插件、脚本、MCP 适配器的开发者。不需要了解软件架构，直接看扩展作者手册：

• 插件开发指南 + 最佳实践 + API 参考
• 插件分发与更新
• 官方插件参考实现：
  • Serpent-Plugin-Renamer——非受限模式（unrestricted），基于 Host 标准对话框与列表控件实现资产批量重命名与实时改动预览
  • Serpent-Plugin-MediaConverter——媒体转码与压缩扩展，演示多规格媒体计划、后台 Job 队列任务生命周期与全平台包分发（any）
  • Serpent-Plugin-ImageUpscaler——非受限模式（unrestricted），演示外部 AI 推理二进制文件管理、跨平台独立 ZIP 分流打包发布（darwin-arm64 / win32-x64）与分块内容回写
• 脚本开发指南 + API 参考
• MCP 开发指南 + API 参考

最终用户使用插件的方法见插件使用，浏览器扩展见浏览器扩展，自动化脚本和 MCP 见自动化功能。