--- title: "Dex SDK" description: "Dex SDK 是一个专用 sub-skill。它帮助 agent 用公开的 Dex SDK 构建、调试、测试和运行" canonical_url: "https://docs.superdurable.io/zh-Hans/build-with-ai/dex-developer-skill/dex-sdk/" source: "docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/build-with-ai/dex-developer-skill/dex-sdk.mdx" locale: "zh-Hans" --- # Dex SDK Dex SDK 是一个专用 sub-skill。它帮助 agent 用公开的 Dex SDK 构建、调试、测试和运行 应用，支持 Python、Go、Java、TypeScript 和 Rust。 ## 安装与使用 选择当前使用的 host。一个 host 只能选择 Plugin 或 standalone Skills 中的一种安装路径。 ### Codex Desktop #### Plugin（推荐） ##### 安装 此路径不需要单独安装 Codex CLI。 1. 打开 plugin browser，选择添加菜单，然后点击 Add a marketplace。 2. Source 使用下面的 repository，Git ref 使用 main，Sparse paths 保持为空。 ```text https://github.com/superdurable/dex-skills ``` 3. 添加 marketplace，打开 Super Durable，选择 Dex 并安装。 4. 打开 repository 或空 project，然后创建新 task。 ##### 使用 输入 @，从 picker 中选择 Dex，再输入请求。只输入普通 @Dex 文本不会创建 Plugin binding。 ```text @Dex Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 在 plugin browser 的 marketplace 管理页面找到 Super Durable，点击 Upgrade。完成后重启 Desktop app，并创建新 task。 #### Standalone Skills 如果选择该方式，请不要再安装 Plugin。三个 Skills 必须一起安装。 ##### 安装 ```bash npx skills add superdurable/dex-skills --skill '*' --agent codex --global ``` ##### 使用 ```text $dex-sdk Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 ```bash npx skills update dex-app-builder dex-sdk dex-connector-contributor --global ``` 如果已安装的 skills CLI 不支持 update，请重新运行上面的安装命令。 ### Codex CLI #### Plugin（推荐） ##### 安装 先确认 shell 的 PATH 可以找到 Codex CLI，然后添加 marketplace 和 Plugin。 ```bash codex --version codex plugin marketplace add superdurable/dex-skills codex plugin add superdurable-dex@superdurable ``` ##### 使用 启动新的 interactive Codex session，输入 @，并从 picker 中选择 Dex。初始 codex prompt 或 codex exec 中的普通 @Dex 文本不是结构化 Plugin binding。 ```text @Dex Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 ```bash codex plugin marketplace upgrade superdurable codex ``` 在新 session 中打开 /plugins，确认 Dex 已启用。 #### Standalone Skills 如果选择该方式，请不要再安装 Plugin。三个 Skills 必须一起安装。 ##### 安装 ```bash npx skills add superdurable/dex-skills --skill '*' --agent codex --global ``` ##### 使用 ```text $dex-sdk Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 ```bash npx skills update dex-app-builder dex-sdk dex-connector-contributor --global ``` 如果已安装的 skills CLI 不支持 update，请重新运行上面的安装命令。 需要确定性非交互调用时，请使用 standalone Skill 路径。 ### Claude Desktop #### Plugin ##### 安装 1. 打开 Customize，进入 Plugins tab。 2. 选择 Add → Add marketplace → Add from a repository。 3. 输入下面的 repository，然后打开 Super Durable marketplace 并安装 Dex。 ```text https://github.com/superdurable/dex-skills ``` ##### 使用 使用自然语言请求或 / picker。 ```text /superdurable-dex:dex-sdk Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 Claude 没有公开的 per-user upgrade command。organization-managed marketplace 由 owner 在 Organization settings → Plugins & skills → Marketplaces → Update 中更新。 #### Standalone Skills Dex 不为 Claude Web 或 Desktop 分发 standalone ZIP Skills。请使用 Plugin。 ### Claude Code CLI #### Plugin（推荐） ##### 安装 在 shell 中运行以下命令。也可以在 interactive Claude Code session 中使用相同命令的 /plugin 版本。 ```bash claude plugin marketplace add superdurable/dex-skills claude plugin install superdurable-dex@superdurable ``` 安装后启动新的 Claude Code session。Claude Code 2.1.273 或更高版本也可以同步同一账号的 Desktop Plugin。 ##### 使用 ```text /superdurable-dex:dex-sdk Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 ```bash claude plugin update superdurable-dex@superdurable ``` 也可以在 interactive session 中使用 /plugin marketplace update superdurable。更新后启动新 session。 #### Standalone Skills 如果选择该方式，请不要再安装 Plugin。三个 Skills 必须一起安装。 ##### 安装 ```bash npx skills add superdurable/dex-skills --skill '*' --agent claude-code --global ``` ##### 使用 ```text /dex-sdk Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 ```bash npx skills update dex-app-builder dex-sdk dex-connector-contributor --global ``` 如果已安装的 skills CLI 不支持 update，请重新运行上面的安装命令。 ### Cursor #### Plugin（推荐） ##### 安装 1. 在 Cursor Desktop 中打开 project，然后打开侧栏中的 Customize。 2. 选择 Plugins → Add → From GitHub Repository，并输入下面的 repository。 ```text github.com/superdurable/dex-skills ``` 3. 打开 Dex，点击 Install，然后选择 user 或 project scope。 user-scope Desktop 安装也可用于 Cursor CLI。或者启动 cursor-agent，输入 /plugin，在 Marketplace tab 中安装 Dex。 ##### 使用 ```text /dex-sdk Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 对于 GitHub-imported team marketplace，管理员点击 Refresh 或启用 Auto Refresh，然后用户 reload Cursor window。 #### Standalone Skills 如果选择该方式，请不要再安装 Plugin。三个 Skills 必须一起安装。 ##### 安装 ```bash npx skills add superdurable/dex-skills --skill '*' --agent cursor --global ``` ##### 使用 ```text /dex-sdk Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 ```bash npx skills update dex-app-builder dex-sdk dex-connector-contributor --global ``` 如果已安装的 skills CLI 不支持 update，请重新运行上面的安装命令。 Cursor 的 Plugin 和 standalone 安装使用相同短 slash command，只有安装来源不同。 ### 其他客户端 #### Plugin Dex 没有为未单列的 host 记录通用 marketplace Plugin 流程。 #### Standalone Skills 未单列的 Agent Skills client 使用 standalone 路径。 ##### 安装 交互选择检测到的兼容 agent，或者显式传入该 host 的 agent id。 ```bash npx skills add superdurable/dex-skills --skill '*' --global npx skills add superdurable/dex-skills --skill '*' --agent --global ``` ##### 使用 使用 host 的 Skill picker、调用 prefix 或匹配的自然语言请求。 ```text Diagnose why this Flow retries after the payment Step completes. ``` ##### 更新 ```bash npx skills update dex-app-builder dex-sdk dex-connector-contributor --global ``` 完整的产品或业务流程需求，请从 [Dex App Builder](https://docs.superdurable.io/zh-Hans/build-with-ai/dex-developer-skill/dex-app-builder.md) 开始。 App Builder 开始做后端时会加载 Dex SDK。 ## 何时使用 以下范围明确的技术工作适合使用 Dex SDK： - Flow、Step、等待、状态转换和失败路由； - Attribute、AttributeMap、Channel、ChannelMap 和 Stream； - typed RPC、Timer、SubFlow、Worker 和 Client； - 重试、超时、heartbeat、durability、lock 和恢复； - SDK 版本兼容、测试、排错或运维； - Dex Web、**dexcli**、Flow 可视化和应用可观测性。 这个 skill 处理的是你的应用，不是 Dex 本身。除非你明确要求它开发 Dex，否则它不会为了 解决应用问题去修改 Dex Server。 ## 版本与来源 写代码之前，skill 会先弄清应用的语言、包管理器、已安装的 Dex SDK 版本、Worker 和 Client 如何启动，以及 repository 的测试命令。 skill 以 repository 源码、lockfile、已安装的 SDK 和对应版本的官方示例为准。除非你要求 升级，否则它保留当前安装的版本。如果找不到与该版本完全对应的源码，它只做到与版本无关的 Flow 模型设计为止，不会编造 API。 它只加载你所用语言的 handbook 和任务需要的参考资料，不会把五种语言都加载进来。 ## 实现前先建模 对于不简单的改动，skill 会在修改代码前先写出模型： - Flow 的标识、typed 启动输入和完成输出； - Step、状态转换，以及工作在哪些点保存； - Flow 默认值，以及每个方法的重试、超时、heartbeat、负载或 lock 选项； - 持久状态、消息、RPC、Stream 和 Timer； - 失败恢复和 SubFlow 边界； - Worker、Client、registry 和序列化的配置，以及应用如何调用 Flow。 模型使用准确的领域名称，并优先采用官方 Dex 模式，而不是手写的协调循环。 ## 实现与验证 完整的应用改动包括：typed 输入、输出和失败；Flow 和 Step 定义；持久化 schema 条目； 注入的依赖；registry 注册；需要时的 Worker 和 Client 配置；应用的入口（例如 HTTP 接口）；以及针对真实 Dex Server 的集成测试。 交付之前，skill 会检查：构建或类型检查、集成场景、重试和超时后的恢复、重复请求、Flow 结束后的行为、每个 primitive 是否都已注册、heartbeat、Stream 行为，以及 Worker 和 Client 的配置是否兼容。 正在运行的 Flow 会限制哪些名称和 schema 可以修改。除非你有明确的迁移方案，否则 skill 会保留现有的 Flow、Step、Attribute、Channel、Stream 和 RPC 名称。 ## 诊断与运维 诊断问题时，skill 默认只读。它可以查看 Dex Web、**dexcli**、SDK 错误和应用日志。未经 你授权，它不会 stop、time travel、publish、invoke、删除、编辑或以其他方式修改 Flow。 skill 会保留 typed Dex 错误的原样，直到你的业务逻辑能区分以下几种情况：业务拒绝、与正在 关闭的 Flow 发生竞争、可以重试的服务故障，以及本地 bug。它只把保留的 Stream 用于尽力而为 的观察，从不把它们当作业务状态的权威来源。 ## 与其他 Skill 的关系 - [Dex App Builder](https://docs.superdurable.io/zh-Hans/build-with-ai/dex-developer-skill/dex-app-builder.md) 在做后端时加载 Dex SDK 的核心内容和 Go 指导，然后加上它自己更严格的规则。 - [Dex Connector Contributor](https://docs.superdurable.io/zh-Hans/build-with-ai/dex-developer-skill/dex-connector-contributor.md) 在实现官方 Connector 时加载共享的 Dex 规则和 Go 指导。 - 直接调用 Dex SDK 时，任务保持为范围明确的技术工作，不会扩展成完整的产品流程。 返回 [Dex Skills 总览与安装](https://docs.superdurable.io/zh-Hans/build-with-ai/dex-developer-skill.md)。