疑难排查

解决当前 Cordy Desktop 构建中的安装、运行时、终端、浏览器、项目工具与诊断问题。

Windows 安装程序警告

已发布 0.3.0 安装程序尚未签名。Windows SmartScreen 可能显示「Windows 已保护你的电脑」。确认取得的是预期 Release 资产后，选择更多信息 → 仍要运行。

运行时状态

点击运行时或 CPU / 内存状态查看详情。

  • **binary missing：**源码检出中运行 pnpm runtime:build；打包构建请重装匹配包，或设置 CORDY_RUNTIME_BIN。
  • **incompatible：**应用与运行时协议版本不同。请从同一源码重建，或重装匹配包。
  • **crashed：**Cordy 使用从 1 秒到最多 30 秒的指数退避重启。反复崩溃会出现在运行时历史与日志中。

手动执行重启运行时会结束当前所有终端与智能体会话，因此有实时会话时会先确认。

终端输入

  • **Shift+Enter 提交而不换行：**Windows 键盘协议支持位于 0.4.0 源码 / 标签中，而该 Release 尚未发布。已发布 0.3.0 不包含此更改。
  • **在接管鼠标的 TUI 中复制：**按住 Shift 拖动，再按 Ctrl+C 或 Ctrl+Shift+C；macOS 也可用 Option 拖动强制选择。
  • **Ctrl+C 中断：**普通 Shell 中，没有选区时它是中断。CLI 请求 kitty 键盘模式后，由 CLI 接收并解释按键事件。
  • **中文 IME 或听写：**当前输入处理接受组合输入与无键码粘贴事件。旧的已发布构建若失败，请升级到包含 0.1.3 修复的已发布版本，或运行匹配的新源码。
  • **Previous session restored：**完整退出后，该横幅表示本地终端历史已恢复到新 Shell 上方；旧进程不再运行。

浏览器

  • **权限被拒：**Cordy 只询问剪贴板读写与全屏。摄像头、麦克风、地理位置和未列出权限会按策略拒绝。
  • 站点仍保持登录：使用设置 → 站点数据 → 退出登录清除该主机，或清除全部浏览数据。
  • **密码填充不可用：**激活一个协议、主机与端口均和保存凭据完全匹配的内置浏览器标签。
  • 下载目录不对：检查设置 → 下载，包括每次询问保存位置。

项目工具

  • **搜索工具不可用：**安装 rg（ripgrep），确保应用可找到，再重试。
  • **提交按钮不可用：**至少暂存一个文件，并输入提交摘要。
  • **改动列表被截断：**隐藏行不能从面板暂存或丢弃；请在终端使用 Git，或缩小工作集。
  • **加载时历史移动：**刷新 Graph，从当前分支顶端重新开始。

诊断

紧凑性能概览提供 2 分钟、10 分钟与 1 小时图表，并有查看详情操作。Workload 部分只在 Windows 可用。

打开设置 → 诊断查看本地日志与存储占用。日志包导出会创建 ZIP；时间范围可选一小时、24 小时、7 天或全部，内容可选主进程日志、运行时日志、诊断事件与系统信息。默认四项全选。

完整性能监视器有另一项导出，会写入带时间戳的本地文件夹，其中包含：

  • 应用与环境信息、指标和运行时重启历史；
  • 最近的结构化事件；
  • main.log 与 runtime.log 的尾部。

两种导出都会脱敏绝对路径与类似路径的值。Cordy 不会上传任何一种；请检查内容后自行附到问题报告。用户数据目录中的 logs/ 保存日志，diagnostics/ 保存事件，Crashpad/ 保存原生崩溃转储。

相关