NOVABERDocs

正在准备搜索…

    文档目录

    开始使用

    安装诊断与启动验证

    1.0.2

    Novaber · 内容核对

    本页目录

    安装报错或看起来已经装好却无法启动时,先判断卡在哪一层:主程序文件、当前启动、WSL / Docker、本机 GPU,还是应用与模型。重复安装不能代替这一步。

    下载并核对只读诊断脚本

    官方检测脚本只读取系统与安装证据,不安装软件、不启动主程序,也不主动上传报告。先对照技能资料清单核验该文件的 SHA-256,再阅读下载内容;不要把网络响应直接交给 Invoke-Expression。

    在目标电脑的普通 64 位 Windows 终端中,进入文件所在目录,选择一种已经安装的 PowerShell 运行:

    powershell.exe -NoLogo -NoProfile -File ./Test-NovaberSetup.ps1
    

    如使用 PowerShell 7,可改为 pwsh.exe -NoLogo -NoProfile -File ./Test-NovaberSetup.ps1。无需为诊断自动提升管理员权限;无法读取的项目会报告受限或未知。

    使用自定义安装目录

    powershell.exe -NoLogo -NoProfile -File ./Test-NovaberSetup.ps1 -InstallPath 'D:/Apps/Novaber/Novaber.exe'
    

    把示例替换成你已知的实际 EXE 路径。该参数只读取文件版本并检查所在盘的可用空间,不会运行文件。默认发现范围是卸载记录和标准路径,找不到不等于没有安装。

    -CommandTimeoutSeconds 可设置为 1–30 秒,默认 8 秒。超时仍是证据不足,不应直接解释为组件损坏。

    怎样理解报告结果

    脚本正常输出一个 schemaVersion: 1 的 JSON 对象,包含工具版本、UTC 检查时间及各项 checks。每项给出状态、原因分类与证据。退出码 0 只说明报告生成成功;同时检查终端中的权限或工具阻止信息。

    状态含义与下一步
    pass这一项观察成功;继续检查其他层,不等于整体安装完成。
    missing有缺失证据,确认需要此组件后再补齐。
    incompatible当前对象不符合检查范围,例如远程 Docker 或不匹配的架构。
    restart-required已发现等待重启的证据,处理后重新检查。
    permission-denied因权限或工具限制未能取证,不能当作没有安装。
    unknown超时、失败或资料不足,需补充观察后判断。

    哪些通过还不代表环境就绪

    • Windows:x64 桌面系统范围通过,不等于仍在微软或当前 Docker 版本的支持范围内。
    • 内存与磁盘:测得容量不代表满足所选应用。Docker 数据、模型和输出可能使用其他盘,需查看实际位置。
    • 虚拟化与重启:缺少固件字段不能断言 BIOS 已关闭虚拟化;没找到已知重启标志也不能保证无需重启。
    • WSL:启用系统功能不等于 WSL 版本足够。旧版内置 WSL 缺少版本命令时,应结合其他证据判断。
    • GPU:主机 nvidia-smi 成功,只证明主机侧观察;容器调用显卡要另行验证。
    • Docker:只检查已确认的本机引擎。远程上下文不是这台电脑的就绪证据;Linux 引擎响应后仍需核对 WSL2 后端。

    权限受限与未知结果

    脚本被拦截时,在自己的终端查看 Get-ExecutionPolicy -List,区分个人默认策略、组织策略与 AI 工具限制。组织策略由管理员处理;仅采用当前许可的运行方式,不全局放宽策略。策略详情见微软说明。

    若工具明确禁止 wsl.exe,不要重新运行仍会调用 WSL 的完整探测。其他检查获准时可使用脚本的 -SkipWsl;WSL 会保持受限状态,不会变成通过。你可以在自己的 Windows 终端执行 wsl --status 和 wsl --version,或通过工具的正式设置处理权限后再检查。

    核对安装文件与本次启动

    先等待交互式向导明确完成,再核对实际安装目录中的 Novaber.exe 版本,以及 resources/app.asar、resources/app-update.yml、resources.pak 和 icudtl.dat。文件版本尾部的第四位为 0 时可按同一三段发行版本核对,但保留实际观察值。不要在排障时运行卸载命令。

    打开实际 EXE 的父目录,确认使用的是这次安装的位置。快捷方式、卸载记录或旧日志只作补充;缺少快捷方式不必立即重装。自定义安装尤其应先核对已知路径。

    启动安装后的程序,观察本次环境检查是否结束、工作台是否出现及显示版本。进程存在、更新检查成功或开发模式截图,不能单独作为这次安装已可用的证明;窗口没有出现或很快消失时,记录现象并继续查原因。

    随后确认 Docker / WSL 和所选应用、模型,再用小任务与导出检查判断业务流程。历史安装包的只读解包记录没有验证静默参数、真实向导的取消和失败分支,也不能证明当前电脑已装好。

    分享报告与继续排查

    分享前检查自定义目录、错误文字和日志片段,移除密码、令牌、私有地址及无关个人信息。脚本会减少导出信息,但你填写的自定义路径仍可能含私人信息。

    准备问题反馈;需要重启或换助手时,按中断恢复保留必要交接信息。

    资料来源