diff --git a/.agents/skills/dmate/SKILL.md b/.agents/skills/dmate/SKILL.md index cc75250..70ecdb3 100644 --- a/.agents/skills/dmate/SKILL.md +++ b/.agents/skills/dmate/SKILL.md @@ -5,13 +5,13 @@ description: 当用户通过本地 Agent 维护 DMate/DAgent 的 Git 仓库、 # Agent 仓库维护 -在本地维护 Git 配置,通过平台正常登录后的“同步 → 检查 → 发布”使新版本生效。适用于支持 SKILL.md 的本地 Agent;需要 Git 和可用的平台浏览器或已授权 API 客户端。本技能不提供凭据,也不依赖平台服务端文件访问。 +在本地维护 Git 配置,通过用户 API 密钥或平台正常登录后的“同步 → 检查 → 发布”使新版本生效。适用于支持 SKILL.md 的本地 Agent;需要 Git 和可用的平台浏览器或已授权 API 客户端。本技能不提供凭据,也不依赖平台服务端文件访问。 ## 确认目标与范围 从用户输入、仓库 remote、平台设置确认:仓库、绑定分支、平台地址、当前账号、Agent、具体修改及是否发布。已有明确授权就继续,不重复确认。用户只要编辑或只要同步时,停在该阶段。信息缺失先做可独立完成的检查,仅询问无法确定的项。 -打开平台核对绑定,记录当前发布版本以备回滚。名称不能替代真实 Agent ID,同名或同仓库多个 Agent 时需明确目标。03 仓库实例见 [references/dmate.md](references/dmate.md);其中地址是已知实例,不是所有任务的默认目标。 +通过 API 或平台页面核对绑定,记录当前发布版本以备回滚。名称不能替代真实 Agent ID,同名或同仓库多个 Agent 时需明确目标。03 仓库实例见 [references/dmate.md](references/dmate.md);其中地址是已知实例,不是所有任务的默认目标。 ## 修改与推送 @@ -22,7 +22,7 @@ description: 当用户通过本地 Agent 维护 DMate/DAgent 的 Git 仓库、 ## 线上刷新与验证 -使用当前环境提供的正规浏览器工具,先读取其操作说明,再基于实际页面操作。若已有授权 API 客户端,可使用参考文档中的接口。不要从浏览器提取 Cookie,不从服务器伪造登录,不修改检查记录,不关闭 TLS/同源校验。缺少登录时请用户正常登录,继续完成不依赖登录的本地工作。 +优先使用用户提供的 API 密钥,通过 `Authorization: Bearer …` 调用参考文档中的接口;先 GET /api/auth/me 确认所属用户,再 GET /api/state 确认绑定。密钥在“头像菜单 → 账号设置 → API 密钥”生成,权限等同所属用户。密钥放系统钥匙串、环境变量或仓库外权限 600 的配置文件,不写入 Git、技能、日志或命令行参数;请求由客户端在内存中构造请求头,禁止输出密钥。接口未部署或没有密钥时,使用当前环境提供的正规浏览器工具,先读取其说明,再基于页面操作。不要从浏览器提取 Cookie,不从服务器伪造登录,不修改检查记录,不关闭 TLS/同源校验。缺少密钥和登录时请用户正常登录,继续完成不依赖登录的本地工作。 1. 进入目标 Agent 的版本管理,执行同步,核对 commit 与本次推送的 SHA,记录平台返回的 versionId。SHA 不一致就停下:同步拉取的是当时分支 HEAD,不能顺手发布并发提交。 2. 查看该版本修改文件,确认内容;执行检查并等待明确结果。检查使用真实云沙箱,可能产生资源费用。检查失败不发布,报告错误;配置问题修复后重新提交,瞬时基础设施故障可重试一次同版本。请求超时先读版本状态,不重复创建检查。 diff --git a/.agents/skills/dmate/references/dmate.md b/.agents/skills/dmate/references/dmate.md index 2dec79a..c184fcd 100644 --- a/.agents/skills/dmate/references/dmate.md +++ b/.agents/skills/dmate/references/dmate.md @@ -1,6 +1,6 @@ # DMate 平台参考 -2026-09-21 根据 DAgentMarket 的 server/index.ts、releases.ts、sandbox-jobs.ts、release-check.ts 核实。上线实现可能变化,以当前页面和响应为准。 +2026-09-21 API 密钥功能已在本地实现,线上是否部署需实际核对。根据 DAgentMarket 的 server/index.ts、releases.ts、sandbox-jobs.ts、release-check.ts 核实。上线实现可能变化,以当前页面和响应为准。 已知测试实例: - Git:https://gitea.d-robotics.cc/peng01.guo/d-pi-03 @@ -24,7 +24,11 @@ | 固定版本试运行 | POST /api/agents/{id}/releases/{versionId}/trial | 返回会话及 versionId | | 新会话 | POST /api/conversations,JSON 为 {"agentId":"目标ID"} | 返回 versionId 与当前发布版本一致 | -写请求使用 application/json,无字段时发 {}。线上依赖正常 SSO 会话 Cookie;Origin 必须等于平台正式 origin,Host 必须匹配;可用 x-dmate-user 锁定已核实账号。不要假定支持 Bearer API token,不把 Cookie 写入技能、Git、命令参数或报告。401 走正常登录;403 检查来源与账号,不绕过认证。 +写请求使用 application/json,无字段时发 {}。API 密钥由 POST /api/auth/keys(JSON {"name":"本地 Agent"})生成,只在响应 token 字段显示一次;GET 同路径返回元数据列表,DELETE /api/auth/keys/{keyId} 撤销。首次生成需用户正常网页登录,后续有效密钥拥有同一用户的完整权限,包括管理密钥。 + +客户端请求头为 Authorization: Bearer dmate_…,无需 Cookie 或 Origin。若提供 Origin,仍必须匹配平台正式 origin;Host 也必须匹配。密钥从服务端记录映射到用户,x-dmate-user 仅作为账号一致性检查。无效 Bearer 返回 401,不回退到 Cookie。密钥默认长期有效,撤销立即阻止新请求并关闭事件流,但不会取消已启动的任务;最近使用时间按分钟记录。Bearer 调用 /api/auth/logout 会撤销当前密钥,不影响同时携带的 Cookie。 + +网页 Cookie 写请求仍需正常登录和正确 Origin。401 请用户检查密钥是否撤销或重新登录;403 检查来源,不绕过认证。不要从浏览器提取 Cookie。Git 凭据与平台密钥独立。 发布门禁:checkStatus 为 passed,report.passed 为 true,report.policyVersion 为 1。check 接口返回 capabilities,不返回上述版本状态,需另读 releases。检查 HTTP 超时不代表后台取消;读取状态确认,状态仍不明确就报告待确认,不盲目重试。