Api Capability Discovery

Capability Discovery

GET /api/v1/capabilities 返回当前凭证允许调用的能力。每项含稳定 id、方法、路径、scope、摘要、写入和 destructive 属性。调用者应在启动时或权限变化后刷新，而不是维护静态 endpoint 白名单。

典型流程：

1. 创建最小 scope 的 API Token。
2. 调用 capability discovery，构建可用操作列表。
3. 对写操作生成幂等键并显示业务影响。
4. 保存 capability ID 和请求 ID 以关联审计。

发现结果受当前用户权限、Token refined scope 和启用插件影响。不可见能力不代表资源不存在，也不应通过错误探测来枚举。