feat(kook): P2 KOOK 专属页+后端 admin 端点(design/17 §2/§4)

后端(KOOK REST, 复用 httpclient WithAuthScheme(Bot), token不打印):
- kook/admin.go(新): ListFriends/HandleFriendRequest/DeleteFriend/BlockFriend/
  ListUserChats/CreateUserChat/ListDirectMessages
- kook/admin_guild.go(新): ListGuilds/ListGuildChannels/ListGuildUsers/ListChannelMsgs/SendTestMessage
- gateway/admin_channels_platform.go(新): kookAdmin(反射解包namedAdapter命中内嵌PlatformAdapter)
  + 4 handler + adminKookView聚合(子项失败记errors不伪造)
- server.go 注册 4 条 ownerAuth 路由: /view /friends /friend/handle /message/test
- admin.go/admin_write_channel_config.go: AdminChannelAccount 加 Capabilities
前端(KOOK 专属页):
- KookPanel.tsx(新): 好友&申请/服务器/频道/成员/私信会话/发消息测试卡片
- AdapterDetailPage.tsx: platform==='kook' 渲染 KookPanel, 否则通用
- types.ts/api.ts: KOOK 类型 + adminChannelPlatformView/Friends/FriendHandle/MessageTest
文档: Docs/api-client.md 新增4端点契约(owner-only)+capabilities+v0.17
验收: go build/vet/test ./... 全绿 + npm run build 97模块全绿; 零新依赖
注: api.ts/types.ts 集中契约文件>500行属既有结构(未新增违规); KOOK其余REST方法留能力面待用

frontend/web/src/lib/api.ts

@@ -31,6 +31,9 @@ import type {
   Mode,
   PersonaRecord,
   PersonaUpsertRequest,
+  KookFriendList,
+  KookMessageTestResult,
+  KookViewResponse,
   RagIndexRequest,
   Role,
   SessionMeta,
@@ -592,6 +595,50 @@ export function adminDeleteChannelAccount(platform: string, id: string): Promise
     method: "DELETE",
   });
 }
+/** GET /api/v1/admin/channels/{platform}/view — one platform account's aggregated
+ *  panel data (friends / servers / channels / members / private chats), owner only. */
+export function adminChannelPlatformView(platform: string, accountId?: string): Promise<KookViewResponse> {
+  const q = accountId ? `?accountId=${encodeURIComponent(accountId)}` : "";
+  return request<KookViewResponse>(`/admin/channels/${encodeURIComponent(platform)}/view${q}`);
+}
+/** GET /api/v1/admin/channels/{platform}/friends?type= — friend/request/blocked list. */
+export function adminChannelPlatformFriends(
+  platform: string,
+  type: string,
+  accountId?: string,
+): Promise<KookFriendList> {
+  const q = new URLSearchParams();
+  if (type) q.set("type", type);
+  if (accountId) q.set("accountId", accountId);
+  const qs = q.toString();
+  return request<KookFriendList>(`/admin/channels/${encodeURIComponent(platform)}/friends${qs ? `?${qs}` : ""}`);
+}
+/** POST /api/v1/admin/channels/{platform}/friend/handle — accept/reject a friend request. */
+export function adminChannelFriendHandle(
+  platform: string,
+  id: number,
+  accept: boolean,
+  accountId?: string,
+): Promise<{ handled: boolean; id: number; accept: boolean }> {
+  const q = accountId ? `?accountId=${encodeURIComponent(accountId)}` : "";
+  return request<{ handled: boolean; id: number; accept: boolean }>(
+    `/admin/channels/${encodeURIComponent(platform)}/friend/handle${q}`,
+    { method: "POST", body: JSON.stringify({ id, accept }) },
+  );
+}
+/** POST /api/v1/admin/channels/{platform}/message/test — send one test message. */
+export function adminChannelMessageTest(
+  platform: string,
+  targetId: string,
+  content: string,
+  accountId?: string,
+): Promise<KookMessageTestResult> {
+  const q = accountId ? `?accountId=${encodeURIComponent(accountId)}` : "";
+  return request<KookMessageTestResult>(`/admin/channels/${encodeURIComponent(platform)}/message/test${q}`, {
+    method: "POST",
+    body: JSON.stringify({ targetId, content }),
+  });
+}
 /** POST /api/v1/admin/plugins/install — honest 501 (needs a plugin source). */
 export function adminPluginInstall(req: { name: string; kind: string; description: string }): Promise<AdminPluginRecord> {
   return request<AdminPluginRecord>("/admin/plugins/install", { method: "POST", body: JSON.stringify(req) });