From 690df7373c6af1ccb36def8c630d522e0f6063e4 Mon Sep 17 00:00:00 2001 From: xiaojunnuo Date: Wed, 8 Jul 2026 12:04:07 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E6=97=A7=E7=89=88=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E5=85=BC=E5=AE=B9=E6=80=A7=E7=9A=84ai=20=E6=8F=90=E7=A4=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .trae/skills/access-plugin-dev/SKILL.md | 1 + .trae/skills/dns-provider-dev/SKILL.md | 1 + .trae/skills/task-plugin-dev/SKILL.md | 1 + AGENTS.md | 5 +++++ 4 files changed, 8 insertions(+) diff --git a/.trae/skills/access-plugin-dev/SKILL.md b/.trae/skills/access-plugin-dev/SKILL.md index 9b22cff40..0b0f64b5e 100644 --- a/.trae/skills/access-plugin-dev/SKILL.md +++ b/.trae/skills/access-plugin-dev/SKILL.md @@ -400,6 +400,7 @@ export class OAuthDemoAccess extends BaseAccess { 4. **错误处理**：API 调用失败时应抛出明确的错误信息。 5. **测试方法**：实现 `onTestRequest` 方法，以便用户可以测试授权是否正常。 6. **统一接口调用**：封装统一的 API 请求方法，避免重复编写错误处理逻辑。 +7. **旧版数据兼容**： 新增注解的插件参数，必须要考虑旧版数据兼容，比如新增一个deployType参数，有两种值：`default`和`custom`，需要在使用时判空，走旧版逻辑。 ## 开发技巧 diff --git a/.trae/skills/dns-provider-dev/SKILL.md b/.trae/skills/dns-provider-dev/SKILL.md index 87276c905..4c43ce181 100644 --- a/.trae/skills/dns-provider-dev/SKILL.md +++ b/.trae/skills/dns-provider-dev/SKILL.md @@ -454,3 +454,4 @@ new TencentDnsProvider(); 3. **记录结构**：定义适合对应云平台的记录数据结构，至少包含 id 字段用于删除记录。 4. **日志输出**：使用 `this.logger` 输出日志，而不是 `console`，参数文本化，不要传对象，否则会输出`[object Object]}`。 5. **错误处理**：API 调用失败时应抛出明确的错误信息。 +6. **旧版数据兼容**： 新增插件参数，必须要考虑旧版数据兼容，比如新增一个deployType参数，有两种值：`default`和`custom`，需要在使用时判空，走旧版逻辑。 diff --git a/.trae/skills/task-plugin-dev/SKILL.md b/.trae/skills/task-plugin-dev/SKILL.md index ec5110fbe..f7d6723bc 100644 --- a/.trae/skills/task-plugin-dev/SKILL.md +++ b/.trae/skills/task-plugin-dev/SKILL.md @@ -641,6 +641,7 @@ new AliyunOSSDeploy(); 4. **日志输出**：使用 `this.logger` 输出日志，而不是 `console`，参数文本化，不要传对象，否则会输出`[object Object]}`。 5. **错误处理**：执行过程中的错误应被捕获并记录。 6. **授权获取**：使用 `this.getAccess(accessId)` 获取授权信息。 +7. **旧版数据兼容**： 新增@TaskInput注解的插件参数，必须要考虑旧版数据兼容，比如新增一个deployType参数，有两种值：`default`和`custom`，需要在使用时判空，走旧版逻辑。 ## 部署逻辑注意事项 diff --git a/AGENTS.md b/AGENTS.md index ce2279a72..47cc02099 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -210,3 +210,8 @@ Certd 是可私有化部署的 SSL/TLS 证书自动化管理平台，提供 Web - 后端业务数据、接口、实体、权限、迁移：改 `packages/ui/certd-server/src/modules` 与 `src/controller`。 - 表单、列表、插件配置 UI：改 `packages/ui/certd-client/src/views/certd` 及对应 `src/api`。 +## 注意事项 + +### 旧版数据兼容 + +- 新增插件参数时，必须要考虑旧版数据兼容，比如新增一个deployType参数，有两种值：`default`和`custom`，需要在使用时判空，走旧版逻辑。 \ No newline at end of file