@cloudcreate/adsense-check 1.4.0 → 1.4.2

package/README.md

@@ -176,7 +176,7 @@ adsense-check https://example.com --ai --api-key sk-xxx...
   │  ...
   └─ 评分: READY — 所有必要项达标
 
-  ┌─ 柔性评分 ──────────────────────────────────── 75/100
+  ┌─ 智能评分 ──────────────────────────────────── 75/100
   │  ████████████████████ 100%  内容质量
   │  ████████████████████ 100%  用户体验
   │  ████████░░░░░░░░░░░░  40%  AI 内容分析

package/dist/{chunk-XKNR4LB4.js → chunk-MFO6RCM3.js}

@@ -304,7 +304,7 @@ var en = {
   "report.content_label": "Content",
   // Two-group scoring
   "report.hard_requirements": "Hard Requirements",
-  "report.soft_scoring": "Soft Scoring",
+  "report.soft_scoring": "Smart Scoring",
   "report.hard.ready": "READY \u2014 all requirements met",
   "report.hard.warn": "NEEDS FIXES \u2014 {count} warning(s) to address",
   "report.hard.fail": "NOT READY \u2014 {count} failure(s) must be fixed",
@@ -317,7 +317,7 @@ var en = {
   "group.policy": "Policy Compliance",
   "group.site_scale": "Site Scale",
   "group.content_quality": "Content Quality",
-  "group.ai_value": "AI Value Analysis",
+  "group.ai_value": "Value Analysis",
   "group.ai_analysis": "AI Content Analysis",
   "group.page_quality": "Page Quality",
   "group.user_experience": "User Experience",
@@ -334,7 +334,7 @@ var en = {
   "reporter.topic": "Topic",
   "reporter.pages_label": "Pages",
   "reporter.confidence": "{confidence} confidence",
-  "reporter.ai_value_label": "AI Value Score",
+  "reporter.ai_value_label": "Value Score",
   "reporter.ai_value_note": "geometric mean \xD7 page-type weights",
   "reporter.ai_dimensions": "AI Dimensions",
   "reporter.avg_per_10": "avg /10",
@@ -343,7 +343,8 @@ var en = {
   "reporter.dim_relevance": "Relevance",
   "reporter.dim_compliance": "Compliance",
   "reporter.formula_label": "Hard {hardPct}% \xD7 0.4 + Soft {softPct}% \xD7 0.6 - Penalty {penalty} = {total}",
-  "reporter.mechanical_label": "mechanical",
+  "reporter.mechanical_label": "Base Score",
+  "reporter.advanced_label": "Advanced Score",
   // Markdown report
   "md.report_title": "AdSense Review Report",
   "md.table.project": "Item",
@@ -360,8 +361,8 @@ var en = {
   "md.table.confidence": "confidence",
   "md.composite_score_title": "Composite Score",
   "md.hard_requirements": "Hard Requirements",
-  "md.soft_scoring": "Soft Scoring",
-  "md.ai_value_title": "AI Value Analysis",
+  "md.soft_scoring": "Smart Scoring",
+  "md.ai_value_title": "Value Analysis",
   "md.table.dimension": "Dimension",
   "md.table.avg_score": "Avg Score",
   "md.dim_value": "Value",
@@ -377,7 +378,7 @@ var en = {
   "md.table.path": "Path",
   "md.table.score": "Score",
   "md.table.content_ratio": "Content Ratio",
-  "md.table.ai_composite": "AI Composite",
+  "md.table.ai_composite": "Advanced",
   "md.table.title": "Title",
   "md.problem_pages": "Problem Page Details",
   "md.ai_status": "AI Status",
@@ -536,7 +537,7 @@ var zh = {
   "report.content_label": "\u6B63\u6587",
   // 两组评分
   "report.hard_requirements": "\u786C\u6027\u8981\u6C42",
-  "report.soft_scoring": "\u67D4\u6027\u8BC4\u5206",
+  "report.soft_scoring": "\u667A\u80FD\u8BC4\u5206",
   "report.hard.ready": "READY \u2014 \u6240\u6709\u5FC5\u8981\u9879\u8FBE\u6807",
   "report.hard.warn": "NEEDS FIXES \u2014 {count} \u9879\u8B66\u544A\u5F85\u4FEE\u590D",
   "report.hard.fail": "NOT READY \u2014 {count} \u9879\u5931\u8D25\u5FC5\u987B\u4FEE\u590D",
@@ -549,7 +550,7 @@ var zh = {
   "group.policy": "\u653F\u7B56\u5408\u89C4",
   "group.site_scale": "\u7AD9\u70B9\u89C4\u6A21",
   "group.content_quality": "\u5185\u5BB9\u8D28\u91CF",
-  "group.ai_value": "AI \u4EF7\u503C\u5206\u6790",
+  "group.ai_value": "\u4EF7\u503C\u5206\u6790",
   "group.ai_analysis": "AI \u5185\u5BB9\u5206\u6790",
   "group.page_quality": "\u9875\u9762\u8D28\u91CF",
   "group.user_experience": "\u7528\u6237\u4F53\u9A8C",
@@ -566,12 +567,13 @@ var zh = {
   "reporter.topic": "\u4E3B\u9898",
   "reporter.pages_label": "\u9875\u9762",
   "reporter.confidence": "\u7F6E\u4FE1\u5EA6: {confidence}",
-  "reporter.ai_value_label": "AI \u4EF7\u503C\u8BC4\u5206",
+  "reporter.ai_value_label": "\u4EF7\u503C\u8BC4\u5206",
   "reporter.ai_value_note": "\u51E0\u4F55\u5747\u503C \xD7 \u9875\u9762\u7C7B\u578B\u52A0\u6743",
   "reporter.ai_dimensions": "AI \u7EF4\u5EA6",
   "reporter.avg_per_10": "\u5747\u5206 /10",
-  "reporter.formula_label": "\u786C\u6027 {hardPct}% \xD7 0.4 + \u67D4\u6027 {softPct}% \xD7 0.6 - \u6263\u5206 {penalty} = {total}",
-  "reporter.mechanical_label": "\u673A\u68B0\u8BC4\u5206",
+  "reporter.formula_label": "\u786C\u6027 {hardPct}% \xD7 0.4 + \u667A\u80FD {softPct}% \xD7 0.6 - \u6263\u5206 {penalty} = {total}",
+  "reporter.mechanical_label": "\u57FA\u7840\u8BC4\u5206",
+  "reporter.advanced_label": "\u9AD8\u7EA7\u8BC4\u5206",
   // 维度名称（终端和 Markdown）
   "reporter.dim_value": "\u4EF7\u503C",
   "reporter.dim_originality": "\u539F\u521B",
@@ -593,8 +595,8 @@ var zh = {
   "md.table.confidence": "\u7F6E\u4FE1\u5EA6",
   "md.composite_score_title": "\u7EFC\u5408\u8BC4\u5206",
   "md.hard_requirements": "\u786C\u6027\u8981\u6C42",
-  "md.soft_scoring": "\u67D4\u6027\u8BC4\u5206",
-  "md.ai_value_title": "AI \u4EF7\u503C\u5206\u6790",
+  "md.soft_scoring": "\u667A\u80FD\u8BC4\u5206",
+  "md.ai_value_title": "\u4EF7\u503C\u5206\u6790",
   "md.table.dimension": "\u7EF4\u5EA6",
   "md.table.avg_score": "\u5747\u5206",
   "md.dim_value": "\u4EF7\u503C",
@@ -610,7 +612,7 @@ var zh = {
   "md.table.path": "\u8DEF\u5F84",
   "md.table.score": "\u8BC4\u5206",
   "md.table.content_ratio": "\u6B63\u6587\u6BD4",
-  "md.table.ai_composite": "AI \u7EFC\u5408",
+  "md.table.ai_composite": "\u9AD8\u7EA7\u8BC4\u5206",
   "md.table.title": "\u6807\u9898",
   "md.problem_pages": "\u95EE\u9898\u9875\u9762\u8BE6\u60C5",
   "md.ai_status": "AI \u72B6\u6001",
@@ -724,6 +726,13 @@ Also classify the page type based on its content and purpose. Choose ONE:
 - "required": About, Privacy, Terms, Contact, Editorial Policy, Legal
 - "utility": Search, Login, Signup, Download, 404, or functional tool pages
 
+IMPORTANT \u2014 special handling for "required" and "utility" pages:
+These pages are necessary for site operation. Do NOT penalize them for low value, originality, or relevance.
+- For "required" pages (Privacy, Terms, About, Contact, Legal): set value=10, originality=10, relevance=10 automatically.
+- Only score compliance normally. Check if the page has reasonable content (not empty or placeholder).
+- For "utility" pages (Search, Login, 404): same rule \u2014 set value=10, originality=10, relevance=10, only evaluate compliance and basic completeness.
+- For all other page types (homepage, listing, content, game_detail, video_detail, reference_detail): score all four dimensions normally.
+
 Page: ${page.url}
 
 Content:
@@ -747,17 +756,25 @@ Reply in ${langName} with JSON:
     const originalityScore = clampScore(result.originality);
     const relevanceScore = clampScore(result.relevance);
     const complianceScore = clampScore(result.compliance);
-    const geoMean = Math.pow(valueScore * originalityScore * relevanceScore * complianceScore, 0.25);
-    const status = geoMean >= 7 ? "pass" : geoMean >= 4 ? "warn" : "fail";
     const validPageTypes = ["homepage", "listing", "content", "game_detail", "video_detail", "reference_detail", "required", "utility"];
     const inferredPageType = validPageTypes.includes(result.pageType) ? result.pageType : void 0;
+    let finalValueScore = valueScore;
+    let finalOriginalityScore = originalityScore;
+    let finalRelevanceScore = relevanceScore;
+    if (inferredPageType === "required" || inferredPageType === "utility") {
+      finalValueScore = 10;
+      finalOriginalityScore = 10;
+      finalRelevanceScore = 10;
+    }
+    const geoMean = Math.pow(finalValueScore * finalOriginalityScore * finalRelevanceScore * complianceScore, 0.25);
+    const status = geoMean >= 7 ? "pass" : geoMean >= 4 ? "warn" : "fail";
     return {
       url: page.url,
       status,
-      relevance: result.relevanceLabel ?? (relevanceScore >= 7 ? "relevant" : relevanceScore >= 4 ? "tangential" : "off-topic"),
-      valueScore,
-      originalityScore,
-      relevanceScore,
+      relevance: result.relevanceLabel ?? (finalRelevanceScore >= 7 ? "relevant" : finalRelevanceScore >= 4 ? "tangential" : "off-topic"),
+      valueScore: finalValueScore,
+      originalityScore: finalOriginalityScore,
+      relevanceScore: finalRelevanceScore,
       complianceScore,
       assessment: result.assessment ?? "",
       suggestions: result.suggestions ?? [],
@@ -1835,7 +1852,12 @@ function buildPageDetails(pages, aiAnalyses, siteType) {
     const contentRatio = totalChars > 0 ? Math.round(contentChars / totalChars * 100) : 0;
     const issues = [];
     let contentStatus = "pass";
-    if (siteType === "content") {
+    const ai = aiMap.get(page.url);
+    const aiStatus = ai?.status;
+    const relevance = ai?.relevance;
+    const pageType = ai?.inferredPageType ?? classifyPage(page.url);
+    const isFunctional = pageType === "required" || pageType === "utility";
+    if (siteType === "content" && !isFunctional) {
       if (contentRatio < 30 && totalChars > 200) {
         issues.push(`Content ratio only ${contentRatio}%, mostly boilerplate`);
         contentStatus = "fail";
@@ -1845,10 +1867,6 @@ function buildPageDetails(pages, aiAnalyses, siteType) {
         contentStatus = contentStatus === "fail" ? "fail" : "warn";
       }
     }
-    const ai = aiMap.get(page.url);
-    const aiStatus = ai?.status;
-    const relevance = ai?.relevance;
-    const pageType = ai?.inferredPageType ?? classifyPage(page.url);
     const { score } = scorePage(pageType, contentChars, contentRatio, issues, siteType, aiStatus);
     const detail = { url: page.url, title: page.title, pageType, totalChars, contentChars, contentRatio, contentStatus, issues, score };
     if (relevance) detail.relevance = relevance;
@@ -2108,7 +2126,7 @@ async function check(options) {
         pageAnalyses = aiResult.pageAnalyses;
         const aiItems = [];
         if (aiResult.suggestions.length > 0) {
-          aiItems.push({ name: t("item.ai.suggestions", lang), status: "warn", message: t("ai.suggestion_count", lang, { count: aiResult.suggestions.length }), detail: aiResult.suggestions.join("; ") });
+          aiItems.push({ name: t("item.ai.suggestions", lang), status: "warn", message: t("ai.suggestion_count", lang, { count: aiResult.suggestions.length }), detailList: aiResult.suggestions });
         }
         allCategories.push({ name: t("group.ai_value", lang), items: aiItems, group: "soft" });
         let suspiciousPages = pageAnalyses.filter((a) => {

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   getSupportedLangs,
   isValidLang,
   t
-} from "./chunk-XKNR4LB4.js";
+} from "./chunk-MFO6RCM3.js";
 
 // src/cli.ts
 import "dotenv/config";
@@ -138,6 +138,9 @@ function renderTerminalReport(report) {
     for (const item of cat.items) {
       lines.push(`    ${ICONS[item.status]} [${LABELS[item.status]}] ${item.message}`);
       if (item.detail) lines.push(chalk.gray(`         ${item.detail}`));
+      if (item.detailList) {
+        for (const d of item.detailList) lines.push(chalk.gray(`       \u2022 ${d}`));
+      }
     }
     lines.push("");
   }
@@ -145,8 +148,12 @@ function renderTerminalReport(report) {
     lines.push(chalk.bold(`  ${t("report.page_details", lang)}`));
     lines.push(chalk.gray(`  (${t("report.pages", lang, { count: report.pages.length })})`));
     lines.push("");
-    const problems = report.pages.filter((p) => p.contentStatus !== "pass" || p.issues.length > 0 || p.ai && p.ai.status !== "pass");
-    const ok = report.pages.filter((p) => p.contentStatus === "pass" && p.issues.length === 0 && (!p.ai || p.ai.status === "pass"));
+    const problems = report.pages.filter(
+      (p) => p.pageType !== "required" && p.pageType !== "utility" && (p.contentStatus !== "pass" || p.issues.length > 0 || p.ai && p.ai.status !== "pass")
+    );
+    const ok = report.pages.filter(
+      (p) => p.pageType === "required" || p.pageType === "utility" || p.contentStatus === "pass" && p.issues.length === 0 && (!p.ai || p.ai.status === "pass")
+    );
     for (const p of problems) renderPage(lines, p, lang);
     if (ok.length > 0) lines.push(chalk.gray(`    ${t("report.pages_ok", lang, { count: ok.length })}`));
     lines.push("");
@@ -192,7 +199,9 @@ function renderPage(lines, page, lang) {
   const ratioColor = page.contentRatio >= 50 ? chalk.green : page.contentRatio >= 30 ? chalk.yellow : chalk.red;
   const scoreColor = page.score >= 80 ? chalk.green : page.score >= 50 ? chalk.yellow : chalk.red;
   const typeIcon = PAGE_TYPE_ICONS[page.pageType] || chalk.gray("?");
-  lines.push(`    ${ICONS[page.contentStatus]} ${typeIcon} ${chalk.bold(path)} ${scoreColor(page.score + "/100")}`);
+  const aiComposite = page.ai?.valueScore != null && page.ai?.originalityScore != null && page.ai?.relevanceScore != null && page.ai?.complianceScore != null ? Math.round(Math.pow(page.ai.valueScore * page.ai.originalityScore * page.ai.relevanceScore * page.ai.complianceScore, 0.25) * 10) : null;
+  const scoreLabels = aiComposite != null ? `${t("reporter.mechanical_label", lang)}: ${scoreColor(page.score + "/100")} | ${t("reporter.advanced_label", lang)}: ${aiComposite >= 70 ? chalk.green : aiComposite >= 40 ? chalk.yellow : chalk.red}(AI ${aiComposite}/100)` : `${t("reporter.mechanical_label", lang)}: ${scoreColor(page.score + "/100")}`;
+  lines.push(`    ${ICONS[page.contentStatus]} ${typeIcon} ${chalk.bold(path)} ${scoreLabels}`);
   lines.push(chalk.gray(`       ${page.title}`));
   lines.push(`       ${t("report.content_label", lang)} ${ratioColor(page.contentRatio + "%")} (${page.contentChars}/${page.totalChars})`);
   for (const issue of page.issues) lines.push(chalk.yellow(`       ! ${issue}`));
@@ -281,8 +290,12 @@ function renderMarkdownReport(report) {
   if (report.pages.length > 0) {
     lines.push(`### ${t("md.page_details", lang)} (${t("md.pages_count", lang, { count: report.pages.length })})`);
     lines.push("");
-    const problems = report.pages.filter((p) => p.contentStatus !== "pass" || p.issues.length > 0 || p.ai && p.ai.status !== "pass");
-    const ok = report.pages.filter((p) => p.contentStatus === "pass" && p.issues.length === 0 && (!p.ai || p.ai.status === "pass"));
+    const problems = report.pages.filter(
+      (p) => p.pageType !== "required" && p.pageType !== "utility" && (p.contentStatus !== "pass" || p.issues.length > 0 || p.ai && p.ai.status !== "pass")
+    );
+    const ok = report.pages.filter(
+      (p) => p.pageType === "required" || p.pageType === "utility" || p.contentStatus === "pass" && p.issues.length === 0 && (!p.ai || p.ai.status === "pass")
+    );
     lines.push(`| ${t("md.table.status", lang)} | ${t("md.table.type", lang)} | ${t("md.table.path", lang)} | ${t("md.table.score", lang)} | ${t("md.table.content_ratio", lang)} | V | O | R | C | ${t("md.table.ai_composite", lang)} | ${t("md.table.title", lang)} |`);
     lines.push(`|------|------|------|------|--------|---|---|---|---|--------|------|`);
     for (const p of [...problems, ...ok]) {
@@ -317,7 +330,9 @@ function renderMarkdownReport(report) {
             return p.url;
           }
         })();
-        lines.push(`**[${path}](${p.url})** (${t("reporter.mechanical_label", lang)}: ${p.score}/100)`);
+        const aiComposite = p.ai?.valueScore != null && p.ai?.originalityScore != null && p.ai?.relevanceScore != null && p.ai?.complianceScore != null ? Math.round(Math.pow(p.ai.valueScore * p.ai.originalityScore * p.ai.relevanceScore * p.ai.complianceScore, 0.25) * 10) : null;
+        const scoreLabels = aiComposite != null ? `${t("reporter.mechanical_label", lang)}: ${p.score}/100 | ${t("reporter.advanced_label", lang)}: ${aiComposite}/100` : `${t("reporter.mechanical_label", lang)}: ${p.score}/100`;
+        lines.push(`**[${path}](${p.url})** (${scoreLabels})`);
         lines.push("");
         for (const issue of p.issues) lines.push(`- \u26A0\uFE0F ${issue}`);
         if (p.ai) {

package/dist/index.d.ts

@@ -7,6 +7,7 @@ interface CheckItem {
     status: CheckStatus;
     message: string;
     detail?: string;
+    detailList?: string[];
 }
 type CheckGroup = 'hard' | 'soft';
 interface CheckCategory {

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   check
-} from "./chunk-XKNR4LB4.js";
+} from "./chunk-MFO6RCM3.js";
 export {
   check
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcreate/adsense-check",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Check if a website meets Google AdSense review requirements",
   "homepage": "https://cloudcreate.ai",
   "repository": {