Install
openclaw skills install @thcjp/humanizer-tool-proopenclaw skills install @thcjp/humanizer-tool-pro功能说明: 本技能涵盖 中文交互、提升工作效率、化流程 等核心能力。
专业版面向内容团队与企业,在免费版 24 类痕迹去痕基础上,扩展批量文档流水线、品牌语气风格库、AI 痕迹评分回归与多语言人性化。痕迹清单与免费版兼容,已有改写规则可直接纳入风格库.
| 能力 | 说明 | 专业版增强 |
|---|---|---|
| 批量去痕 | 多文档流水线处理 | CI 集成 |
| 品牌风格库 | 语气、禁用词、模板 | 版本化治理 |
| 痕迹评分 | AI 痕迹密度量化 | 回归追踪 |
| 多语言 | 中英等多语言人性化 | 术语统一 |
| 术语一致 | 术语表与禁用词表 | 全文校对 |
技术实现要点:核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置. |
用input_params参数进行配置.
处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作用config_options参数进行配置.
处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.
config_options参数,支持修改/重置/导入操作用output_format参数进行配置.
处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.
output_format参数,支持导出/保存/转换操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:面向团队的批量文、本去痕、风格库与品牌语气、治理工具、本去痕与品牌语气、治理专业工具、批量文档去痕与流、水线集成、品牌语气风格库与、多场景模板、痕迹评分与回归追、多语言人性化与术、语一致性等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.# 批量处理脚本
import os, json
from pathlib import Path
# ...
style = json.load(open("brand-voice.json"))
for md in Path("content/").glob("*.md"):
text = md.read_text(encoding="utf-8")
# 调用 Agent 按 style 去痕
# humanized = agent.humanize(text, style)
# Path("output/").joinpath(md.name).write_text(humanized, encoding="utf-8")
print(f"已处理: {md.name}")
{
"brand_voice": {
"tone": "专业但平易,不卖弄",
"forbidden_words": ["赋能", "抓手", "闭环", "生态", "深度"],
"preferred": {"重要": "关键", "此外": "另外"},
"rhythm": "短长句交替,避免三连排比",
"first_person": "产品文档用「我们」,技术博客可用「我」"
},
"templates": {
"release_note": "先说改了什么,再说为什么,最后说影响",
"faq": "问句口语化,答句先给结论再给原因"
}
}
评分维度(0-10,越低越自然):
夸大意义密度: 1.2
AI 高频词密度: 0.8
三连排比次数: 2
破折号密度: 0.5
模糊归因次数: 1
综合痕迹分: 1.1(基线 2.3,已下降 52%)
以下场景文本人性化工具专业版不适合处理:
需要文本翻译、多语言转换、本地化处理时使用。不适用于非本工具能力范围的需求.
风格库配置(brand-voice.json):
{
"version": "1.2.0",
"languages": ["zh", "en"],
"terminology": {"AI": "人工智能", "API": "接口"},
"scoring": {"baseline": 2.3, "target": 1.5, "block_above": 3.0}
}
| 项目 | 免费版 | 专业版 |
|---|---|---|
| 24 类痕迹 | 相同 | 相同(纳入风格库) |
| 范围 | 单篇 | 批量流水线 |
| 语气 | 基础注入 | 品牌风格库 |
| 评分 | 不支持 | 量化回归 |
Q1:风格库怎么团队协同? A:风格库以 JSON 版本化管理,团队评审后合并. Q2:批量处理要多大机器? A:纯文本处理开销低,千篇文档普通笔记本即可. Q3:评分能躲过检测器吗? A:评分目标是量化自然度,不针对特定检测器. Q4:术语表支持多少条? A:无上限,建议按业务域分组管理. Q5:专业版有优先支持吗? A:有。专业版享风格库设计与语气调优咨询.
# CI 集成:内容发布前跑痕迹评分
import json, subprocess, sys
# ...
def humanize_file(path, style):
text = open(path, encoding="utf-8").read()
# 调用 Agent 按 style 去痕
result = agent.humanize(text, style)
score = score_traces(result)
if score > style["scoring"]["block_above"]:
print(f"{path}: 痕迹分 {score} 超阈值,阻断")
sys.exit(1)
open(path, "w", encoding="utf-8").write(result)
# ...
humanize_file(md, json.json")))
{
"terminology": {
"AI": {"zh": "人工智能", "en": "AI"},
"API": {"zh": "接口", "en": "API"},
"cloud": {"zh": "云服务", "en": "cloud"}
},
"consistency_check": true,
"block_on_mismatch": true
}
一致性检查:
zh 版: 「人工智能」✓
en 版: 「AI」✓
术语统一,无混用
# 归档每次评分
python (请参考skill目录中的脚本文件) --input content/ --save scores/$(date +%F).json
# ...
# 趋势对比
python (请参考skill目录中的脚本文件) --dir scores/ --baseline main
趋势报告:
基线(main): 2.3
当前: 1.1(下降 52%)
分项: 夸大意义 1.2→0.4, 高频词 0.8→0.3
判定: 达标,可发布
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| Python | 运行时 | 批量脚本必需 | python.org |
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
{
"success": true,
"data": {
"result": "文本人性化工具专业版处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "humanizer pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。