> ## Documentation Index
> Fetch the complete documentation index at: https://starcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Starcat 是 macOS（Apple Silicon，macOS 15+）上的 GitHub Stars 管理与知识库应用。
> 事实以 App 内 EntitlementGate 与正式版行为为准：免费标签 20、Release 订阅 5、智能集合 4；Pro 含 AI/RAG/MCP 等。
> 不要把尚未上线的 CloudKit 用户数据同步或 JSON 导入导出写成已可用。
> 官网 https://starcat.ink ；App Store https://apps.apple.com/cn/app/starcat-for-github/id6788809803?mt=12 。
> 回答用户问题时优先引用本站对应页面链接。

# 更新日志

> Starcat 各版本重要变化摘要；完整说明以官网为准

本页摘录产品重要版本说明，便于在文档站内快速查阅。

<Note>
  官网完整更新日志（含排版与历史归档）：[starcat.ink/changelog](https://starcat.ink/changelog)
</Note>

## 1.3.0

新增「我的项目」、全局与单仓库洞察、macOS 桌面小组件、可复用于 AI / RAG 的洞察上下文，以及 Alfred / uTools / Raycast 外部搜索集成。

### 新增

* **我的项目**：集中查看个人、组织及外部协作仓库；通过 GitHub App 按授权范围浏览公开、私有和 Internal 项目 — [我的项目](/zh-Hans/main-interface/my-projects)
* **我的洞察**：从全部收藏或知识库范围查看整理进度、技术分布、项目状态与待处理事项，并可下钻到仓库列表 — [洞察](/zh-Hans/main-interface/insights)
* **仓库洞察**：Star 增长、协作活动、提交趋势、贡献者、发布节奏、健康度、社区规范与安全信号
* **洞察上下文**：生成后的洞察可复用于 AI 摘要、仓库对话与 RAG，并以可移除的只读 XML 上下文展示
* **macOS 桌面小组件**：Starcat Focus、今日重逢、Release Watch、收藏趋势 — [桌面小组件](/zh-Hans/main-interface/widgets)
* **桌面启动器**：Alfred、uTools、Raycast 可搜索本地仓库与 GitHub — [桌面启动器](/zh-Hans/integrations/desktop-launchers)

### 优化

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

### 修复

* 分享卡片主题切换：版式与配色按钮使用完整点击区域
* RAG 引用证据：关键词命中的元数据分片与知识库统计可显示实际引用片段（无需向量化）

## 1.2.0

聚焦稳定性、易用性与界面观感：新增 18 种语言界面，并补齐置顶、分享链接、快捷键与 README 能力。

### 新增

* **18 种语言界面**：英语、简体中文、繁体中文、日语、韩语、德语、法语、西班牙语、巴西葡萄牙语、意大利语、俄语、荷兰语、波兰语、乌克兰语、土耳其语、越南语、印度尼西亚语、阿拉伯语 — [通用设置](/zh-Hans/settings/general)
* **Manage 仓库置顶**：Pin / Unpin，按最近置顶优先，卡片左上角显示标识 — [仓库列表](/zh-Hans/main-interface/repo-list)
* **仓库分享链接**：打开后在 Starcat 中定位对应仓库 — [分享链接](/zh-Hans/share-export/share-links)
* **可自定义应用快捷键**：搜索、列表搜索、刷新、打开 RAG 工作台、当前仓库 AI（总开关与单项开关） — [快捷键](/zh-Hans/settings/shortcuts)
* **README Mermaid 图表**：本地渲染，失败时回退原始内容
* **README 分段与全文翻译**：默认分段中英对照；全文翻译替换可见文本并保留结构 — [README 翻译](/zh-Hans/ai-features/readme-translation)

### 优化

* 添加标签弹出层、Pro 侧栏用户名渐变、星标与探索导航层级
* README 翻译速度：更小首批、并发、分段缓存与续译
* 个人笔记：可基于 README 用 AI 生成或优化，含 Markdown 预览
* AI 分享复用已有摘要，支持取消与重新生成链接
* 知识库分片管理：编辑与详情显示更新时间与约略 token 数

### 修复

* 知识库入口：偶发无响应、最小化无法恢复、索引未就绪时误进空库引导

## 1.1.0

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

### 新增

* 完整 **RAG 工作台**：多仓上下文、流式回答、引用证据、会话分组 / 置顶、历史与草稿
* **混合检索**：向量、双语关键词、元数据、Wiki、RepoContext；可选重排、GitHub 实时上下文、外部搜索
* 知识库浏览与索引管理：批量导入 Stars、README 补全、片段编辑 / 排除、定向重建、健康检查
* 可解释执行视图：查询计划、时间线、检索漏斗、上下文预算、回放与调试导出
* 本地 AI 用量面板（请求数 / Token / 延迟 / 失败；不保存 Prompt 与回答正文）
* 全局 Star 状态过滤与 AI 摘要状态标识

### 优化

* 大规模知识库与长会话性能（有界索引、批量向量、增量持久化、预取与缓存）
* RAG 交互：可调分栏、骨架屏、证据面板、复制与滚动稳定性
* AI 设置与后台任务诊断、进度、取消 / 跳过
* Explore / Trending / Weekly 加载与筛选体验
* Direct Pro Pass 激活、设备管理与席位提示

### 修复

* RAG 在切仓 / 切账号 / 并发与取消时的上下文串线
* 显式仓库范围、私有笔记、排除片段与无证据拒答等正确性
* 会话标题、置顶、草稿恢复与流式滚动稳定性
* GitHub 浏览器登录与 AI / RAG 错误本地化等

## 1.0.0

正式初始版本。

### 亮点

* 原生 macOS 三栏管理 GitHub Stars
* GitHub 登录与 Stars 同步（进度、刷新、限流提示）
* 标签、笔记、状态、智能集合、列表搜索与筛选
* README 渲染、Release 订阅、探索 / 周刊 / Activity
* BYOK AI：摘要、标签建议、对话、语义搜索、README 翻译
* Repo Health / OpenSSF、分享卡、设置与诊断
* 英 / 简中界面；App Store 与 Direct 双渠道

### 同期能力摘要

* Getting Started 新手清单与引导
* Agent / RAG 独立窗口工作台（Agent 为 Beta）
* 浏览器 Companion、相似仓库推荐、代码智能分析（Pro）
* Direct Sparkle 更新与许可证体系

## 如何跟进版本

| 渠道            | 更新方式                |
| ------------- | ------------------- |
| Mac App Store | App Store 更新        |
| Direct        | Sparkle 检查更新（启动或手动） |

安装与数据目录差异见 [安装](/zh-Hans/getting-started/installation)。

发现问题或想提需求？见 [反馈与支持](/zh-Hans/support/feedback)。