Files
claude-code/packages/remote-control-server/web/components/ACPMain.tsx
claude-code-best 2e9aaf4993 feat: ACP 协议版本 remote control (#293)
* fix: 添加 usage 字段缺失时的防御性防护

第三方 API(如智谱 GLM)在某些流式响应中不返回 usage 字段,
导致 usage.input_tokens 访问 undefined 崩溃并连锁影响后续所有请求。

- claude.ts: content_block_stop 创建消息时 fallback 到 EMPTY_USAGE
- LocalAgentTask.tsx: usage 为 undefined 时提前返回
- tokens.ts: getTokenCountFromUsage 加 null guard 和 ?? 0
- cost-tracker.ts: input_tokens/output_tokens 加 ?? 0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: ACP Plan 展示 — 支持 session/update plan 类型的可视化

补全 PlanUpdate 类型定义(PlanEntry/Priority/Status),新建 PlanView 组件
渲染进度条、状态图标和优先级标签,在 ChatInterface 中处理 plan 更新逻辑。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: 穷鬼模式下跳过 verification agent 以节省 token

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* test: 补充 RCS 后端 + 前端测试覆盖 (+116 tests)

后端新增 3 个测试文件 (70 tests):
- automationState: normalize/snapshot/equals 纯函数
- client-payload: toClientPayload 协议转换
- transport-normalize: normalizePayload + extractContent

前端新增 2 个测试文件 (46 tests):
- utils: formatTime/statusClass/truncate/extractEventText 等
- api-client: getUuid/setUuid/api GET/POST 错误处理

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: RCS ACP 页面添加权限模式选择器 + 权限响应修复

- 新增权限模式选择器 UI(6种模式:默认/自动接受编辑/跳过权限/规划/不询问/自动判断)
- 权限模式通过 ACP _meta 从 web → acp-link → agent 全链路传递
- 修复 PermissionPanel 点击"允许"发送 cancelled 而非 selected 的 bug
- 权限模式和模型选择持久化到 localStorage
- acp-link 直接连接路径同步支持 permissionMode 透传

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: RCS Web UI 重构 + QR 修复 + ACP 扫描自动跳转

- RCS Web UI 组件全面重构: Dialog 迁移 Radix UI, lazy loading,
  主题系统改进, 组件样式优化
- IdentityPanel QR 码显示修复: requestAnimationFrame 延迟绘制
  解决 Radix Dialog Portal 挂载时序问题
- ACP QR 扫描自动跳转: IdentityPanel 扫描 ACP 格式 { url, token }
  后存储 sessionStorage 并跳转 /code/?acp=1
- 新增 ACPDirectView 组件: ACP 直连视图, 用 ACPClient 连接并
  渲染 ACPMain 聊天界面

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: ACP 权限管道改进 — 模式同步 + bypass 检测 + 统一权限流水线

- agent.ts: applySessionMode 同步 appState.toolPermissionContext.mode
- agent.ts: bypassPermissions 可用性检测 (非 root 或 sandbox 环境)
- permissions.ts: createAcpCanUseTool 接入 hasPermissionsToUseTool
  统一权限流水线, 替代原来分散的处理逻辑
- permissions.ts: 支持 onModeChange 回调, 模式变更时实时同步

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: acp-link 支持 permissionMode 默认值传递给 agent

客户端 (Zed/VS Code 等) 的 new_session 不一定携带 permissionMode,
导致 agent 收到 _meta: undefined, permission 回退到 default。

修复: handleNewSession 使用 fallback 链:
  客户端传值 > config.permissionMode > ACP_PERMISSION_MODE 环境变量

使用: ACP_PERMISSION_MODE=auto acp-link claude

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: 更新文档及说明

* fix: 修复类型错误

* chore: 提交脚本

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-18 21:54:22 +08:00

244 lines
8.1 KiB
TypeScript

import { useState, useCallback, useEffect, useMemo } from "react";
import type { ACPClient } from "../src/acp/client";
import type { AgentSessionInfo } from "../src/acp/types";
import { ChatInterface } from "./ChatInterface";
import { cn } from "../src/lib/utils";
import { MessageSquare, Plus, PanelLeftClose, PanelLeft } from "lucide-react";
interface ACPMainProps {
client: ACPClient;
agentId?: string;
}
/**
* Main container — Anthropic sidebar + chat layout.
* Sidebar: sectioned by recency, orange active state, warm raised bg.
*/
export function ACPMain({ client, agentId }: ACPMainProps) {
const [sidebarCollapsed, setSidebarCollapsed] = useState(false);
// Handle session selection
const handleSelectSession = useCallback(async (session: AgentSessionInfo) => {
try {
if (client.supportsLoadSession) {
await client.loadSession({ sessionId: session.sessionId, cwd: session.cwd });
} else if (client.supportsResumeSession) {
await client.resumeSession({ sessionId: session.sessionId, cwd: session.cwd });
} else {
throw new Error("Loading or resuming sessions is not supported by this agent.");
}
} catch (error) {
console.error("Failed to load/resume session:", error);
}
}, [client]);
return (
<div className="flex h-full w-full">
{/* 侧边栏 — Anthropic warm sidebar, hidden on mobile */}
<div
className={cn(
"hidden md:flex flex-col border-r border-border/60 bg-surface-1/50 transition-all duration-200 flex-shrink-0",
sidebarCollapsed ? "w-12" : "w-64",
)}
>
{/* 头部 */}
<div className="flex items-center justify-between px-3 py-4">
{!sidebarCollapsed && (
<span className="text-xs font-display font-semibold text-text-muted uppercase tracking-widest px-1"></span>
)}
<div className={cn("flex items-center gap-0.5", sidebarCollapsed && "mx-auto")}>
{!sidebarCollapsed && (
<button
type="button"
onClick={() => {
// ChatInterface handles new session internally
}}
className="h-7 w-7 flex items-center justify-center rounded-lg text-text-muted hover:text-brand hover:bg-brand/10 transition-colors"
title="新会话"
>
<Plus className="h-4 w-4" />
</button>
)}
<button
type="button"
onClick={() => setSidebarCollapsed(!sidebarCollapsed)}
className="h-7 w-7 flex items-center justify-center rounded-lg text-text-muted hover:text-text-primary hover:bg-surface-2 transition-colors"
>
{sidebarCollapsed ? (
<PanelLeft className="h-4 w-4" />
) : (
<PanelLeftClose className="h-4 w-4" />
)}
</button>
</div>
</div>
{/* 会话列表 */}
{!sidebarCollapsed && (
<div className="flex-1 overflow-y-auto">
<SidebarSessionList client={client} onSelectSession={handleSelectSession} />
</div>
)}
</div>
{/* 聊天区域 */}
<div className="flex-1 flex flex-col min-w-0">
<ChatInterface client={client} agentId={agentId} />
</div>
</div>
);
}
// =============================================================================
// 侧边栏会话列表 — Anthropic 分段式(今天/昨天/更早)
// =============================================================================
function SidebarSessionList({
client,
onSelectSession,
}: {
client: ACPClient;
onSelectSession: (session: AgentSessionInfo) => void;
}) {
const [sessions, setSessions] = useState<AgentSessionInfo[]>([]);
const [loading, setLoading] = useState(true);
const [activeId, setActiveId] = useState<string | null>(null);
const loadSessions = useCallback(async () => {
if (!client.supportsSessionList) {
setLoading(false);
return;
}
setLoading(true);
try {
const response = await client.listSessions();
setSessions(response.sessions);
} catch (err) {
console.warn("[SidebarSessionList] Failed to load:", err);
} finally {
setLoading(false);
}
}, [client]);
useEffect(() => {
if (client.getState() === "connected" && client.supportsSessionList) {
loadSessions();
}
}, [client, loadSessions]);
useEffect(() => {
const handler = (state: string) => {
if (state === "connected") {
setTimeout(loadSessions, 200);
}
};
client.setConnectionStateHandler(handler);
return () => client.removeConnectionStateHandler(handler);
}, [client, loadSessions]);
useEffect(() => {
const interval = setInterval(loadSessions, 10000);
return () => clearInterval(interval);
}, [loadSessions]);
const sorted = useMemo(
() =>
[...sessions].sort((a, b) => {
const dateA = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
const dateB = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
return dateB - dateA;
}),
[sessions],
);
if (loading && sessions.length === 0) {
return (
<div className="flex items-center justify-center py-8">
<span className="text-xs text-text-muted font-display">...</span>
</div>
);
}
if (sessions.length === 0) {
return (
<div className="flex items-center justify-center py-8">
<span className="text-xs text-text-muted font-display"></span>
</div>
);
}
// 按日期分组
const groups = groupByRecency(sorted);
return (
<nav className="py-1" aria-label="历史会话">
{groups.map((group, gi) => (
<div key={group.label}>
{gi > 0 && <div className="mx-3 my-2 border-t border-border/40" />}
<div className="px-4 py-2">
<span className="text-[10px] font-display font-semibold uppercase tracking-widest text-text-muted/70">
{group.label}
</span>
</div>
{group.sessions.map((session) => (
<button
key={session.sessionId}
type="button"
onClick={() => {
setActiveId(session.sessionId);
onSelectSession(session);
}}
className={cn(
"w-full flex items-center gap-2.5 px-4 py-2 text-left transition-colors rounded-none",
session.sessionId === activeId
? "bg-brand/8 text-text-primary"
: "text-text-secondary hover:bg-surface-2/60 hover:text-text-primary",
)}
title={session.title || session.sessionId}
>
<MessageSquare className="h-3.5 w-3.5 flex-shrink-0 opacity-50" />
<span className="text-[13px] font-display truncate leading-snug">
{session.title && session.title.trim() ? session.title : "新会话"}
</span>
</button>
))}
</div>
))}
</nav>
);
}
// =============================================================================
// 按日期分组:今天 / 昨天 / 更早
// =============================================================================
interface SessionGroup {
label: string;
sessions: AgentSessionInfo[];
}
function groupByRecency(sessions: AgentSessionInfo[]): SessionGroup[] {
const now = new Date();
const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
const yesterday = new Date(today.getTime() - 86400000);
const groups: SessionGroup[] = [
{ label: "今天", sessions: [] },
{ label: "昨天", sessions: [] },
{ label: "更早", sessions: [] },
];
for (const session of sessions) {
const date = session.updatedAt ? new Date(session.updatedAt) : new Date(0);
if (date >= today) {
groups[0].sessions.push(session);
} else if (date >= yesterday) {
groups[1].sessions.push(session);
} else {
groups[2].sessions.push(session);
}
}
return groups.filter((g) => g.sessions.length > 0);
}