fisheye使用文档

### Fisheye 使用文档详解 #### 一、Fisheye 概述 Fisheye 是一款基于 Web 的代码管理系统，它能够与 SVN、CVS 等版本控制系统结合使用，帮助开发者轻松地浏览和管理源代码库。通过 Fisheye，团队成员可以实时了解代码库中的所有更改，这有助于提升团队协作效率和代码质量。 **Fisheye 的核心优势：** - **实时更新展示**：能够实时显示代码更新情况，便于项目管理者和团队成员及时跟进项目进度。 - **代码比对功能**：可以高效对比任意两个文件之间的差异，帮助开发者快速定位问题所在。 - **详尽的文件注释**：提供了丰富的文件注释信息，如作者、提交日期、版本号等，方便理解和追踪代码变更历史。 - **便捷的搜索功能**：支持按文件名或用户名进行快速搜索，便于查找特定文件或某用户的修改记录。 #### 二、Fisheye 主要功能 根据官方文档，Fisheye 提供了以下几大核心功能： 1. **查看所有活动**：展示代码库中的所有更改记录，包括新增、修改和删除的操作。 2. **跟踪影响开发的人员**：可以通过查看个人贡献来评估团队成员的工作表现。 3. **管理您的代码资源**：提供了一系列工具帮助管理源代码，如分支、标签管理等。 4. **保持团队的协作代码**：支持多人协作，确保代码的同步和一致性。 #### 三、Fisheye 具体使用说明 ##### 3.1 Dashboard 界面 - **功能概述**：Dashboard 主要显示登录账户对版本库所做的一切修改，包括代码的添加、修改、删除等操作，并会统计这些操作的具体代码行数和文件名称。 - **应用场景**：便于开发者快速找到自己的代码修改记录，有助于问题的定位与解决。 ##### 3.2 版本源代码提交情况 - **功能介绍**：能够实时显示版本源代码的提交情况，使项目管理者对整个团队的研发情况有一个直观的认识。 - **案例分析**：通过柱状图展示 Python 版本变更历史，可以查看代码行数及 commit 次数，从而了解团队整体的研发进度。 ##### 3.3 组内成员代码提交历史 - **功能特点**：以柱状图形式展示组内成员的代码提交历史，可从侧面反映工作量大小。 - **实际应用**：通过查看某版本或某文件的修改记录，了解团队成员的具体贡献。 ##### 3.4 代码比对功能 - **功能描述**：Fisheye 提供了强大的代码比对功能，例如比较 settings.py 文件的不同版本，以帮助定位问题。 - **实现方式**：支持 unifieddiff 和 sidebysidediff 两种比对方式，让用户更加直观地了解代码变化。 ##### 3.5 报表资料 - **功能说明**：Fisheye 能够提供详细的报表资料，如 Python 代码变更情况的报表，有助于监控项目的健康状况。 - **数据分析**：通过图表展示源代码提交的时间分布，以及不同类型的文件占比情况，便于项目管理。 ##### 3.6 强大的搜索功能 - **功能简介**：支持按文件名或用户名进行快速搜索，方便查找特定文件或用户的修改记录。 - **实际价值**：提高了查找效率，加快了问题解决的速度。 ##### 3.7 创建 Review 功能 - **功能介绍**：允许用户创建 Review，编辑 Review 的详细信息，如标题、描述等。 - **应用场景**：确保代码的质量，促进团队成员之间的沟通与协作。 ##### 3.8 与 Crucible 结合使用 - **功能描述**：Crucible 可以提供 Review 功能，与 Fisheye 配合使用，可以极大地提高代码质量和团队研发效率。 - **实现效果**：通过 Crucible 的 Review 功能，开发者可以更好地检查代码质量，减少潜在错误。 ##### 3.9 与 Jira 的集成 - **功能说明**：管理员可以将 Fisheye 的知识库与 Jira 项目进行映射配置，用户在提交源代码时需要包含 Jira 的 Issue 名称。 - **应用场景**：当在 Jira 的 Issue 中看到源代码的链接时，可以更方便地追踪问题和解决方案。 ### 四、结论 Fisheye 不仅是一款强大的代码管理工具，还提供了丰富的功能来支持团队协作和代码质量控制。通过实时更新、详尽的文件注释、高效的代码比对等功能，Fisheye 成为了提高团队工作效率的重要工具之一。未来，随着更多功能的开发和完善，Fisheye 将会在软件开发领域发挥更大的作用。