diggermedia 安装速查 (v1.0.0)
================================

diggermedia = Golddigger 自研的「内容生产与渠道运营工具」，交付到**客户自己的环境**运行。
只提供工具：Token 客户自购、不代理挖客、我们不持有买家数据（0 留存 · 0 抽佣）。

------------------------------------------------------------
一 · 解压
------------------------------------------------------------
    unzip diggermedia-v1.0.0.zip -d diggermedia
    cd diggermedia

不需要 pip install，不需要虚拟环境，不需要 Node。
只需要 CPython 3.11+（标准库即可，零第三方依赖）。

------------------------------------------------------------
二 · 先跑通（不接任何外部服务，mock 模式）
------------------------------------------------------------
    python3 -m app.cli doctor
    python3 -m app.cli run "EU buyers now require GRS recycled polyester" --mock

doctor 打印生效配置（密钥打码）；
run  跑一条信号 → 选题 → 提纲 → 稿件 → 体检报告，输出 JSON。

默认数据目录是 /var/lib/diggermedia，想放在本地目录：

    python3 -m app.cli --data-dir ./data run "你的产品描述" --mock

------------------------------------------------------------
三 · 接真实通道（可选）
------------------------------------------------------------
文本通道用**你自己的**模型账号（Base URL + Key 自填，我们不托管、不售 token）：

    export DIGGERMEDIA_LLM_BASE_URL=https://<你的 OpenAI 兼容端点>/v1
    export DIGGERMEDIA_LLM_API_KEY=<你的 Key>

蒸馏通道用 diggerkit 配额（Key 自购）：

    export DIGGERMEDIA_DISTILL_BASE_URL=https://golddigger.gold
    export DIGGERMEDIA_DISTILL_KEY=<你的 diggerkit Key>
    export DIGGERMEDIA_DISTILL_DRIVER=contract      # /v1/* 契约层（默认）

    python3 -m app.cli run "你的产品描述" --platform wechat
    python3 -m app.cli quota                        # 蒸馏配额快照

蒸馏是异步的：接口先回 status=running，关键词在 LLM 那一步跑完后才出现，
客户端会轮询等待（上限 DIGGERMEDIA_DISTILL_POLL_TIMEOUT，默认 120 秒）。

------------------------------------------------------------
四 · 本地 API
------------------------------------------------------------
    python3 -m app.cli serve --mock     # 默认只监听 127.0.0.1:8741

路由（JSON）：
    GET  /healthz
    POST /api/signals        录入雷达信号
    POST /api/topics         信号 → 结构化选题（蒸馏）
    POST /api/outline        选题 → 提纲
    POST /api/drafts         提纲 → 稿件（bilingual=true 出中英双份）
    GET  /api/drafts/<id>    取稿件 + 体检报告
    GET  /api/quota          配额快照
    POST /api/assets         资料中心写入
    GET  /api/assets/search  资料中心检索
    GET  /api/upgrade/check  升级检查

设置 DIGGERMEDIA_ADMIN_TOKEN 后，所有 /api/* 需要带 X-Admin-Token 头。

------------------------------------------------------------
五 · 自升级
------------------------------------------------------------
    python3 -m app.cli upgrade-check                 # 查升级源
    python3 -m app.cli upgrade-check --offline-dir ./offline-pkg
    python3 -m app.cli upgrade-import ./offline-pkg   # 导入离线升级包

安全底线：manifest 必须带自身 ed25519 签名；缺公钥 / 无签名 / 验签失败 /
产物 sha256 不符 → 一律拒绝，且在换包之前停；升级前自动快照数据库，
健康检查失败自动回滚。

------------------------------------------------------------
六 · 跑测试（可选，确认包完整）
------------------------------------------------------------
    python3 -m unittest discover -s tests -t .

------------------------------------------------------------
七 · 数据在哪
------------------------------------------------------------
全部数据在 DIGGERMEDIA_DATA_DIR 一个目录里（app.db / uploads / generated /
backups / logs / credentials），可导出、可迁移、无供应商锁定。
备份与迁移只要搬这一个目录。

------------------------------------------------------------
包内文件
------------------------------------------------------------
    app/            程序本体（含 upgrade/ 自升级引擎）
    tests/          75 个用例（含真起 HTTP 服务器的端到端）
    samples/        5 份对外风格样例（写客户文案的语气基准）
    requirements.txt 依赖说明（无第三方依赖）
    README.md       完整文档（安装 / 配置 / 用法 / 当前实现到哪一步）
    INSTALL.txt     本文件
    VERSION         版本号

------------------------------------------------------------
联系
------------------------------------------------------------
商务 / 渠道合作：factorihub@outlook.com
客户支持：      gdana@agentmail.to
