# 說明中心搜尋失敗，是沒有結果還是沒人點？

按搜尋事件分缺口，分母寫清楚，不把點擊或瀏覽當成問題已解決。

## 每次搜尋各自分類

這份原創六次搜尋記錄有結果數及已觀察點擊。零結果另列一類；有結果時，clicked=false 表示沒有點，clicked=null 表示點擊依據未明。無點擊比例以所有有結果事件作分母，點擊未明另報。這是教材假設，並非鉑星科技的實際分析。

六次完整假設搜尋

| 事件 | 結果數 | 有否點擊 | 分類 |
| --- | --- | --- | --- |
| S1 | 0 | 沒有 | 零結果 |
| S2 | 0 | 沒有 | 零結果 |
| S3 | 2 | 沒有 | 無點擊 |
| S4 | 1 | 沒有 | 無點擊 |
| S5 | 3 | 沒有 | 無點擊 |
| S6 | 2 | 有 | 有點擊 |

## 件數與兩個分母一起列

零結果是 2/6；四次有結果之中，三次無點擊，即 3/4；一次有點。這些數字不能證明答案可用、讀者離開原因，或是否從 Google 進來。

1. 按記錄事件點數
2. 先分零結果
3. 有依據才分點擊
4. 未知及分母一起報

結果數或點擊未明，不默當成功或失敗。

S3 的點擊依據改成 null，無點擊仍是三次嗎？

不是。無點擊剩兩次，一次點擊未明，一次有點。有結果分母仍是四，應報 2/4，另列一次未明。

## 整理搜尋缺口工作表

完整 JSON 附原例及改點擊個案；表格與 Markdown 可用來註解日後實際匯出，保留觀察期間、事件層次及未知欄位。客戶真實搜尋文字不要放公開例子。

結果數用 0 至 1,000 整數或 null；點擊依據為 true、false 或 null。零結果卻記有點擊違反本例約定，須拒絕。有結果分母為零便沒有百分比，事件編號重複或超過 30 次也拒絕。

零結果缺口可能先要核讀者權限，未必立即要寫新文章。可用工作表整理搜尋分析需求，工作是否成功另外量度。

## 完整本地記錄與逐項結果

```json
{
  "issuer": "Astera Technology",
  "resource": "ops-help-search-gap-classification",
  "locale": "zh-HK",
  "contract": "這份原創六次搜尋記錄有結果數及已觀察點擊。零結果另列一類；有結果時，clicked=false 表示沒有點，clicked=null 表示點擊依據未明。無點擊比例以所有有結果事件作分母，點擊未明另報。這是教材假設，並非鉑星科技的實際分析。",
  "input": {
    "events": [
      {
        "id": "S1",
        "results": 0,
        "clicked": false
      },
      {
        "id": "S2",
        "results": 0,
        "clicked": false
      },
      {
        "id": "S3",
        "results": 2,
        "clicked": false
      },
      {
        "id": "S4",
        "results": 1,
        "clicked": false
      },
      {
        "id": "S5",
        "results": 3,
        "clicked": false
      },
      {
        "id": "S6",
        "results": 2,
        "clicked": true
      }
    ]
  },
  "output": {
    "ok": true,
    "state": "complete",
    "result": {
      "events": 6,
      "withResults": 4,
      "counts": {
        "zero-results": 2,
        "no-click": 3,
        "clicked": 1,
        "unknown-click": 0,
        "unknown-results": 0
      },
      "zeroResultFraction": [
        2,
        6
      ],
      "noClickAmongWithResults": [
        3,
        4
      ]
    },
    "trace": [
      {
        "id": "S1",
        "decision": "zero-results"
      },
      {
        "id": "S2",
        "decision": "zero-results"
      },
      {
        "id": "S3",
        "decision": "no-click"
      },
      {
        "id": "S4",
        "decision": "no-click"
      },
      {
        "id": "S5",
        "decision": "no-click"
      },
      {
        "id": "S6",
        "decision": "clicked"
      }
    ]
  },
  "verificationCases": [
    {
      "name": "baseline",
      "input": {
        "events": [
          {
            "id": "S1",
            "results": 0,
            "clicked": false
          },
          {
            "id": "S2",
            "results": 0,
            "clicked": false
          },
          {
            "id": "S3",
            "results": 2,
            "clicked": false
          },
          {
            "id": "S4",
            "results": 1,
            "clicked": false
          },
          {
            "id": "S5",
            "results": 3,
            "clicked": false
          },
          {
            "id": "S6",
            "results": 2,
            "clicked": true
          }
        ]
      },
      "expected": {
        "ok": true,
        "state": "complete",
        "result": {
          "events": 6,
          "withResults": 4,
          "counts": {
            "zero-results": 2,
            "no-click": 3,
            "clicked": 1,
            "unknown-click": 0,
            "unknown-results": 0
          },
          "zeroResultFraction": [
            2,
            6
          ],
          "noClickAmongWithResults": [
            3,
            4
          ]
        }
      }
    },
    {
      "name": "material-edit",
      "input": {
        "events": [
          {
            "id": "S1",
            "results": 0,
            "clicked": false
          },
          {
            "id": "S2",
            "results": 0,
            "clicked": false
          },
          {
            "id": "S3",
            "results": 2,
            "clicked": true
          },
          {
            "id": "S4",
            "results": 1,
            "clicked": false
          },
          {
            "id": "S5",
            "results": 3,
            "clicked": false
          },
          {
            "id": "S6",
            "results": 2,
            "clicked": true
          }
        ]
      },
      "expected": {
        "ok": true,
        "state": "complete",
        "result": {
          "events": 6,
          "withResults": 4,
          "counts": {
            "zero-results": 2,
            "no-click": 2,
            "clicked": 2,
            "unknown-click": 0,
            "unknown-results": 0
          },
          "zeroResultFraction": [
            2,
            6
          ],
          "noClickAmongWithResults": [
            2,
            4
          ]
        }
      }
    },
    {
      "name": "fresh-boundary",
      "input": {
        "events": [
          {
            "id": "S1",
            "results": 0,
            "clicked": false
          },
          {
            "id": "S2",
            "results": 0,
            "clicked": false
          },
          {
            "id": "S3",
            "results": 2,
            "clicked": null
          },
          {
            "id": "S4",
            "results": 1,
            "clicked": false
          },
          {
            "id": "S5",
            "results": 3,
            "clicked": false
          },
          {
            "id": "S6",
            "results": 2,
            "clicked": true
          }
        ]
      },
      "expected": {
        "ok": true,
        "state": "unknown",
        "result": {
          "events": 6,
          "withResults": 4,
          "counts": {
            "zero-results": 2,
            "no-click": 2,
            "clicked": 1,
            "unknown-click": 1,
            "unknown-results": 0
          },
          "zeroResultFraction": [
            2,
            6
          ],
          "noClickAmongWithResults": [
            2,
            4
          ]
        }
      }
    }
  ],
  "meaningOfNull": "該欄位未知或沒有已建立的值；請按逐項結果判斷。",
  "businessSideEffects": false
}
```