Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* CCAgentFeatureLayout
* ---------------------------------------------------------------------------
* CC Agent 系统(原 ChatSystem)主功能的 Feature Layout。
*
* 职责:
* 1. 向 Shell 的 Sidebar 上半槽位注入 CC Agent 功能自己的内容
* (CCAgentSidebarUpper)
* 2. 通过 <Outlet /> 包装本功能内的所有 View 路由
*
* 路由结构(二层路由的"功能内路由"层):
* index → CCAgentIndexRedirect (默认 session 解析占位)
* :sessionId → CCAgentSessionView (具体 CCS 会话视图)
*
* 注意:这一层自身不消费 Shell 的宽度/折叠/底部用户信息区(那些都在
* MainLayout + Sidebar Shell 里),但作为二级路由 layout 必须把 MainLayout
* 下发的 Outlet context 原样透传给子路由(见下方 Outlet)——React Router 的
* useOutletContext 只穿透最近一层 Outlet,不透传会让子路由(CCAgentSessionView
* 等)断链拿不到右栏折叠态。
*/
import { useEffect } from 'react';
import { Outlet, useLocation, matchPath, useOutletContext } from 'react-router-dom';
import { resolveAgentIslandVisibleSessionIdFromPath } from '@/lib/agentIslandVisibleSessionRoute';
import { SplitGroup } from './SplitGroup';
import { useRegisterCCAgentSidebar } from './useRegisterCCAgentSidebar';
import { saveLastChatView, saveLastDocView } from './lib/lastViewStore';
export function CCAgentFeatureLayout() {
const location = useLocation();
// 注入 CC Agent 项目/对话侧栏到 Shell 上半槽位(SkillHub / IssueTracker 共用同一 hook)。
useRegisterCCAgentSidebar();
useTrackLastView();
// 透传 MainLayout 下发的 shell context。本层是二级路由 layout(MainLayout →
// cc-agent → :sessionId),useOutletContext 只读最近一层 Outlet,不在这里透传,
// 子路由(CCAgentSessionView / OrcaWorkflowRoute / WorkdirBrowseRoute)就拿不到
// 右栏折叠态 / 切换回调 / 在场声明回调(断链后右栏开关无法工作、面板无法声明在场)。
const shellContext = useOutletContext<{
sidebarWidth?: number;
rightSidebarCollapsed?: boolean;
onToggleRightSidebar?: () => void;
/** B2b:工具面板当前贴哪条边(布局树推导),展开入口按此落角。 */
rightSidebarSide?: 'left' | 'right';
setRightSidebarAvailable?: (available: boolean) => void;
/**
* 把"当前 cc-agent session id"推给 MainLayout,Shell/RSB 据此从 store 拉对应桶的 tab 列表。
* 仅 CCAgentSessionView 的路由主实例(ownsRoute=true)调用,内嵌实例(workdir-browse rail /
* OrcaSplitView)不调,避免覆盖主实例声明的 sessionId。
*/
setRightSidebarSessionId?: (sessionId: string | null) => void;
/**
* 把"当前 cc-agent session 的 workingDir"推给 MainLayout,Shell/RSB 注入 plugin ctx,
* file-browser plugin 据此 useFileTree / useFileContent。空串 = 尚未解析或 remote session。
* 同 setRightSidebarSessionId,仅主实例调。
*/
setRightSidebarWorkdir?: (
workdir: string,
remoteHostId?: string | null,
deviceLinkDeviceId?: string | null,
) => void;
} | null>();
return (
<SplitGroup
activeSessionId={resolveAgentIslandVisibleSessionIdFromPath(location.pathname) ?? undefined}
>
<Outlet context={shellContext} />
</SplitGroup>
);
}
/**
* 监听 cc-agent 内部路由切换,把当前位置写入 localStorage,供下次回到
* /cc-agent 时 CCAgentIndexRedirect 恢复。
*
* 命中规则(chat / doc 两个 slot 完全独立,互不覆盖):
* - /cc-agent/new → chat slot: { kind: 'new' }
* - /cc-agent/:sessionId → chat slot: { kind: 'session', sessionId }
* - /cc-agent/files/:sessionId → doc slot: { sessionId }
* - /cc-agent (index, 等待 redirect) / scheduled / 其它 → 不写
*/
function useTrackLastView(): void {
const location = useLocation();
useEffect(() => {
const path = location.pathname;
if (matchPath('/cc-agent/new', path)) {
saveLastChatView({ kind: 'new' });
return;
}
const filesMatch = matchPath('/cc-agent/files/:sessionId', path);
if (filesMatch?.params.sessionId) {
saveLastDocView({ sessionId: filesMatch.params.sessionId });
return;
}
const orcaMatch = matchPath('/cc-agent/orca/:sessionId', path);
if (orcaMatch?.params.sessionId) {
saveLastChatView({ kind: 'session', sessionId: orcaMatch.params.sessionId });
return;
}
// /cc-agent/:sessionId — 必须排除已经命中过的静态段(new / scheduled / files /
// boot)。boot 是副窗启动网关(SecondaryWindowBootGate),只是过渡路由、并非真实
// session,落它会污染 lastChatView。
const sessionMatch = matchPath('/cc-agent/:sessionId', path);
const sid = sessionMatch?.params.sessionId;
if (sid && sid !== 'new' && sid !== 'scheduled' && sid !== 'files' && sid !== 'boot') {
saveLastChatView({ kind: 'session', sessionId: sid });
}
}, [location.pathname]);
}