diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..9141d34
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,15 @@
+# 本仓库不走安装步骤：入口一律从仓根以 `python -m arm.xxx` 运行。
+# `python -m` 会把仓根放进 sys.path，包内 import 因此直接可解析，不需要 pip install -e。
+# 这里只声明元数据与运行依赖，供环境搭建和新同事阅读。
+# 模型版本另由环境变量 ARMVER 控制（见 arm/build_model.py），与下面的包版本无关。
+
+[project]
+name = "arm"
+version = "2.0"
+description = "6 自由度人形机械臂：CadQuery 参数化建模、行程/碰撞扫描、制造文件导出与三维查看器"
+requires-python = ">=3.11"
+dependencies = [
+    "cadquery>=2.5",  # 建模内核（含 OCP / pythonocc 绑定）
+    "numpy",
+    "scipy",          # sweep_v2 的干涉判定
+]
diff --git a/src/armcore.py b/src/armcore.py
index eea91bc..8c6b0c7 100644
--- a/src/armcore.py
+++ b/src/armcore.py
@@ -20,11 +20,15 @@ from OCP.TopAbs import TopAbs_FACE, TopAbs_REVERSED, TopAbs_SOLID
 from OCP.TopoDS import TopoDS
 
 V = cq.Vector
-ROOT = r"G:/Robot_v2"
-SRC_STEP = ROOT + r"/Model/Solidworks/电机.STEP"
-HALF_STEP = ROOT + r"/Model/Solidworks/配件/端面齿半联轴器_相同件x2.STEP"
-CLAMP_STEP = ROOT + r"/Model/Solidworks/配件/端面齿联轴器_抱箍_两片装配.STEP"
-WORKSPACE = ROOT + r"/机器人手臂"
+
+# 路径全部由本文件位置推出，仓库可以整体搬迁；三个环境变量是临时覆盖入口。
+_HERE = os.path.dirname(os.path.abspath(__file__)).replace("\\", "/")
+WORKSPACE = os.environ.get("ARM_WORKSPACE") or os.path.dirname(_HERE)
+ROOT = os.environ.get("ARM_ROOT") or os.path.dirname(WORKSPACE)
+MODEL = os.environ.get("ARM_MODEL_ROOT") or (ROOT + r"/Model/Solidworks")
+SRC_STEP = MODEL + r"/电机.STEP"
+HALF_STEP = MODEL + r"/配件/端面齿半联轴器_相同件x2.STEP"
+CLAMP_STEP = MODEL + r"/配件/端面齿联轴器_抱箍_两片装配.STEP"
 OUT = WORKSPACE + r"/out"
 WEB = WORKSPACE + r"/web"
 DOCS = WORKSPACE + r"/docs"