Developers
Sidecar 管理
查看、管理和修复 WinCode 开发者模式中的 Sidecar 本地依赖组件
Sidecar 管理
Sidecar 是 WinCode 在本地运行所需的依赖组件，包括 Node.js 运行时和 Claude Code CLI。开发者模式下，您可以查看它们的状态、手动触发更新，以及修复下载失败等问题。
查看 Sidecar 状态
进入 设置 > 开发者模式，在 Sidecar 组件 区域可以查看所有本地依赖的当前状态：
| 状态 | 含义 |
|---|---|
| 已就绪 | 组件已下载完毕，版本正确，可以正常使用 |
| 下载中 | 正在下载组件，请耐心等待 |
| 更新可用 | 有新版本可用，WinCode 会在合适时机自动更新 |
| 下载失败 | 下载过程中遇到错误，需要手动处理 |
| 未安装 | 组件尚未下载，通常出现在首次开启开发者模式时 |
每个组件旁边会显示当前版本号。如果所有组件都显示"已就绪"，说明本地依赖环境完全正常。
手动检查更新
通常情况下，WinCode 会在后台自动检测 Sidecar 组件的更新，并在状态栏提示您。如果需要手动检查：
- 进入 设置 > 开发者模式。
- 在 Sidecar 区域点击 检查更新。
- 如果有新版本可用，WinCode 会提示您是否立即更新。
- 点击 立即更新 开始下载。更新过程中不影响 WinCode 的其他功能。
重新下载组件
如果 Sidecar 组件出现异常（例如对话功能突然无法使用，状态显示错误），可以尝试重新下载：
- 进入 设置 > 开发者模式 > Sidecar 组件。
- 找到需要重新下载的组件。
- 点击组件右侧的 重新下载 按钮。
- WinCode 会删除当前的组件文件并重新下载最新版本。
重新下载需要网络连接，下载完成后组件状态会恢复为"已就绪"。
清除所有缓存
如果多个组件都出现问题，或者重新下载后仍然异常，可以选择清除所有 Sidecar 缓存并重新开始：
- 进入 设置 > 开发者模式。
- 滚动到 Sidecar 区域底部。
- 点击 清除所有 Sidecar 数据。
- 确认操作。WinCode 会删除所有已下载的本地依赖。
- 重新开启开发者模式（或关闭后再开启），WinCode 会自动重新下载所有必需组件。
此操作不会删除您的对话记录、设置或其他个人数据，只会清除运行时依赖文件。
存储空间管理
Sidecar 组件存储在 WinCode 的应用数据目录中，默认占用约 250MB 空间。如果您需要释放空间：
- 临时清除：按照上述步骤"清除所有 Sidecar 数据"，在不需要开发者模式时保持关闭状态。
- 完全移除：关闭开发者模式后，手动删除应用数据目录中的 sidecars 文件夹。详见 环境准备 中的存储位置说明。
常见问题
组件下载卡在某进度不动？
可能是网络波动导致。建议等待几分钟后，点击"重新下载"。如果反复出现，检查网络连接是否正常，或尝试切换到手机热点下载。
下载完成后仍显示"未安装"？
可能是权限问题。请确保 WinCode 对应用数据目录有写入权限。在企业管控的电脑上，可能需要联系 IT 部门解除限制。
更新后旧版本占用空间？
WinCode 在更新时会自动清理旧版本文件。如果发现磁盘空间异常，可以手动检查应用数据目录中的 sidecars 文件夹，删除明显的旧版本目录。