init: ops-assistant codebase

docs/ai_command_guide.md

@@ -0,0 +1,150 @@
+# AI 命令解释知识库（用于自然语言→标准命令翻译）
+
+## 总原则
+- 目标：把用户的自然语言翻译成**唯一**的标准命令。
+- 只输出一行命令，不要解释。
+- 不能确定时输出 `FAIL`。
+- 标准命令必须以 `/` 开头。
+
+---
+
+## OPS 模块
+### /help
+**用途**：显示 OPS 可用命令清单（同 /start /ops help）。
+**常见自然语**：
+- 你能做什么 / 你会什么
+- 功能 / 菜单 / 帮助 / help
+- 查看命令 / 看下命令
+**输出命令**：
+- `/help`
+
+### /ops modules
+**用途**：查看模块启用状态。
+**常见自然语**：
+- 模块状态 / 查看模块
+- ops 模块 / ops modules
+**输出命令**：
+- `/ops modules`
+
+---
+
+## CPA 模块
+### /cpa help
+**用途**：显示 CPA 模块可用命令。
+**常见自然语**：
+- cpa 帮助 / cpa help
+**输出命令**：
+- `/cpa help`
+
+**用途**：查询 CPA 服务状态与 usage 快照。
+**常见自然语**：
+- cpa状态 / CPA状态 / cpa status / cpastatus
+- cpa 服务状态 / cpa 运行状态 / cpa 正常吗
+- 查下 cpa / 看下 cpa 状态
+**输出命令**：
+- `/cpa status`
+
+### /cpa usage backup
+**用途**：导出实时 usage 并打包备份。
+**常见自然语**：
+- cpa 备份 / 备份 cpa
+- 备份 usage / cpa usage 备份
+- 导出 cpa 使用情况
+**输出命令**：
+- `/cpa usage backup`
+
+### /cpa usage restore <backup_id>
+**用途**：从备份恢复 usage。
+**常见自然语**：
+- 恢复 cpa / 回滚 cpa
+- 用备份 <id> 恢复
+- 恢复 usage <id>
+**输出命令**：
+- `/cpa usage restore <backup_id>`
+
+---
+
+## Cloudflare 模块
+### /cf status
+**用途**：查看 Cloudflare 配置状态。
+**常见自然语**：
+- cf 状态 / cloudflare 状态
+- cf 配置怎么样
+**输出命令**：
+- `/cf status`
+
+### /cf zones
+**用途**：列出 zone 列表。
+**常见自然语**：
+- cf zones / cf 区域列表 / 站点列表
+**输出命令**：
+- `/cf zones`
+
+### /cf dns list <zone_id>
+**用途**：列出指定 zone 的 DNS 记录。
+**常见自然语**：
+- 列出 DNS / 查看 DNS / cf dns list
+- zone <id> 的 dns 记录
+**输出命令**：
+- `/cf dns list <zone_id>`
+
+### /cf dns update <zone_id> <record_id> <type> <name> <content> [ttl] [proxied]
+**用途**：更新 DNS 记录。
+**常见自然语**：
+- 更新 dns / 修改解析
+- 把 <name> 改成 <ip>
+**输出命令**：
+- `/cf dns update <zone_id> <record_id> <type> <name> <content> [ttl] [proxied]`
+
+### /cf dnsadd <name> <content> [true] [type]
+**用途**：新增 DNS 记录（name 自动匹配 zone）。
+**常见自然语**：
+- 新增解析 / 添加 DNS
+- 增加 <name> -> <ip>
+**输出命令**：
+- `/cf dnsadd <name> <content> [true] [type]`
+
+### /cf dnsset <record_id> <content> [true]
+**用途**：按 record_id 修改内容（可选开启代理）。
+**常见自然语**：
+- 更新记录内容 / 改 IP
+**输出命令**：
+- `/cf dnsset <record_id> <content> [true]`
+
+### /cf dnsdel <record_id> YES
+**用途**：删除 DNS 记录（需 YES 确认）。
+**常见自然语**：
+- 删除 DNS 记录 / 删解析
+**输出命令**：
+- `/cf dnsdel <record_id> YES`
+
+### /cf dnsproxy <record_id> on|off
+**用途**：切换代理开关（不改 content）。
+**常见自然语**：
+- 开启/关闭代理
+**输出命令**：
+- `/cf dnsproxy <record_id> on|off`
+
+### /cf workers list
+**用途**：列出 Workers。
+**常见自然语**：
+- 列出 workers / cf workers
+**输出命令**：
+- `/cf workers list`
+
+---
+
+## Mail 模块
+### /mail status
+**用途**：查看邮件服务/配置状态。
+**常见自然语**：
+- 邮件状态 / mail 状态
+- 邮箱配置是否正常
+**输出命令**：
+- `/mail status`
+
+---
+
+## 兜底规则
+- 无法确定命令或缺少关键参数时输出 `FAIL`。
+- 不要猜测 zone_id/record_id/backup_id 等关键参数。