问题排查
安装时弹出发布者警告
Section titled “安装时弹出发布者警告”Beta 构建在代码签名前,SmartScreen/Defender 警告是正常显示。按下载页面的”首次运行说明”仅允许一次,此后就不再显示。安装文件较大,首次扫描可能需要些时间 —— 若窗口没立即弹出,请稍候再重新运行。
VNC 远程画面
Section titled “VNC 远程画面”新建标签页菜单 → VNC 连接… 或保存的连接。输入项:
| 项目 | 默认值 | 说明 |
|---|---|---|
| 主机 | — | VNC 服务器 IP 或域名 |
| 端口 | 5900 | VNC 默认端口 |
| 密码 | — | VNC 认证密码 |
| 保存名称 | — | 输入则注册到保存的连接 |
通过 SSH 隧道访问内网 VNC
Section titled “通过 SSH 隧道访问内网 VNC”打开连接对话框的 SSH 隧道 选项,即可经 bastion 服务器访问内网 VNC。无需在防火墙外部直接开放 5900 端口。
| 按钮 | 行为 |
|---|---|
| 剪贴板发送 | 将本地剪贴板发送到远程 |
Ctrl+Alt+Del | 向远程 PC 发送 Ctrl+Alt+Del |
| 📁 FT | 切换文件传输面板 |
剪贴板快捷键
Section titled “剪贴板快捷键”Ctrl+Shift+V—— 仅将本地剪贴板发送到远程(不发送粘贴键)Ctrl+V—— 发送 + 连远程的粘贴键一起发送
文件传输(TightVNC 2.x FT)
Section titled “文件传输(TightVNC 2.x FT)”文件传输面板功能:
| 功能 | 方法 |
|---|---|
| 文件夹浏览 | 点击列表,↑ 上级文件夹 |
| 刷新 | ↻ 按钮 |
| 新建文件夹 | ➕ 按钮 |
| 上传 | ⬆ 按钮(可多选文件) |
| 下载 | 双击 / 右键 / 勾选后下载 |
| 重命名 / 删除 | 右键菜单 |
上传同名文件时会显示覆盖确认消息。
若文件名乱码,请更改面板顶部的编码下拉(默认 UTF-8)。更改时会自动重连。
VNC 问题排查
Section titled “VNC 问题排查”| 症状 | 原因 | 处理 |
|---|---|---|
| 连接失败 | 主机·端口·密码错误 | 重新确认连接信息,确认服务器 VNC 是否运行 |
| 无法访问内网 | 防火墙拦截 | 打开 SSH 隧道选项 |
| 没有文件传输面板或出错 | 非 TightVNC 2.x 服务器 | 更换为 TightVNC 2.x 服务器 |
| 文件名乱码 | 服务器编码不一致 | 在编码下拉中选择服务器编码(如 EUC-KR) |
| 能看到画面但剪贴板不通 | 服务器剪贴板禁用 | 在 VNC 服务器设置中启用剪贴板共享 |
WinRM —— 远程 Windows PowerShell
Section titled “WinRM —— 远程 Windows PowerShell”新建标签页菜单 → WinRM(远程 Windows)…。输入项:
| 项目 | 默认值 | 说明 |
|---|---|---|
| 主机 | — | 远程 Windows PC IP 或域名 |
| 用户 | — | Windows 本地或域账户 |
| 密码 | — | 账户密码 |
| 端口 | 5985(HTTP)/ 5986(HTTPS) | 通过 HTTPS 使用切换选择 |
| 使用 HTTPS | 关闭 | 开则 5986,关则 5985 |
| 保存名称 | — | 输入则注册到保存的连接 |
远程 PC 前置条件
Section titled “远程 PC 前置条件”在远程 PC 上以管理员身份打开 PowerShell 并执行以下命令:
Enable-PSRemoting -Force若非域环境而是工作组或直接 IP 连接,需在客户端 PC 上配置 TrustedHosts。点击连接对话框的 “添加信任此主机” 按钮会自动处理。
要手动配置:
# 在管理员 PowerShell 中执行Set-Item WSMan:\localhost\Client\TrustedHosts -Value "目标IP或主机名" -Force工作方式及限制
Section titled “工作方式及限制”- 在控制台输入 PowerShell 命令并按 Enter 执行。
- 用 ↑ / ↓ 键浏览命令历史。
- 这是每条命令建立新连接的命令式方式(不保持会话状态)。
- 不支持
Read-Host这类交互式提示。
WinRM 问题排查
Section titled “WinRM 问题排查”| 症状 | 原因 | 处理 |
|---|---|---|
| ”访问被拒绝”错误 | 账户权限不足 | 使用管理员账户或加入允许远程管理组 |
| 连不上(工作组) | 未配置 TrustedHosts | 点击对话框”添加信任此主机” |
| 连不上(防火墙) | 5985/5986 端口被拦截 | 在远程 PC 防火墙中允许 WinRM 端口 |
| 无 WinRM 服务 | PSRemoting 未启用 | 在远程 PC 上执行 Enable-PSRemoting -Force |
| HTTPS 证书错误 | 自签名证书 | 改用 HTTP(5985)连接或配置证书信任 |
| 菜单中没有 WinRM | 正在 macOS 上运行 | Windows 专用功能,请在 Windows PC 上使用 |
屏幕区域捕获(📷)
Section titled “屏幕区域捕获(📷)”点击标签栏的 📷 按钮,屏幕上会覆盖一层透明叠加层。
- 用鼠标拖动选择要捕获的区域(含外接显示器)。
- 捕获的图片会在标记编辑器中打开 —— 可用箭头·文本·荧光笔添加注释。
- 点击 “发送给 AI” 按钮,图片会附加到已打开的 AI 聊天中。
桌面镜像(实时流传输)
Section titled “桌面镜像(实时流传输)”新建标签页菜单 → 🖥️ 桌面捕获… → 在窗口列表中选择应用后,该窗口会在面板中实时流传输(仅查看)。
- AI 可用
panel_screenshot工具查看镜像画面。 - Web 预览面板可用 ✏️ 按钮捕获后发送给 AI。
全面问题排查
Section titled “全面问题排查”应用崩溃·画面变白的情况
Section titled “应用崩溃·画面变白的情况”| 症状 | 原因 | 处理 |
|---|---|---|
| 画面变白并自动重载 | 渲染进程崩溃 | 自动恢复 —— 正常行为 |
| 30 秒内反复崩溃 3 次以上 | GPU 驱动或内存问题 | 更新 GPU 驱动后重新运行 |
| 重载后仍持续白屏 | 严重的渲染器错误 | 查看 crash.log 后咨询 |
崩溃日志位置:%APPDATA%\Blyck\crash.log
发生崩溃时:
- 打开
crash.log查看最后的错误内容。 - 用
F12打开开发者工具,在控制台标签中查看错误。 - 若仍未解决,请将
crash.log和logs\blyck.log附加到咨询页面。
卡顿·按键输入延迟
Section titled “卡顿·按键输入延迟”| 症状 | 原因 | 处理 |
|---|---|---|
| 5~10 秒卡顿后自动恢复 | RAG 重新索引或 LSP 初始化中主线程阻塞 | 稍候 |
| 反复卡顿 | 资源争用 | 附加 blyck.log 后咨询 |
| AI 作业中长时间卡顿 | 回合后挡(60 分钟)或 2 分钟无响应处理 | 用 ■ 停止按钮强制中断 |
Blyck 在应用启动时以及每 4 小时间隔从 update.blyck.dev 检查更新。新版本会在后台下载后于应用退出时自动安装。
| 症状 | 原因 | 处理 |
|---|---|---|
| 更新不生效 | 应用未完全退出 | 连托盘图标一起完全退出后重新运行 |
| 下载失败 | 公司网络拦截 CDN | 请 IT 团队放行 update.blyck.dev 或手动安装 |
| 检查不到更新 | 离线环境 | 联网后重启 |
| 症状 | 原因 | 处理 |
|---|---|---|
| 显示全屏锁定 | 14 天试用结束 | 粘贴许可证密钥进行认证 |
| ”订阅已到期” | 订阅到期或取消 | 在 Lemon Squeezy 门户中查看订阅状态 |
| 认证失败 | 离线状态 | 联网后重试 |
| ”已注册到其他设备” | 设备注册超额 | 在 Lemon Squeezy 门户中管理设备 |
| 认证后过 7 天被锁定 | 离线 grace period 超出 | 联网后重启应用重新校验 |
DB 连接相关
Section titled “DB 连接相关”| 症状 | 原因 | 处理 |
|---|---|---|
| 连接超时 | 网络·防火墙拦截 | 确认主机·端口·防火墙规则。PG/MySQL 10 秒,MSSQL 15 秒 |
Oracle ORA-xxxxx | 服务端错误(服务名·账户锁定等) | 重新确认服务器连接信息 |
Oracle NJS-116 | 不支持 Thin 模式的环境 | 勾选强制 Thick + 设置 64 位 Instant Client 路径 |
Oracle NJS-118 | Thick 初始化错误 | 重启应用后重试 |
| MySQL BIGINT 显示为字符串 | 超过 2^53 的精度保护 | 正常行为 —— 非 bug |
| 连接池会话激增 | — | 由连接池(最多 4 个)自动管理,无问题 |
更多 DB 相关问题请参阅 DB 客户端 页面。
Web 预览相关
Section titled “Web 预览相关”| 症状 | 原因 | 处理 |
|---|---|---|
| 页面加载不出来 | 开发服务器未运行 | 先运行本地开发服务器后输入 URL |
preview_eval 立即失败 | 页面尚在加载中 | preview_wait 工具后重试 |
| 画面空白卡住 | URL 错误或服务器错误 | 确认 URL 和服务器状态 |
详情请参阅 运行 · 预览 页面。
RAG 检索相关
Section titled “RAG 检索相关”| 症状 | 原因 | 处理 |
|---|---|---|
| 无结果或显示旧文件 | 索引未更新 | 聊天设置 → 确认 RAG 索引状态 |
| 已删除文件仍被检索到 | Orphan 条目 | 运行 Orphan Scan 清理工具 |
| 结果噪声太多 | 索引了不必要文件 | 用 .termeditignore 添加排除模式 |
| 更换嵌入模型后结果异常 | 重新索引进行中 | 等待重新索引完成 |
RAG 索引管理请参阅 RAG 检索 页面。
SSH 连接相关
Section titled “SSH 连接相关”| 症状 | 原因 | 处理 |
|---|---|---|
| 卡在密码输入 | 非标准提示(检测等待最多 30 秒) | 直接输入或使用密码保存 |
| 自动重连失败 | 密码专用服务器(重连时不重用密码) | 配置密钥/agent 认证或手动重连 |
| 仅 SFTP 失败 | SFTP 子系统禁用 | 在文件面板中手动重新连接 |
| 中文乱码 | 服务器区域设置 | 用服务器 locale 确认 *.UTF-8 |
详情请参阅 终端 · SSH · SFTP 页面。
AI 功能相关
Section titled “AI 功能相关”| 症状 | 原因 | 处理 |
|---|---|---|
| AI 聊天禁用 | CLI 未安装或未登录 | 在准备向导中安装·登录 CLI |
| 401/403 错误 | API 密钥过期或错误 | 重新注册密钥或重新执行 claude login |
| 收不到响应 / 卡住 | 网络或认证过期 | 自动重试 3 次后重新登录,开始新聊天 |
| 没有审批卡片文件就被改 | 🚀 自动模式启用 | 用 Ctrl+3 切换为 ⚡ 执行+评审模式 |
详情请参阅 AI 聊天 页面。
LSP 自动完成相关
Section titled “LSP 自动完成相关”| 症状 | 原因 | 处理 |
|---|---|---|
| Python 自动完成不工作 | Pyright 未安装 | 首次打开 Python 文件时批准”下载?”模态 |
| Go 自动完成不工作 | 无 Go 工具链 | 安装 Go 后 go install golang.org/x/tools/gopls@latest |
| Rust 自动完成不工作 | rust-analyzer 下载失败 | 在可访问 GitHub 的环境中重启应用,或手动安装后注册 PATH |
| 公司网络下载失败 | GitHub 被拦截 | 直接安装相应服务器并注册到 PATH |
终端显示相关
Section titled “终端显示相关”| 症状 | 原因 | 处理 |
|---|---|---|
| 文字模糊 | WebGL 回退(Canvas/DOM) | 在设置中明确指定 Canvas 渲染器 |
| 全角字符对齐错乱 | 正在使用 DOM 渲染器 | 在设置中指定 Canvas 渲染器 |
| 中文乱码(本地) | — | Windows 自动应用 UTF-8,ipconfig 等原生 exe 用 PowerShell cmdlet 替代 |
想撤销错误的变更
Section titled “想撤销错误的变更”用 Ctrl+Shift+H 打开变更历史,文件·DB·SSH 变更都已记录。选择条目执行 撤销。DML 在执行前会自动备份数据,因此无 WHERE 的 UPDATE 也能恢复。
详细行为请参阅 Git · ChangeSet 页面。
日志·数据位置(Windows)
Section titled “日志·数据位置(Windows)”| 项目 | 位置 |
|---|---|
| 应用日志 | %APPDATA%\Blyck\logs\blyck.log(2MB 轮换) |
| 崩溃日志 | %APPDATA%\Blyck\crash.log |
| 连接信息(不含密码) | %APPDATA%\Blyck\connections.json |
| 布局(标签·分割) | %APPDATA%\Blyck\layout.json |
| AI 聊天记录 | %APPDATA%\Blyck\chats\ |
| 变更历史(ChangeSet) | %APPDATA%\Blyck\blyck-history.db |
| RAG 索引 | 各工作区的 SQLite 文件 |
密码和令牌不存放在文件中,而是加密保管在 OS 凭据存储 中。日志中密码·令牌·API 密钥·用户路径会自动屏蔽,且仅保存在本地,不会向外部传输。
无法解决的问题请发送到咨询页面。一并写上环境信息(OS·版本)和复现步骤,我们能更快地帮到你。Blyck 内部打开的辅助服务器(MCP·VNC 代理等)全部仅以 localhost 动态端口 + 令牌认证 打开,因此无需防火墙例外或开放端口。