Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 「我的 Issue」页顶部提示的选取规则(纯函数,返回 i18n key)。
*
* 抽出来的原因:这里是产品判断而不是渲染细节 —— 哪些降级值得打扰用户、哪些不值得,
* 需要能被单测钉住,不该埋在组件里。
*
* 贯穿本文件的一条判据:**提示不得断言页面上不存在的数据范围**。「只显示本机记录」
* 这类结论必须先确认列表里真的没有远端内容,否则它会与同一页列出的东西自相矛盾。
*/
import type { MyIssuesResult } from '@/../shared/myIssues';
/**
* 列表里是否有远端数据。判据用 state —— 账本兜底项一律 `unknown`,任何带真实状态的
* 条目都只能来自远端(平台通道或 GitHub 增强)。
*
* 刻意**不**看 `sources.includes('github-account')`:账本里 identity 为 github-user
* 的记录也会打这个来源(那是提交时就确认的事实),所以它不再等价于「来自远端」。
*/
function hasRemoteData(data: MyIssuesResult): boolean {
return data.items.some((item) => item.state !== 'unknown');
}
/**
* 平台那一路拿不到数据时的提示。`platform-unavailable`(接口还没上线)与 `fetch-failed`
* (网络 / 服务端异常)**结构完全相同** —— 都是「平台侧的历史与实时状态都拿不到」,
* 区别只在原因,所以共用一份逻辑,不各写一遍。
*
* 两条都**无条件提示**。先前 platform-unavailable 只在「列表里有 unknown 项」时才提示,
* 想省掉接口上线前的常驻横幅,但那个优化会造出更坏的结果:账本为空(新设备、重装、或
* 提交早于账本功能)时一条提示都没有,页面直接显示「还没有提交过 Issue」——
* 空的本机兜底**不能证明远端历史为空**,于是把「暂时查不到」说成了「你从未提交」。
* 噪音只是烦,错误信息是骗人的,后者更糟。
*
* 措辞按列表里有没有远端内容选:混合列表用不带「仅本机」结论的那版。
*/
function platformNoticeKey(data: MyIssuesResult, reason: 'unavailable' | 'fetchFailed'): string {
const suffix = hasRemoteData(data) ? 'PartialHint' : 'Hint';
const base = reason === 'unavailable' ? 'platformUnavailable' : 'fetchFailed';
return `issueTracker.mine.${base}${suffix}`;
}
/**
* 列表是否**可被确证是完整的** —— 只有三路**都真查过且都成功**才算。
*
* 空态标题靠它决定能不能说「还没有提交过 Issue」。三个条件各有必要:
* - `degraded === null` —— 平台通道成功;
* - `githubEnhancement !== null` —— GitHub 账号那一路**真的查过**。没配增强时它是 null,
* 而 `githubEnhancementFailed` 也会是 false(没配不是失败)—— 只看后者就会把「从未
* 查过」当成「查过且为空」,对直接在 GitHub 上提过 issue 的用户重演本次要修的错误
* 断言。平台侧不知道用户绕过 Cindy 直接提的那些,只有增强查得到;
* - `!githubEnhancementFailed` —— 那一路没有中途失败。
*
* 代价是「还没有提交过 Issue」只在配了增强的用户身上出现,没配的用户看到的是
* 「暂时查不到」。这是刻意的保守 —— 本页反复确立的原则:错误信息比保守措辞更糟。
*/
export function canTrustEmptyList(data: MyIssuesResult): boolean {
return (
data.degraded === null && data.githubEnhancement !== null && !data.githubEnhancementFailed
);
}
export function selectMyIssuesNotices(data: MyIssuesResult): string[] {
const notices: string[] = [];
if (data.degraded === 'platform-unavailable') {
notices.push(platformNoticeKey(data, 'unavailable'));
}
// 未登录:文案讲的是「登录后能看到全部与最新状态」,不含「仅本机」结论,
// 无论列表里有没有远端内容都成立,所以只有这一条不需要分版本。
if (data.degraded === 'not-signed-in') {
notices.push('issueTracker.mine.notSignedInHint');
}
if (data.degraded === 'fetch-failed') {
notices.push(platformNoticeKey(data, 'fetchFailed'));
}
// 可选增强配了却没用上:主来源的提示在前,这条补充说明「你 GitHub 那部分也没进来」。
// 只在**兜底通道也没救回来**时出现 —— 回退成功就没有可见损失,不打扰用户。
//
// 按来源分两版,**默认落在通用版**,只有确知是插件通道才给插件专属排障。
//
// 三种 failed 现场,只有第一种能指向插件页:
// - source === 'ghost' —— 插件 PAT 搜不动本仓(实测 422),提示去插件页检查是对的;
// - source === 'gh-cli' —— 用户根本没在用插件,gh 用的是完整 OAuth token,
// 失败多为网络或额度,指向插件页等于指向一个不存在的页面;
// - githubEnhancement === null —— 配了却连身份都没问出来(token 过期 / 撤销 / 限流),
// 此时**连来源都不知道**,更不能断言是插件的问题。
//
// 判据刻意写成「是不是 ghost」而不是「是不是 gh-cli」:未知情况必须落在保守那一版。
// 反过来写(`=== 'gh-cli' ? 通用 : 插件`)会把上面第三种现场误判成插件故障 ——
// 与本页反复栽的同一个坑:default 分支断言了自己并不知道的事。
if (data.githubEnhancementFailed) {
notices.push(
data.githubEnhancement?.source === 'ghost'
? 'issueTracker.mine.enhancementFailedHint'
: 'issueTracker.mine.enhancementFailedGenericHint',
);
}
if (data.truncated) {
notices.push('issueTracker.mine.truncatedHint');
}
return notices;
}