> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/chinese/guan-li-yu-she-zhi/workflow/card-sdk.md).

# Card SDK

**Card SDK** 可让合作伙伴和开发者为 DocFlow 构建自定义工作流卡片。您可以将卡片打包为合作伙伴应用并上传，也可以直接从 GitHub 导入。

<figure><img src="https://1870485400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlPczlNw8zzYNLfjfispX%2Fuploads%2Fgit-blob-85e251c7b975d5ec09d78d7ec75c470e1d7c8bfa%2Fworkflow_card_sdk.png?alt=media" alt="Card SDK 选项卡，包含 Upload ZIP、GitHub Import 和 Submissions"><figcaption><p>Card SDK — 上传合作伙伴应用 ZIP 文件、从 GitHub 导入，或查看您的提交。</p></figcaption></figure>

## 工作原理

* **Download SDK Template** — 从包含预期结构的官方模板开始。
* **Upload ZIP** — ZIP 文件必须包含 `app.json` 和带有卡片定义的 `.docflowcompose/flow/` 文件夹（最大 10 MB）。Upload & Validate 会在接受软件包之前对其进行检查。
* **GitHub Import** — 直接从 GitHub 仓库导入卡片定义。
* **Submissions** — 跟踪您提交的卡片状态。

通过验证并获接受后，您的自定义卡片会与内置卡片一起显示在 **Add Card** 库中。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docbits.com/chinese/guan-li-yu-she-zhi/workflow/card-sdk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
