应清空CodingPlan缓存目录、清理项目构建产物、重置语言服务器索引、禁用非必要插件缓存、迁移用户数据目录至大容量分区。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行方舟CodingPlan本地开发环境时发现磁盘空间持续告急，且系统提示“磁盘空间不足”或IDE响应迟缓，很可能是其本地缓存目录中积累了大量冗余数据。这些数据包括编译中间产物、依赖包快照、日志快照、临时构建文件及已失效的元数据索引，长期未清理会显著占用C盘或用户主目录空间。以下是针对性释放磁盘空间的操作步骤：
一、清空CodingPlan专属缓存目录
方舟CodingPlan默认将运行时缓存集中存储于用户目录下的隐藏路径中，该路径不随卸载自动清除，且包含大量可安全删除的中间产物。手动定位并清空此目录是最直接有效的释放方式。
1、按下Command + Shift + G（Mac）或Win + R（Windows），打开“前往文件夹”或“运行”窗口；
2、Mac用户输入：~/Library/Caches/ark-codingplan/；Windows用户输入：%LOCALAPPDATA%\ArkCodingPlan\Cache\；
3、确认进入该目录后，全选所有子文件夹与文件（不进入子目录，仅选顶层内容）；
4、按Command + Delete（Mac）或Delete → Shift+Delete 强制删除（Windows），跳过回收站直接清除；
5、重新启动CodingPlan，首次加载将重建必要缓存，后续运行空间占用将回归合理水平。
二、清理项目级构建产物与临时输出
CodingPlan在每个打开的项目根目录下自动生成.codingplan-build或target/类临时构建目录，这些目录体积常达数百MB至数GB，且每次构建均叠加而非覆盖。保留最新一次即可，历史产物属明确冗余项。
1、在访达（Mac）或文件资源管理器（Windows）中，逐个检查已打开项目的根目录；
2、查找名称含.codingplan-build、build/、dist/、out/或target/的文件夹；
3、对非当前活跃开发分支所对应的构建目录（例如：分支名含feature-、hotfix-或带时间戳的旧目录），右键选择“移到废纸篓”或“删除”；
4、特别注意保留当前正在调试的分支所生成的最新构建目录，避免重复编译耗时；
5、完成清理后，在CodingPlan中执行“重新构建项目”以验证功能完整性。
三、重置语言服务器与索引数据库
CodingPlan依赖本地语言服务器（LSP）维护代码语义索引，其索引文件（如workspace-index.db或.codingplan-index/）可能因异常中断而膨胀或损坏，导致磁盘占用虚高且检索变慢。重置索引可同时释放空间并提升响应性能。
1、关闭CodingPlan主程序，确保后台进程完全退出（可通过活动监视器或任务管理器确认无codingplan-lsp或ark-language-server进程）；
2、打开终端（Mac/Linux）或命令提示符（Windows），执行以下命令定位索引路径：
3、Mac/Linux：find ~/Library/Application\ Support -name "*index*" -type d 2>/dev/null | grep codingplan；
4、Windows：dir "%APPDATA%\ArkCodingPlan" /s /b | findstr "index"；
5、对查得的完整索引目录路径，执行删除操作：rm -rf [路径]（Mac/Linux）或rmdir /s /q [路径]（Windows）；
6、重启CodingPlan，等待状态栏显示“索引重建中”，完成后即启用精简、健康的全新索引。
四、禁用非必要插件缓存持久化
部分第三方插件（如AI补全、远程调试桥、Git增强工具）默认启用本地缓存持久化，其缓存分散在~/.codingplan/extensions/子目录中，单个插件缓存可达1–3GB。关闭非核心插件的缓存写入，可从源头遏制冗余增长。
1、在CodingPlan中打开设置界面（Cmd+, / Ctrl+,）；
2、左侧导航选择扩展（Extensions），右侧列表中找到已安装但非每日必需的插件；
3、点击插件右侧的齿轮图标，选择扩展设置；
4、查找关键词为cache、storage、persistence的配置项；
5、将对应开关设为Disabled或False，例如："aiCompletion.cacheEnabled": false；
6、保存设置并重启CodingPlan，后续该插件将仅使用内存缓存，退出即释放。
五、迁移用户数据目录至大容量分区
若本地C盘或系统盘长期处于紧张状态，且上述清理后仍频繁触发空间告警，可将CodingPlan的整个用户数据根目录（含配置、缓存、扩展、全局模板）整体迁出，从根本上隔离其对系统盘的压力。
1、关闭CodingPlan，备份原目录：~/.codingplan（Mac/Linux）或%APPDATA%\ArkCodingPlan（Windows）；
2、将该目录完整复制到D盘、E盘或外接SSD的指定路径，例如：D:\codingplan-data\；
3、在终端或命令提示符中，执行符号链接创建（Mac/Linux）：ln -sf D:/codingplan-data ~/.codingplan；
4、Windows需以管理员身份运行命令提示符，执行：mklink /J "%APPDATA%\ArkCodingPlan" "D:\codingplan-data"；
5、验证链接有效性：在终端中输入ls -la ~/.codingplan（Mac/Linux）或dir %APPDATA%\ArkCodingPlan（Windows），确认指向新路径；
6、启动CodingPlan，观察启动日志是否加载来自新路径的配置与缓存，确认迁移生效。
