refactor(certd-online-plugin): 更新插件开发相关配置与文档

This commit is contained in:
xiaojunnuo
2026-08-02 23:41:47 +08:00
parent eae7edbda0
commit 01abf348d2
3 changed files with 16 additions and 7 deletions
@@ -1,4 +1,4 @@
interface:
display_name: "Certd 在线插件开发"
short_description: "通过本地 Agent Server 使用 Codex 或 Trae 开发 Certd 在线插件"
default_prompt: "启动本地 Agent Server读取插件 YAML 和对应类型规范,按需求修改 content 并返回完整 YAML 草稿。"
short_description: "通过 Certd API 使用 Codex 或 Trae 开发在线插件"
default_prompt: "读取在线插件 YAML 和对应类型规范,按需求修改 content,保存历史记录后通过 Certd API 写回。"
@@ -1,11 +1,11 @@
# 本地历史记录
历史记录和开发临时文件只保存在 Codex/Trae 当前工作区的 `tmp-online-plugin-dev/` 下,不调用 Certd 后端历史接口。
历史记录和开发临时文件只保存在 Codex/Trae 当前工作区的 `.tmp/online-plugin-dev/` 下,不调用 Certd 后端历史接口。
目录格式:
```text
tmp-online-plugin-dev/
.tmp/online-plugin-dev/
history/
plugin-12/
2026-08-02T12-30-00-before-edit.yaml
@@ -18,7 +18,7 @@ tmp-online-plugin-dev/
要求:
- 修改前保存完整 YAML。
- 临时 YAML、脚本草稿、调试记录都放到 `tmp-online-plugin-dev/` 下,不散落到项目目录。
- 临时 YAML、脚本草稿、调试记录都放到 `.tmp/online-plugin-dev/` 下,不散落到项目目录。
- `change.md` 只记录插件 ID、版本、时间和脱敏修改摘要。
- 不保存 Token、证书、私钥、Cookie、环境变量和真实授权值。
- 恢复历史版本前先备份当前 YAML。
@@ -21,6 +21,7 @@
<a-tag color="blue">API 模式</a-tag>
</div>
<a-textarea class="plugin-ai-dev__prompt-text" :value="prompt" readonly :rows="24" placeholder="生成后复制到 Codex 或 Trae 中运行。" />
<div class="plugin-ai-dev__prompt-warning">该提示词包含 Certd 的访问 Token请勿泄露给他人</div>
</div>
</section>
</div>
@@ -130,8 +131,8 @@ ${token}
6. 使用当前 Token 调用 Certd API,通过 /sys/plugin/find 查询插件和 Access。
7. 开发 Task 或 DNS 插件前,先查询对应 Access,优先复用 Access 提供的 API/SDK 能力。
8. 如果没有 Access,先创建 Access 插件;如果 Access 的 editable 为 true 且缺少能力,可以先修改 Access。
9. 在当前工作区创建并使用 tmp-online-plugin-dev 作为本次插件开发临时目录,历史记录、临时 YAML、脚本草稿和调试记录都放在该目录下。
10. 修改任何插件前,先在 tmp-online-plugin-dev/history 下保存完整 YAML 历史记录,便于恢复。
9. 在当前工作区创建并使用 .tmp/online-plugin-dev 作为本次插件开发临时目录,历史记录、临时 YAML、脚本草稿和调试记录都放在该目录下。
10. 修改任何插件前,先在 .tmp/online-plugin-dev/history 下保存完整 YAML 历史记录,便于恢复。
11. 通过 Certd API 读取和保存完整插件 YAML,不使用 WebSocket,不依赖浏览器草稿。
12. 保存完成后向用户报告 API 操作结果,不自动发布。
@@ -220,5 +221,13 @@ onMounted(loadPluginOptions);
font-family: Consolas, "Courier New", monospace;
font-size: 12px;
}
&__prompt-warning {
flex: none;
margin-top: 8px;
color: #d4380d;
font-size: 12px;
line-height: 20px;
}
}
</style>