故障排除

Digital Design Studio:故障排查。查看 Windows 2.1.2.3、Linux 2.1.2.3 或 Cloud 2.1.2.10 的要求与故障排查步骤。

Overview

先确定准确的产品、版本、操作系统、架构、命令和错误文本。保持签名验证启用。

首先将机器与系统要求与网络进行比较。记录操作系统、架构、桌面环境或浏览器的任何差异。

下载未开始

公共安装程序无需登录。使用当前下载页面。HTTP429表示达到请求限制;请等待提示的重试间隔。HTTP503表示已批准产物或其验证材料不可用。如果持续失败,请提供准确 URL 和消息。

对于 Windows 2.1.2.3,请使用官方页面提供的已签名下载,并按照Windows 安装操作。记录下载渠道、软件包版本和准确的错误。

软件包无法安装

确认以下所有事项:

  • 计算机是在 amd64/x86_64 上的 Ubuntu 24.04 LTS,与已验证的 Linux 2.1.2.3 环境一致;

  • 文件名和校验和与下载页面一致;

  • debsig-verify按照已发布策略和密钥环接受该软件包;

  • 命令使用sudo apt install ./FILE.deb,包括./;

  • 软件包管理器没有报告未解决的依赖或磁盘空间问题。

保留完整的apt错误。不包含失败软件包和依赖名称的普通截图通常不足以诊断安装问题。

搜索中找不到应用

软件包安装和桌面启动器发现是独立检查。先尝试运行已安装命令:

Bash
altifigence-ide

如果应用搜索尚未刷新,请退出 Linux 桌面会话并重新登录。使用 dpkg -l | grep altifigence 检查已安装的软件包,并将其与已验证的 .deb 比较。

浏览器登录未返回应用

桌面浏览器登录期间,请在浏览器返回本地 127.0.0.1 回调时保持应用打开。如果回调失败,请记录准确的错误和时间。

未签发许可证

对于 Windows 2.1.2.3,请打开 My PC 项目以使用本地编辑、保存和 GDS 查看。为 Testbench 流程安装可选 OSS 仿真器。其他操作不可用时,请记录所选主机和准确的消息。

CLI 命令不可用

验证安装后,请使用已安装的执行文件:

Bash
alti version
alti capabilities
alti commands

release install 引导程序安装功能和受保护本地运行器所用的已签名布局。遇到安装或功能错误时,请记录准确的可执行文件路径、发布目录和诊断,然后按照 Install on Linux 操作。

使用 alti commands 查看本地命令,使用 alti capabilities 查看已安装的功能目录。请在支持请求中保留准确的命令、诊断和退出状态。

对于离线验证错误,请使用非敏感源码运行 CLI First Success 示例。将 stdout、stderr 和退出状态分开保留,并一同记录准确的命令和工作区路径。

收集最小诊断报告

逐个运行只读检查。不要以管理员身份运行应用,也不要收集整个主目录或应用数据目录。

有用信息包括:

  • 以下命令的输出:uname -s和uname -m;

  • NAME、VERSION_ID以及VERSION_CODENAME,来源为/etc/os-release;

  • 对于已安装桌面产品,以下命令报告的准确软件包名、版本和架构:dpkg-query;

  • 以下命令是否command -v altifigence-ide找到 Digital Design Studio 启动器;

  • 下载文件名和本地计算的 SHA-256;

  • 准确界面标题或 CLI 错误码、退出状态及故障发生的大致本地时间。

分享日志或截图前,检查每一行。删除源代码文本、敏感的绝对项目路径、案例不需要的邮箱地址、令牌、Cookie、授权码、私有下载链接、私钥和第三方工具许可证数据。优先提供仍包含失败操作及完整错误的最小片段。

联系

将支持问题发送至contact@altifigence.com。仅包含:

  • 产品、版本、操作系统和架构;

  • 发生失败的准确命令或界面;

  • 完整错误文本和大致时间;

  • 相关时提供产物文件名及计算的 SHA-256。

同时说明预期结果、实际结果,以及是否可通过新的非敏感项目或 CLI 离线预检复现问题。

附加诊断资料前,删除项目源代码、专有日志、访问令牌、Cookie、私钥和个人数据。

查找合适的恢复指南

症状

优先检查

指南

Windows 更新处于等待状态

打开的 DDS 窗口和软件包正在使用的消息

Windows 安装

WSL 项目断开连接

发行版、Linux 用户和原始文件夹身份

Windows / WSL

Cloud 项目无法打开

所选组织、账户访问权限和项目

运行时控制

保存时报告冲突

最新已保存修订和未保存编辑器文本

本地工作区

MCP 已连接但工具缺失

连接范围及该连接显示的工具目录

MCP 错误

2.0.2 功能检查

  • 对于来自 Digital Design Studio 2.0.2 的项目,在 Windows 2.1.2.3 上使用 本地 → 此电脑上的项目 → 打开示例。应用在为新用户自动打开示例前会检查首次运行资格。

  • 对于 Windows Testbench 编译或 include 错误,请阅读仿真器日志与 Verilog settings guide。

  • 对于 Windows My PC 项目的内置 GDS 视图中的文件错误,请选择保存在项目中、非空且不超过 4 MiB 的 .gds 或 .gdsii 文件。

  • 对于 Agent,请记录显示的原因并阅读Agent 指南。

  • 对于存储或 QUOTA 限制,请保留工作并阅读 Cloud storage 或 weekly QUOTA。

  • 有关更新或回滚,请按照 Update, move and roll back 操作,并保留确切的安装程序/错误。

Using Digital Design Studio 2.0.2

对于来自 Digital Design Studio 2.0.2 的项目,请在当前主机上使用这些检查:Windows 2.1.2.3、Linux 2.1.2.3 或 Cloud 2.1.2.10。严重错误或保存失败时可能提供私密错误报告。请审阅报告,然后选择“发送报告”。支持人员保留报告 30 天。自动数据包括预定义的错误代码、组件和阶段、桌面或 Cloud 界面、产品/平台/版本信息、发生次数和时间、项目保护状态及随机报告 ID。如果提供可选评论,请在发送前审阅全文并确认。请勿包含源码文本、NDA 材料、凭据或个人数据。高亮行可在确认前删除。受保护或未经确认的项目使用预定义的自动数据。报告存储评论确认时间和版本。分享前请审阅所有信息;Community 帖子是公开的。

将所选主机、输入文件、工具版本、诊断和保存的输出与每项结果一起保留。

2.0.2 支持参考

单击 X 后应用程序仍在运行

在 Windows 2.1.2.3 上,默认的隐藏到托盘设置让 X 隐藏窗口而工作继续进行。使用托盘图标 → 打开 Digital Design Studio 返回,或选择退出以在检查未保存的工作后退出。在 设置 → 桌面 → 关闭窗口时 中更改设置。重试报告软件包正在使用的更新前,请关闭其余 DDS 窗口。