盈绰服务云

盈绰服务云物业运营助手，用于处理盈绰服务云收费催缴、工单、多业态营收操作。

可执行文件路径：scripts/yc-cloud.sh

./scripts/yc-cloud.sh

模块概览

| 模块 | 说明 | |------|------| | collection | 收费催缴管理 — 见 modules/lewei.md | | order | 工单管理 — 见 modules/qingpeng.md | | rebate | 多业态营收 — 见 modules/lewei.md |

业务模块均存放于 modules/ 目录下，按需引用。使用前必须读取对应模块文件。

配置模块 (config)

config 为顶层命令，管理本地持久化配置。当前实现里，真正写入本地配置文件的键只有 apiKey。

| 命令 | 说明 | |------|------| | config list | 查看当前所有配置 | | config set <key> <value> | 设置配置项 | | config get <key> | 查看指定配置项 |

认证口径：

| 键 | 说明 | |----|------| | apiKey | 唯一持久化配置项，可通过 config set 写入本地配置 |

初始化示例：

baseURL 不属于 config 配置项，而是在构建阶段通过 BuildAPIBaseURL 注入到二进制中。切换测试/生产环境时，使用对应的 make build-* 或 make install-* 产物。

./scripts/yc-cloud.sh config set apiKey <api-key>

除 accessKey 对应的 apiKey 值需要用户提供外，其余配置由构建产物内置；切换环境时请更换对应产物。

路由规则

使用前先按以下规则加载对应模块文件：

涉及 收费、催缴、欠费、收银台、应收管理、短信、模板、分享账单、账单快照、缴款明细、缴款汇总、collection：读取 modules/lewei.md；若同时涉及 5.9 工单或跨模块权限，也读 modules/qingpeng.md。
涉及 工单、报事、报修、派单、认领、审批、转派、退回、撤销、评价、附件、order：同时读取 modules/lewei.md 和 modules/qingpeng.md。
涉及 多业态、营收、rebate、multi-business：读取 modules/lewei.md；若同时涉及工单，也读 modules/qingpeng.md。

冲突优先级（当模块文件之间有矛盾时）：

当前本地 CLI 实际注册的命令
当前对话中用户提供的需求
安全/权限守卫（凭证检查、项目权限）
更具体的模块 skill 优先于通用说明
更新的版本说明优先，但不得超越本地 CLI 实际能力

执行规则

核心原则：先判断请求类型，再按最短路径执行。

请求分流

先把请求分成三类，再继续：

当前上下文整理：用户要基于当前对话里已经出现的结果做筛选、汇总、排序、改写、提炼
CLI 查询/操作：用户明确要查询、创建、发送、生成、流转，且必须调用 yc-cloud
本地文件分析：用户明确给出本地文件并要求分析文件内容

处理规则：

如果当前对话上下文已经足够回答，直接基于上下文处理，不要调用 CLI、Python、脚本，也不要读取新的本地文件
只有当用户请求明确落在 CLI 能力内时，才进入 CLI 执行链路
只有当用户明确要求分析本地文件，或任务必须依赖本地文件原始内容时，才允许读取文件

执行顺序

判断请求类型：先判断属于“当前上下文整理”“CLI 查询/操作”还是“本地文件分析”
上下文整理直出：如果属于“当前上下文整理”，直接输出结果；不要进入鉴权检查、命令预检或脚本处理
加载模块：如果属于 CLI 链路，按路由规则读取对应 modules/*.md 文件
检查鉴权：确认 apiKey 等所需信息已准备；同时确认当前二进制已通过 make build-* 或 make install-* 注入正确环境的 BuildAPIBaseURL；缺失则停止并提示用户补充
执行命令：优先用最轻量只读命令预检；直接执行文档中的命令，不绕过 CLI
简短输出：给出实际命令、命中链路、失败 code/message、下一步唯一建议

全局守卫

不要凭记忆发明或复用 projectId、customerId、workOrderId 等业务 ID；缺少时先查询或询问用户
始终以本地 CLI 实际注册命令为准；若 skill 文档提到的命令本地不存在，直接说明版本不支持，不替换命令
同一轮任务中，CLI 鉴权预检最多执行一次；已经成功后，不要重复执行同类预检
如果 config list、项目列表或其他轻量预检已经成功，不要因为“更保险”再次执行相同命令
只有在命令明确报出 permission denied、不可执行或缺少执行权限时，才允许尝试 chmod +x
不要主动为了保险执行 chmod +x
基于当前上下文做筛选、汇总、排序、提炼时，禁止调用 Python、Node、shell 脚本、jq、awk 或读取新的本地文件
只有满足以下任一条件时，才允许用 Python 或其他脚本：
- 用户明确要求分析本地 Excel、CSV、JSON 等文件
- 任务需要对大规模结构化数据做精确聚合，而当前上下文不足以可靠完成
- 当前 CLI 无法直接提供所需统计结果，且用户目标明确要求精确结果
使用 Python 或其他脚本前，先说明三件事：要读取哪个文件、为什么必须使用脚本、不会修改原始数据
如果 CLI 原生命令已经能返回结构化结果，优先使用 CLI 结果做整理，不要额外再跑 Python 后处理
保持回答快速、短、可执行；不写长篇背景解释