clearotron

在公司确定名称之前，先弄清楚有哪些障碍。向 Clearotron 提供名称、经营类别和销售地区：它会搜索商标注册簿和开放网络，查找冲突；像商标审查律师一样分析风险；并发布书面报告，每项发现背后都附有机器可读的审计记录。它会在你自己的机器上无头运行：无需网关或平台，你要核查的名称也不会传到我们这里。

快速开始 · 安装与运行 · 文档 · 安全 · 贡献 · 许可证

安装

先不安装任何东西，看看它如何运行。

npx clearotron demo

该命令会获取已发布的软件包——下载前会询问一次——然后将已完成的核查结果载入本地门户，并输出门户地址和登录密码。在浏览器中打开该地址。无需注册、无需凭据，也不会向我们发起网络请求。

只要窗口保持打开，演示就会持续运行；关闭窗口时，它会删除创建的所有内容——机器上不会留下任何东西，下次运行时也会从干净状态开始。如果想在关闭窗口后保留示例报告，请运行 npx clearotron demo --keep；它会输出一个命令，供你完成后删除该文件夹。npx clearotron demo --once 会发布报告后退出，并以相同方式保留文件夹。

然后安装它。

npx clearotron install

适用于 macOS、Linux 或 Windows，要求 Node 22.13 或更新版本。无需 root 权限：程序会安装到 ~/.local，并将 clearotron 命令放在 ~/.local/bin，随后逐个询问问题，并在保存凭据前逐一检查。以下每条命令都会使用安装好的 clearotron——也就是你安装时所用的同一渠道版本——因此，如果 ~/.local/bin 尚未加入 PATH，请改用完整路径 ~/.local/bin/clearotron。**Windows 上可通过 PowerShell 原生运行：无需 WSL2、Git 或管理员权限。**使用 npm install --global clearotron 安装，然后运行 clearotron install。它会在你启动它的窗口中运行，就像在 Mac 上一样：关闭窗口会停止搜索，下次运行 clearotron start 即可继续。

有关通过 npm 自带的全局安装方式进行安装，请参阅 INSTALL.md §2。

npx clearotron install 会安装稳定版——这是发布前已完成真实端到端核查的版本。如果你想使用最新代码，只要有值得测试的内容，就会发布一个 beta 版本：

npx clearotron@beta install

各渠道的承诺内容，以及稳定版的发布时间：docs/RELEASES.md。如果不确定该选哪个，使用第一条命令即可。

稍后如需移除：INSTALL.md §2a 列出了安装写入的所有路径，并说明哪个路径存放报告，方便你有意保留它们。

快速开始

安装后，先检查它发现了什么，再让它执行任何操作。doctor 只读取信息——不会写入任何内容， 不会调用任何人，并会列出所有仍缺少的项目：

clearotron doctor

然后启动产品，并打开它打印出的门户地址：

clearotron start

这就是你们公司所有人使用的门户。订购一份商标清查使用的是同一个页面——用一句话描述需求， 或者自行设置类别、市场和搜索深度：

完成后的商标清查报告如下——结论、风险等级和四项答复。商标 VENQORI 是虚构的；其背后的注册簿数据是真实且实时的，报告本身也明确说明了这一点：

冲突分布图按照商标相似度和商品接近程度展示每项发现，并按司法辖区列出背后的权利人：

然后运行你自己的任务：在门户中下单，或向引擎提供任务文件：

clearotron run --job my-job.json

工作原理

• 推理 CLI 负责思考。 每个阶段都以无头方式调用 Claude CLI（claude）或 Codex CLI；如果机器上没有，安装过程会安装它。CLEAROTRON_AI_BILLING 决定费用由谁承担：你登录的订阅、API 密钥，或你自己的 Google、Microsoft 或 Amazon 云账户。无论由谁付费，实际运行的都是 CLI——没有直接调用模型的路径。
• 一个注册簿凭据决定覆盖范围和费用。 CLEAROTRON_DATABASE 没有默认值——运行时如果未设置，会拒绝执行，而不是替你选择供应商。EUIPO 和本地 USPTO 索引免费；Clarivate、Signa 和 Corsearch 则需要订阅。六种注册簿及其覆盖范围。
• 一个搜索密钥。 PERPLEXITY_API_KEY 用于开放网络和各个市场。没有这个密钥，商标清查会在入口处拒绝执行，不会先让注册簿阶段产生费用。
• 一次运行需要数小时，并且可以从中断处继续。 每个已完成的阶段都会保存在磁盘上；恢复运行时只会重新执行缺失的阶段，因供应商限额而暂停的运行则会自动继续。
• 已完成的运行可以查询。 MCP 服务让 Claude、ChatGPT 或你的编辑器能用自然语言读取并询问任何已完成的运行：可信的本地 stdio 接口，以及经过身份验证的 HTTP 接口。后者的读取工具会为已登录身份提供服务，而写入操作（包括会产生费用的 start_run）则需要 ops 令牌。连接它。
• 引擎不与任何供应商绑定。 driver/register-plan.mjs 决定要搜索什么，它将 capabilities 对象作为参数接收，并且不会导入任何供应商。遇到未知的注册簿 ID 时会抛出异常，而不会回退到其他选项。
• 律师事务所只需安装一套系统，即可服务其所有客户公司。 每家公司只需设置一次，使用各自的类别、市场和风险框架；每个人只能看到分配给自己的公司。添加公司 · 为这些公司的人员提供连接器。

安全

报告可能会涉及贵公司尚未公布的名称。请像保护尚未公开的计划一样保护任务池、归档文件和交付文件包；在律师事务所中，则应像保护案件档案一样保护它们。

本软件的作者不会收到任何信息——没有商标信息、公司背景、结果、使用情况报告或崩溃报告。本代码库中没有遥测功能，也没有我们控制的端点：所有数据目的地都是你使用自己的凭据配置的注册簿、推理供应商或搜索供应商。 每次调用离开机器的数据 · 报告漏洞。

文档

目标	从这里开始
运行一次搜索	QUICKSTART.md
安装、配置和使用	INSTALL.md — 参考文档
选择一家登记服务商，或在没有付费服务商的情况下运行	INSTALL.md § 3a
提交任务，或使用运行生成的内容	INTAKE · DELIVERY
从聊天应用中阅读并询问已完成的运行结果	mcp-server/CONNECT.md
在投入任何费用前确认一切正常	docs/E2E.md
了解架构	docs/architecture/ · decisions
使用自己的名称运行，或创建分支	docs/branding.md · TRADEMARKS.md
撰写用户会看到的句子	docs/writing-standard.md · docs/writing-rules.md

开发

克隆仓库得到的是工作树，不是安装产品的方式——请从上方的软件包安装。

git clone https://github.com/CordilleraSarl/clearotron
cd clearotron
npm install                    # every workspace
npm run build:ui               # the browser bundle is not committed — build it once
npm test                       # the offline suite — no credentials, no network
npx clearotron demo            # replays finished clearances into a local portal

在克隆仓库中，从该目录运行命令 npx clearotron …。

npm test 是离线测试套件，也是 CONTRIBUTING.md 要求贡献者首先运行的命令；同样免费的 npm run test:full 是合并门槛。

项目文档

这里明确列出相关链接，而不是只依赖 GitHub 侧边栏。侧边栏界面并不会呈现所有格式的行为准则；有人从 tarball 或镜像阅读本文档时，侧边栏也根本不存在；无法打开的文档，就和从未写过一样。

CODE_OF_CONDUCT.md	本项目对参与者行为的要求，以及违反要求时会发生什么
CONTRIBUTING.md	提交变更以供审查前需要满足的条件
SECURITY.md	如何报告漏洞，以及之后会收到怎样的回复
LICENSE · ADDITIONAL-TERMS.md	AGPL-3.0-only，以及与之配套的第 7 条附加条款
TRADEMARKS.md	名称和标志；许可证并未授予相关权利

许可证

AGPL-3.0-only，附有第 7 条下的附加条款。它适用于本仓库中的代码和文档——不适用于你安装的推理命令行工具、不适用于你与登记机构和研究服务提供方达成的协议，也不适用于各自拥有许可证的 npm 依赖项。它不授予对名称或标志的任何权利：TRADEMARKS.md。

提供咨询、托管服务和支持的，是构建该产品的团队——[email protected]。运行 Clearotron 并不需要这些服务。