feat: 工资查询助手首版 v1.0.105

基于 skill-template 脚手架开发，包含： - payroll_config（费率配置，可编辑）+ payslip_snapshots（解析历史，只读）2 张业务表 - 全国默认 + 北上广 4 套费率（社保/公积金/个税起征点/7 级税率表） - 5 个业务 Action：calculate-payslip-simple / calculate-payslip-full / explain-term / view-config / edit-config - 个税累计预扣法计算，支持多月历史累加 - 20 个薪资名词库（社保/公积金/个税/全勤/加班费等） - 完整市场文档（README/TUTORIAL/DEMO/CHANGELOG） - 296 测试全部通过
2026-09-07 17:02:05 +08:00
commit 3db196e49d
205 changed files with 29927 additions and 0 deletions
--- a/tests/desktop/record_screencast.py.sample
+++ b/tests/desktop/record_screencast.py.sample
@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*-
+"""
+Screencast 录制入口（模板）。
+
+启用方式：
+  1. 复制为 record_screencast.py
+  2. 修改 SKILL_SLUG 和 SUBTITLE_SCRIPT
+  3. 决定 test_file 指向哪个测试（默认 test_desktop_smoke.py；
+     有附件场景的用 test_desktop_smoke_with_attachment.py）
+  4. 运行：python tests/desktop/record_screencast.py
+
+依赖：
+  1. pip install mss
+  2. 系统已安装 ffmpeg 并在 PATH 中
+  3. jiangchang-platform-kit 可推断路径（见 _bootstrap 逻辑）
+  4. MEDIA_ASSETS_ROOT 环境变量指向 media-assets 仓库（或使用默认路径）
+
+平台 kit v?? 之后 run_screencast 自动激活并最大化匠厂窗口、支持指定显示器、
+字幕支持每条独立时长。本模板已经利用这些能力，新 skill 复制后无需再内嵌
+ctypes 激活代码。
+"""
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+
+def _bootstrap_screencast() -> None:
+    """将 jiangchang-platform-kit/tools 加入 sys.path，使 screencast 包可导入。"""
+    here = Path(__file__).resolve()
+    skill_root = here.parents[2]
+    workspace_root = skill_root.parent
+    open_claw_root = workspace_root.parent
+
+    candidates = [
+        workspace_root / "jiangchang-platform-kit" / "tools",
+        open_claw_root / "jiangchang-platform-kit" / "tools",
+        Path(r"D:\AI\jiangchang-platform-kit") / "tools",
+    ]
+    env_kit = os.environ.get("JIANGCHANG_KIT_ROOT", "")
+    if env_kit:
+        candidates.insert(0, Path(env_kit) / "tools")
+
+    for cand in candidates:
+        if (cand / "screencast" / "__init__.py").exists():
+            if str(cand) not in sys.path:
+                sys.path.insert(0, str(cand))
+            return
+
+    raise RuntimeError(
+        "找不到 jiangchang-platform-kit/tools/screencast。\n"
+        "请设置 JIANGCHANG_KIT_ROOT 环境变量，或将 platform-kit 放在 workspace "
+        "同级目录。"
+    )
+
+
+_bootstrap_screencast()
+
+from screencast import run_screencast  # noqa: E402
+
+# ============================================================
+# ↓↓↓ 复制后只需修改下面这些 ↓↓↓
+# ============================================================
+
+SKILL_SLUG = "query-payslip-default"   # 替换为本技能 slug
+
+# 字幕脚本设计要点（来自 disburse-payroll-icbc 实战经验）：
+# 1. **关键词全用 ASCII**：保险起见绕开 Windows cp936/UTF-8 编码偶发问题。
+#    虽然 platform-kit 已修了 subprocess 编码，ASCII 关键词仍是最稳的。
+# 2. **用 "step: N/X" 模式作触发锚**：在测试代码里加 _logger.info("step: 1/5 ...")
+#    日志作为字幕触发点，能精确控制字幕出现时机，比依赖 SDK 内部日志更可靠。
+# 3. **关键词每条只触发一次**，所以"step: 1/" 这种唯一前缀比"准备数据"更稳。
+# 4. **三元组支持每条独立时长**：(关键词, 文案, 显示秒数)；
+#    long wait 场景可以让某条字幕停留更久（如 30s）覆盖中间无日志输出的等待期。
+SUBTITLE_SCRIPT = [
+    # (keyword, text)  二元组用默认时长（5s）
+    ("ensure_app_running",  "启动匠厂智能体平台"),
+    ("wait_gateway_ready",  "网关就绪"),
+    ("step: 1/",            "准备测试数据"),
+    ("step: 2/",            "执行技能操作"),
+    # (keyword, text, duration)  三元组指定独立时长
+    ("step: 3/",            "技能在后端持续执行，请稍候...", 30.0),
+    ("step: 4/",            "结果汇总返回"),
+    ("PASSED",              "测试通过 ✓"),
+]
+
+# 测试文件选择（按需切换）：
+#   - test_desktop_smoke.py: 纯问答 skill 用这个
+#   - test_desktop_smoke_with_attachment.py: 需要上传附件的 skill 用这个
+TEST_FILE_NAME = "test_desktop_smoke.py"
+
+# 音乐子目录（按 skill 风格选）：
+#   - "music/corporate": 商务严肃（金融、办公场景）
+#   - "music/calm": 舒缓（流程演示、配置类）
+#   - "music/upbeat": 活力（成功汇报、营销视频）
+#   - "music"（默认）: 三个子目录混选
+MUSIC_SUBDIR = "music/corporate"
+
+# ============================================================
+
+if __name__ == "__main__":
+    _here = Path(__file__).resolve()
+    test_file = str(_here.parent / TEST_FILE_NAME)
+    output_dir = str(_here.parent / "artifacts" / "recordings")
+
+    run_screencast(
+        skill_slug=SKILL_SLUG,
+        subtitle_script=SUBTITLE_SCRIPT,
+        pytest_args=[test_file, "-v", "-s"],
+        output_dir=output_dir,
+        music_subdir=MUSIC_SUBDIR,
+        # platform-kit 自动激活+最大化窗口（Windows ctypes / 其他系统协议），
+        # 想关掉传 activate_window=False
+        # monitor_index=1 显式录主屏（多显示器场景推荐）
+    )