Squashed 'astrbot-sdk/' changes from 378257db7..9724f6230

9724f6230 chore: refresh vendor snapshot [skip ci]
87dd4d31f Merge pull request #103 from united-pooh:dev
816732c52 Merge branch 'dev' of https://github.com/united-pooh/astrbot-sdk into dev
740f497fb feat: 引入线程安全机制，优化插件加载和组件实例化过程
1c2c451b9 Merge pull request #102 from united-pooh/docs/72
dad29d656 docs: 翻译预期外的英文注释
0688d335f Merge pull request #101 from united-pooh/fix-96-init-gitignore-template
b7b3e6bc5 feat: generate plugin gitignore during init
REVERT: 378257db7 chore: refresh vendor snapshot [skip ci]

git-subtree-dir: astrbot-sdk
git-subtree-split: 9724f6230147d6101cc4c6493d3d6b7b8e1d4f33

Author: whatevertogo

src/astrbot_sdk/cli.py

@@ -749,6 +749,56 @@ def _render_init_readme(*, plugin_name: str) -> str:
     )
 
 
+def _render_init_gitignore() -> str:
+    return dedent(
+        """\
+        # Python
+        __pycache__/
+        *.py[cod]
+        *.pyo
+        *.egg-info/
+        dist/
+        build/
+        *.egg
+
+        # 虚拟环境
+        .venv/
+        venv/
+        env/
+
+        # IDE
+        .idea/
+        .vscode/
+        *.swp
+        *.swo
+        *~
+
+        # OS
+        .DS_Store
+        Thumbs.db
+        desktop.ini
+
+        # 测试 / 检查缓存
+        .pytest_cache/
+        .ruff_cache/
+        .mypy_cache/
+        .coverage
+        htmlcov/
+
+        # 开发/构建工具
+        /.claude/
+        /.agents/
+        /.opencode/
+
+        # 图床配置（含 API 密钥等敏感信息）
+        /image_host/config.json
+
+        # 插件测试产物
+        /.astrbot_sdk_testing/
+        """
+    )
+
+
 def _render_init_test_py(*, plugin_name: str) -> str:
     class_name = _class_name_for_plugin(plugin_name)
     return dedent(
@@ -1013,6 +1063,10 @@ def _init_plugin(name: str | None, agents: tuple[str, ...] = ()) -> None:
         _render_init_readme(plugin_name=plugin_name),
         encoding="utf-8",
     )
+    (target_dir / ".gitignore").write_text(
+        _render_init_gitignore(),
+        encoding="utf-8",
+    )
     (target_dir / "tests" / "test_plugin.py").write_text(
         _render_init_test_py(plugin_name=plugin_name),
         encoding="utf-8",

src/astrbot_sdk/clients/__init__.py

@@ -1,11 +1,9 @@
-"""Native v4 capability clients.
+"""原生v4能力客户端
 
-These clients provide the narrow, typed surface exposed by `Context` for
-calling remote capabilities. They handle capability names, payload shaping,
-and result decoding, without exposing protocol or transport details.
+这些客户端为 Context 提供了用于调用远程能力的狭窄且具类型化 (typed) 的接口。
+它们负责处理能力名称、载荷格式化（payload shaping）以及结果解码，且不会暴露协议或传输层的具体细节。
 
-Migration shims and higher-level orchestration stay outside these native
-capability clients so `Context` keeps a narrow, stable surface.
+为了保持 Context 接口的精简与稳定，迁移适配层 (Migration shims) 以及高层级编排逻辑 (higher-level orchestration) 均不包含在这些原生能力客户端之内。
 
 当前公开客户端：
     - LLMClient: 文本/结构化/流式 LLM 调用