懒猫微服 SDK 与扩展开发指南
你是一个专业的懒猫微服原生开发工程师。当用户希望用 Node.js/Go 从零开发一款微服应用，并希望调用微服底层系统 API（如获取设备列表、注册文件关联）时，请遵循本指南。
- 引入 Lzc-SDK (@lazycatcloud/sdk)
官方提供了 JavaScript/TypeScript 和 Go 版本的 SDK。这让应用可以直接与懒猫微服的系统层、包管理层进行 gRPC 通信。
JavaScript / TypeScript 示例
SDK 内部使用 grpc-web ，可以直接在浏览器前端代码中使用。 安装: npm install @lazycatcloud/sdk
用法:
import { lzcAPIGateway } from "@lazycatcloud/sdk"
// 初始化网关，使用当前页面的 origin (如 https://myapp.heiyu.space) const lzcapi = new lzcAPIGateway(window.location.origin, false)
// 示例：获取微服内的应用列表 async function fetchApps() { const apps = await lzcapi.pkgm.QueryApplication({ appidList: [] }) console.log(apps) }
Go 语言示例
由于原生支持 gRPC，Go 是开发高性能后端的好选择。 安装: go get -u gitee.com/linakesi/lzc-sdk/lang/go
用法:
import ( lzcsdk "gitee.com/linakesi/lzc-sdk/lang/go" "gitee.com/linakesi/lzc-sdk/lang/go/common" )
// 初始化 API lzcapi, err := lzcsdk.NewAPIGateway(context.TODO())
// 示例：获取设备列表 request := &common.ListEndDeviceRequest{Uid: "admin"} devices, err := lzcapi.Devices.ListEndDevices(ctx, request)
- 注册文件类型关联 (file_handler )
如果你开发了一个阅读器、播放器或编辑器，你希望用户在“懒猫网盘”里双击某类文件时，直接唤起你的应用来处理。
配置方法 (lzc-manifest.yml ): 在 application 块中声明 file_handler 。
示例：配置一个 Markdown 编辑器
application: file_handler: mime: - text/markdown # 标准的 mime type - x-lzc-extension/md # 或者指定具体的文件后缀 (懒猫特有语法) # - / # (高危) 匹配所有文件，适合"MD5计算器"等工具 actions: # 当用户在网盘打开该文件时触发。%u 会被自动替换为实际的网盘文件路径。 open: /edit?filepath=%u
应用内的处理: 当网盘唤起你的应用时，浏览器会跳转到 https://你的应用域名/edit?filepath=/用户/文档/test.md 。你的前端或后端代码只需要解析 URL 中的 filepath 参数，然后通过挂载的 /lzcapp/run/mnt/home (或 API) 去读取该文件内容即可。
平台兼容性说明
如果需要查看具体支持的 gRPC 方法列表（Go/JS）或了解更多的官方库（如前端专用的 lzc-file-pickers 选择器，或者内嵌的小型数据库 lzc-minidb ），请主动读取本技能包 references/ 目录下的相关 Markdown 文档。