通过调用成均智能的HTTP API接口,检测文本中的敏感信息、语法错误、标点符号问题等。
v1.0.0调用成均平台HTTP API,检测文本中的敏感词、领导官员称谓、禁用词、语法和标点错误,保障内容合规安全。 (No change needed, the text is already in Chinese)
运行时依赖
安装命令
点击复制本土化适配说明
通过调用成均智能的HTTP API接口,检测文本中的敏感信息、语法错误、标点符号问题等。 安装说明: 安装命令:["openclaw skills install chengjun-content-security"]
技能文档
成均内容安全 Skill 名称:成均内容安全 描述:通过调用成均平台的 HTTP API 接口,检测文本中的敏感信息、语法错误、标点符号问题等,保障内容合规。
简介 这是一个用于检测文本敏感信息的 Skill,通过调用成均平台(博达智能体开放平台)的内容安全接口,快速识别文本内容中的敏感数据、语法错误等问题,适用于内容审核、数据合规等场景。
本技能支持检测以下内容: 敏感词汇 领导人称谓 官员称谓 禁用词汇 语法错误 标点符号问题
重要配置说明 API 认证配置(二选一): 方式 1:直接使用 Token(推荐) export CHENGJUN_API_KEY="your_http_api_token" 方式 2:使用凭证获取 Token export CHENGJUN_TENANT_ID="your_tenant_id" export CHENGJUN_CLIENT_ID="your_client_id" export CHENGJUN_CLIENT_SECRET="your_client_secret"
服务信息: 生产环境 Base URL: https://api.vsbclub.com/ 获取 Token: GET /boda/getTokenByClientId 文本预检: POST /pre-sys/precheck/text 认证方式: Authorization Bearer Token
功能特性 支持多种内容安全检查(敏感词、领导人称谓、官员称谓、禁用词、语法词、标点符号) 支持直接 Token 和自动获取 Token 两种认证方式 Token 自动缓存管理,避免频繁请求 标准化的 JSON 格式输入输出 完善的错误处理和超时机制 兼容 OpenClaw 对话式调用 文本长度限制:5000 字符 使用 Python 标准库,无需额外依赖
安全说明 API 认证 支持直接传入 Token 或通过凭证自动获取 Token Token 通过 Authorization 请求头传递 凭证信息仅用于获取 Token,不会发送到其他服务 数据安全 预检结果不会被服务端保存 单次请求文本长度不超过 5000 字符 使用 HTTPS 协议传输数据
技术实现 使用的技术栈 技术 用途 Python 3.8+ 主要开发语言 urllib (标准库) HTTP 请求库 依赖安装 本 Skill 使用 Python 标准库,无需安装额外依赖。
使用方法 对话式调用 请帮我检测这段文本是否包含敏感信息:{待检测文本内容} API 认证配置 方式 1:直接使用 Token export CHENGJUN_API_KEY="your_http_api_token" 方式 2:使用凭证自动获取 Token export CHENGJUN_TENANT_ID="your_tenant_id" export CHENGJUN_CLIENT_ID="your_client_id" export CHENGJUN_CLIENT_SECRET="your_client_secret"
参数说明 参数名 类型 必传 说明 text string 是 待检测的文本内容(不超过 5000 字符) api_key string 否 API 密钥(可选,默认从环境变量读取)
返回格式 { "code": 200, "msg": "检测成功", "precheck": { "leader": [], "officer": [], "forbidden": [], "grammar_word": [], "sensitive": [ { "word": "党的二十", "correct": ["党的二十大"], "misdescription": null, "category": "中国共产党相关表述", "sentence": "为深入学习贯彻党的二十精神", "explain": null, "startInSentence": 9, "riskLevel": "middle", "level": "疑似错误", "start": 9, "end": 13, "priority": 2, "typeNum": 1 } ], "punctuation": [], "urlBody": null, "wordNum": 481 } }
检查项说明 检查项 说明 leader 领导人称谓检查结果 officer 官员称谓检查结果 forbidden 禁用词检查结果 grammar_word 语法词检查结果 sensitive 敏感词检查结果 punctuation 标点符号检查结果
错误码说明 通用错误码 错误码 说明 200 检测成功 -1 业务逻辑错误(文本为空或超长) API 调用错误 错误码 说明 401 认证失败(Token 无效或凭证错误) 403 权限不足 429 请求频率超限 500 服务器内部错误 -2 API 调用失败(网络或服务问题)
示例代码 from main import check_content, run # 方式 1:使用环境变量中的 Token # export CHENGJUN_API_KEY="your_http_api_token" result = check_content( text="创建特色社会主义道路,为深入学习贯彻党的二十精神" ) # 方式 2:直接传入 Token result = check_content( text="创建特色社会主义道路,为深入学习贯彻党的二十精神", api_key="your_http_api_token" ) # 使用 run 函数(兼容 OpenClaw) result = run({ "text": "创建特色社会主义道路,为深入学习贯彻党的二十精神" }) # 打印结果 print(json.dumps(result, ensure_ascii=False, indent=2))
注意事项 使用前需要配置 API 认证(Token 或凭证) 单次请求文本长度不超过 5000 字符 预检结果不会被服务端保存 接口调用超时时间为 30 秒 Token 自动缓存,有效期内的请求不会重复获取
API 接口文档 详细文档请参考:https://platform.vsbclub.com/docs/zh/webber/content_check.html 获取 Token 接口 请求地址:GET https://api.vsbclub.com/boda/getTokenByClientId 请求参数:tenantId, clientId, clientSecret 返回:token(有效期约 2 小时) 文本预检接口 请求地址:POST https://api.vsbclub.com/pre-sys/precheck/text 请求头:Authorization: {token} 请求参数:text(待检测文本) 返回:precheck(检测结果)
故障排查 如果调用失败,检查: 网络连接:curl -I https://api.vsbclub.com/ Token 配置:确认 CHENGJUN_API_KEY 设置正确 凭证配置:如用方式 2,确认三个环境变量都正确 文本长度:确保不超过 5000 字符 服务状态:服务可能暂时不可用,稍后重试
获取 API 凭证 访问开放平台注册页面,完成开发者认证并创建应用获取: tenantId(租户 ID) clientId(客户端 ID) clientSecret(客户端密钥) 或直接获取可用的 HTTP API Token