ahang1598 Seeyon 营销数据分析
使用 scripts/seeyon_marketing.py 作为唯一公开入口。脚本优先从环境变量登录 OA；账号或密码未配置时，复用连接器通过浏览器登录保存的本地会话。不要要求用户提供 Cookie、JSESSIONID 或 route。
准备认证
优先使用运行环境配置：
OA_BASE_URL：完整 OA 登录地址。OA_AUTH_USERNAME：当前登录账号，同时作为自由协同默认发送人。OA_AUTH_PASSWORD：登录密码。
当 OA_AUTH_USERNAME 或 OA_AUTH_PASSWORD 未配置时，不要中止或要求用户复制 Cookie。先在 WorkBuddy 中连接“Seeyon 营销数据分析”连接器：连接器读取已配置的 OA 服务地址，打开隔离登录页面；用户登录成功后自动保存会话，当前 Skill 随后直接复用该 sessionId。OA_BASE_URL、SEEYON_SERVICE_URL 和连接器 connector-config.json.serviceUrl 按此顺序提供服务地址。
不要在命令、回复、日志或文件中展示这些变量的值。浏览器会话不可用时，只提示用户在 WorkBuddy 中重新连接对应连接器，不要索要 Cookie。
运行环境需要 Python 3.9+、requests 和 pycryptodome，版本范围见 scripts/requirements.txt。依赖缺失时，只有在用户授权修改环境后才能安装。
选择命令
order-query 查询销售订单报表前 100 行
organization 查询单位、部门、人员、岗位、角色、职务级别或完整快照
collaboration-send 生成流程并发送营销分析自由协同
先查看参数：
python scripts/seeyon_marketing.py --help
python scripts/seeyon_marketing.py collaboration-send --help
若登录地址不能正确推导业务根地址，可用当前命令的 --base-url 覆盖。不要改为手工传 Cookie。
查询销售订单
python scripts/seeyon_marketing.py order-query
默认报表名为“销售订单查询”，需要覆盖时使用 --report-name "销售订单查询"。
查询严格遵循以下数据边界：
- 只匹配名称完全一致的报表，多个同名报表取服务端顺序中的第一个。
- 使用首个匹配报表的
createMember作为临时bizId，缺失时停止，不猜测。 - 固定查询第 1 页、每页 100 条。
- 保留服务端行数、重复记录和顺序，不去重、不合并、不排序、不修正。
- 不查询销售出库报表，也不拼接出库记录。
- 字段名按显示名称优先级解析；单元格优先使用显示值
v，缺少时回退原始值s。
除非用户明确要求原始数据，不要整段原样展示 orders。将其作为分析事实输入。
生成营销分析
只根据 orders 中真实存在的字段回答用户问题：
- 明确区分报表事实、计算结果和分析判断。
- 计算金额和数量时处理千分位逗号、空值和非数字显示值。
- 重复行仍属于本次报表结果，不自行删除；需要说明重复影响时单独提示。
- 数据为空时说明当前报表没有返回订单，不虚构客户、金额或状态。
- 用户要求订单汇总、未发货、开票、收款或客户分析时，只使用实际存在的对应字段。
推荐报告结构：
# 销售订单分析
## 数据范围
## 核心指标
## 状态与异常
## 客户或负责人分布
## 建议
不存在相应字段时省略该章节，并说明数据限制。
查询组织信息
python scripts/seeyon_marketing.py organization accounts
python scripts/seeyon_marketing.py organization departments --account-id "单位ID"
python scripts/seeyon_marketing.py organization members --account-id "单位ID" --login-name "lisi"
python scripts/seeyon_marketing.py organization posts --account-id "单位ID"
python scripts/seeyon_marketing.py organization roles --account-id "单位ID"
python scripts/seeyon_marketing.py organization job-levels --account-id "单位ID"
python scripts/seeyon_marketing.py organization all --account-id "单位ID"
分页中途失败时保留已经取得的数据并明确标记不完整，不把部分结果描述为完整结果。
发送营销分析协同
当用户要求把分析结果发送给 OA 人员时，业务参数完整后直接执行，不在发送前额外询问确认。发送人默认使用 OA_AUTH_USERNAME，接收人可使用登录名或完整人员 JSON。
python scripts/seeyon_marketing.py collaboration-send \
--account-id "单位ID" \
--subject "销售订单分析报告" \
--content "<h1>销售订单分析</h1><p>……</p>" \
--recipient-login-name "lisi" \
--recipient-login-name "wanger"
未提供原始流程 XML 时生成并行流程。需要自定义流程时提供 --process-xml-file；XML 在任何附件和正文写入前校验。
附件可选，需要时重复使用 --attachment "D:/reports/销售订单分析.xlsx"。
只有用户明确要求预览或暂不发送时才增加 --dry-run。dry-run 允许人员与流程校验，但不上传附件、不保存正文、不发送协同。
判断结果
所有命令输出单个 JSON 文档。使用 ok 判断业务成功，不以 HTTP 200 代替业务成功。
公共字段：
okcommandcompletedStagesfailed_step（失败时）error（失败时，已脱敏）
订单查询成功还包含 reportName、reportId、分页摘要和 orders。自由协同成功还包含 summaryId、contentId、发送人、接收人、流程模式和附件摘要。
附件、正文或最终发送失败时，报告已完成阶段和已有业务 ID，不自动重试、不自动回滚，避免重复协同。
安全边界
- 不输出用户名、密码、Cookie、
JSESSIONID、route、Token 或附件二进制。 - 不访问或加载同级来源 Skill 目录；本 Skill 必须独立运行。
- 不在自动测试中连接真实 OA。
- 用户只要求查询或分析时不发送协同。
- 用户明确要求发送时直接执行；用户明确要求预览时才使用
--dry-run。