Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { Button } from '@/components/ui/button';
import { GithubConnectButton } from '@/features/cc-agent/GithubConnectButton';
/**
* IssueTrackerFeatureLayout — 「我的 Issue」页
* ---------------------------------------------------------------------------
* Issue 本体在 GitHub 上;本页解决的是「提交完就再也看不到了」。
*
* 口径:看自己的 issue 与提交 issue 走**同一条公共能力**,只要 Cindy 登录态,
* 不要求用户有 GitHub 账号 —— 所以本页任何状态下都**不得**提示「你需要连接
* GitHub」。用户自己的 GitHub 身份只是可选增强(把他直接在 GitHub 上提的也并进来),
* 没有它页面照常工作;连接入口仅用于可选的 GitHub 账号增强。
*
* 一条都没有时,页面退回原来的引导形态(告诉用户怎么用 /issue 提交)。
*
* **取数期间不换界面**(engineering-conventions §7),分两层做到:
* 1. 有落盘快照时首屏直接渲染上次的列表(useMyIssues 的 hydrate),内容立刻可读可点,
* fresh 一到原子替换 —— 常见路径上根本不存在「等待态」。
* 2. 没有快照(首次使用)时保留引导正文,但**不显示标题** —— 标题是结论,而这时还没查完。
* 上一版在这里显示「暂时查不到你的 Issue」,于是 GitHub 上有几十条的用户先被告知
* 查不到、再跳成列表:比 loading 文案更糟,因为它是错的。
* 进度反馈一律只放在 header 的刷新图标上(零布局变化)。
*
* 左侧 app 侧栏沿用 cc-agent 项目/对话列表(显式注册,避免冷启动直接进 /issues
* 时左栏空白,详见 useRegisterCCAgentSidebar)。
*/
import { useCallback } from 'react';
import { Bug, ExternalLink, RefreshCw } from 'lucide-react';
import { useNavigate } from 'react-router-dom';
import { useTranslation } from 'react-i18next';
import type { MyIssuesResult } from '@/../shared/myIssues';
import { cn } from '@/lib/utils';
import { InvisibleWindowDragStrip } from '@/components/layout/windowDrag';
import { useRegisterCCAgentSidebar } from '@/features/cc-agent/useRegisterCCAgentSidebar';
import { MyIssueList } from './MyIssueList';
import { useMyIssues } from './hooks/useMyIssues';
import { canTrustEmptyList, selectMyIssuesNotices } from './lib/myIssuesNotices';
import { prefillIssueCommandDraft } from './lib/startIssueChat';
const GITHUB_ISSUES_URL = 'https://github.com/makecindy/cindy/issues';
export function IssueTrackerFeatureLayout() {
const { t } = useTranslation();
const navigate = useNavigate();
// 沿用 cc-agent 侧栏;冷启动直接进 /issues 时也能播种,不留空白左栏。
useRegisterCCAgentSidebar();
const { data, hasFreshData, loading, refreshing, error, refresh } = useMyIssues();
const items = data?.items ?? [];
const hasItems = items.length > 0;
// 预填草稿 + 跳新建页,不自动发送 —— 用户还要在那条命令后面补描述。
const startIssueChat = useCallback(() => {
prefillIssueCommandDraft();
navigate('/cc-agent/new');
}, [navigate]);
return (
<div className="relative flex h-full w-full flex-col bg-content-area">
{/* mac 上本页不渲染通用 ContentHeader,顶部垫一条透明窗口拖拽条
(windowDrag.tsx 约定);它不吃点击,不挡下面的刷新按钮。 */}
<InvisibleWindowDragStrip />
<header className="flex shrink-0 items-center gap-3 px-6 pb-3 pt-8">
<h1 className="text-15 font-medium text-foreground">{t('issueTracker.list.header')}</h1>
{data ? <ViewerLine data={data} /> : null}
<div className="flex-1" />
<GithubConnectButton visible={!loading && !data?.githubEnhancement} />
<button
type="button"
onClick={refresh}
disabled={loading || refreshing}
title={t('issueTracker.mine.refresh')}
aria-label={t('issueTracker.mine.refresh')}
className={cn(
'flex size-7 items-center justify-center rounded-full text-sidebar-muted',
'transition-colors hover:bg-sidebar-item-hover hover:text-foreground',
'disabled:pointer-events-none disabled:opacity-50',
)}
>
{/* 动画挂外层 span,SVG 保持静态:挂在 SVG 上会每帧惊动主线程
(engineering-conventions「常驻动画必须 compositor-only」)。
首屏取数期间也转 —— 正文保持引导内容不动,这里是唯一的进度反馈,
且它零布局变化、不构成跳变。 */}
<span className={cn('inline-flex', (loading || refreshing) && 'animate-spinner')}>
<RefreshCw size={14} />
</span>
</button>
</header>
{/* 「怎么提交」常驻在 header 下方、**滚动区之外**:issue 多的时候放列表末尾
等于看不见。空态不渲染它 —— 那时 EmptyGuide 里已经有同一段说明。 */}
{hasItems ? <SubmitHintBar onStartIssueChat={startIssueChat} /> : null}
<div className="min-h-0 flex-1 overflow-y-auto px-3 pb-6 pt-2">
{error && !hasItems ? (
// 整页错误态只留给「从来没加载成功过」;已经有数据时刷新失败不能把列表
// 盖掉(useMyIssues 特意保留了旧 data),否则用户点一下刷新就丢失全部内容。
<LoadFailed onRetry={refresh} busy={refreshing} />
) : hasItems ? (
<>
{error ? <RefreshFailedNotice onRetry={refresh} busy={refreshing} /> : null}
<Notices data={data} />
<MyIssueList items={items} />
</>
) : (
<>
<Notices data={data} />
<EmptyGuide onStartIssueChat={startIssueChat} data={data} hasFreshData={hasFreshData} />
</>
)}
</div>
</div>
);
}
/**
* 说明文案里的 `/issue` —— 可点击,点了直接开一个预填好该命令的新对话。
* 两处说明(顶部条与空态)共用它,避免样式与行为各写一套;`size` 只差内边距,
* 视觉语言(等宽字 + 浅底 + hover 加深)一致。
*/
function IssueCommandButton({ onClick, size = 'sm' }: { onClick: () => void; size?: 'sm' | 'lg' }) {
const { t } = useTranslation();
return (
<button
type="button"
onClick={onClick}
title={t('issueTracker.mine.startIssueChat')}
aria-label={t('issueTracker.mine.startIssueChat')}
className={cn(
'rounded-full bg-sidebar-item-hover font-mono text-foreground',
'transition-colors hover:bg-sidebar-item-active',
size === 'lg' ? 'px-1.5 py-0.5' : 'px-1 py-0.5',
)}
>
/issue
</button>
);
}
/**
* 只在「恰好配了 GitHub 身份」时说明列表额外并入了谁名下的 issue。
* 没配时**什么都不显示** —— 提示「未连接」会重新制造「必须有 GitHub 账号」的暗示。
*/
function ViewerLine({ data }: { data: MyIssuesResult }) {
const { t } = useTranslation();
if (!data.githubEnhancement) return null;
return (
<span className="truncate text-12 text-sidebar-muted">
{t('issueTracker.mine.viewerGithub', { login: data.githubEnhancement.login })}
</span>
);
}
/** 降级 / 截断提示:数据没给全时必须明说(选取规则见 lib/myIssuesNotices)。 */
function Notices({ data }: { data: MyIssuesResult | null }) {
const { t } = useTranslation();
if (!data) return null;
const notices = selectMyIssuesNotices(data);
if (notices.length === 0) return null;
return (
<div className="mb-2 flex flex-col gap-1.5 rounded-xl bg-sidebar-item-hover px-3 py-2">
{notices.map((key) => (
<p key={key} className="text-11 leading-relaxed text-sidebar-muted">
{t(key)}
</p>
))}
</div>
);
}
/**
* 已有数据时刷新失败:降级成列表上方一条提示 + 重试,旧内容照常可读可点。
* 与整页 LoadFailed 复用同一组文案,只是不夺走内容区。
*
* 重试进行中**不清掉这条提示**:清了会让它消失、失败后又出现,两次跳变
* (engineering-conventions §7)。刷新状态由 header 图标表达,这里只把按钮禁用掉 ——
* 否则它看着可点、点了却被 useMyIssues 的 in-flight 静默挡掉,毫无反馈。
*/
function RefreshFailedNotice({ onRetry, busy }: { onRetry: () => void; busy: boolean }) {
const { t } = useTranslation();
return (
<div className="mb-2 flex flex-wrap items-center gap-x-2 gap-y-1 rounded-xl bg-sidebar-item-hover px-3 py-2">
<p className="text-11 text-sidebar-muted">{t('issueTracker.list.loadFailed')}</p>
<button
type="button"
onClick={onRetry}
disabled={busy}
className={cn(
'text-11 text-sidebar-muted underline-offset-2',
'hover:text-foreground hover:underline',
'disabled:pointer-events-none disabled:opacity-50',
)}
>
{t('issueTracker.list.retry')}
</button>
</div>
);
}
function LoadFailed({ onRetry, busy }: { onRetry: () => void; busy: boolean }) {
const { t } = useTranslation();
return (
<div className="flex flex-col items-start gap-2 px-3 py-2">
<p className="text-13 text-foreground">{t('issueTracker.list.loadFailed')}</p>
{/* 刻意不展示 main 侧错误原文:它可能带 userData 绝对路径,详情只进 main 日志。 */}
<button
type="button"
onClick={onRetry}
disabled={busy}
className={cn(
'text-12 text-sidebar-muted underline-offset-2',
'hover:text-foreground hover:underline',
'disabled:pointer-events-none disabled:opacity-50',
)}
>
{t('issueTracker.list.retry')}
</button>
</div>
);
}
/**
* 列表非空时的常驻说明条:同一段「怎么提交」的文案压成一行。
* 与空态的 EmptyGuide 共用同一组 i18n key,只是版式一个紧凑一个居中大版 ——
* 两处说法必须一致,不要各写一套。
*
* 它常驻占位,所以刻意压到最低存在感:11px 灰字 + 文字链,不用实心按钮
* (那是空态的主 CTA)。
*/
function SubmitHintBar({ onStartIssueChat }: { onStartIssueChat: () => void }) {
const { t } = useTranslation();
return (
<div
className={cn(
'flex shrink-0 flex-wrap items-center gap-x-1.5 gap-y-1',
'border-b border-border px-6 pb-2',
)}
>
<p className="text-11 leading-relaxed text-sidebar-muted">
{t('issueAgent.redirect.descriptionBefore')}
<IssueCommandButton onClick={onStartIssueChat} />
{t('issueAgent.redirect.descriptionAfter')}
</p>
<button
type="button"
onClick={() => window.electronAPI.openExternal(GITHUB_ISSUES_URL)}
className={cn(
'inline-flex items-center gap-1 text-11 text-sidebar-muted',
'underline-offset-2 transition-colors hover:text-foreground hover:underline',
)}
>
{t('issueAgent.redirect.cta')}
<ExternalLink size={11} />
</button>
</div>
);
}
/**
* 一条都没有时的引导:怎么提、去哪看。正文与 CTA 沿用改版前的整页引导;
* 标题换成空态该说的话 —— 原来那句「Issue 已迁移至 GitHub」是整页引导时代的说法,
* 现在这一页本身就是能用的列表,再说「已迁移」会让人以为页面没做。
*
* 标题分两版:只有三路查询都成功、确实为空时才敢说「还没有提交过 Issue」。任一路
* 降级或失败时它就是一句错误断言 —— 用户在 GitHub 上有几十条 issue、只是这次没查到,
* 页面却告诉他从没提交过(实际发生过,见 canTrustEmptyList)。
*/
function EmptyGuide({
onStartIssueChat,
data,
hasFreshData,
}: {
onStartIssueChat: () => void;
data: MyIssuesResult | null;
hasFreshData: boolean;
}) {
const { t } = useTranslation();
// 这一轮还没查完(或数据来自落盘快照)时**整个标题不渲染**:引导正文与 CTA 无论有没有
// issue 都成立,标题却是个结论。上一版在这里显示「暂时查不到你的 Issue」,于是有 35 条
// 的用户先被告知查不到、再跳成列表 —— 比 loading 文案更糟,因为它是错的。
// 标题从无到有是内容增加,不是形态替换。
const trustable = hasFreshData && data ? canTrustEmptyList(data) : false;
return (
<div className="flex flex-col items-center gap-4 px-8 py-16 text-center">
<div className="flex size-16 items-center justify-center rounded-full bg-sidebar-item-hover">
<Bug size={28} className="text-sidebar-muted" strokeWidth={1.5} />
</div>
{hasFreshData ? (
<h2 className="text-lg font-medium text-foreground">
{t(trustable ? 'issueTracker.mine.emptyTitle' : 'issueTracker.mine.emptyTitleUnverified')}
</h2>
) : null}
<p className="max-w-md text-sm text-sidebar-muted">
{t('issueAgent.redirect.descriptionBefore')}
<IssueCommandButton onClick={onStartIssueChat} size="lg" />
{t('issueAgent.redirect.descriptionAfter')}
</p>
<Button
variant="cta"
size="lg"
type="button"
onClick={() => window.electronAPI.openExternal(GITHUB_ISSUES_URL)}
className="mt-2"
>
{t('issueAgent.redirect.cta')}
<ExternalLink size={14} />
</Button>
</div>
);
}