Starcat 更新日志

这里记录 Starcat 的重要变化，内容用于发布说明。

1.5.0

Starcat 1.5.0 围绕发现、整理和回顾 GitHub 仓库进行了全面扩展：新增 Awesome 发现、Spotlight 系统搜索、GitHub Lists 与批量 AI 整理、GitHub 贡献小组件，并继续完善活动会话、README 阅读和仓库洞察体验。

新增

• Agent 多 Runtime：Agent 工作台可在内置 Runtime、Codex App Server 与 DeepSeek Harness 间切换，并复用 Starcat 的仓库上下文、知识检索和业务工具；支持服务商、模型、配置检测、执行轨迹与运行指标。

• Awesome 发现：通过 Starcat 精选或自定义 Awesome 来源发现项目，按来源和章节浏览、搜索、筛选及批量选择仓库，并查看仓库文件与外部资源。

• Awesome 来源管理：可添加公开 GitHub Awesome 仓库作为来源，在后台解析并显示进度；支持手动刷新，网络失败时继续使用本地缓存。
• Spotlight 仓库搜索：通过 macOS Spotlight 搜索已 Star 仓库及本地笔记，并直接打开 Starcat 定位到对应详情；仓库标题旁可一键复制完整名称。

• GitHub Lists 整理：支持仓库加入多个 GitHub List，并使用 AI 生成分组建议；应用前可预览、筛选和调整结果，也可新建分组、删除建议或重新分组。

• 批量 AI 工作台：多选仓库后批量生成摘要、标签和分组建议，通过统一任务队列查看进度并在同一窗口审核；每次任务可选择代码上下文和外部搜索。
• 自动 AI 整理：可为 GitHub Lists 配置自动整理范围和调度策略；默认保留人工审核，也可由用户主动开启自动确认。
• GitHub 贡献小组件：新增贡献概览、贡献摘要、年度热力图和贡献雷达图，可查看今日贡献、单日峰值、贡献总数及 Commit、Issue、PR、评审等活动结构。
• GitHub 服务状态：主窗口状态面板接入 GitHub 官方状态，可直接查看当前服务是否正常。
• README 页内搜索：在 README 中按 ⌘F 打开查找条并切换匹配项；列表搜索默认调整为 ⌘⇧F，两组快捷键都可在设置中修改。
• 仓库文档与视频：可选择在 Starcat 独立窗口打开同仓 Markdown 文档，并使用原生控件播放支持的 GitHub README 视频。

• 洞察安全公告与 Release 附件：查看最新安全公告、风险等级和 GHSA / CVE 信息，也可浏览、复制或下载最新 Release 附件。

• 活动后台通知：Starcat 运行时无需打开活动页，即可收到 Issue、PR 和 Discussion 更新，并区分关闭、重开与合并等状态变化。
• 活动状态与筛选：Issue / PR 显示打开、关闭或已合并状态；Star、Unstar 和 Fork 显示是否已入库，并可按状态组合筛选。
• Issue 会话操作：展示开帖标题、标签和事件流；支持粘贴图片、预览 Markdown、复制链接或正文、引用回复，以及编辑自己的开帖和评论。

• 公开 Star 数据贡献：新增默认关闭的隐私选项，可匿名贡献公开仓库 ID 与可用 Star 时间，用于改进仓库推荐；失败不会影响正常同步。
• 分享与开源入口：仓库健康、仓库洞察和收藏统计支持复制分享文案；分享卡与导出内容补充 Starcat 来源，帮助菜单和关于页可直达源码仓库。
• Star 趋势图片分享：仓库洞察中的 Star 趋势卡片可直接复制为图片，导出时保留仓库身份和头像，便于保存或分享。
• 自研仓库推荐：Direct 版接入离线训练推荐结果，在现有相似仓库入口展示模型校准后的匹配度，并按模型版本刷新缓存。

优化

• Awesome 浏览体验：来源、章节和仓库列表改为增量加载与稳定分页，完善来源搜索、真实描述、仓库元数据、刷新进度和三栏布局。
• AI 整理体验：未分组入口移至中栏横幅，开始前可创建分组；任务队列展示仓库头像、描述、状态统计和审核结果，并支持放弃或继续未完成会话。
• AI 处理性能：批量摘要、标签和分组任务采用有界并行处理，生成结果按仓库即时展示，大量仓库下的窗口打开、审核和滚动更加流畅。
• 长列表加载：活动、探索、Awesome、Release、知识库和 AI 审核等列表统一提前分页加载，快速滚动时不再容易丢失后续数据。
• AI 用量统计：用量面板增加预估费用、计价覆盖率和持久化快照，便于了解不同模型与任务的消耗。
• 桌面小组件：重新整理 Focus、仓库回顾、收藏趋势和 Release Watch 的视觉层级与热力图布局；移除内容稀疏的大尺寸规格。
• Issue 本地状态：评论、事件流和未提交草稿按会话缓存，切换帖子或重启 Starcat 后仍可继续；可在设置中分别清理。
• Release 附件下载：下载行实时显示进度，完成后通过 Toast 展示保存位置并可直接打开。
• 标签与分组编辑：标签合并改用 Sheet 选择目标，候选顺序和默认选中更可预期，并统一标签与 GitHub List 分组弹窗标题。
• 界面细节：快捷键修饰键与主键改为独立键帽，时间线空详情增加选择引导，推荐标签使用更清晰的分行和悬停效果。
• Agent Runtime 诊断：完善 Runtime 自动识别、配置文档、可选能力和失败提示，执行时间线可查看思考摘要、工具调用、错误、产物和费用估算；工作区标题增加 Beta 标识以明确预览状态。

修复

• 账户数据隔离：从缓存恢复登录态时先切换到对应账户数据库，避免短暂读取或写入其他账户的数据。
• Release notes 图片：活动时间线中的截图按窗口宽度等比缩放，不再被裁切。
• README 与评论翻译：切换仓库或会话时不再混入上一项翻译；开帖和每条评论都可正确显示对照翻译。
• 评论框切换：切换到其他 Issue 时立即停止当前 AI 生成并收回编辑框，不会把草稿带到新帖子。
• 活动入库状态：从时间线加入知识库后只更新入库标记，不再关闭当前详情或重置选择。
• Star 数量同步：在管理、探索和活动中 Star 或取消 Star 后，列表与详情的数量立即保持一致。
• 仓库社区信号：正确识别目录形式的 GitHub Issue Forms，不再误判为缺失。
• AI 摘要窗口：展开后保持在 README / 洞察切换栏下方，不再遮挡页面导航。

1.4.0

Starcat 1.4.0 在活动页接入 GitHub 通知：不必打开浏览器，也能处理被 @、评审请求和 Issue / PR 会话，并继续打磨知识库索引与探索体验。

重要更新：Starcat 在线服务已完成升级，请尽快更新至 1.4.0。旧版本仍可查看已有本地缓存，但在线刷新、推荐、发现、Wiki 和分享等服务将不再可用。

新增

• GitHub 通知收件箱：在活动页查看被 @、评审请求、指派、讨论、Release 和安全公告；可按未读、提及、评审、Issue、PR 等类型筛选，并按今天、昨天、本周和更早分组。「全部」还会把你自己的 Star、Unstar、Fork 按时间排在一起。时间线可区分 Issue / PR，头像和用户名可打开 GitHub 主页，Dependabot 使用官方圆形图标；看过的条目保持已读，刷新时同步按钮会转动。缺少通知权限时会提示重新授权，也可在系统通知中心收到提醒。

• Issue / PR 会话：选中后阅读开帖和评论，撰写或预览回复，并支持上一条 / 下一条。完成等同 GitHub Inbox 的 Done，不会关闭 Issue；确认仍开放时可关闭，已关闭的可重新打开。也可在 GitHub 打开，或在 Starcat 打开对应仓库。
• AI 撰写评论：空输入时按当前会话起草回复，有草稿时润色并补全。回复语言跟帖子走，不跟草稿或 App 界面语言。
• 通知会话翻译：对照或全文翻译开帖和全部评论，标题、仓库名和输入框保持原文。目标语言可自动跟随界面；已经是目标语言的段落会跳过，新译文会短暂淡入。
• 本机 CLI 推理：Direct 版知识库 RAG 可选择 Codex CLI 或 Claude Code CLI；设置页会检测安装、版本和路径，未安装时提供指引。

优化

• 外部 CodebaseMemory 运行时：Direct 版不再内置大体积可执行文件，可自动检测当前官方安装，也可在设置中手动选择。
• 长思考流畅度：知识库问答与仓库 AI 对话中，较长的思考过程不再把界面拖卡，完成后仍可展开阅读全文。
• AI 索引上次预拉：打开设置即可看到上次完成时间和计数，并用绿、橙、红标识结果。
• 外部索引连接测试：Meilisearch 与 Qdrant 各自显示结果，文案紧贴「测试并保存」，成功为绿勾、需重建为橙警告、失败为红叉。
• 语义搜索进度：一点击先转忙碌细环，已是最新的仓库会推进进度环，且只补缺或过期向量。
• 语义相关度百分比：与同行语言、Stars、Forks 同字号。
• 知识库分片状态：详情区分分片是否仍在知识库，以及当前模型的向量化状态。
• 知识库向量化进度：按当前模型已就绪覆盖率显示，最近一次构建不再误标完成，并可从工具栏状态面板查看与暂停。
• 索引问题分片：点击待处理、失败或过期卡片即可打开知识库并定位到对应分片。
• Meilisearch 关键词索引：重建知识库时先同步文本，不必等全部向量化完成即可检索。
• 知识库中文检索：中文中缀可检索；点名仓库时更稳地落到 README 等已索引内容。
• 快捷键录制控件：加宽按键显示区域，仅在用户修改快捷键后在输入框内显示恢复默认入口。
• README 翻译：目标语言可设为自动（跟随界面语言），已是目标语言的段落不再翻译，新译文会短暂淡入。
• 翻译与 AI 撰写错误：失败时在右下角 toast 提示；AI 配置不完整时可前往设置。
• 首次操作引导：去掉与系统提示叠层，统一为黄色胶囊。
• 活动页数量与说明：列表数量改到系统标题栏 subtitle，分类说明入口挪到中栏。
• 通知时间线分页：距离底部约 8 条时提前加载下一页，长列表滚动不必等到触底。

修复

• 3D 代码图谱启动：复用账户级共享图谱服务与仓库路由，修复已安装仍提示未找到，以及共享 daemon 缓存冲突导致的端口超时。
• 查询规划时间线：思考收成查询规划的子步骤，计划结果和右侧计划面板在规划真正完成后才出现。
• 暂停向量化：取消 embedding 不再被当成网络不可用，进度也不会弹回。
• 全局筛选面板：修复打开仓库筛选时的明显延迟，现在可以更快响应。
• 探索离线缓存：后端暂时不可用时立即显示“发现”“热门”和“新发布”的本地数据，不再长时间停留在骨架屏。
• 探索分类数量：首次打开时恢复“发现”“热门”“新发布”和“周刊”的缓存数量，无需逐项点击。

1.3.0

Starcat 1.3.0 新增“我的项目”、全局与单仓库洞察、macOS 桌面小组件、可复用于 AI 与 RAG 的洞察上下文，以及 Alfred、uTools 和 Raycast 外部搜索集成，帮助你管理、理解并更快找回仓库。

新增

• 我的项目：集中查看个人、组织及外部协作仓库；通过 GitHub App 按授权范围浏览公开、私有和 Internal 项目，并继续使用现有筛选、详情与 Star 趋势。
• 我的洞察：从全部收藏或知识库范围查看整理进度、技术分布、项目状态与待处理事项，并可直接下钻到对应仓库列表。

• 仓库洞察：查看 Star 增长、协作活动、提交趋势、贡献者、发布节奏、项目健康度、社区规范与安全信号；切换仓库和刷新时保持内容稳定。

• 仓库洞察上下文：生成后的洞察可复用于 AI 摘要、仓库对话与 RAG 回答，并以可移除的只读 XML 上下文展示，同时准确说明不可用、自定义提示词未注入和回退状态。
• macOS 桌面小组件：提供 Starcat Focus、今日重逢、Release Watch 和收藏趋势，可在桌面查看常用仓库、每日推荐、未读 Release 与近期收藏增长，并点击直达对应内容。

• Alfred Workflow：可直接从 Alfred 搜索 Starcat 本地仓库与 GitHub。查看项目
• uTools 插件：可直接从 uTools 搜索 Starcat 本地仓库与 GitHub。查看项目
• Raycast Extension：可直接从 Raycast 搜索 Starcat 本地仓库与 GitHub。查看项目

优化

• 洞察聚合复用：我的洞察和仓库洞察数据将作为上下文参与 RAG 知识库问答。
• RAG 提示词设置：支持对照并复制只读默认提示词，问答与对话压缩模板采用更清晰的 Markdown 排版。
• 自定义提示词诊断：明确显示自定义模板支持的上下文能力与占位符，且不再自动改写用户内容。
• 首次使用引导：新增功能截图并优化欢迎音效、卡片层级和窗口尺寸，让首次浏览更加稳定。

修复

• 分享卡片主题切换：版式与配色按钮现在使用完整、连续的点击区域，消除边缘和按钮间隙偶发无响应。
• RAG 引用证据：关键词检索命中的元数据分片与知识库统计事实现在会显示实际引用片段，无需向量化也能在回答及历史会话中核验来源。

1.2.0

Starcat 1.2.0 聚焦稳定性、易用性与界面观感：新增 18 种语言界面，并补齐置顶、分享链接、快捷键与 README 能力，持续打磨导航、标签、笔记、翻译与知识库等常用路径。

新增

• 18 种语言界面：Starcat 现支持英语、简体中文、繁体中文、日语、韩语、德语、法语、西班牙语、巴西葡萄牙语、意大利语、俄语、荷兰语、波兰语、乌克兰语、土耳其语、越南语、印度尼西亚语和阿拉伯语。
• Manage 仓库置顶：支持 Pin / Unpin，按最近置顶优先排列，卡片左上角显示置顶标识。
• 仓库分享链接：点击后在 Starcat 中打开并定位到对应仓库。
• 可自定义应用快捷键：支持搜索、刷新、打开知识库 RAG 工作台与当前仓库 AI，并提供总开关与单项开关。
• README Mermaid 图表：本地渲染，窄详情栏自适应尺寸，失败时回退显示原始内容。
• README 分段与全文翻译：默认分段中英对照；全文翻译替换可见文本并保留原结构。

优化

• 添加标签弹出层：彩色图标行与选中态更清晰，背景与主窗口一致。
• Pro 侧栏用户名渐变：明暗主题分别适配，减轻首字母割裂与浅色对比不足。
• 星标与探索导航：三级层级与筛选上下文更清晰。
• README 翻译速度：更小首批请求、增量展示、最多 4 路并发、分段缓存与未完成段落续译。
• 个人笔记交互：可基于 README 用 AI 生成或优化笔记，含进度、Markdown 编辑预览、草稿复制与保存状态。
• AI 分享：复用已有 AI 摘要，支持取消创建与重新生成分享链接。
• 知识库分片管理：卡片分片数字与语言/星标同字号；编辑与详情页显示更新时间与约略 token 数。

修复

• 知识库入口：修复偶发无响应、最小化无法恢复，以及索引未就绪时误进空库引导的问题。

1.1.0

Starcat 1.1.0 将收藏的仓库升级为本地优先、过程可解释的 RAG 知识库，并集中优化了性能、稳定性和 macOS 使用体验。

新增

• 新增完整的知识库 RAG 工作台，支持多仓库上下文、流式回答、引用证据、会话分组与置顶、历史管理和草稿恢复。
• 新增混合检索，综合向量、双语关键词、仓库元数据、Wiki 和 RepoContext，并可选用重排、GitHub 实时上下文及外部搜索。
• 新增知识库浏览与索引管理，支持从 Stars 批量导入、README 补全、知识片段编辑与排除、定向重建和索引健康检查。
• 新增可解释的 RAG 执行视图，包括查询计划、执行时间线、检索漏斗、上下文预算、历史回放、检索设置和调试导出。
• 新增本地 AI 用量面板，可查看请求数、Token、延迟和失败统计，且不保存 Prompt 或回答正文。
• 新增全局 Star 状态过滤和 AI 摘要状态标识，帮助快速定位待阅读、已归档和已生成摘要的仓库。

优化

• 优化大规模知识库和长会话性能，通过有界索引、批量向量处理、增量持久化、预取限制和缓存降低等待时间。
• 优化 RAG 工作台交互，包括可调整分栏、加载骨架、引用与证据面板、代码和表格复制、滚动稳定性及响应式字号。
• 优化 AI 设置和后台任务，提供更清晰的模型能力配置、标签建议保护、诊断信息、任务进度以及取消和跳过操作。
• 优化 Explore、Trending 和 Weekly 的加载、缓存、来源过滤、时间线及快速切换体验。
• 优化设置页、Picker、分段控件、侧边栏图标、语义颜色和紧凑窗口下的 macOS 原生体验。
• 优化浏览器 Companion 集成，支持自定义本地端口、推荐结果分页、Star 状态同步和更清晰的可用性反馈。
• 优化 Direct Pro Pass 的许可证激活、设备管理、席位上限提示、订阅取消和渠道更新控制。

修复

• 修复仓库或账户切换、并发任务、取消操作和过期回调可能导致 RAG 上下文串线的问题。
• 修复显式仓库范围、私有笔记、双语关键词、Wiki、排除片段、错误引用标记及无证据拒答的正确性问题。
• 修复标题生成、置顶排序、草稿与历史恢复、长会话压缩、流式计时和滚动到底部的稳定性问题。
• 修复知识库列表重复刷新、旧向量覆盖新片段、来源更新不准确和后台 Wiki 刷新异常。
• 修复 GitHub 浏览器登录、AI/RAG 错误本地化以及多处设置、布局和无障碍问题。

1.0.0

Starcat 正式初始版本。

亮点

• 用原生 macOS 三栏界面管理 GitHub Stars。
• 支持 GitHub 登录和 Stars 同步，包含进度显示、刷新和限流提示。
• 支持按全部收藏、标签、语言、智能集合、状态、归档、Fork 和搜索浏览仓库。
• 支持查看仓库详情，包括元信息、README、GitHub 快捷入口、克隆链接和取消收藏。
• 支持标签、批量打标签、私有笔记，以及阅读或使用状态管理。
• 支持本地搜索仓库名称、作者、描述、笔记和相关元数据。
• 支持 GitHub Trending、周刊来源、推荐和仓库活动浏览。
• 支持 Release 追踪、仓库订阅、资源查看和已读状态管理。
• 支持自带配置的 AI 能力，包括仓库摘要、标签建议、对话、语义搜索、README 翻译和分享辅助。
• 支持仓库健康度、OpenSSF Scorecard、Wiki 上下文和相关洞察。
• 支持创建和导出分享卡及仓库集合。
• 支持应用设置、存储管理、诊断、开源致谢、主题、语言和界面偏好。
• 支持英文和简体中文。
• 作为原生 macOS 应用运行，包含沙盒、强化运行时、窗口管理和 App Store 上架准备。

新增

• 新增 Getting Started 新手引导系统，覆盖同步、RAG/Agent 试用、项目主页和知识库等关键操作，支持返回导航和调试模式开关。
• 新增浮层状态保护防止异常退出后引导入口锁死，统一手动重播防护，以及分享指引气泡位置优化。
• 新增 Agent 与 RAG 独立窗口工作台，支持窗口置顶、侧边栏折叠，并继承主窗口界面字号。
• 新增 Agent 计划与工具输出展示、扩展事件模型，并完善运行时事件反馈闭环。
• 新增落地页首屏加载动效及多阶段过渡动画、macOS 专属下载弹窗及优化后的定价网格，以及下载版本区块。
• 新增相似仓库推荐，支持保存推荐结果、展示更清晰的推荐卡片、标记已收藏仓库，并可在新的 Starcat 窗口中打开推荐仓库。
• 新增更多 GitHub 登录方式，包括浏览器登录、Token 登录、登录方式选择器和授权倒计时。
• 新增仓库代码智能分析能力，作为 Pro 功能提供独立的仓库分析工作区、结果缓存和设置入口。
• 新增详情页 AI 助手入口、README AI 摘要、摘要缓存，并支持从 Starcat 和浏览器入口触发摘要生成。
• 新增 Browser Plugin 工作流，可在 GitHub 页面与 Starcat 配对，并访问仓库上下文、笔记、标签、健康度、Wiki 上下文、推荐和 Safari WebExtension 支持。
• 新增开始使用清单，引导首次设置和关键操作。
• 新增探索发现相关页面，覆盖趋势、发现、GitHub 搜索和仓库榜单。
• 新增 README 后台预拉取和健康分预热，让仓库详情更快进入可用状态。
• 新增健康分排序、健康分颜色优化和 OpenSSF Scorecard 预热，帮助更快判断仓库质量。
• 新增菜单栏与 macOS 顶部菜单控制，常用操作更容易触达。
• 新增 Direct 分发能力，与 App Store 渠道并行，包含独立 Direct 构建目标、渠道配置和仅 Direct 版本启用的 Sparkle 自动更新。
• 新增 Direct 版 Sparkle 更新支持，包含 appcast 更新清单、EdDSA key 配置、检查更新菜单入口，以及私钥备份和多台 Mac 签名流程文档。
• 新增 Direct License 基础设施，包含 License API 服务、本地授权存储，以及同时服务 App Store 和 Direct 渠道的权益抽象。
• 新增中立的 Direct 支付网关抽象，为后续接入 Creem 等支付 provider 预留扩展点。
• 新增服务状态徽章、服务健康检查和本地运维工具，方便配置和排查问题。
• 新增界面字号档位、发布记录分页，以及发布订阅总数侧边栏展示。

• 提供 Agent 工作台，包含可审计追踪、回复样式、清晰的工具栏入口和标题栏控制。
• 提供完整的 DMG 背景、应用拖放位置和可读的 Direct 分发文件名。
• 提供优化后的落地页视觉、macOS 专属下载流程、定价布局和产品质感。
• 提供首次同步与周刊页面加载状态，以及统一加载提示组件。
• 提供推荐卡片、推荐缓存、清晰入口、已收藏标记和 Pro 权限提示。
• 提供 README 阅读体验，包含 GitHub 图片处理、系统风格滚动条和清晰加载状态。
• 提供全局搜索，包含快捷键、历史记录、可靠焦点获取和 GitHub 搜索结果分页。
• 提供 GitHub Stars 列表、侧边栏统计、语言图标和空状态展示。
• 提供 Activity 与 Weekly 浏览能力，包含筛选、快速数量统计和详情加载状态。
• 提供分享卡能力，包含多种版式、配色、个人资料展示和 Pro 可用性判断。
• 提供设置页文案、存储操作、服务配置和诊断日志反馈。
• 提供深色模式下 AI、健康度、搜索、分享和插件相关界面的完整适配。
• 提供发布准备材料、开源致谢、分发方案和应用内发布说明读取能力。
• 提供 Direct 发布工具链，包含 App Store / Direct 独立打包脚本、Direct 运行入口、Sparkle appcast 生成和 appcast / DMG 上传编排。
• 提供 Starcat 官网 nginx 规则，支持 Sparkle appcast 不缓存和 Direct 下载路径。
• 提供工具栏、危险操作、常用操作、标签、侧边栏和批量操作中的统一图标规范。
• 提供内部诊断、遥测安全边界和开发专用开关，避免未完成能力被当成正式功能。
• 提供 Agent 默认产物加载选择。
• 提供 RAG 与工作台输入框的稳定首键输入体验。
• 提供 RAG 中栏消息对齐和工作台标题栏图标显示。
• 提供正确的落地页 macOS 版本文案。
• 提供关闭主窗口后通过 Dock 或菜单栏重新打开 Starcat 的行为。
• 提供浮层覆盖 README 或其他交互区域时的正确鼠标光标行为。
• 提供 GitHub 仓库名称大小写不一致时的 AI 摘要生成能力。
• 提供浏览器插件中不可用或 Pro 限制动作的明确处理。
• 提供外部入口修改笔记和标签后的可见内容自动刷新。
• 提供推荐仓库新窗口和 README 加载的稳定体验。
• 提供 CodebaseMemory 启动、存储、缓存和仓库切换支持。
• 提供子目录 README 图片和 GitHub raw 图片路径显示。
• 提供全局搜索焦点时机和搜索结果交互细节。
• 提供存储重置完成态、未登录状态下存储页滚动和设置页布局边界处理。
• 提供语言数据缺失时的语言统计排序。
• 提供 Release 构建可用的调试菜单控制。
• 提供 Direct 构建签名和 entitlements 检查，确保非 App Store 版本不带 App Sandbox entitlement，同时 App Store 版本继续保留沙箱配置。
• 提供 Direct 更新测试打包流程，支持临时版本覆盖 marketing/build 版本，并避免 appcast 生成时混入旧 DMG。