chendelian
6e3f79dde9
把 _activate_and_maximize_windows 内嵌的 50+ 行 ctypes 实现抽到独立的 SDK 子模块 src/jiangchang_desktop_sdk/window_win32.py，暴露公开函数 activate_and_maximize_jiangchang_window，给 screencast 工具也复用（见后续 commit）。 client.py 的 _activate_and_maximize_windows 退化为 6 行薄壳，调用新模块。 设计： - window_win32 是 SDK 子模块（放 src/jiangchang_desktop_sdk/ 下），不放 tools/， 避免 SDK 反向依赖工具层 - ctypes EnumWindows + ShowWindow(SW_MAXIMIZE) + SetForegroundWindow 逻辑不变 - 跨平台行为不变：Windows 真执行，其他系统返回 False - bring_to_front 调用方完全不感知变化（向后兼容） Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
jiangchang-platform-kit
1. 项目简介
匠厂平台共享 Python SDK：在同一发行包中提供 Skill 侧通用能力（权益校验、统一日志与运行环境解析）与 桌面应用自动化能力（通过 CDP 连接匠厂客户端，驱动聊天与断言）。
2. 安装方式
pip install jiangchang-platform-kit --index-url https://git.jc2009.com/api/packages/client-jiangchang/pypi/simple/
3. 包含的模块
- jiangchang_skill_core：权益 HTTP 客户端、
enforce_entitlement、统一文件日志、JIANGCHANG_*数据根与技能根路径解析等，供 Skill CLI / 服务进程使用。 - jiangchang_desktop_sdk：匠厂桌面应用自动化客户端（基于 CDP + Playwright 同步 API）。本包不声明 Playwright 依赖；请在运行环境中自行安装 Playwright，以便
import playwright可用。
4. 快速开始
jiangchang_skill_core
import os
from jiangchang_skill_core import (
EntitlementClient,
enforce_entitlement,
setup_skill_logging,
get_skill_logger,
)
os.environ.setdefault("JIANGCHANG_AUTH_BASE_URL", "https://auth.example.com")
os.environ.setdefault("JIANGCHANG_AUTH_API_KEY", "secret")
setup_skill_logging(skill_slug="demo-skill", logger_name="demo")
log = get_skill_logger()
log.info("skill started")
# client = EntitlementClient()
# enforce_entitlement(user_id="u1", skill_slug="demo-skill")
jiangchang_desktop_sdk
from jiangchang_desktop_sdk import JiangchangDesktopClient, AskOptions
# 需已安装 playwright，且匠厂客户端可按 CDP 端口暴露调试接口
client = JiangchangDesktopClient()
client.ensure_app_running(wait_timeout_s=30.0)
try:
answer = client.ask("你好", options=AskOptions(new_task=True))
print(answer)
finally:
client.disconnect()
5. 发版流程（维护者）
git tag v0.1.0
git push origin v0.1.0
# CI 自动打包并发布到 Gitea Package Registry（见 .github/workflows/publish.yml）
仓库内还保留 examples/、tools/、python-runtime/ 目录及既有 Skill / 前端相关的 GitHub Actions 工作流，与本 PyPI 包的发布彼此独立。
v0.2.0 — data-jcid migration (internal refactor)
TL;DR
本次内部重构:SDK 不再依赖匠厂主仓库的 data-jcid 属性。
所有公开 API(ask / read / new_task / wait_gateway_ready 等)
签名与行为保持不变,只有内部选择器实现切换到新的语义锚点 + ClawX testid。
改变了什么
client.py内所有[data-jcid="..."]选择器已移除- 改用匠厂主仓库为 SDK 承诺的语义锚点:
data-role/data-message-id/data-streaming(在 ChatMessage 上)、data-sending/data-message-count(在 chat-page 根上) window.__jc_sending__仍是核心 sending 信号,保持不变- 这些锚点由匠厂主仓库的以下机制守护:
docs/JIANGCHANG_CUSTOM_ANCHORS.md中央清单- 源码内
JIANGCHANG CUSTOM ANCHOR边界注释 harness/specs/jiangchang-custom-anchors.spec.tsE2E 守护测试- Gitea CI grep 检查 step
已知限制
send_file()暂未实现,抛NotImplementedError。 原因:附件上传走 Electron IPC,SDK 需要主仓库提供新 hook。_gateway_state()永远返回'unknown'。 原因:gateway 状态不再暴露 DOM data-state;本方法已预留未来通过window.__jc_gateway_state__读取的实现路径。
这两个限制对常规 ask/read 工作流无影响,sending 完成判定依靠
window.__jc_sending__ + data-sending + 文本稳定性合流即可。
升级影响
- 在 jiangchang v2.0.17(含)以上版本上跑:应正常工作
- 在 jiangchang v2.0.16(及更早含 data-jcid 的版本)上跑:不再兼容 如果需要在旧版本上跑,固定 SDK 版本到 v0.1.x
验证清单(集成方建议跑一次)
打开匠厂客户端 → 用 SDK 跑下面 3 步,确认基础流程通:
from jiangchang_desktop_sdk import JiangchangDesktopClient
with JiangchangDesktopClient() as c:
c.ensure_app_running()
c.wait_gateway_ready()
c.new_task()
answer = c.ask("你好,请回复确认 SDK 可用")
assert answer, f"Empty answer: {answer!r}"
print("OK:", answer[:200])