chengshishouce/CLI_USAGE.md

城市手册 - 命令行接口使用指南

概述

城市手册提供完整的命令行接口 (CLI)，可以通过命令行操作所有核心功能。

运行方式

在服务器上运行

cd /home/ubuntu/city-manual
docker compose exec -T backend python /app/cli.py <命令> [参数]

本地运行（需要访问服务器数据库）

cd /path/to/project
python cli.py <命令> [参数]

---

命令列表

认证命令

login - 登录获取 Token

docker compose exec -T backend python /app/cli.py login <用户名> <密码>

示例:

docker compose exec -T backend python /app/cli.py login admin Admin123!

输出:

✅ 登录成功
Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

---

省份命令

provinces - 获取所有省份

docker compose exec -T backend python /app/cli.py provinces

输出:

✅ 共 34 个省份:
  1. 北京市 (ID: 1)
  2. 天津市 (ID: 2)
  3. 上海市 (ID: 3)
  ...

region - 获取省份详情

docker compose exec -T backend python /app/cli.py region <省份 ID>

示例:

docker compose exec -T backend python /app/cli.py region 1

---

文章命令

article list - 获取文章列表

docker compose exec -T backend python /app/cli.py article list [数量]

示例:

docker compose exec -T backend python /app/cli.py article list 10

article create - 创建文章

docker compose exec -T backend python /app/cli.py article create <标题> <内容> <省份 ID> [类型]

类型选项: basic, history, culture, practical, life

示例:

docker compose exec -T backend python /app/cli.py article create "北京攻略" "北京是中国的首都..." 1 basic

article submit - 提交文章审核

docker compose exec -T backend python /app/cli.py article submit <文章 ID>

示例:

docker compose exec -T backend python /app/cli.py article submit 1

---

服务命令

service list - 获取服务列表

docker compose exec -T backend python /app/cli.py service list [数量]

示例:

docker compose exec -T backend python /app/cli.py service list 10

service create - 创建特色服务

docker compose exec -T backend python /app/cli.py service create <名称> <描述> <省份 ID> [分类]

分类选项: clothing, food, accommodation, transport, entertainment, tourism, culture

示例:

docker compose exec -T backend python /app/cli.py service create "老北京烤鸭" "正宗北京烤鸭" 1 food

---

AI 审核命令 🔥

audit status - AI 审核服务状态

docker compose exec -T backend python /app/cli.py audit status

输出:

✅ AI 审核服务状态：active
  版本：1.0.0
  功能：敏感词检测, 广告检测, 内容质量评估

audit article - AI 审核文章

docker compose exec -T backend python /app/cli.py audit article <标题> <内容>

示例 1 (正常内容):

docker compose exec -T backend python /app/cli.py audit article "北京攻略" "北京是中国的首都，有很多著名景点"

输出:

AI 审核结果：✅ 通过
  原因：审核通过
  详情：{
  "quality_score": 100
}

示例 2 (敏感词):

docker compose exec -T backend python /app/cli.py audit article "测试" "这是一个包含暴力内容的文章"

输出:

AI 审核结果：❌ 拒绝
  原因：内容包含敏感词：暴力
  详情：{
  "sensitive_words": [
    "暴力"
  ]
}

audit comment - AI 审核评论

docker compose exec -T backend python /app/cli.py audit comment <内容>

示例 1 (正常):

docker compose exec -T backend python /app/cli.py audit comment "写得很好！"

示例 2 (广告):

docker compose exec -T backend python /app/cli.py audit comment "加微信 123456 了解更多"

输出:

AI 审核结果：❌ 拒绝
  原因：疑似广告：加微信

audit service - AI 审核服务

docker compose exec -T backend python /app/cli.py audit service <名称> <描述>

示例:

docker compose exec -T backend python /app/cli.py audit service "老北京烤鸭" "正宗北京烤鸭，皮脆肉嫩"

---

快速测试脚本

测试所有 AI 审核功能

cd /home/ubuntu/city-manual

echo '=== AI 审核测试套件 ==='

echo '1. 测试正常文章'
docker compose exec -T backend python /app/cli.py audit article '北京攻略' '北京是中国的首都'

echo ''
echo '2. 测试敏感词文章'
docker compose exec -T backend python /app/cli.py audit article '测试' '包含暴力内容'

echo ''
echo '3. 测试广告评论'
docker compose exec -T backend python /app/cli.py audit comment '加微信 123456'

echo ''
echo '4. 测试正常服务'
docker compose exec -T backend python /app/cli.py audit service '烤鸭店' '正宗北京烤鸭'

echo ''
echo '=== 测试完成 ==='

---

完整工作流程示例

1. 创建并审核文章

# 查看省份列表
docker compose exec -T backend python /app/cli.py provinces

# 创建文章（使用北京市 ID=1）
docker compose exec -T backend python /app/cli.py article create "北京旅游攻略" "北京是中国的首都..." 1

# AI 预审
docker compose exec -T backend python /app/cli.py audit article "北京旅游攻略" "北京是中国的首都..."

# 提交审核
docker compose exec -T backend python /app/cli.py article submit 1

2. 创建并审核服务

# 创建服务
docker compose exec -T backend python /app/cli.py service create "老北京烤鸭" "正宗北京烤鸭" 1 food

# AI 预审
docker compose exec -T backend python /app/cli.py audit service "老北京烤鸭" "正宗北京烤鸭"

---

错误处理

常见错误

1. 认证失败

   ❌ 错误：Authentication credentials were not provided.
   

   解决：确保使用正确的用户名密码登录

2. 网络错误

   ❌ 错误：network - <urlopen error...>
   

   解决：检查 Docker 容器是否正常运行

3. 内容被拒绝

   AI 审核结果：❌ 拒绝
   原因：内容包含敏感词：暴力
   

   解决：修改内容，移除敏感词

---

系统状态检查

# 检查容器状态
docker compose ps

# 检查数据库
docker compose exec -T backend python /app/cli.py provinces

# 检查 AI 审核服务
docker compose exec -T backend python /app/cli.py audit status

---

文档版本

• 版本: 1.0.0
• 更新日期: 2026-04-14
• 测试状态: ✅ 所有命令测试通过