# think-light-plugins

**Repository Path**: osheyx/think-light-plugins

## Basic Information

- **Project Name**: think-light-plugins
- **Description**: ThinkLight 官方插件样例（WASM + Python）与插件接口说明
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://gitee.com/osheyx/think-light
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-25
- **Last Updated**: 2026-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# think-light-plugins

> ThinkLight（思灯）多仓项目的一部分 —— 官方插件样例与插件接口说明。

[← 返回编排仓 think-light](https://gitee.com/osheyx/think-light)

## 状态

🚧 **WIP（开发中）**。仓库已公开以固化目录结构与插件接口约定，样例插件尚未实现。

## 这个仓库负责什么

插件机制让用户**不改网关本体**就能扩展行为：加一条自定义规则、加一种新的传输通道、加一个自己的 Agent 适配器。

本仓是官方样例与接口说明的**权威出处** —— 插件作者看到的宿主 API 以本仓 README 为准。

## 两种插件形态

| 形态 | 目录 | 特点 |
| --- | --- | --- |
| WASM 插件 | `wasm/` | 沙箱隔离、性能好；Rust / Go / AssemblyScript 编写，宿主用 Wasmtime 加载 |
| Python 子进程插件 | `python/` | 开发快、调试方便；由网关拉起子进程通信 |

插件目录默认位置见配置项 `plugins.wasm_dir` / `plugins.python_dir`（默认 `vendor/plugins/...`）。

## 宿主 API 约定（草案）

插件能看到的宿主能力，先按这四类收敛：

1. **读状态** —— 当前任务列表、链路状态、传感器最新一帧
2. **写状态** —— 修改任务状态 / 进度 / 摘要
3. **发指令** —— 向板端下发 `sys_cmd`
4. **订阅事件** —— 按事件类型回调

> ⚠️ 该接口仍在收敛中，定稿后会同步到本仓 README 与 `think-light/docs/adr/`。**接口未稳定前不要依赖它做生产插件。**

## 目录结构

```
think-light-plugins/
├── wasm/          # WASM 插件样例（Rust / Go / AssemblyScript）
├── python/        # Python 子进程插件样例
└── README.md      # 插件接口说明（权威）
```

## 相关仓库

| 仓库 | 职责 |
| --- | --- |
| [think-light](https://gitee.com/osheyx/think-light) | 编排仓：方案总纲、ADR、安装脚本、统一命令入口 |
| [think-light-protocol](https://gitee.com/osheyx/think-light-protocol) | 报文契约唯一来源 |
| [think-light-firmware](https://gitee.com/osheyx/think-light-firmware) | 板端 C 固件 |
| [think-light-gateway-rs](https://gitee.com/osheyx/think-light-gateway-rs) | Rust 网关（生产版） |
| [think-light-gateway-py](https://gitee.com/osheyx/think-light-gateway-py) | Python 网关（调试版） |
| [think-light-dashboard](https://gitee.com/osheyx/think-light-dashboard) | Web 仪表盘 |

## License

[MIT](LICENSE) © 2026 heyongxian