tianxuan / docs /LINUX-MIGRATION.md
masterofthestars's picture
Tianxuan: full project + data (checkpoints, world_model, data without raw) with correct directory structure
db7bc06
|
Raw History Blame Contribute Delete
2.38 kB

迁移到 Linux (虚拟机重装)

迁移前 (旧 Windows 系统, 关机前)

从 C:\Users\l1064\Desktop\tianxuan 拷出 2 个目录 (总 ~102MB):

资产 位置 大小
Transformer 检查点 (批 2310, loss≈3.9, 含 Adam 优化器状态) sandbox/data/checkpoints-tf/ 66MB
真实语料 (11 部古典小说, 1.873M 汉字, 续训必需) data/raw/ 53MB

其余源码/文档/脚本已在 Hugging Face (masterofthestars/tianxuan); 旧 GitHub l1064709321/tianxuan 不再作为主仓库。

迁移后 (VM Linux, 有网后)

# 1. 装 Node ≥ 18
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs   # Debian/Ubuntu
#    或: sudo dnf install nodejs   # CentOS/RHEL

# 2. 克隆代码 (源码不靠拷贝, 走 Hugging Face 主仓库)
git clone https://huggingface.co/masterofthestars/tianxuan.git
cd tianxuan
npm install

# 3. 把拷出来的 2 个目录放进仓库
mkdir -p sandbox/data
cp -r /path/to/checkpoints-tf sandbox/data/checkpoints-tf
mkdir -p data
cp -r /path/to/raw data/raw

# 4. 编译 (outDir 必须是 sandbox/dist)
npx tsc --outDir sandbox/dist

# 5. 续训 (接断点, 2M 真实语料, 2 epochs)
node sandbox/dist/ml/train.js --resume sandbox/data/checkpoints-tf \
  --transformer 1 --nlayers 4 --nhead 4 --emb 128 --ctx 32 --bptt 32 \
  --epochs 2 --realTokens 2000000 --out sandbox/data/checkpoints-tf

# 6. 评估 (loss / top-1 / ppl)
cd sandbox && node eval-tf-now.js

训练监控

# 看最近日志
tail -f sandbox/data/checkpoints-tf/../../logs/train.log   # 或看 console 输出
# 续训中想加速: 检查点保存默认每 10 批, 可加 --ckpt 500 降低开销 (单 epoch 约 7196 批)

可选: 推 HuggingFace (VM 能通 huggingface.co 时)

export HF_TOKEN=hf_你的token          # 旧 token 已在聊天暴露, 建议先去 settings 撤销重发
export UPLOAD_DATA=1                  # 要连 data/ 大检查点一起传就设 1 (默认 0 排除)
bash scripts/upload-to-hf.sh          # 详见 docs/HF-UPLOAD.md

宪章提醒 (AGENTS.md)

  • 验证/训练/生成一律在 sandbox/, 生产 data/ 只读
  • 续训命令带 --out sandbox/data/checkpoints-tf, 不要漏 (默认 outDir 是生产 data/checkpoints)
  • 代码零外部依赖 (纯 TS 数值内核), npm install 只装 node_modules 基础包