用途：langgraph-cli 用于脚手架创建、开发、构建和部署 LangGraph 应用，并管理 LangSmith Deployments（列出、删除、查看日志）。
主要命令：langgraph new 从模板创建项目；langgraph dev 本地热重载运行（无需 Docker）；langgraph build 构建 Docker 镜像；langgraph up 通过 Docker Compose 本地启动（含 Postgres）；langgraph deploy 部署到 LangGraph Platform；langgraph dockerfile 生成 Dockerfile。除 new 外，所有命令读取项目根目录的 langgraph.json。
安装：Python 用 pip install 'langgraph-cli[inmem]'（含 dev 支持）或 pip install langgraph-cli（仅 build/up/deploy）；UV 用 uv add "langgraph-cli[inmem]" 或 uv add langgraph-cli；JavaScript 用 npx @langchain/langgraph-cli 或 npm install -g @langchain/langgraph-cli（全局命令为 langgraphjs）。
配置：langgraph.json 必填 dependencies（依赖数组，"." 表示从 pyproject.toml、setup.py、requirements.txt 或 package.json 解析本地包）和 graphs（图 ID 到路径的映射，格式 ./path/file.py:variable 或 ./path/file.js:function，变量须为 CompiledGraph 或返回它的函数）；可选 env、python_version、node_version、pip_config_file、dockerfile_lines。
dev 与 up 区别：dev 无需 Docker，内存/本地 pickle 持久化，默认端口 2024，默认热重载，支持 --debug-port 调试；up 需要 Docker，使用 PostgreSQL，默认端口 8123，可选 --watch，资源占用更重。
典型流程：new 脚手架 → 编辑 langgraph.json → dev 快速迭代 → up --recreate 类生产验证 → deploy 部署 → deploy logs -f 查看日志。
限制与注意：deploy 需要 Docker，Apple Silicon 上还需 Docker Buildx 交叉编译到 linux/amd64；deploy 只能更新自身创建的部署，无法更新通过 LangSmith UI 或 GitHub 集成创建的部署；dependencies 必须包含所有包；dev 直接在本机运行，依赖的系统包需本地安装；deploy 需要 LANGSMITH_API_KEY（dev 可选，缺失则无 LangSmith 追踪）。