DotCraft SDK
DotCraft SDK 面向外部客户端、社交渠道适配器和自动化集成。它们都连接同一个 AppServer Wire Protocol，并复用 DotCraft 的线程、流式事件、审批和投递能力。
快速开始
- 先阅读 AppServer 模式指南，确认你要使用 stdio 还是 WebSocket。
- 如果用 Python 构建独立适配器，选择 Python SDK。
- 如果用 TypeScript 构建社交渠道模块，选择 TypeScript SDK。
- 从最接近的平台示例开始复制配置，再替换 token、回调地址和权限白名单。
配置
| 目标 | 文档 |
|---|---|
| 使用 Python 构建外部渠道适配器 | Python SDK |
| 参考 Telegram Python 适配器 | Python Telegram Adapter |
| 使用 TypeScript 构建外部频道模块 | TypeScript SDK |
| 接入飞书 / Lark | Feishu Adapter |
| 接入 Telegram | Telegram Adapter |
| 接入微信 | Weixin Adapter |
| 接入 QQ | QQ Adapter |
| 接入企业微信 | WeCom Adapter |
使用示例
| 场景 | 推荐入口 |
|---|---|
| 写一个 Python Bot | Python SDK + Telegram Adapter |
| 写一个 TypeScript 社交渠道 | TypeScript SDK |
| 接入已有 AppServer | 使用 WebSocket transport |
| 让 DotCraft 托管适配器子进程 | 使用 stdio / subprocess 模式 |
进阶
故障排查
适配器连不上 DotCraft
确认 AppServer 已以 WebSocket 模式启动，URL 包含 /ws，token 与客户端配置一致。
消息能收到但无法投递结果
检查适配器是否在初始化握手中声明了投递能力和 channel tools；平台 token、回调地址和权限白名单也需要匹配。
不知道选 Python 还是 TypeScript
需要快速写独立适配器时选 Python；需要复用现有 TypeScript 渠道模块、交互式初始化或平台包时选 TypeScript。