⚙️ 发布说明

🚀 版本 0.3.1（2026-03-31）

✨ 主要特性

📦 产品分析服务：新增 ProductService，覆盖产品分析完整生命周期：创建、轮询、拉取报告（纯 REST API，无需 WebSocket）。
- client.product.create()：提交产品名称或 URL，可附带附件
- client.product.get_info()：轮询产品生成状态
- client.product.get_report()：获取完整分析报告（关键词、人群画像、竞品、活动建议）
- client.product.get_categories()：获取行业分类数据
- client.product.create_and_wait()：高层封装方法，自动处理 create → poll → report，并支持回调
📊 产品数据模型：为产品 API 增加了完整的 Pydantic 类型模型：CreateProductRequest、CreateProductResponse、ProductInfo、ProductReport、Campaign、IndustryCondition、Category、Industry

🔧 改进

🔇 更干净的日志：包含凭据的 WebSocket URL 日志从 INFO 下调到 DEBUG；断开连接内部日志同样下调到 DEBUG
📋 更好的 CLI 输出：计划状态统一为 [plan] status: xxx；任务结果显示 [task_result] completed/stopped；JSON 完成消息会解析成人类可读原因，避免截断原始 JSON
🛡️ 示例鲁棒性提升：两个示例在 mate.yaml 缺失或凭据无效时会给出明确提示并安全退出，不再回退到空默认值

📝 新增文件

wyseos/mate/services/product.py：ProductService 实现
examples/product_analysis/example.py：独立产品分析示例
docs/api-product-create.md：产品 API 文档（中文）

📦 查看：wyseos-sdk 0.3.1 on PyPI

🚀 版本 0.3.0（2026-03-31）

✨ 主要特性

🎯 营销模式：完整营销能力，覆盖产品分析、热点话题选择、推文/线程生成，以及富流分片聚合。
- 新增 TaskMode.Marketing 用于营销会话执行
- 新增 MarketingService REST API：get_product_info、get_report_detail、update_report、get_research_tweets
- 新增 SessionService.get_marketing_data()，按会话拉取生成内容（reply/like/retweet/tweet）
- 富流支持 writer_twitter、marketing_tweet_reply、marketing_tweet_interact
🔑 JWT 认证：HTTP 与 WebSocket 同时支持 API Key 和 JWT 双认证。
🛑 CLI 安全模式：新增 stop_on_x_confirm，用于无头/CLI 场景下阻止浏览器确认动作。
⏸️ 会话暂停：新增 send_pause() 用于暂停活跃会话。

🔧 改进

📦 TaskRunner 重构：将 TaskRunner、TaskExecutionOptions、TaskResult、TaskMode 从 websocket.py 拆分到独立 task_runner.py（websocket 模块减少约 500 行）。
🔇 更干净的 CLI 输出：调试日志由 INFO 下调到 DEBUG；verbose 输出统一 [plan]/[text]/[task_result] 前缀；JSON 完成消息解析为可读原因。
📋 会话协议对齐：CreateSessionRequest 简化（移除 team_id，新增 mode/platform/extra）；SessionInfo 字段更宽松并提供合理默认值。
🏭 工厂函数：在包级别导出 create_task_runner()，便于统一初始化。

🐛 问题修复

修复 run_interactive_session 中 auto_accept_plan 不生效
修复收到最终答案后会话未停止
修复截图打印时包含超大 base64 数据

💥 破坏性变更

CreateSessionRequest 不再需要 team_id
会话状态常量重命名：SESSION_STATUS_RUNNING → SESSION_STATUS_ACTIVE
计划状态 SKIPPED 重命名为 SKIP

📦 查看：wyseos-sdk 0.3.0 on PyPI

🚀 版本 0.2.1（2025-09-11）

✨ 主要特性

🎯 新增 TaskRunner 接口：将复杂 WebSocket 任务执行从 400+ 行代码简化到 10-20 行。
- run_task()：自动执行并返回完整结果
- run_interactive_session()：交互式执行，支持用户输入
⚙️ 新增 TaskExecutionOptions：高级执行配置，含更合理默认值（如 capture_screenshots=False）。
📊 新增结果跟踪：完整 TaskResult 模型，包含执行时长、消息计数、计划历史和结构化错误信息。

🔧 改进

📦 消息处理重构：按 text/plan/rich/input 拆分模块化处理器。
📚 文档增强：重写 quickstart 和 README，提供更现代的示例与 API 说明。
⚡ 性能优化：默认配置更偏速度，减少不必要数据收集与内存占用。
🛡️ 错误处理增强：提供更完整错误上下文并改进资源清理。

🐛 问题修复

🧵 线程安全增强：改进并发场景下完成事件处理。
🔌 连接管理改进：优化 WebSocket 生命周期与回收。

📦 查看：wyseos-sdk 0.2.1 on PyPI

📦 版本 0.2.0（2025-08-25）

💥 破坏性变更

🏷️ 项目更名：SDK 从 wyse-mate-sdk 更名为 wyseos-sdk。导入路径需从 wyse_mate 更新为 wyseos.mate。
- 之前：from wyse_mate import Client
- 之后：from wyseos.mate import Client

🔧 改进

🏗️ 项目重构：与 WyseOS 对齐，引入更可扩展的 wyseos 命名空间。
⚙️ 配置简化：移除 user_agent、debug、http_client 配置项。
📚 新增示例：增加 examples 目录与 getting_started 指南。

🐛 问题修复

🚫 修复 ImportError：修复配置简化后 DEFAULT_USER_AGENT 的导入错误。
✅ 修复 ValidationError：将 SessionInfo.intent_id 调整为可选，兼容 API 缺字段场景。

📦 查看：wyseos-sdk 0.2.0 on PyPI

📦 版本 0.1.2（2025-08-08）

🔧 改进

🆕 新增：计划消息与整体状态跟踪
🆕 新增：更多 WebSocket 交互与稳定性支持
📈 改进：示例用法更清晰

📦 查看：wyse-mate-sdk 0.1.2

📝 提交记录

👥 反馈

🐛 发现问题？请在 Github 提交 issue

🚀 版本 0.3.1（2026-03-31）

✨ 主要特性

📦 产品分析服务：新增 ProductService，覆盖产品分析完整生命周期：创建、轮询、拉取报告（纯 REST API，无需 WebSocket）。
- client.product.create()：提交产品名称或 URL，可附带附件
- client.product.get_info()：轮询产品生成状态
- client.product.get_report()：获取完整分析报告（关键词、人群画像、竞品、活动建议）
- client.product.get_categories()：获取行业分类数据
- client.product.create_and_wait()：高层封装方法，自动处理 create → poll → report，并支持回调
📊 产品数据模型：为产品 API 增加了完整的 Pydantic 类型模型：CreateProductRequest、CreateProductResponse、ProductInfo、ProductReport、Campaign、IndustryCondition、Category、Industry

🔧 改进

🔇 更干净的日志：包含凭据的 WebSocket URL 日志从 INFO 下调到 DEBUG；断开连接内部日志同样下调到 DEBUG
📋 更好的 CLI 输出：计划状态统一为 [plan] status: xxx；任务结果显示 [task_result] completed/stopped；JSON 完成消息会解析成人类可读原因，避免截断原始 JSON
🛡️ 示例鲁棒性提升：两个示例在 mate.yaml 缺失或凭据无效时会给出明确提示并安全退出，不再回退到空默认值

📝 新增文件

wyseos/mate/services/product.py：ProductService 实现
examples/product_analysis/example.py：独立产品分析示例
docs/api-product-create.md：产品 API 文档（中文）

📦 查看：wyseos-sdk 0.3.1 on PyPI

🚀 版本 0.3.0（2026-03-31）

✨ 主要特性

🎯 营销模式：完整营销能力，覆盖产品分析、热点话题选择、推文/线程生成，以及富流分片聚合。
- 新增 TaskMode.Marketing 用于营销会话执行
- 新增 MarketingService REST API：get_product_info、get_report_detail、update_report、get_research_tweets
- 新增 SessionService.get_marketing_data()，按会话拉取生成内容（reply/like/retweet/tweet）
- 富流支持 writer_twitter、marketing_tweet_reply、marketing_tweet_interact
🔑 JWT 认证：HTTP 与 WebSocket 同时支持 API Key 和 JWT 双认证。
🛑 CLI 安全模式：新增 stop_on_x_confirm，用于无头/CLI 场景下阻止浏览器确认动作。
⏸️ 会话暂停：新增 send_pause() 用于暂停活跃会话。

🔧 改进

📦 TaskRunner 重构：将 TaskRunner、TaskExecutionOptions、TaskResult、TaskMode 从 websocket.py 拆分到独立 task_runner.py（websocket 模块减少约 500 行）。
🔇 更干净的 CLI 输出：调试日志由 INFO 下调到 DEBUG；verbose 输出统一 [plan]/[text]/[task_result] 前缀；JSON 完成消息解析为可读原因。
📋 会话协议对齐：CreateSessionRequest 简化（移除 team_id，新增 mode/platform/extra）；SessionInfo 字段更宽松并提供合理默认值。
🏭 工厂函数：在包级别导出 create_task_runner()，便于统一初始化。

🐛 问题修复

修复 run_interactive_session 中 auto_accept_plan 不生效
修复收到最终答案后会话未停止
修复截图打印时包含超大 base64 数据

💥 破坏性变更

CreateSessionRequest 不再需要 team_id
会话状态常量重命名：SESSION_STATUS_RUNNING → SESSION_STATUS_ACTIVE
计划状态 SKIPPED 重命名为 SKIP

📦 查看：wyseos-sdk 0.3.0 on PyPI

🚀 版本 0.2.1（2025-09-11）

✨ 主要特性

🎯 新增 TaskRunner 接口：将复杂 WebSocket 任务执行从 400+ 行代码简化到 10-20 行。
- run_task()：自动执行并返回完整结果
- run_interactive_session()：交互式执行，支持用户输入
⚙️ 新增 TaskExecutionOptions：高级执行配置，含更合理默认值（如 capture_screenshots=False）。
📊 新增结果跟踪：完整 TaskResult 模型，包含执行时长、消息计数、计划历史和结构化错误信息。

🔧 改进

📦 消息处理重构：按 text/plan/rich/input 拆分模块化处理器。
📚 文档增强：重写 quickstart 和 README，提供更现代的示例与 API 说明。
⚡ 性能优化：默认配置更偏速度，减少不必要数据收集与内存占用。
🛡️ 错误处理增强：提供更完整错误上下文并改进资源清理。

🐛 问题修复

🧵 线程安全增强：改进并发场景下完成事件处理。
🔌 连接管理改进：优化 WebSocket 生命周期与回收。

📦 查看：wyseos-sdk 0.2.1 on PyPI

📦 版本 0.2.0（2025-08-25）

💥 破坏性变更

🏷️ 项目更名：SDK 从 wyse-mate-sdk 更名为 wyseos-sdk。导入路径需从 wyse_mate 更新为 wyseos.mate。
- 之前：from wyse_mate import Client
- 之后：from wyseos.mate import Client

🔧 改进

🏗️ 项目重构：与 WyseOS 对齐，引入更可扩展的 wyseos 命名空间。
⚙️ 配置简化：移除 user_agent、debug、http_client 配置项。
📚 新增示例：增加 examples 目录与 getting_started 指南。

🐛 问题修复

🚫 修复 ImportError：修复配置简化后 DEFAULT_USER_AGENT 的导入错误。
✅ 修复 ValidationError：将 SessionInfo.intent_id 调整为可选，兼容 API 缺字段场景。

📦 查看：wyseos-sdk 0.2.0 on PyPI

📦 版本 0.1.2（2025-08-08）

🔧 改进

🆕 新增：计划消息与整体状态跟踪
🆕 新增：更多 WebSocket 交互与稳定性支持
📈 改进：示例用法更清晰

📦 查看：wyse-mate-sdk 0.1.2

📝 提交记录

👥 反馈

🐛 发现问题？请在 Github 提交 issue

⚙️ 发布说明

目录

⚙️ 发布说明

目录