快速上手

FiboCode 在编辑器中以代码、文档与图谱构建一套可随代码持续成长的知识库。这份共享上下文也会提供给你选择的 Agent CLI，让你和智能体能够共同理解、定位与修改代码。

理解与代码一同生长。

落到日常，它有两种用法——一种服务于写，一种服务于读：

两条路都从同一件事开始：装好应用、打开工作台、配好模型。

下载安装

前往 FiboCode 版本发布页获取最新安装包：

• macOS：打开 .dmg，把 FiboCode 拖入"应用程序"文件夹。
• Windows：运行 .exe 安装器，按提示完成安装。

官网首页的"立即下载"按钮会自动解析到最新版本，无需自己比对版本号。

开始之前

1. 打开工作台。 在左侧工作台面板点击"打开文件夹"选择代码库，也可以直接把文件夹拖进来。不支持拖入 .zip 文件；之后可从"最近打开"快速切换。FiboCode 以整个仓库、而非单个文件作为理解的单位。

2. 配置模型。 进入 系统配置 → 模型配置 → 新增 Provider，填写供应商名称、接口名称（OpenAI 兼容）、Base URL、API Key 与模型名称，保存后勾选主模型。把一个低延迟模型额外标记为快速模型，需要即时响应的调用会优先走它；"高级设置"里可调整并发量、超时时间与最大输出 Token。

模型就位后，这三项能力才会启用：

• diff 总结 —— 在源代码管理面板悬停文件或目录，即时得到本次改动的摘要；提交前还能一键生成 commit message。
• 代码补全 —— 编辑器内的 AI 建议面板，逐条接受或拒绝。
• 代码解析 —— 全仓库分析，产出目录与文件级的注解文档和概念图。

3. 为 Agent 安装 Fibo Skills（可选，但推荐）。 Fibo Skills 会为终端中的 Agent CLI 加入“规格 → 计划 → 执行 → 同步”工作流，并指导 Agent 将规格、计划和变更记录写入 .fibo/ 文档体系。FiboCode 本身不会自动记录项目的演进历史；如需由 Agent 持续维护这些记录，建议安装并使用 Fibo Skills。安装方式见 Fibo Skills。

用法一：增强的终端工作流

沿用你早已信赖的 Agent CLI，不改变任何习惯——FiboCode 只是在它周围补齐上下文与审查。

1. 切到 CLI 模式，开始编程。 在对话面板切换到 CLI 模式并打开终端，照常运行 Claude Code、Codex 或任何你习惯的 Agent CLI。
2. 切回对话模式，结算变更。 编程告一段落后切回对话模式，FiboCode 会统计这段时间内被改动的文件，并列在变更文件卡片上——不必再靠记忆或 git status 回溯智能体动过什么。
3. 进入快速审查。 点击卡片上的 Review：逐 hunk 查看 diff，逐块接受或拒绝，也可整文件全接受 / 全拒绝。需要时可借助快照回滚到更早的文件状态。
4. 提交。 打开源代码管理，暂存改动，生成或手写 commit message，完成提交。

用法二：分析与理解代码

把一个仓库读懂，靠的不是从头翻一遍文件，而是让代码自己讲出结构。

1. 配置解析范围与模板。 进入 系统配置 → 代码分析：
   • 目录黑名单 —— 按目录名精确匹配，命中的目录及其全部子内容不参与分析（如 node_modules、dist）。
   • 扩展名白名单 —— 只有命中代码扩展名或配置扩展名白名单的文件才会被分析。
   • 分析模板 —— 目录、代码文件、配置文件三份模板可分别编辑，决定注解文档的产出结构；改坏了可一键重置为原始内容。
2. 开始分析。 回到工作台面板点击分析，启动全仓库解析。解析按目录与文件并发进行，并发量取自模型配置；过程中可随时中止，完成后会提示"代码解析完成"。
3. 阅读注解。 点击任意目录或文件，右侧文档视图即显示对应的文字注解；切到概念图视图可看该处的结构图。目录级注解回答"这一层在做什么"，文件级注解回答"这个文件如何实现"。
4. 顺着标签跳转。 注解里的 码 / 文 / 图 标签都是可点击的锚点：码跳到源码文件与行号，文跳到关联文档，图跳到对应概念图。读到哪、跳到哪，代码与解释始终双向可达。

下一步

• Fibo Skills —— 在 Skills 指南中了解每个 Skill 的用途与安装方式。
• 论坛 —— 在 GitHub Discussions 提问、交流工作流。
• 问题反馈 —— 在 Issue 跟踪页提交 Bug。