PJQ — Public Judgment Quotient

PJQ — 公众评价指数

公众舆论的地震仪。PJQ 衡量一段媒体内容实际获得了怎样的受众反馈——将真实观点与粉丝噪声、机器人和自我推销者区分开来。

线上服务： pjq.life · 许可证： Apache-2.0

---

这是什么

PJQ 接收一段内容的网址（目前支持 YouTube；接下来将支持 Reddit、Telegram 和新闻），采集其下的评论，并根据7 类立场标准对每条评论进行分类。输出是一份评判结果：一个数值化的反馈评分（mood），以及结构化的细分数据——有多少人实质性赞同、有多少人提出反对、有多少人保持中立，以及有多少噪声淹没了信号。

可以把它看作一个媒体反馈观测站，基于同一核心通过两种传输方式提供服务：

• REST API（/api/v1/*），用于分析自动化；以及
• MCP 服务（/mcp/），让 AI Agent（Claude Desktop 等）能够直接在聊天中运行分析并读取评判结果。

此存储库包含什么

此存储库是 PJQ 的开源客户端和规范。托管分析引擎（采样、分类、质量保证、ONNX 立场模型和提示词内部机制）仍保持闭源——这是产品的核心竞争优势。此处开放的内容涵盖了使用、集成和了解 PJQ 所需的一切：

web/    — the full web client (React + TypeScript + Vite SPA, 5 languages)
spec/   — the conceptual specification
          ├── CONCEPT.md          what PJQ is and why
          ├── RUBRIC.md           the 7-category stance rubric (definitions)
          ├── domains.yaml        the 11-domain content taxonomy
          ├── FEATURED.md         the open, automatic showcase-ranking formula
          └── verdict-schema.md   the shape of a verdict (API output)
docs/   — integration reference
          ├── api-reference.md    REST API surface
          ├── mcp-reference.md    MCP tools and schemas
          └── user-guide/         end-user guide (EN + RU)

一句话了解 7 类标准

每条评论恰好归入以下一类：SUP（实质性支持）、AGA（实质性反对）、NEU（中立）、OFF（离题）、THIN（浅层正面——只有赞扬，没有论据）、SUS（非自然行为——机器人、付费评论或协同行为）、AGN（另有所图——评论只是作者实现外部目的的载体）。

**报告规则：**观点指标（mood、support）严格根据 SUP / AGA / NEU 计算。THIN / OFF / SUS / AGN 分开统计，绝不会抬高支持率。详见 spec/RUBRIC.md。

运行 Web 客户端

客户端是一个标准的 Vite SPA。默认情况下，它会连接到托管后端 pjq.life（生产环境中为同源）。

cd web
npm install
npm run dev      # dev server with hot reload
npm run build    # production build (with build-time SEO prerender) -> dist/

若要让客户端连接其他后端，请复制 web/.env.example 并设置 VITE_API_BASE。

集成

• REST API——在 pjq.life 的控制台获取 API 密钥，然后参阅 docs/api-reference.md。只读工具不消耗额度；完整分析消耗 1 个额度。
• MCP——让支持 MCP 的客户端连接到 https://pjq.life/mcp/，并参阅 docs/mcp-reference.md 了解导出的工具。

API 绝不会返回评论原文——根据 PJQ 的隐私政策，只返回汇总数据、百分比和少量代表性样例。

状态

PJQ 已上线，正在积极开发中。路线图公开发布于 pjq.life/flightlog。此存储库跟踪客户端和规范；引擎更新则部署到托管服务。

许可证

版权所有 2026 PJQ（github.com/Makaric）。依据 Apache License 2.0 版授权——详见 LICENSE。

Русская версия: README_RU.md。