docs(config): user-facing .env.example comments for config UI (v1.0.47)

.env.example

@@ -1,30 +1,50 @@
-# ── 运行模式 / adapter 档位（见 development/ADAPTER.md）──
-OPENCLAW_TEST_TARGET=mock              # mock | simulator_rpa | real_api | real_rpa
+# 运行模式：决定本技能用模拟数据还是真实浏览器/接口去执行
+OPENCLAW_TEST_TARGET=mock              # 可选：mock=本地模拟，simulator_rpa=仿真站点，real_api=真实接口，real_rpa=真实浏览器；模板默认 mock，日常正式使用请改为 real_rpa
 
-# ── 目标系统 ──
-TARGET_BASE_URL=https://sandbox.jc2009.com   # 仿真/生产地址，可被进程环境变量覆盖
+# 目标网站地址：技能要访问的网站或服务地址
+TARGET_BASE_URL=https://sandbox.jc2009.com   # 填写完整网址（含 https://）；换环境时再改，一般保持默认即可
 
-# ── 默认账号（仅非敏感标识；密码走 account-manager）──
-DEFAULT_LOGIN_ID=04110001
+# 默认登录账号：仅填写非敏感的账号标识（如工号/登录名）
+DEFAULT_LOGIN_ID=04110001              # 只填账号标识，不要填密码；密码请在「账号管理」中登记
 
-# ── 浏览器 / RPA ──
-OPENCLAW_BROWSER_HEADLESS=0            # 0=有头(默认) 1=无头(CI)
-OPENCLAW_PLAYWRIGHT_STEALTH=1          # 1=开启反检测指纹(默认)
+# 是否显示浏览器窗口：打开后能否看见自动化操作过程
+OPENCLAW_BROWSER_HEADLESS=0            # 0=显示窗口（推荐，便于排查），1=后台静默运行
 
-# ── 存证 ──
-OPENCLAW_RECORD_VIDEO=0                # 0=默认不录屏；1=启用录屏+字幕+旁白+背景音+MP4
-OPENCLAW_ARTIFACTS_ON_FAILURE=1        # 1=失败截图(默认)
+# 浏览器防检测：降低被网站识别为自动化工具的概率
+OPENCLAW_PLAYWRIGHT_STEALTH=1          # 1=开启（推荐），0=关闭；一般保持默认
 
-# ── 节流 / 超时 ──
-STEP_DELAY_MIN=1.0                     # 步骤间随机等待下限(秒)
-STEP_DELAY_MAX=5.0                     # 步骤间随机等待上限(秒)
-HUMAN_WAIT_TIMEOUT=180                 # 滑块/验证码/2FA 等人工超时(秒)
+# 是否录制操作过程：用于留证、复现问题或向他人演示
+OPENCLAW_RECORD_VIDEO=0                # 0=不录屏（默认），1=录屏并生成带说明的视频文件；需要留证时再改为 1
 
-# ── 数据目录子路径（见 development/DATA_PATHS.md；留空则用 skill 数据目录下默认子文件夹）──
-# 相对路径相对于 {JIANGCHANG_DATA_ROOT}/{USER_ID}/{slug}/，不是 workspace / CWD
-# SKILL_DOWNLOAD_DIR=downloads
-# SKILL_IMPORT_DIR=imports
-# SKILL_EXPORT_DIR=exports
-# SKILL_UPLOAD_DIR=uploads
-# SKILL_CACHE_DIR=cache
-# SKILL_TEMP_DIR=temp
+# 失败时是否截图：任务出错时自动保存现场截图，便于排查
+OPENCLAW_ARTIFACTS_ON_FAILURE=1        # 1=失败时截图（推荐），0=不截图
+
+# 步骤最短等待：两步操作之间随机停顿的下限，模拟真人节奏
+STEP_DELAY_MIN=1.0                     # 单位：秒；一般保持默认，页面不稳定时可略调大
+
+# 步骤最长等待：两步操作之间随机停顿的上限
+STEP_DELAY_MAX=5.0                     # 单位：秒；须大于等于最短等待；一般保持默认
+
+# 人工处理超时：遇到滑块、验证码、二次验证时，等待人工处理的最长时间
+HUMAN_WAIT_TIMEOUT=180                 # 单位：秒；来不及处理时可调大，如 300
+
+# 以下为可选目录配置。一般不用改；取消注释并填写后，才覆盖默认子文件夹。
+# 填写相对路径时，相对于本技能的数据目录（不是当前工作目录）。
+
+# 下载目录：技能保存下载文件的位置
+# SKILL_DOWNLOAD_DIR=downloads          # 相对本技能数据目录；留空或保持注释则用默认 downloads
+
+# 导入目录：待导入文件放置的位置
+# SKILL_IMPORT_DIR=imports              # 相对本技能数据目录；留空或保持注释则用默认 imports
+
+# 导出目录：技能导出文件的保存位置
+# SKILL_EXPORT_DIR=exports              # 相对本技能数据目录；留空或保持注释则用默认 exports
+
+# 上传目录：待上传文件放置的位置
+# SKILL_UPLOAD_DIR=uploads              # 相对本技能数据目录；留空或保持注释则用默认 uploads
+
+# 缓存目录：临时缓存文件的位置
+# SKILL_CACHE_DIR=cache                 # 相对本技能数据目录；留空或保持注释则用默认 cache
+
+# 临时目录：运行中临时文件的位置
+# SKILL_TEMP_DIR=temp                   # 相对本技能数据目录；留空或保持注释则用默认 temp