Tencent Doc Update Watch

Overview

Use this skill to re-crawl Tencent Docs links and detect updates with snapshot diffing. The workflow outputs: - manifest.json (structured machine-readable result) - report.md (human-readable diff summary)

Quick Run

Run with default doc list:

python scripts/check-qq-doc-updates.py 
  --config references/default-docs.json 
  --workspace /tmp/tencent-doc-watch

Run with explicit baseline:

python scripts/check-qq-doc-updates.py 
  --config /abs/path/my-docs.json 
  --workspace /tmp/tencent-doc-watch 
  --compare /tmp/tencent-doc-watch/snapshots/20260305_101500/manifest.json

Privacy Defaults

Default behavior is privacy-first: - Raw HTML/opendoc/cookie files are removed after parsing. - URL query values are redacted in opendoc_url fields. - Public URL in manifest removes query strings to avoid leaking tokens.

Keep raw files only when explicitly needed for debugging:

python scripts/check-qq-doc-updates.py 
  --config references/default-docs.json 
  --workspace /tmp/tencent-doc-watch 
  --keep-raw

Config Format

Use JSON:

{
  "docs": [
    {
      "name": "Example Sheet",
      "url": "https://docs.qq.com/sheet/DEXAMPLE_SHEET_001?tab=sample"
    },
    {
      "name": "Example Doc",
      "url": "https://docs.qq.com/doc/DEXAMPLE_DOC_001"
    }
  ]
}

Optional field: - id: Tencent doc ID (auto-parsed from URL when omitted)

Output and Status

Generated under <workspace>/snapshots/<label>/: - manifest.json - report.md - raw/ only when --keep-raw is enabled

Report status values: - UNCHANGED - CHANGED - NEW - FIRST_RUN

Key Detection Signals

Comparison currently checks: - last_modify_ms - rev - cgi_code - title - pad_type

中文补充

此 Skill 固化“腾讯文档重新抓取 + 与历史快照对比”的流程。默认开启隐私最小化策略： - 不持久化原始抓取内容（除非加 --keep-raw） - 脱敏 opendoc_url 查询参数 - 在 manifest.json 中移除页面 URL 的查询参数