DDIOT Device Workbench

DDIOT VSCode 插件首版实现，定位为本地 MicroPython 设备编程工作台。

• 平台网站：https://iot.cdddiot.com
• 插件 API：https://iot.cdddiot.com

功能

• Explorer 中的 DDIOT 设备 Tree View。
• 账号密码或公众号验证码登录，Token 安全保存并自动刷新。
• 在设备树中选择并设置当前设备，统一显示为 设备名称-完整SN。
• 设备文件同步到 microPython/{设备名}-{完整SN}。
• 部署时实时扫描设备项目根目录，不生成 .ddiot、manifest 或备份。
• 上传、删除、部署、重启前由 VSCode 弹窗确认。
• Token 仅保存到 VSCode SecretStorage。
• 内置 Streamable HTTP MCP server，固定监听 http://127.0.0.1:17892/mcp。

平台 API

当前唯一有效的插件 API 契约随扩展包提供，文件为 docs/api.md，基础路径为 /api/plugin/v1。

平台 API 是用户权限、设备归属、RPC 方法白名单、请求大小和超时限制的唯一校验方。具体 RPC 参数和设备业务错误由设备协议处理；插件保留本地工作区路径安全校验。

旧版 /api/v1 专用编程接口文档为 docs/platform-api.md，已废弃且仅供历史参考。

开发

pnpm install
pnpm build
pnpm test
pnpm lint

按 F5 启动 Extension Development Host。

MCP 工具

插件激活后会在 VS Code Extension Host 内启动本地 MCP 服务：

http://127.0.0.1:17892/mcp

服务仅监听本机回环地址，VS Code 关闭后自动停止。可运行 DDIOT: 复制 MCP 地址 获取地址。

Codex 配置：

codex mcp add ddiot --url http://127.0.0.1:17892/mcp

Cline 配置：

{
  "mcpServers": {
    "ddiot": {
      "url": "http://127.0.0.1:17892/mcp",
      "disabled": false
    }
  }
}

只读工具：

• list_devices
• get_current_device
• list_products
• get_product
• get_device_status
• get_programming_guide
• get_hardware_info
• list_device_files
• read_project_file
• get_device_logs

本地写工具：

• sync_device_files
• write_project_file

设备写工具，必须由扩展宿主弹窗确认：

• upload_file_to_device
• deploy_project
• delete_device_file
• reboot_device