Document mirror and proxy defaults

README.md

@@ -29,13 +29,21 @@ git submodule update --init --recursive
 ./scripts/setup_env.sh
 ```
 
-脚本会显式设置 B300 代理和国内 PyPI 源：
+脚本默认使用国内源和 B300 机器特定代理，避免直接访问外网导致下载失败：
 
-```bash
-http://100.72.0.101:8888
-https://mirrors.aliyun.com/pypi/simple/
+```text
+http_proxy=http://100.72.0.101:8888
+https_proxy=http://100.72.0.101:8888
+HTTP_PROXY=http://100.72.0.101:8888
+HTTPS_PROXY=http://100.72.0.101:8888
+PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
+UV_DEFAULT_INDEX=https://mirrors.aliyun.com/pypi/simple/
+UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
+HF_ENDPOINT=https://hf-mirror.com
 ```
 
+其中 proxy 是当前 B300/g0049 环境的 machine-specific 配置。换到其他机器、其他集群或本地环境时，需要先确认代理地址是否仍然可用；如果不可用，应覆盖 `http_proxy`、`https_proxy`、`HTTP_PROXY`、`HTTPS_PROXY`，或在无墙环境下显式清空这些变量。PyPI/uv/Hugging Face 镜像也可以通过上面的环境变量覆盖。
+
 Python 依赖安装在仓库内 `.venv`，不会写入系统 Python。安装逻辑是：
 
 1. 先在 `.venv` 内安装 `uv`。

SKILL.md

@@ -5,10 +5,15 @@ Use this skill when the user wants to run or modify the TI coding-agent SFT prob
 ## Repository Contract
 
 - Work in `/ssd/workspace/yi/ti_coding_agent_probe` on B300 unless the user says otherwise.
-- Use the B300 proxy for all network access:
+- Use the B300/g0049 machine-specific proxy for all network access:
   - `http_proxy=http://100.72.0.101:8888`
   - `https_proxy=http://100.72.0.101:8888`
   - `HF_ENDPOINT=https://hf-mirror.com`
+- The default package mirrors are domestic China mirrors:
+  - `PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/`
+  - `UV_DEFAULT_INDEX=https://mirrors.aliyun.com/pypi/simple/`
+  - `UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/`
+- When moving this repo to another machine, first verify or replace the proxy variables. The proxy values above are not portable cluster-wide defaults.
 - Do not install Python packages globally. Use the repository-local `.venv` created by `scripts/setup_env.sh`.
 - `scripts/setup_env.sh` installs `uv` inside `.venv`, then installs SWIFT from the submodule using SWIFT's documented source-install path: `uv pip install -e third_party/modelscope-swift --torch-backend=auto`.
 - Default setup adds training extras: `deepspeed<0.19`, `liger-kernel`, `tensorboard`, and `nvitop`. Disable with `INSTALL_TRAINING_EXTRAS=0`.