CyberMind-FR ccfb58124c docs: Add trilingual documentation (French and Chinese translations)

Add complete French (fr) and Chinese (zh) translations for all documentation:

- Root files: README, CHANGELOG, SECURITY, BETA-RELEASE
- docs/: All 16 core documentation files
- DOCS/: All 19 deep-dive documents including embedded/ and archive/
- package/secubox/: All 123+ package READMEs
- Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/

Total: 346 translation files created

Each file includes language switcher links for easy navigation between
English, French, and Chinese versions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-03-20 10:00:18 +01:00

4.3 KiB

Raw Blame History

secubox-app-device-intel

Languages: English | Francais | 中文

统一设备清单，聚合所有 SecuBox 子系统的数据。SecuBox 生态系统的一部分。

概述

纯聚合层，将 mac-guardian、client-guardian、DHCP、P2P mesh、暴露扫描器和模拟器模块的数据合并为单一设备清单，具有启发式分类、用户覆盖和跨 mesh 可见性。

架构

device-intelctl (CLI)
  └── functions.sh (聚合库)
        ├── di_collect_mac_guardian()    → /var/run/mac-guardian/clients.db
        ├── di_collect_client_guardian() → UCI client-guardian
        ├── di_collect_dhcp()           → /tmp/dhcp.leases
        ├── di_collect_p2p_peers()      → ubus luci.secubox-p2p
        ├── di_collect_exposure()       → /proc/net/tcp
        └── di_collect_emulators()      → emulators/*.sh
              ├── usb.sh    → /sys/bus/usb/devices/
              ├── mqtt.sh   → mosquitto broker
              └── zigbee.sh → zigbee2mqtt / deCONZ API

数据流

收集 — 并行查询每个数据源
合并 — 以 MAC 地址为键，合并所有来源的字段
分类 — 应用启发式链（用户 > 模拟器 > mesh > 端口 > 厂商 > 主机名）
缓存 — 存储到 /tmp/device-intel/cache-devices.json（可配置 TTL）
服务 — CLI 或 RPCD 返回统一的 JSON

分类优先级

优先级	来源	示例
1	用户覆盖	UCI `device-intel.<mac>.type`
2	模拟器来源	MQTT 客户端 → mqtt_device
3	Mesh peer 匹配	P2P peer IP → mesh_peer
4	基于端口	端口 445 → storage
5	基于厂商	Synology → storage
6	基于主机名	`.sensor.` → iot_sensor
7	回退	unknown

模拟器模块

KISS 风格的可插拔设备发现：

usb.sh — 遍历 /sys/bus/usb/devices/，按 bDeviceClass 分类（storage、serial、HID、camera、audio、printer、wireless）
mqtt.sh — 通过 $SYS 主题或日志查询 mosquitto broker
zigbee.sh — 查询 zigbee2mqtt HTTP API 或 deCONZ REST API

每个模块导出 emulate_<type>() 返回管道分隔的设备条目。

CLI 使用

device-intelctl status                                    # 概览
device-intelctl list table                                # 表格视图
device-intelctl list json                                 # JSON 输出
device-intelctl show aa:bb:cc:dd:ee:ff                    # 设备详情
device-intelctl classify                                  # 批量分类
device-intelctl set-type aa:bb:cc:dd:ee:ff iot_sensor     # 覆盖类型
device-intelctl set-label aa:bb:cc:dd:ee:ff "Temp Sensor" # 自定义标签
device-intelctl emulators                                 # 模块状态
device-intelctl mesh-list                                 # Mesh peer 设备
device-intelctl export json > inventory.json              # 完整导出

UCI 配置

/etc/config/device-intel
  config device-intel 'main'     → enabled, cache_ttl, classify_interval
  config display 'display'       → view mode, grouping, refresh
  config emulator 'mqtt'         → broker_host, port, discovery_topic
  config emulator 'zigbee'       → coordinator, adapter, api_port
  config emulator 'usb'          → scan_interval, track_storage, track_serial
  config device_type '<id>'      → name, icon, color, vendor/hostname/port 匹配规则
  config device '<mac_clean>'    → 用户覆盖（type, label, capabilities, notes）

文件

/etc/config/device-intel                          UCI 配置
/etc/init.d/device-intel                          procd 初始化脚本
/usr/sbin/device-intelctl                         CLI 控制器
/usr/lib/secubox/device-intel/functions.sh        核心聚合库
/usr/lib/secubox/device-intel/classify.sh         启发式分类引擎
/usr/lib/secubox/device-intel/emulators/usb.sh    USB 外设模拟器
/usr/lib/secubox/device-intel/emulators/mqtt.sh   MQTT broker 模拟器
/usr/lib/secubox/device-intel/emulators/zigbee.sh Zigbee 协调器模拟器

依赖

jsonfilter（OpenWrt 原生）
curl（用于模拟器 API 调用）
可选：secubox-app-mac-guardian、secubox-app-client-guardian、secubox-p2p

4.3 KiB Raw Blame History Unescape Escape