明确Studio调试入口与串行DAG语义

README.md

@@ -86,3 +86,14 @@ v18 脱敏协议回放不调用模型或媒体服务：
 ```bash
 uv run python -m unittest tests.test_v18_replay -v
 ```
+
+## LangSmith Studio（开发调试）
+
+根目录的 `langgraph.json` 让 LangGraph Agent Server / LangSmith Studio
+加载 `production_build_agents/app.py:graph`；`examples/studio_input.json`
+是对应的调试输入示例。该入口只用于观察节点、状态和提示词，不包含正式 Run 的
+registry、输入身份绑定、文件锁与终态业务文件重验。
+
+需要创建、恢复或重复打开真实业务 Run 时，始终使用 `run_demo.py`。当前 Runtime
+有意按 `priority → task_id` 每次只选择一个 ready Task；Plan 可以表达 DAG，
+但本版本不并行执行多个 ready Task。

examples/studio_input.json

@@ -2,7 +2,7 @@
   "run_id": "GlobalData-Example-1",
   "protocol_version": "0.3",
   "input_path": "/Users/samlee/Documents/works/VideoImageProductionBuild/容易内耗的人其实需要停止悲伤者叙事#自我(690788)_production_final.json",
-  "input_sha256": "由启动器根据输入文件内容计算",
+  "input_sha256": "6216a62103e49fff7e7245870c9e2cf57175aed0bcea105882cd4c7b0b50863c",
   "output_dir": "/tmp/production-build-agents-studio",
   "status": "PENDING",
   "phase": "PREPROCESS",

production_build_agents/app.py

@@ -1,7 +1,7 @@
-"""供 LangGraph Agent Server 和 LangSmith Studio 加载的应用入口。
+"""仅供 LangGraph Agent Server / LangSmith Studio 开发调试的裸 Graph 入口。
 
-Agent Server 自己管理 thread、checkpoint 和持久化，因此这里导出的 Graph
-不注入测试使用的 InMemorySaver。
+这里不负责正式 Run 的 registry、输入 hash 绑定、文件锁和终态重验。
+需要持久执行或恢复业务 Run 时必须使用项目根目录的 ``run_demo.py``。
 """
 
 from __future__ import annotations