选择商户后端语言，解压后按包内 README 启动。示例会实际检查凭证、页面来源、图片内容归档、原会话续期、订单与号码绑定，以及最终存证结果；每一步显示中文建议和请求编号。

默认本机运行、使用合成数据和调试项目。项目凭证只填写后端 .env；正式测试需要后端配置和页面双重确认。调试通过只表示本地链路通过，腾讯云存证须以最终状态与实际完整性核验为准。

Token响应中的 environment.mode、environment.localOnly 和 environment.expiresAt 是该会话的最终环境快照；不要用项目当前开关反推历史会话。

// 这段代码只能运行在商户后端
// KHS_PROJECT_CREDENTIAL=cred_xxx.secret（不要填写 Bearer）
const khs = KhsClient.fromEnv();
await khs.checkCredential(); // GET /api/v1/credential-status
// 下行方法对应 POST /api/v1/recording-tokens
const tokenResult = await khs.issueRecordingToken({
  origin: "https://h5.customer.com",
  userRef: "USER-10001",   // 可选：商户自己的用户标识
  flowRef: "FLOW-20260827", // 可选：跨页面业务流程标识
  idempotencyKey: await getOrCreateEntryKey() // 同一次重试必须复用
});

// 必须把 traceSessionId 保存到商户数据库
await saveTraceSession({
  traceSessionId: tokenResult.traceSessionId,
  confirmationRequired:
    tokenResult.persistence.confirmationRequired,
  confirmationDeadline:
    tokenResult.persistence.confirmationDeadline,
  environment: tokenResult.environment // debug/production会话快照
});

// 只把下面两个字段返回当前业务网页
return {
  traceSessionId: tokenResult.traceSessionId,
  recordingToken: tokenResult.recordingToken
};

<script
  src="https://khs.szshuqi.com/sdk/recorder.min.js"
  crossorigin="anonymous" defer></script>
<script>
  window.addEventListener("DOMContentLoaded", async () => {
    KHSRecorder.error(error => {
      console.log("error", error);
      showRecordingStatus(`${error.code}: ${error.message}`);
    });

    const tokenProvider = async ({ reason, traceSessionId, origin, signal }) => {
      const response = await fetch(
        reason === "initial"
          ? "/business/recording-token"
          : "/business/recording-token/renew",
        {
          method: "POST", credentials: "same-origin",
          headers: { "Content-Type": "application/json" },
          body: JSON.stringify({ traceSessionId, origin }), signal
        }
      );
      const data = await response.json();
      if (!response.ok) throw Object.assign(new Error(data.message), data);
      return data;
    };

    const recording = await KHSRecorder.init({
      endpoint: "https://khs.szshuqi.com",
      tokenProvider,
      pagehideStrategy: "flush"
    });
    await saveCurrentTraceSessionId(recording.traceSessionId);
  });

  // 页面业务完成或离开前，由业务代码显式调用并等待成功
  async function finishRecording() {
    await KHSRecorder.stop();
  }
</script>

window.addEventListener("DOMContentLoaded", async () => {
  const cancelError = KHSRecorder.error(error => {
    console.log("error", error);

    if (error.code === "ORIGIN_MISMATCH") {
      showRecordingStatus(
        `页面来源 ${error.actualOrigin} 与 Token 来源 ${error.expectedOrigin} 不一致`
      );
    }

    if (error.code.startsWith("TOKEN_") || error.code === "INVALID_RECORDING_TOKEN") {
      showRecordingStatus("自动续期未完成，请检查商户后端Token接口和requestId");
    }
    if (error.code === "SESSION_ALREADY_SEALED") {
      showRecordingStatus("请清理已封存traceSessionId并申请新会话");
    }
  });

  const cancelDebug = new URLSearchParams(location.search).get("khs_debug") === "1"
    ? KHSRecorder.debug(info => console.debug("KHS debug", info))
    : null;

  // 也可以主动查看当前脱敏诊断信息
  console.log(KHSRecorder.getDiagnostics());

  // SPA组件销毁时执行：
  // cancelError();
  // cancelDebug?.();
});

调试信息虽然已脱敏，生产页面仍不建议长期打开控制台日志。禁止打印recordingToken、项目服务端凭证或把完整错误对象上传到不受控的第三方日志平台。