Property Workorder CLI

可执行文件路径：./scripts/jinbi-cli.sh

./scripts/jinbi-cli.sh

---

模块概览

| 模块 | 说明 | |------|------| | config | 配置管理 | | auth | 认证（获取用户ID） | | order | 工单管理 — 见 references/order.md | | visit | 拜访管理 — 见 references/visit.md | | meeting | 业主见面会 — 见 references/meeting.md | | ai-answer | AI问答 — 见 references/ai-answer.md | | daojia | 到家管理 — 见 references/daojia.md | | jxc | 进销存 — 见 references/jxc.md |

业务模块均存放于 references/ 目录下，按需引用。

---

配置模块 (config)

config 是顶层命令，用于设置全局环境和凭证。

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

配置项：

| 键 | 说明 | 默认值 | |----|------|--------| | accessKey | 访问密钥（必填） | - | | baseURL | API接口地址 | - | | authURL | 认证接口地址 | -|

示例：

# 查看当前配置
./scripts/jinbi-cli.sh config list

# 设置 accessKey
./scripts/jinbi-cli.sh config set accessKey <accessKey>

---

认证模块 (auth)

| 命令 | 说明 | |------|------| | auth getUserId | 根据accessKey获取用户ID（查询用户ID） |

使用场景： 用户需要查询用户ID时，调用此命令

参数：

| 参数 | 说明 | |------|------| | --access-key | 直接传入accessKey（可选，若未传入则使用配置文件中的值） |

说明： 执行命令前会自动检查 accessKey 是否已配置（通过参数或配置文件）

示例：

# 使用配置文件中的accessKey
./scripts/jinbi-cli.sh auth getUserId

# 直接传入accessKey
./scripts/jinbi-cli.sh auth getUserId --access-key <accessKey>

---

执行规则

核心原则：不要思考，直接执行。

1. 直接执行：用户提出需求 → 立即执行
2. 检查配置：所有命令均不需要提示登录，无需登录 Token 或不使用auth login 认证服务，均使用accessKey 的机制。直接通过命令 config list 查询配置
   • 若 accessKey 无值 → 直接返回：请设置的你Access Key。登录企微 -> 点击工作台 -> 搜索"获取key"并点击进入-> 点击生成key -> key生成后点击复制 -> 告诉我 "设置accessKey：粘贴复制的key"

---

AI 问答模块 (ai-answer)

AI 智能问答模块，基于知识库进行流式检索回答。

| 命令 | 说明 | |------|------| | ai-answer query <question> | AI 问答流式检索（支持 SSE） |

参数：

| 参数 | 必填 | 说明 | |------|------|------| | <question> | 是 | 提问内容 | | --top-k <n> | 否 | 相关文档片段数量，默认 5 | | --rerank | 否 | 开启重排序 | | --no-rerank | 否 | 关闭重排序（默认） | | --raw | 否 | 输出 SSE 原始 event/data | | --debug | 否 | 打印每个 SSE 事件原始内容 | | --quiet | 否 | 仅输出回答正文和错误 | | --json | 否 | JSON 格式输出 |

示例：

# AI 问答流式检索
./scripts/jinbi-cli.sh ai-answer query "保洁"

# 指定返回相关文档片段数量
./scripts/jinbi-cli.sh ai-answer query "保洁" --top-k 5

# 开启重排序
./scripts/jinbi-cli.sh ai-answer query "保洁" --rerank

# 输出 SSE 原始 event/data
./scripts/jinbi-cli.sh ai-answer query "保洁" --raw

# 打印每个 SSE 事件原始内容（调试）
./scripts/jinbi-cli.sh ai-answer query "保洁" --debug

# 仅输出回答正文和错误
./scripts/jinbi-cli.sh ai-answer query "保洁" --quiet

# JSON 格式输出
./scripts/jinbi-cli.sh ai-answer query "保洁" --json

---