feat(template): 升级 desktop E2E 模板到本系列最佳实践

基于 disburse-payroll-icbc 实战经验沉淀，让所有未来新 skill 复制模板后直接
享受本系列全部改进：

- record_screencast.py.sample:
  · 字幕脚本改用 "step: N/X" 模式 + ASCII 关键词锚（避免编码问题）
  · 展示三元组 (keyword, text, duration) 用法（依赖 platform-kit subtitle.py）
  · 加 TEST_FILE_NAME / MUSIC_SUBDIR 切换常量
  · 文档说明绕开 SDK ask() / send_file 的最佳实践

- test_desktop_smoke.py.sample:
  · docstring 加"何时用此模板 / 何时改用 _with_attachment"指引
  · 标注已知 SDK 限制（ask() user_idx<0 / send_file NotImplementedError）

- test_desktop_smoke_with_attachment.py.sample（新增）:
  · 完整附件场景模板，import jiangchang_desktop_sdk.e2e_helpers 6 个 API
  · 7 步 step: N/7 模式，跟 record_screencast.py.sample 字幕脚本对齐
  · 占位符 SKILL_SLUG / PROMPT / EXPECTED_KEYWORDS_IN_REPLY

- README.md: 追加 3 节
  · 模板选择指南（纯问答 vs 附件场景）
  · 已知 SDK 坑（send_file / ask / 字幕关键词 / bring_to_front）
  · 录屏新能力（activate_window / monitor_index / 字幕三元组）

- conftest.py: 同步到支持新版 platform-kit src/ 布局的 SDK 路径推断

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

tests/desktop/conftest.py

@@ -2,11 +2,13 @@
 """
 可选桌面 E2E：pytest 收集时自动加载，负责把 jiangchang_desktop_sdk 加入 sys.path。
 
-查找顺序（与 content-manager 对齐思路，去掉业务仓专属路径假设）：
+查找顺序：
 1. 已 pip install 则直接 import；
-2. 环境变量 JIANGCHANG_KIT_ROOT → sdk/jiangchang-desktop-sdk/src；
-3. 自本文件上溯：skill 根 → workspace 根 → OpenClaw 根，拼 jiangchang-platform-kit/sdk/.../src；
-4. 都找不到则 pytest.exit 给出可操作的排障说明。
+2. 环境变量 JIANGCHANG_KIT_ROOT → sdk/jiangchang-desktop-sdk/src（旧版布局）；
+3. 环境变量 JIANGCHANG_KIT_ROOT → src（新版 platform-kit 布局）；
+4. 自本文件上溯：skill 根 → workspace 根 → OpenClaw 根，拼路径；
+5. 兜底 D:\\AI\\jiangchang-platform-kit\\src（若存在）；
+6. 都找不到则 pytest.exit 给出可操作的排障说明。
 """
 from __future__ import annotations
 
@@ -31,12 +33,22 @@ def _bootstrap_jiangchang_desktop_sdk() -> None:
     candidates = []
     if env_kit_root:
         candidates.append(os.path.join(env_kit_root, "sdk", "jiangchang-desktop-sdk", "src"))
+        candidates.append(os.path.join(env_kit_root, "src"))
     candidates.append(
         os.path.join(workspace_root, "jiangchang-platform-kit", "sdk", "jiangchang-desktop-sdk", "src")
     )
     candidates.append(
         os.path.join(open_claw_root, "jiangchang-platform-kit", "sdk", "jiangchang-desktop-sdk", "src")
     )
+    candidates.append(
+        os.path.join(workspace_root, "jiangchang-platform-kit", "src")
+    )
+    candidates.append(
+        os.path.join(open_claw_root, "jiangchang-platform-kit", "src")
+    )
+    default_kit_src = r"D:\AI\jiangchang-platform-kit\src"
+    if os.path.isdir(default_kit_src):
+        candidates.append(default_kit_src)
 
     tried = []
     for cand in candidates:
@@ -49,10 +61,10 @@ def _bootstrap_jiangchang_desktop_sdk() -> None:
 
     pytest.exit(
         "无法定位 jiangchang_desktop_sdk。请任选一种方式解决：\n"
-        "  1) pip install -e <path-to>/jiangchang-platform-kit/sdk/jiangchang-desktop-sdk\n"
+        "  1) pip install -e <path-to>/jiangchang-platform-kit\n"
         "  2) 设置环境变量 JIANGCHANG_KIT_ROOT=<path-to>/jiangchang-platform-kit\n"
-        "  3) 将 jiangchang-platform-kit 与本仓库放在同一 workspace 父级可推断的位置，例如：\n"
-        f"     {workspace_root}/jiangchang-platform-kit/ 或 {open_claw_root}/jiangchang-platform-kit/\n"
+        "     （SDK 新版位置：<root>\\src；旧版：<root>\\sdk\\jiangchang-desktop-sdk\\src）\n"
+        "  3) 将 jiangchang-platform-kit 与本仓库放在同一 workspace 父级可推断的位置\n"
         "已尝试的候选路径：\n  - " + "\n  - ".join(tried),
         returncode=4,
     )