docs: update artifact paths to ~/.opencli/ in docs and skills

Sync documentation with the new default output directory. Also improve
resolveExploreDir error message with a hint for legacy artifact paths.

Author: Astro-Han

CLI-EXPLORER.md

@@ -86,7 +86,7 @@ OpenCLI 内置 Deep Explore，自动分析网站网络请求：
 opencli explore https://www.example.com --site mysite
 ```
 
-输出到 `.opencli/explore/mysite/`：
+输出到 `~/.opencli/explore/mysite/`：
 
 | 文件 | 内容 |
 |------|------|
@@ -721,4 +721,4 @@ opencli synthesize mysite                                        # 生成候选
 opencli verify mysite/hot --smoke                                # 冒烟测试
 ```
 
-生成的候选 YAML 保存在 `.opencli/explore/mysite/candidates/`，可直接复制到 `src/clis/mysite/` 并微调。
+生成的候选 YAML 保存在 `~/.opencli/explore/mysite/candidates/`，可直接复制到 `src/clis/mysite/` 并微调。

README.zh-CN.md

@@ -390,7 +390,7 @@ opencli generate https://example.com --goal "hot"
 opencli cascade https://api.example.com/data
 ```
 
-探索结果输出到 `.opencli/explore/<site>/`。
+探索结果输出到 `~/.opencli/explore/<site>/`。
 
 ## 常见问题排查
 

docs/developer/ai-workflow.md

@@ -24,7 +24,7 @@ Discover APIs, infer capabilities, and detect framework:
 opencli explore https://example.com --site mysite
 ```
 
-Outputs to `.opencli/explore/<site>/`:
+Outputs to `~/.opencli/explore/<site>/`:
 - `manifest.json` — Site metadata
 - `endpoints.json` — Discovered API endpoints
 - `capabilities.json` — Inferred capabilities

skills/opencli-explorer/SKILL.md

@@ -86,7 +86,7 @@ OpenCLI 内置 Deep Explore，自动分析网站网络请求：
 opencli explore https://www.example.com --site mysite
 ```
 
-输出到 `.opencli/explore/mysite/`：
+输出到 `~/.opencli/explore/mysite/`：
 
 | 文件 | 内容 |
 |------|------|
@@ -721,7 +721,7 @@ opencli synthesize mysite                                        # 生成候选
 opencli verify mysite/hot --smoke                                # 冒烟测试
 ```
 
-生成的候选 YAML 保存在 `.opencli/explore/mysite/candidates/`，可直接复制到 `src/clis/mysite/` 并微调。
+生成的候选 YAML 保存在 `~/.opencli/explore/mysite/candidates/`，可直接复制到 `src/clis/mysite/` 并微调。
 
 ## Record Workflow
 
@@ -758,8 +758,8 @@ opencli record "https://example.com/page" --timeout 120000
 # 3. 完成操作后按 Enter 停止（或等超时自动停止）
 
 # 4. 查看结果
-cat .opencli/record/<site>/captured.json        # 原始捕获
-ls  .opencli/record/<site>/candidates/          # 候选 YAML
+cat ~/.opencli/record/<site>/captured.json        # 原始捕获
+ls  ~/.opencli/record/<site>/candidates/          # 候选 YAML
 ```
 
 ### 页面类型与捕获预期

skills/opencli-usage/plugins.md

@@ -30,7 +30,7 @@ opencli record <url>                            # 录制，site name 从域名
 opencli record <url> --site mysite             # 指定 site name
 opencli record <url> --timeout 120000          # 自定义超时（毫秒，默认 60000）
 opencli record <url> --poll 1000               # 缩短轮询间隔（毫秒，默认 2000）
-opencli record <url> --out .opencli/record/x   # 自定义输出目录
+opencli record <url> --out ~/.opencli/record/x   # 自定义输出目录
 
 # Strategy Cascade: auto-probe PUBLIC → COOKIE → HEADER
 opencli cascade <api-url>

src/synthesize.ts

@@ -139,7 +139,10 @@ export function resolveExploreDir(target: string): string {
   // Fallback: check cwd/.opencli/explore/<target> (legacy location)
   const cwdCandidate = path.join('.opencli', 'explore', target);
   if (fs.existsSync(cwdCandidate)) return cwdCandidate;
-  throw new Error(`Explore directory not found: ${target}`);
+  throw new Error(
+    `Explore directory not found: ${target}. `
+    + 'If artifacts were created elsewhere, pass the full path.',
+  );
 }
 
 export function loadExploreBundle(exploreDir: string): LoadedExploreBundle {