# ============================================================
# 需求代理登记表（学科级知识文件）· v0.2
# 维护约定：
#   - 每个代理必须声明：目标构念 / 偏差方向 / 滞后 / 覆盖 / 操纵风险 / 效度证据 / 状态
#   - 新增/修改走「提案 → 轮次记录 → 更新」流程（见 07-iteration.md）
#   - 镜像文档：discipline/08-measurement.md §2
# ============================================================
version: "0.2"
updated_at: "2026-08-10"
purpose: "需求统计与预测（DSF）的代理登记表：一切测量都是代理，必须声明偏差"

proxies:
  - id: appstore_chart_rank
    name: "App Store 畅销榜名次"
    target_construct: "2C 消费需求（按分类聚合）"
    bias_direction: "未知偏中位；免费+内购混合口径；榜单只覆盖头部 → 对长尾低估"
    lag: "同步（排名实时；下载量 T+1）"
    coverage: "主要市场 iPhone 用户；对 2B/开发者工具覆盖差"
    manipulation_risk: "刷榜、付费投放、榜单算法调整"
    validity_evidence: "ADDO 中作为参与度观测代理之一；与专家估计的收敛性待验（RQ-A1 续）"
    status: active

  - id: steam_player_count
    name: "Steam 玩家数与热门榜"
    target_construct: "PC 游戏/工具类消费与使用需求"
    bias_direction: "低估；免费游戏与主机/移动端不在内；对深度使用比下载更敏感"
    lag: "同步（玩家数 24h 粒度）"
    coverage: "PC 玩家；地区差异"
    manipulation_risk: "低（需真实游玩行为）"
    validity_evidence: "ADDO 信号层；与榜单名次互为参考"
    status: active

  - id: arxiv_papers
    name: "arXiv 论文数（按领域关键词）"
    target_construct: "研究投入/能力供给需求（供给侧代理）"
    bias_direction: "高估（关键词噪声、灌水）；对产业需求滞后"
    lag: "领先（论文先行，产品需求滞后 1-3 年）"
    coverage: "学术界公开成果；工业界闭源成果不在内"
    manipulation_risk: "低（存在关键词堆砌）"
    validity_evidence: "待验：与评测基准发布数、行业报告引用数对比"
    status: active_candidate

  - id: github_stars
    name: "GitHub 项目数 / star 增长"
    target_construct: "工程采用需求"
    bias_direction: "高估（demo 项目、营销仓库）"
    lag: "领先/同步"
    coverage: "开发者社区；企业内部使用不可见"
    manipulation_risk: "star 刷量、组织账户批量创建"
    validity_evidence: "待验：与招聘帖、论文引用交叉验证"
    status: active_candidate

  - id: ai_job_posts
    name: "AI 岗位招聘帖"
    target_construct: "人才/采纳需求"
    bias_direction: "低估（平台覆盖不全）；受融资周期影响"
    lag: "同步/滞后"
    coverage: "公开渠道岗位"
    manipulation_risk: "低"
    validity_evidence: "待验：与 OECD AI 强度分类、NBER 微观数据对比"
    status: proposed