Kimi Code Desktop 首次打开一个项目时，默认能读到的通常不是整块磁盘，而是你在打开项目时选定并绑定的那个工作区目录及其子目录，再叠加一层忽略规则。担心越权读取和担心漏读关键代码，可以分开验证：越权看路径绑定和忽略规则，漏读看客户端文件树与磁盘实际内容的对照。
工作区路径决定 Kimi Code Desktop 能读到的目录范围，忽略规则决定这个范围里哪些文件被跳过，两者叠起来才是完整的读取边界。建议按四步走：确认设置里的工作区绝对路径、用文件管理器对照文件树、检查忽略规则命中项、新建探针文件做动态验证。若探针文件不可见，先排查路径绑定和忽略规则，不要直接判定客户端读不到文件；界面位置以你当前客户端版本实际显示为准。
在客户端设置里找到当前工作区路径
工作区路径是读取范围的第一道边界，先把它确定下来。路径通常显示在项目名旁边、窗口标题或状态栏，也可能收在设置里的工作区/项目面板中；如果只显示文件夹名，展开看完整路径。
修改入口一般在“文件”菜单里的打开文件夹、切换工作区，或设置的“工作区管理”区域。切换后是否需要重启：多数情况下客户端会立即重新索引新目录，但已经打开的对话可能仍绑定旧路径，建议切换后新开一个会话，必要时重启客户端再确认一次。
把设置里显示的路径抄下来，在系统终端里对照：
# 确认当前目录与客户端显示的工作区是否指向同一位置
pwd
ls -la /path/to/your/workspace如果两处指向不同目录，后面所有关于“能读到哪些文件”的判断都不成立，先把路径对齐再往下走。
用文件管理器对照工作区文件列表
把客户端左侧文件树逐层展开，用系统文件管理器或终端对照同一目录。终端对照时可以限制层级，避免目录太大刷屏：
# 只列两层，排除 .git 内部结构
find . -maxdepth 2 -not -path "*/.git/*" | sort常见不一致原因有这几类：
- 隐藏文件：以点开头的文件与环境变量文件，在文件管理器和部分客户端里默认不显示。
- 忽略规则命中：依赖目录、构建产物、虚拟环境、日志、二进制文件常被默认排除。
- 符号链接与权限：链接指向的目录、当前用户无读权限的目录，客户端可能不展开。
- 索引范围：部分客户端只索引代码类扩展名，图片、压缩包等不出现在文件树里。
不一致时先区分是“客户端没显示”还是“客户端没读取”：前者看显示设置，后者看忽略规则与文件权限。
检查默认忽略规则覆盖了哪些文件
忽略规则决定工作区里哪些内容不进入读取范围，位置通常有三处：项目根目录的忽略配置文件（写法类似 .gitignore）、客户端设置里的“忽略/排除”面板、客户端自带的一套全局默认规则。
可调整项一般包括目录名、扩展名、文件名模式和单文件大小上限。调整后大多需要重新加载工作区或重启会话才会生效，部分版本会提示重新索引。
检查顺序建议：先看项目根目录忽略配置文件里有哪些模式，再看设置面板是否覆盖了默认值，最后确认是否存在客户端级别的强制忽略项（这类项通常不允许在项目里覆盖）。把命中的目录和扩展名列出来，记进后面的结论模板。
新建一个测试文件观察客户端能否发现
静态对照只能看出“没显示什么”，动态测试才能确认“能不能真的读到”。
- 在工作区根目录新建一个普通文本文件，例如 read_scope_probe.md，内容写一行可识别的句子。
- 再在一个常见子目录（例如 src/）里放一个同名文件，内容不同，用来判断子目录是否被单独排除。
- 在客户端里刷新文件树或重新打开项目；如果客户端支持读取文件，可以让它打开该文件并复述内容。
- 预期结果：根目录文件应出现在文件树中，且内容与写入一致；子目录文件的表现单独记录。
结果解读：根目录文件也不可见，问题在路径绑定；根目录可见但子目录不可见，优先怀疑忽略规则命中了该目录；文件树可见但内容读取失败，查看是否为权限或大小限制。测试完成后删除探针文件，避免长期留在仓库里被提交。
记录首次打开项目后的文件访问结论
把上面几步的结果写成一段固定记录，下次换项目或升级客户端时直接对照。
项目：<项目名>
客户端版本：<客户端里显示的版本号>
工作区绝对路径：<设置里显示的路径>
文件树与磁盘一致性：一致 / 不一致（原因：隐藏文件 / 忽略规则 / 权限）
命中忽略规则的目录与扩展名：<列表>
探针文件结果：可见且可读 / 可见不可读 / 不可见
读取边界结论：<哪些目录不在读取范围内>
后续调整入口：忽略配置文件位置 / 设置面板位置
记录时间：<日期>边界说明：这份记录只对当前客户端版本、当前工作区和当前忽略规则成立；换项目、改忽略规则或升级客户端后都需要重新验证一次。后续调整入口集中在两处：设置里的工作区路径与忽略面板，以及项目根目录的忽略配置文件。