如果你在用文心快码企业版时发现IDE左侧边栏始终不显示当前代码库的架构分析视图，先别急着怀疑是软件坏了——这个功能默认就是关闭的，而且依赖一套完整的“插件+配置文件+后端服务”联动机制。说白了，它不是开箱即用的静态UI组件，而是需要你主动配齐三样东西才能跑起来。

许多用户遇到这个问题，第一反应往往是“怎么插件装了还是看不到？”其实答案很简单：功能默认未启用，且必须满足三个硬性前提——插件本身正确安装并启用、项目根目录下有正确的配置文件、后端分析服务处于就绪状态。三者缺一不可，而且首次使用还需要手动触发一次全量扫描。下面逐一拆解。

确认是否已安装并启用“文心快码架构洞察”插件

打开IDE的插件管理页面（以IntelliJ IDEA为例，路径：File → Settings → Plugins），搜索【文心快码架构洞察】。确保插件列表里出现了这个名称，并且右侧的勾选框是选中状态。如果没勾选，IDE根本不会注册架构分析的边栏入口，自然看不到任何面板。

需要特别留意的是：如果你的插件列表里只有“文心一言基础版”或“文心快码通用版”，那说明你装的是精简包——企业版专属的架构分析能力必须通过独立的插件包激活，其他版本的插件无法复用。这一点最容易踩坑，务必核实清楚。

检查项目根目录是否存在 .wenyiyan/config.yaml

在项目的最外层目录下，手动创建 .wenyiyan/config.yaml 文件。文件名首尾务必带点，路径不能放错——放在 src 或子模块下均无效。文件内容至少包含以下结构：

analysis:
enabled: true
mode: "full"

这个文件是触发全量架构扫描的硬性前提。没有它，即使插件已启用，IDE启动时也会直接跳过初始化步骤，左侧边栏始终保持空白。很多用户以为装了插件就够了，其实这个配置文件才是真正的“开关”。

验证后端分析服务是否就绪

架构分析不是纯前端计算——所有依赖关系解析、调用链生成、模块聚类都由后端服务完成，IDE只负责渲染结果流。所以服务离线时，边栏必然无数据。有两种验证方式：

方法一：在终端执行 curl -X GET "http://localhost:8081/health"，如果返回 {"status":"UP"}，说明本地分析服务运行正常。

方法二：如果你用的是云托管模式，需要登录百度智能云千帆控制台，进入文心快码企业版 → 实例管理，确认对应集群状态是否为“运行中”。集群处于“暂停”或“升级中”时，IDE侧边栏会一直显示“等待连接…”，此时就算前面两步都做了也白搭。

强制触发一次全量架构扫描

即使前三步全部就绪，第一次打开项目时插件也不会自动扫描——必须手动触发。静置等待不会自动激活。操作步骤如下：

第一步：确保项目已正确加载，IDE右下角没有“Indexing…”提示；

第二步：右键点击项目根目录 → 选择“文心快码 → Trigger Full Architecture Scan”；

第三步：观察IDE底部状态栏是否出现类似“Scanning… (32/147 files)”的进度提示；

第四步：等进度条走完，状态栏显示“Scan completed”，左侧边栏的架构视图就会自动展开。

这一步是最后一个容易忽略的细节。很多开发者配置完前三步后以为会自动生效，结果发现边栏还是空白，原因就在这里——必须手动触发一次扫描才能看到结果。记住，这是企业版架构分析的启动流程，不是Bug。