Kimi Code Desktop 打开项目后文件列表为空、或者只显示零星几个文件时，多数情况不是项目坏掉，而是工作区没有指向真正的项目根目录，或者目录读取权限、忽略规则把文件挡在了客户端之外。建议按“工作区路径 → 系统读权限 → 忽略规则 → 刷新行为 → 客户端日志”的顺序排查，每一步都能单独验证，不必先重装客户端。
文件列表为空时，先确认工作区路径是否等于项目根目录，再用终端里的 ls 或 dir 验证该目录能被列出，然后检查 .gitignore 与客户端忽略设置，最后用一个新建文件测试刷新是实时还是快照。这套顺序适合本地项目首次接入或切换分支后的显示异常，不适合远程仓库尚未克隆完成的情况。每一步都建议留下可复现的命令输出或日志片段。
确认当前工作区路径是否指向真实项目根目录
路径查看位置通常在窗口标题、左侧文件面板顶部，或者“设置 → 工作区/项目”一栏里以绝对路径形式展示。先把这个路径复制出来，和你在系统里打开项目的路径做一次逐字比对。
常见的错误选法有三种：一是选了用户主目录，文件列表里会混入大量无关目录；二是选了仓库的父目录，如果父目录下还并排放着多个项目，客户端可能只把它当成普通文件夹处理；三是选了 dist、build、out 这类构建产物目录，源码自然不显示。判断项目根目录比较稳妥的依据是目录内存在 .git、package.json、pyproject.toml、go.mod、Cargo.toml 之类的标志文件。
修正步骤：先关闭当前工作区，再重新选择文件夹，定位到含上述标志文件的那一层；重新打开后，对照设置里的工作区路径确认它是绝对路径而不是某个快捷方式或符号链接指向的旧位置。如果项目通过软链接接入，建议直接选择链接指向的真实目录再验证一次。
在终端用 ls 或 dir 确认目录下文件可列出
这一节验证的是系统层面能否读取该目录。macOS 或 Linux 下在终端执行：
ls -la /Users/you/projectWindows 下在 PowerShell 或 CMD 中执行：
dir "D:\work\project"预期输出是 total 行加若干 drwxr-xr-x、-rw-r`--r--` 权限位，以及文件名列表；Windows 会输出目录、文件数量和具体文件名。只要终端能正常列出同样的文件，就说明路径本身是可读的，问题更可能出在客户端一侧。
权限不足时的报错特征比较固定：macOS/Linux 常见 Permission denied、Operation not permitted、ls: cannot open directory；Windows 常见“拒绝访问”或“系统找不到指定的路径”。如果终端也读不到，客户端自然读不到，需要先处理权限，例如确认当前用户对目录有读和执行权限，或把项目移动到用户可读写的目录下。使用外置磁盘、网络挂载点时，还要确认挂载已完成、没有被系统卸载。
检查客户端忽略规则是否把项目文件排除在外
忽略规则的入口一般有两处：客户端设置里的“文件排除/忽略列表”，以及项目根目录下的 .gitignore、.ignore 文件。前者管客户端自身是否显示，后者是仓库共享的忽略约定，两处都生效时容易叠加。
常见的忽略模式包括 node_modules/、dist/、build/、.venv/、__pycache__/、*.log、*.min.js、.env 等。如果缺失的刚好是这些目录下的文件，多半是被规则挡住了。
临时关闭验证的方法：先把 .gitignore 中相关行注释掉，或者在客户端设置里把忽略列表临时清空，然后重新打开工作区观察。验证结束记得把改动恢复，避免误提交。需要提醒的是，部分客户端对某些目录有内置排除，不提供开关，这时应以文件面板的实际表现和日志里的 readdir 结果为准，不要假定设置里没有就代表没有忽略。
用新建文件测试客户端刷新后能否识别
这一步用来区分读取是打开时的静态快照，还是会跟随文件系统动态刷新。在项目根目录新建一个文件，例如 check-workspace.txt，内容写一行：
workspace check然后执行刷新动作：右键文件面板选择刷新、使用菜单里的 Reload，或者关闭后重新打开该文件夹。观察结果可以这样记录：如果新文件出现、而原有文件仍缺失，方向偏向忽略规则；如果新文件也不出现，方向偏向路径或权限；如果只有重开工作区才会出现，说明读取偏向打开时快照，长时间编辑前需要手动刷新一次。
记录时建议写清操作时间和观察到的现象，方便和后面的日志相互印证。
如果仍读不到，收集客户端日志中的路径报错
日志位置一般在设置的“打开日志目录”入口，或者系统默认的应用日志目录下，macOS 常见在 ~/Library/Logs/，Windows 常见在 %APPDATA% 下的应用目录，Linux 常见在 ~/.config/ 下的应用目录。文件名可能类似 main.log、renderer.log，具体以你安装的版本为准。
需要关注的关键字段是 workspace、root、path、readdir，以及 ENOENT（路径不存在）、EACCES 或 EPERM（权限不足）、permission denied。可以先用命令过滤出错误行：
grep -iE "ENOENT|EACCES|EPERM|workspace|readdir" main.log | tail -n 50提取日志时不要把原始文件整段贴出去，建议先把用户名、绝对路径前缀、token、环境变量等替换成占位符，只保留报错类型和相关路径层级。这样既保留了可验证线索，也避免把本机信息带进公开提问里。