VNC 仿真实践完整使用指南

一、整体流程（你需要做什么）

1. 注册并登录学习平台。
2. 确认已具备申请VNC实操环境的权限（未开通时请加入处芯积律知识星球或联系管理员）。
3. 在个人电脑上安装任意一款常用 VNC 客户端（见第二节）。
4. 在网站内申请远程环境，等待分配完成（通常数十秒级，请勿重复点击）。
5. 打开“用户中心 → 我的 VNC 连接”，复制服务器地址、端口、用户名与 VNC 密码。
6. 用 VNC 客户端按 服务器:端口 连接，输入凭据进入远程 Linux 桌面。
7. 在远程桌面打开终端，按课程要求准备个人练习目录，从 /project 复制只读工程到个人目录，再按讲义执行仿真命令。
8. 将 EDA 环境、alias 等个人配置写在实践目录 ~/cxjl_practice/ 下的环境文件（勿只改 /home/cxjlXX/.cshrc）；申请 VNC 后新开终端会自动加载，详见第六节。
9. （可选）若需在 VNC 内使用 Claude 终端助手：先在网站「我的 VNC 连接」页填写配置并保存，再在远程桌面按指南启动；详见下文第九节。

二、在本机安装 VNC 客户端

平台不强制指定唯一品牌，可使用常见客户端，如 TightVNC、RealVNC Viewer、TigerVNC。

Windows

• 从官网下载 Viewer（仅需连接远程，不必安装完整服务端）。
• 按安装向导完成安装；首次连接若系统防火墙提示，允许该客户端访问网络。
• 连接目标填写为 服务器地址:端口号（英文冒号，端口以页面显示为准）。

macOS

• 可使用 RealVNC Viewer、TigerVNC 等。
• 新建连接时主机填服务器地址，端口填页面给出的 VNC 端口。

Linux

• 可使用 Remmina 或 vncviewer（TigerVNC）。
• 命令行示例：vncviewer 服务器地址:端口。

三、在网站上申请远程环境

1. 使用浏览器登录平台。
2. 点击右上角用户头像，在下拉菜单中选择“申请VNC实操环境”。
3. 若系统检测到已有有效会话，会直接弹出当前连接信息。
4. 若尚无会话，按需选择使用时长、桌面环境、分辨率后提交申请。
5. 申请成功后会展示服务器地址、端口、用户名、VNC 密码，请及时保存。

四、查看连接信息并建立 VNC 连接

1. 进入“用户中心 → 我的 VNC 连接”（一般路径 /projects/my-tasks/vnc-account）。
2. 查看服务器地址、端口号、用户名、VNC 密码及连接地址。
3. 将连接信息填入本机 VNC 客户端并连接；首次连接输入 VNC 密码。
4. 注意会话有效期（北京时间），过期后需重新申请。

五、进入桌面后：个人目录与只读工程路径

• 个人练习目录（可写）：/home/USER/cxjl_practice。
• 课程只读源码统一在 /project/ 下。
• 八大项目的推荐只读子路径、难度梯度与学习方式见 IC 仿真实践 页项目列表与分阶段方案。
• 请勿在 /project 源目录直接改动，务必复制到个人目录后再练习。

个人工作区跨端口保留（与平台账号绑定）

个人练习目录 ~/cxjl_practice 绑定的是平台登录账号，而不是某一次 VNC 端口或某个 cxjl Linux 用户名。 因此：今天从端口 5910 进入、明天从 5915 进入，或系统分配到不同的 cxjl10 / cxjl11 等账号时， 只要仍在 ~/cxjl_practice 及其子目录中操作，即可继续看到上次保存的工程、仿真结果与个人配置（如 examapp_user_env.*）。

请勿在 /home/USER/ 下另建与 cxjl_practice 同级的目录存放工程（如 cxjl_practice1），否则换端口或换 cxjl 账号时可能无法随平台账号保留。

长期未使用时的自动清理

为合理使用服务器资源，若连续 30 天未再使用个人工作区（以在网站成功申请 VNC 时刷新活跃时间为准；非仅网站登录）， 且当时没有进行中的 VNC 会话，系统将自动清理该账号绑定的个人工作区目录。 重要成果、源码修改与仿真数据请自行备份到本机或 Git 仓库，勿把唯一原件只存放在教学环境中。

六、个人环境配置（跨会话保留，推荐）

换端口（如 5910 → 5911）或隔天再申请时，可能分配到不同的 Linux 账号（cxjl10、cxjl11 等）。 写在 /home/cxjlXX/.cshrc 或 ~/.bashrc 里的个人 alias 不会随平台账号带走； 请把 alias、setenv、自定义 export 等写在与平台账号绑定的实践目录中。

重要：远程桌面默认终端是 Bash（提示符形如 [cxjl11@myhost …]$），与 tcsh 语法不同。 Bash 请用 .sh，tcsh 请用 .csh；切勿在 Bash 里 source …examapp_user_env.csh，否则会报「语法错误：未预期的文件结尾」。

• Bash 终端 / make（推荐）：/home/USER/cxjl_practice/examapp_user_env.sh
• tcsh 终端：/home/USER/cxjl_practice/examapp_user_env.csh
• 通用入口（Bash）：~/cxjl_practice/examapp_user_env（内部会加载 .sh）
• 示例参考：examapp_user_env.csh.example
• 说明文件：处芯积律_环境配置说明.txt（首次申请 VNC 后在实践目录自动生成）
• 网页入口：我的 VNC 连接 →「个人环境配置」卡片

EDA 工具链：首次申请 VNC 后，系统会在上述文件中自动写入 EDA 加载段（source /eda/env_init.tsh），一般无需再手动添加。 若需自定义 alias 等，可编辑对应文件；tcsh 专用写法请写在 .csh，Bash 写法请写在 .sh。

自动加载：申请 VNC 成功后，系统会在 ~/.bashrc（Bash）与 ~/.cshrc（tcsh）写入自动 source 段，新开终端即可使用 vcs 等命令。

当前终端已打开时，请按 Shell 类型手动执行：

# Bash 终端（默认，make 前也用这个）
source ~/cxjl_practice/examapp_user_env.sh

# tcsh 终端
source ~/cxjl_practice/examapp_user_env.csh

曾写在旧 ~/.cshrc 的 tcsh 配置请复制到 examapp_user_env.csh；Bash 相关配置请写在 examapp_user_env.sh。修改后重新申请 VNC 或新开终端生效。

七、完成一次代码仿真（通用流程）

具体命令以当期讲义为准，以下为通用流程：

# 将 USER 替换为您的 VNC 用户名
cd /home/USER/cxjl_practice

# 示例：复制 SoC V1.1 到个人目录
cp -a /project/SOC_V1.1/To_Customer ./SOC_V1.1_To_Customer_my
cd ./SOC_V1.1_To_Customer_my/soc
ls -la

# 新开 Bash 终端会自动加载 EDA；当前终端若找不到 vcs，请先执行（Bash 用 .sh，勿用 .csh）：
# source ~/cxjl_practice/examapp_user_env.sh
# make comp 等命令需在已加载 EDA 的同一终端中执行

进入课程指定仿真目录后，按讲义执行 make/脚本/yrun 等命令。

八、常见问题

• 连不上：核对 IP 与端口，检查网络或防火墙，会话是否过期。
• 密码错误：使用“我的 VNC 连接”页显示的 VNC 密码，不是网站登录密码。
• 权限不足：确认在 /home/USER/cxjl_practice 下操作，而不是 /project。
• 命令找不到（如 vcs）：先确认当前是 Bash 还是 tcsh；Bash 执行 source ~/cxjl_practice/examapp_user_env.sh，tcsh 执行 source ~/cxjl_practice/examapp_user_env.csh；或新开终端（系统会自动加载）。勿在 Bash 里 source .csh 文件。
• source …examapp_user_env.csh 报语法错误：说明当前是 Bash 终端，请改用 source ~/cxjl_practice/examapp_user_env.sh。
• 换端口后配置丢失：环境应写在实践目录 examapp_user_env.sh / examapp_user_env.csh，不要只改当前 cxjl 账号 home 下的 .bashrc / .cshrc。
• 换端口后工程找不到：请确认文件保存在 ~/cxjl_practice 内；该目录与平台账号绑定，换端口或换 cxjl 用户仍可找回。
• 个人文件夹被清理：连续 30 天未在网站申请 VNC（未刷新工作区活跃时间）时系统会自动清理；重要数据请定期备份到本机。
• 中文输入：桌面启动后会尝试启动 ibus（或 fcitx），并尽量注册 D-Bus 会话总线。若仍无法切换中文，请确认服务器已安装 ibus、ibus-libpinyin 等，并重新申请一次 VNC 以刷新 ~/.vnc/xstartup；终端里可试 Super+空格 / Ctrl+空格，或在终端执行 ibus-setup 添加「智能拼音」引擎。
• 使用 claude 报错 EACCES … /claudehome/.claude/debug：请确认用的是 which claude 显示的 ~/bin/claude（勿直接跑 /usr/local/bin/claude），在官网「我的 VNC 连接」再点一次保存并生效以更新启动脚本；仍失败请联系管理员执行 launcher 修复。
• 使用 claude 时其它异常，请保留终端提示信息并联系管理员协助处理。

九、Claude 在网站上的配置与在服务器上使用（可选）

平台支持在网页端为你的 VNC 实践 Linux 账号下发 Claude CLI 所需环境变量（代理 Base URL、API Key、模型名等），你在远程桌面终端中直接使用 claude 或提供的启动脚本即可。以下为推荐流程。

1. 在官网上配置（保存到平台，而非只存在本机浏览器）

1. 使用浏览器登录学习平台。
2. 打开 用户中心 → 我的 VNC 连接（与查看 VNC 地址、密码为同一页：/projects/my-tasks/vnc-account）。
3. 向下滚动到 「Claude 配置（VNC 专属）」卡片。
4. 填写：
   • 代理侧网址（Base URL）：你使用的 Anthropic 兼容代理根地址（示例形态：http://127.0.0.1:3000，以实际服务为准）。
   • Claude API Key：由你的代理或上游服务提供的密钥；每次点击「保存并生效」时需重新输入完整 Key（页面会显示已保存 Key 的脱敏片段便于辨认）。
   • 模型名：与上游支持的 ID 一致。Claude 代理常用 claude-sonnet-4-6；DeepSeek 官方请 Base URL 填 https://api.deepseek.com/anthropic，模型如 deepseek-v4-flash、deepseek-chat（见 DeepSeek API 文档）。
5. 配置页会根据你填写的 Base URL 自动识别接入方式（如 DeepSeek 官方、Anthropic 兼容代理等），并可在模型名为空时推荐默认模型 ID。
6. 点击 「保存并生效」。配置会写入平台数据库，并与你的账号绑定；终止当前 VNC 会话不会删除该配置，下次申请 VNC 成功后系统会再次下发到新的实践环境。
7. 若不再需要，可在同一卡片点击 「停用配置」，将停止为后续会话注入 Claude 环境。

2. 在服务器（VNC 远程桌面）上使用

1. 按第四节连接进入远程 Linux 桌面，打开终端。
2. 在「我的 VNC 连接」页的 Claude 卡片中查看 「当前受限目录」（有活跃会话时会显示服务器上的绝对路径）。请先进入该目录再启动 Claude，例如：

   cd /home/你的实践用户名/…   # 以页面显示为准
   claude

   若站点提供了 ./claude_practice.sh，也可在同一目录下执行该脚本（以你环境中实际文件为准）。
3. 安全与沙箱说明：服务端启用 bubblewrap 时，通过平台下发的 claude 入口通常仅能访问你的实践工作目录（在沙箱内映射为 /workspace）。请勿绕过平台入口直接执行 /usr/local/bin/claude，否则可能不受上述目录限制。
4. 启动前可自检：which claude 应指向 $HOME/bin/claude；ls -la ~/.claude_runtime/home/.claude 应对当前用户可写。
5. 若在终端使用 claude 时出现 EACCES: permission denied, open '/claudehome/…'，多为未走平台启动器或启动器过旧；请重新保存并生效 Claude 配置后重试。
6. 若出现 Unable to connect to API (EHOSTUNREACH) 且界面仍像连旧代理：请确认 which claude 为 ~/bin/claude，并在官网重新保存并生效（旧版启动器未把 DeepSeek 地址传入沙箱时会误连 1.95.142.151:3000，实践账号防火墙会拒绝）。DeepSeek 官方 Base URL 须为 https://api.deepseek.com/anthropic。