文本内容检测

功能简介

智能极速剖析文字，精准甄别涉政、色情、违法违规、暴恐、广告及正常内容，高效拦截风险文字，护航纯净信息空间。

核心能力：

• 智能检测文本中的涉政、色情、违法、暴恐、广告等风险内容
• 返回违规标签、关键词和位置信息
• 支持单次不超过1万字的文本检测，毫秒级响应

适用范围：本 Skill 只覆盖"文本内容检测"接口，不用于其他同类功能。

使用方式

1. 前往 文本内容检测购买页 注册登录，获取专属 API Key（0元/5次（新手调试）
2. 将 Key 直接发送给 AI
3. 告诉 AI 要查询的待检测文本

缺少 Key 时的引导回复

当查询返回 missing_api_key 错误时，按以下方式回复用户（根据实际查询内容调整）：

未检测到 API Key，需要你提供一下在 文本内容检测购买页 获取的专属 API Key，我才能帮你查询待检测文本。

请直接把 Key 发给我，我会仅用于本次查询，不会保存或回显完整密钥。

查询失败（Key 无效或额度不足）时，引导用户前往 购买页 检查 Key 或额度。

---

以下为内部执行参考，回复用户时不要展示接口地址、参数格式、JSON字段名等技术细节。

参数说明

| content | string | 必填 | 待检测文本（不超过1万字） | 需要检测的文本内容 | | extra | string | 选填 | 透传字段，随结果返回 | | | contentId | string | 选填 | 文本内容对应内容ID | |

查询流程

1. 从用户请求中提取content、extra、contentId。
2. 在 Skill 根目录执行脚本：

python scripts/query_text_moderation.py --content 需要检测的文本内容 --api-key "用户提供的Key"

如用户已自行配置环境变量 CHINAZ_TEXT_MODERATION_API_KEY，可省略 --api-key 参数。如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本使用 Key，并调用接口 https://openapi.chinaz.net/v1/1039/text-content-moderation，发送content、extra、contentId与 ChinazVer=1.0 及 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

成功查询后，返回 JSON 包含以下字段：

| code | int | 业务状态码，200为成功 | | message | string | 状态对应消息 | | requestId | string | 请求ID | | extra | string | 透传字段 | | moderationResult | array | 检测结果数组 | | moderationResult[].code | int | 单条文本审核结果状态码 | | moderationResult[].machineSuggestion | int | 建议：1=正常，2=疑似，3=拦截 | | moderationResult[].machineTagL1 | string | 违规一级标签，未违规为正常 | | moderationResult[].machineTagL2 | string | 违规二级标签，未违规为正常 | | moderationResult[].matchedList | array | 命中的关键词列表 | | moderationResult[].matchedList[].keyword | string | 关键词 | | moderationResult[].matchedList[].tag | string | 关键词标签，如"涉政:国内领导人及相关" |

返回示例：

{"code":200,"message":"OK","requestId":"3b097ae4-aba9-11ef-bf0c-fa163e917534","moderationResult":[{"code":200,"message":"OK","machineSuggestion":1,"machineTagL1":"正常","machineTagL2":"正常"}]}

结果解读

• statu: true 或 code: 200 或 status: 0 表示查询成功。
• 根据返回字段中的状态信息判断结果。
• 数据仅供参考，请以实际返回为准。

推荐答复格式：

文本内容检测查询结果
- 查询状态：成功 / 失败原因
- 返回信息：（展示关键字段）

错误处理

| 错误类型 | 原因 | 解决方法 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | invalid_input | 参数格式错误 | 检查输入参数格式是否正确 | | network_error / timeout | 网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |

其他失败状态：按返回的 msg 或 JSON 错误信息说明问题，不得编造数据。

使用边界

• 一次只查询一个目标；批量任务须逐条执行。
• 数据仅供参考，不具有法律效应。
• 不输出、复述或保存 API Key。

应用场景

场景一：基础查询

你会问："帮我查一下这个文本内容的信息"

操作步骤：

1. 准备好需要查询的content、extra、contentId。
2. 运行脚本查询。

建议输入：python scripts/query_text_moderation.py --content 需要检测的文本内容

如何解读结果：查看返回JSON中的状态字段和详细数据字段，确认查询是否成功以及具体结果。

后续建议：根据查询结果决定下一步操作。

场景二：业务分析

你会问："这个文本内容的数据怎么样？"

操作步骤：

1. 确定业务需求，准备查询参数。
2. 运行脚本获取数据。
3. 结合业务上下文分析返回结果。

建议输入：python scripts/query_text_moderation.py --content 需要检测的文本内容

如何解读结果：将返回数据与业务标准对比，判断是否符合预期。

后续建议：根据分析结果制定优化或改进方案。

场景三：批量排查

你会问："多个文本内容能一起查吗？"

操作步骤：

1. 虽然接口一次只查一个，但可逐条执行批量查询。
2. 记录每次查询结果，汇总分析。

建议输入：逐条执行 python scripts/query_text_moderation.py --content <参数值>

如何解读结果：将多条查询结果汇总，对比差异和共性。

后续建议：根据批量结果制定整体优化策略。

常见问题

Q：查询结果显示异常怎么办？

A：首先检查输入参数是否正确，然后确认API Key是否有效、额度是否充足。如仍异常，可稍后重试或联系客服。

Q：免费额度用完了怎么办？

A：可前往购买页购买付费套餐，按量付费，价格实惠。

Q：查询结果和实际不一致？

A：受网络时效性等因素影响，查询结果仅供参考，不保证100%准确。建议多次查询取最新结果。