RepoCare使用手册

文档目录文档首页

RepoCare 产品文档

RepoCare 使用手册

RepoCare 是面向 GitHub 开源项目维护者的工作台：在固定提交上体检项目资料，按证据分诊 Issue、审查 PR，把建议整理成可编辑的草稿，最后由你确认交付。本手册说明每个页面怎么用、结果怎么理解，以及部署和配置方法。

常用主题模型连接关注矩阵审查航道隔离验证发布草稿结果待确认

从这里开始

快速开始约 15 分钟：连接仓库、完成第一次体检、保存第一份草稿。核心概念固定快照、证据、建议与确认——理解 RepoCare 如何得出每个结论。功能总览工作区布局、各页面分工，以及所有页面共用的操作约定。

按功能浏览

项目概览查看项目状态与维护变化，从近期记录回到具体任务。项目体检在固定提交上检查文档、协作规范与工程配置，导出可追溯报告。贡献路径验证在隔离环境里检验新贡献者能否按文档完成安装、测试和检查。Issue 分诊用关注矩阵排序反馈，完成 AI 分诊、人工确认、回复与复现。PR 检查用审查航道找到卡住的变更，分块 AI 审查并筛选发现。维护调查与对照验证围绕一个问题准备候选补丁，并用同一测试对比两个版本。草稿与交付编辑、校验并交付文档改进、Issue 回复和 PR 评论。工作区设置模型连接、GitHub 授权、项目专属规则与本地偏好。

实践、部署与参考

工作流与最佳实践四个完整维护场景，以及控制成本、保留记录的做法。常见问题按现象排查启动、连接、模型、执行和发布问题。部署与运维本地运行、容器部署、隔离执行、备份恢复与升级。管理员配置登录方式、环境变量与数据处理说明。术语、状态与限额界面词汇、状态含义、处理上限与功能边界速查。

按任务查找

我想要…	从这里开始
第一次使用，得到一份项目体检报告	快速开始
弄清“快照”“证据”“建议”分别指什么	核心概念
先处理最需要关注的 Issue	Issue 分诊 · 关注矩阵
找出卡住最久、还没人审的 PR	PR 检查 · 审查航道
让 AI 帮我审一个 PR，并发表评论	PR 检查 · 发起 AI 审查
验证新贡献者能否按 README 跑通测试	贡献路径验证
判断一个 Bug 能否稳定复现	Issue 分诊 · 复现 Bug
修改、审阅并发布一份草稿	草稿与交付
接入 DeepSeek、OpenAI、Claude 或本机模型	工作区设置 · 模型连接
在自己的电脑或服务器上运行 RepoCare	部署与运维
页面打不开、任务一直排队、发布失败	常见问题

一次维护的完整路径

连接仓库：选择 GitHub 仓库与分支，建立本次工作的上下文。
固定快照并体检：后台锁定一个提交，检查文档、协作模板和工程配置，所有引用都指向这个版本。
审阅协作内容：在 Issue 分诊和 PR 检查中阅读原文、证据和 AI 建议，记录你的判断。
按需验证：在隔离的 Docker 环境中复现 Bug、走通贡献路径，或对比修复前后的测试结果。
编辑草稿：文档改进、Issue 回复和 PR 评论都先成为草稿，可比较差异、检查风险、保存版本。
确认交付：确认目标和内容后，由你决定发布到 GitHub，或下载交给其他维护者。

每一步都有独立的产物，可以停在任何一步：没有模型也能做基础体检，没有 GitHub 写入权限也能完成阅读、编辑和下载。

按角色阅读

项目维护者：先读快速开始和核心概念，然后按需查阅功能指南。发布前通读草稿与交付。

协作审阅者：重点阅读 PR 检查、Issue 分诊和工作流与最佳实践，理解每条结论对应的提交与证据范围。

部署管理员：先完成部署与运维和管理员配置，再按验收清单检查后台服务、登录、备份与恢复。

使用这份手册

按 Ctrl + K（macOS 为 ⌘ + K）或 / 打开全文搜索，可以搜索功能名称、操作步骤和错误提示。
工作区侧栏底部的“使用指南”、首页和登录页顶部的“产品文档”都能打开本手册，未登录也可以阅读。
手册以 Markdown 保存在仓库的 docs/product/ 目录，随代码一起维护；每页右侧都有“在 GitHub 编辑此页”。

手册描述的是当前版本的操作行为。模型结论需要核对；“执行成功”只表示选定的验证步骤完成，不能代替项目自身的完整测试和维护者判断。适用范围见术语、状态与限额。