tencent-doc-update-watch（腾讯文档更新手表）

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 的查询参数