核心用法
M2M Ads 提供 CLI 工具和 JS/TS 库两种交互方式，核心流程包括：
1. 机器注册：每台机器执行 m2m-ads register 完成证明工作挑战，获取唯一身份凭证
2. 发布广告：支持四种操作类型——出售(sell)、求购(buy)、交换(exchange)、赠送(gift)，需提交语义嵌入向量(384维)、WGS-84坐标、价格弹性等结构化数据
3. 生命周期管理：广告状态可在 active/frozen/ended 间流转
4. 智能匹配：服务器自动运行匹配引擎，综合操作类型兼容性、地理范围交集、价格容忍度计算、余弦相似度(≥0.3)四重过滤
5. Webhook 通知：配置回调URL接收实时匹配事件
显著优点
- 向量语义匹配：384维嵌入+pgvector实现非关键词的语义相似度检索，突破传统分类广告的关键词局限
- 机器原生设计： proof-of-work注册机制适合IoT/自动化场景，无需人工账户体系
- 双边市场优化：价格容忍度字段私有存储，保护谈判策略的同时实现弹性匹配
- 技术栈现代：Fastify 5 + Kysely + pgvector，TypeScript全链路类型安全
潜在缺点与局限
- 冷启动门槛：需自行生成384维语义向量，对非AI/ML背景用户不友好
- 生态依赖：强制依赖特定npm包和Node≥18，嵌入式设备兼容性存疑
- 匹配透明度低：价格容忍度为私有字段，买方无法知晓卖方的弹性空间
- Webhook可靠性：5秒超时+静默失败，关键交易场景需额外兜底机制
- 无CLI生命周期命令：冻结/结束广告需直接调用API，体验断层
适合人群
- 构建二手物品/库存自动交易平台的开发者
- 需要语义搜索能力的C2C/B2B分类广告系统
- IoT设备网络中的资源置换场景（算力、存储、物料）
- 研究pgvector生产实践的技术团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据持久化 | 广告内容存储于第三方服务器(m2m-ads.com)，需确认SLA和数据主权条款 |
| 匹配公平性 | 价格容忍度私有+向量黑箱，存在信息不对称导致的套利空间 |
| 网络暴露 | Webhook端点需公网可达，增加机器攻击面 |
| 版本兼容性 | 0.1.0早期版本，API契约可能不稳定 |
安全等级说明
系统报告明确标注"未执行安全扫描"，且存在Webhook外泄、POW注册可能的DDoS攻击面、向量注入攻击（若嵌入来源未校验）等未审计风险，建议生产使用前补充渗透测试。