VNC 仿真实践完整使用指南

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

1. 注册并登录学习平台。
2. 确认已具备申请VNC实操环境的权限（未开通时按页面提示完成星球 / 付费等要求）。
3. 在个人电脑上安装任意一款常用 VNC 客户端（见第二节）。
4. 在网站内申请远程环境，等待分配完成（通常数十秒级，请勿重复点击）。
5. 打开“用户中心 → 我的 VNC 连接”，复制服务器地址、端口、用户名与 VNC 密码。
6. 用 VNC 客户端按 服务器:端口 连接，输入凭据进入远程 Linux 桌面。
7. 在远程桌面打开终端，按课程要求准备个人练习目录，从 /project 复制只读工程到个人目录，再按讲义执行仿真命令。
8. 将 EDA 环境、alias 等个人配置写在实践目录 ~/soc3_practice/examapp_user_env.csh（勿只改 /home/cxjlXX/.cshrc）；申请 VNC 后新开 tcsh 终端会自动加载，详见第六节。
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/soc3_practice。
• 课程只读源码统一在 /project/ 下。
• 八大项目的推荐只读子路径、难度梯度与学习方式见 IC 仿真实践 页项目列表与分阶段方案。
• 请勿在 /project 源目录直接改动，务必复制到个人目录后再练习。

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

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

• 主配置（tcsh / EDA，推荐）：/home/USER/soc3_practice/examapp_user_env.csh
• 可选（bash 终端）：/home/USER/soc3_practice/examapp_user_env.sh
• 示例参考：examapp_user_env.csh.example
• 说明文件：处芯积律_环境配置说明.txt（首次申请 VNC 后在实践目录自动生成）
• 网页入口：我的 VNC 连接 →「个人环境配置」卡片

首次配置：申请 VNC 后，在远程桌面执行 vi ~/soc3_practice/examapp_user_env.csh，例如加入：

source /eda/env_init.tsh

自动加载：每次在网站申请 VNC 成功后，系统会在当前 Linux 用户的 ~/.cshrc 写入 EXAMAPP_PRACTICE_ENV_AUTOLOAD 段，新开 tcsh 终端自动 source 上述文件。已打开的终端请手动执行：

source ~/soc3_practice/examapp_user_env.csh

曾写在旧 ~/.cshrc 的内容请复制到 examapp_user_env.csh，再重新申请 VNC 或新开终端。

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

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

# 将 USER 替换为您的 VNC 用户名
cd /home/USER/soc3_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
ls -la

# 新开 tcsh 终端会自动 source ~/soc3_practice/examapp_user_env.csh
# 若 vcs 等命令找不到，请确认已在 examapp_user_env.csh 中 source EDA，或执行：
# source ~/soc3_practice/examapp_user_env.csh

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

八、常见问题

• 连不上：核对 IP 与端口，检查网络或防火墙，会话是否过期。
• 密码错误：使用“我的 VNC 连接”页显示的 VNC 密码，不是网站登录密码。
• 权限不足：确认在 /home/USER/soc3_practice 下操作，而不是 /project。
• 命令找不到（如 vcs）：确认已在 ~/soc3_practice/examapp_user_env.csh 中 source EDA 环境，并新开 tcsh 终端或执行 source ~/soc3_practice/examapp_user_env.csh；勿只依赖上次写在 /home/cxjlXX/.cshrc 的配置。
• 换端口后配置丢失：环境应写在实践目录 examapp_user_env.csh，不要只改当前 cxjl 账号的 home 下 .cshrc。
• 中文输入：桌面启动后会尝试启动 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。