tellcheck

Name: tellcheck
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords生产力02 周前更新

代码仓库

关于 tellcheck

tellcheck 是面向写作者的本地文风检查与确定性 AI 痕迹审计工具，可检查语气和重复表达。它支持可编辑的风格配置，且无需联网或调用模型。

主要功能

01比较文风节奏与表达习惯
02训练和管理风格配置
03查找重复短语与句首
04审计 AI 痕迹并标注位置
05管理词表与风格说明

适用场景

01按指定风格检查草稿
02检查文本中的重复表达
03扫描文案中的 AI 特征用语
04维护各风格专属词语规则

MCP 相关

MCP 服务提供风格与词典管理、文风匹配、重复检查和文本审计工具。本地 `second_read` 工具会按说明返回失败，因为该功能需要托管模型。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-tellcheck": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/tellcheck"
      ]
    }
  }
}

启动命令npx -y @reneturcios/tellcheck

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/tellcheck0.1.0stdio

ocighcr.io/cloudcorprecords/tellcheck:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

tellcheck

根据语音风格检查一段文字，并扫描其中会让文章读起来像机器生成的特征。所有操作都在本地确定性地运行：不联网、不需要 API 密钥、不调用模型。状态（风格、词典、指令、默认风格）以 JSON 格式保存在 TELLCHECK_HOME 或 ~/.tellcheck 下。

这是对 etincel 写作风格工具的洁净室重建，基于其公开的 README 工具规范实现。相关架构是根据该说明文档重建并编写的。

功能

风格。 内置十二种预设风格（Direct & Warm、Executive Brief、Reflective Essayist、Founder Memo、Plainspoken Analyst、Wry & Candid、PR Review、Code Comment、Slack Message、LinkedIn Post、Website Copy、Blog Post），每种风格都配有正式度、亲和度和直接度调节项，以及节奏描述。你可以根据样本训练自己的风格、直接通过调节项创建风格、分叉、更新、删除风格，也可以设置默认风格。
语音风格匹配。 根据风格基线比较草稿的节奏和写作特征（句子长度及其变化、缩略形式的使用率、破折号的使用、片段句、疑问句）。输入过短时，会如实提示置信度较低，而不会给出精确度虚假的分数。
自我重复。 检测重复的句子开头和短语，也会检测与训练风格自身样本中的内容重复的情况。
AI 特征审查。 确定性扫描：内置特征词汇表，并为每个命中项提供建议替换词（例如“comprehensive”“cutting-edge”“leverage”“seamless”“streamline”）；还会检测节奏问题（段落长度过于一致、突发性低）和优点（具体程度、具体内容与抽象内容的平衡）。结果包含 green、yellow、orange 或 red 等级、0–100 分以及带位置的发现项。可选文体类别：email、blog、memo、essay、social、docs、general、personal；docs 类别会抑制 Markdown 结构相关的发现项。提供 sourceFacts 时，会标记文本中缺少事实支持的数字。
词典和指令。 全局及每种风格都可以设置禁用词列表和自定义词列表，还可以设置自由格式的风格指令。
second_read，实话实说。 在原工具中，本地安装的 second read 总是会失败，并给出明确说明（此功能需要托管模型）。本次重建如实复现了这一行为，而不会伪造结果。

命令行界面

每个工具对应一个子命令，接受单个 JSON 参数对象：

npx @reneturcios/tellcheck list_styles '{}'
npx @reneturcios/tellcheck get_style_guide '{"styleId":"founder-memo"}'
npx @reneturcios/tellcheck train_style '{"name":"My Voice","samples":["..."]}'
npx @reneturcios/tellcheck audit_text '{"text":"...","register":"blog"}'
npx @reneturcios/tellcheck --version

退出码：0 表示成功，1 表示工具错误，2 表示用法错误。

MCP

npx -y @reneturcios/tellcheck mcp

MCP 客户端配置：

{
  "mcpServers": {
    "tellcheck": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tellcheck", "mcp"]
    }
  }
}

工具（20 个）

工具	用途
`list_styles`	预设风格、训练风格，以及（若已定义）团队风格
`get_style_guide`	获取某种风格的完整指南
`train_style`	根据样本训练风格（节奏、缩略形式、破折号、段落变化）
`create_style_from_dials`	根据十一个语音风格调节项创建风格
`update_style`	重命名风格或调整其调节项
`fork_style`	分叉本地风格（分叉公共图库中的风格会返回如实的错误）
`delete_style`	删除用户创建的风格
`set_default_style`	设置默认风格
`check_voice_match`	根据风格基线比较节奏和写作特征
`check_self_repetition`	检测重复的句子开头和短语，包括与训练样本的重复
`audit_text`	确定性扫描 AI 特征，返回等级、分数和带位置的发现项
`second_read`	在本地总是失败，并给出原工具的明确说明
`add_banned_word` / `remove_banned_word`	管理禁用词（全局或按风格设置）
`add_custom_word` / `remove_custom_word`	管理自定义词典词条
`list_dictionary`	列出词典范围，以及某种风格合并后的有效词表
`set_style_instructions` / `clear_style_instructions` / `get_style_instructions`	管理自由格式的风格指令

Docker

docker run -i ghcr.io/cloudcorprecords/tellcheck          # stdio MCP server
docker run --rm ghcr.io/cloudcorprecords/tellcheck list_styles '{}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (temp TELLCHECK_HOME, no network)
npm run dev     # run the CLI from source