汇总 AI 公司核查更新与文档上传 API #25

2026-10-30T10:19:48Z

codex-bot commented

2026-10-30 10:19:48 +00:00

目标与范围

按用户要求，将 PR #23 与 #24 在 main 之外合并成一个评审 PR。

#23：完善 AI 公司分类、成立主体核查并修复部署断言；head 770be83。
#24：文档上传 API、专用密钥与批量上传客户端；head 6bfeea4。

head: codex/research-api-integration；base: main；最终合并提交 15024c3。
两个源分支均已完整合入，无文本冲突。共同修改的 auth-cli.ts 同时保留最新研究计数和文档 API 冒烟逻辑；其余文件逐一核对，与对应源分支一致。

逐文件改动与目的

AGENTS.md：允许通过文档 API 维护数据库正文，保留 main-only CI 与数据库权威源约定。
README.md：补充接口、版本、批量、专用密钥、客户端和重试说明。
apps/docs/src/lib/docs.ts：增加批量事务、幂等回执、分页目录/历史及指定修订查询。
apps/docs/src/lib/document-keys.ts：同库管理 API Key 摘要、权限、有效期与撤销状态。
apps/docs/src/lib/documents-api.ts：统一文档 API 鉴权、输入校验和错误响应。
apps/docs/src/pages/api/documents/index.ts：目录分页与单篇保存。
apps/docs/src/pages/api/documents/batch.ts：有界、原子的批量保存。
apps/docs/src/pages/api/documents/item/[...slug].ts：单篇、历史元数据及指定修订读取。
apps/docs/src/proxy.ts：将文档 Key 权限限定在文档接口，不放开研究或其他页面。
apps/docs/scripts/docs-cli.ts：创建、查看和撤销文档 Key，原文只写私有新文件。
scripts/docs-admin.sh：暴露服务器 Key 管理命令。
scripts/documents-client.py：标准库客户端，支持 HTTPS/隧道、自动分批及保留请求 ID 的受控重试。
scripts/test_documents_client.py：传输、权限、分批与重试轻量测试。
apps/docs/tests/documents-api.test.ts：鉴权、只读权限、过期/撤销、回滚、分页和幂等测试。
apps/docs/scripts/test-docs.mjs：将 API 测试接入既有主线检查。
apps/docs/scripts/auth-cli.ts：同步 1,023 条公司、11 类、1,259 条证据、189 条观测的数量检查，并保留隔离卷 API 冒烟逻辑；生产 verify 不执行写入测试。
apps/docs/tests/research.test.ts：保留新增业务分类、主体历史核查与 Peec 团队下界回归断言修正。
content/research/ai-companies.seed.json：合入官方业务分类、候选主体与历史核查，包括 Thrive、Brila、Utopai、Fundraisly、Goldfish、Tapflow、Atoms、Happycapy 等；保留未知项与收入边界。
content/research/ai-companies.sources.json：同步来源和候选覆盖记录。
content/research/ai-income-analysis.json：同步研究版本与收入统计参考。

验证

已通过：11 项 Python 轻量测试、两项研究审计/统计检查、JSON/Python/Shell 语法、源分支祖先关系、逐文件保留与共同脚本核对、git diff --check。
完整类型检查、TypeScript 测试、构建和容器验收未运行，按 main-only 约定留待用户手动合并后的主线 CI。工作流未改动，未在本机编译或构建。

交付状态

已推送汇总工作分支，main 未改动，未部署，生产数据库与 API Key 未改动。已核对最新源提交完整包含；#23、#24 已关闭，原分支保留。
等待用户手动合并本汇总 PR，不开启自动合并。

汇总期间追加的 2025 发现台账和公开档案范围核查（770be83）已补入并重做受影响的轻量检查。

## 目标与范围按用户要求，将 PR #23 与 #24 在 main 之外合并成一个评审 PR。 - #23：完善 AI 公司分类、成立主体核查并修复部署断言；head 770be83。 - #24：文档上传 API、专用密钥与批量上传客户端；head 6bfeea4。 head: codex/research-api-integration；base: main；最终合并提交 15024c3。两个源分支均已完整合入，无文本冲突。共同修改的 auth-cli.ts 同时保留最新研究计数和文档 API 冒烟逻辑；其余文件逐一核对，与对应源分支一致。 ## 逐文件改动与目的 - AGENTS.md：允许通过文档 API 维护数据库正文，保留 main-only CI 与数据库权威源约定。 - README.md：补充接口、版本、批量、专用密钥、客户端和重试说明。 - apps/docs/src/lib/docs.ts：增加批量事务、幂等回执、分页目录/历史及指定修订查询。 - apps/docs/src/lib/document-keys.ts：同库管理 API Key 摘要、权限、有效期与撤销状态。 - apps/docs/src/lib/documents-api.ts：统一文档 API 鉴权、输入校验和错误响应。 - apps/docs/src/pages/api/documents/index.ts：目录分页与单篇保存。 - apps/docs/src/pages/api/documents/batch.ts：有界、原子的批量保存。 - apps/docs/src/pages/api/documents/item/[...slug].ts：单篇、历史元数据及指定修订读取。 - apps/docs/src/proxy.ts：将文档 Key 权限限定在文档接口，不放开研究或其他页面。 - apps/docs/scripts/docs-cli.ts：创建、查看和撤销文档 Key，原文只写私有新文件。 - scripts/docs-admin.sh：暴露服务器 Key 管理命令。 - scripts/documents-client.py：标准库客户端，支持 HTTPS/隧道、自动分批及保留请求 ID 的受控重试。 - scripts/test_documents_client.py：传输、权限、分批与重试轻量测试。 - apps/docs/tests/documents-api.test.ts：鉴权、只读权限、过期/撤销、回滚、分页和幂等测试。 - apps/docs/scripts/test-docs.mjs：将 API 测试接入既有主线检查。 - apps/docs/scripts/auth-cli.ts：同步 1,023 条公司、11 类、1,259 条证据、189 条观测的数量检查，并保留隔离卷 API 冒烟逻辑；生产 verify 不执行写入测试。 - apps/docs/tests/research.test.ts：保留新增业务分类、主体历史核查与 Peec 团队下界回归断言修正。 - content/research/ai-companies.seed.json：合入官方业务分类、候选主体与历史核查，包括 Thrive、Brila、Utopai、Fundraisly、Goldfish、Tapflow、Atoms、Happycapy 等；保留未知项与收入边界。 - content/research/ai-companies.sources.json：同步来源和候选覆盖记录。 - content/research/ai-income-analysis.json：同步研究版本与收入统计参考。 ## 验证已通过：11 项 Python 轻量测试、两项研究审计/统计检查、JSON/Python/Shell 语法、源分支祖先关系、逐文件保留与共同脚本核对、git diff --check。完整类型检查、TypeScript 测试、构建和容器验收未运行，按 main-only 约定留待用户手动合并后的主线 CI。工作流未改动，未在本机编译或构建。 ## 交付状态已推送汇总工作分支，main 未改动，未部署，生产数据库与 API Key 未改动。已核对最新源提交完整包含；#23、#24 已关闭，原分支保留。等待用户手动合并本汇总 PR，不开启自动合并。汇总期间追加的 2025 发现台账和公开档案范围核查（770be83）已补入并重做受影响的轻量检查。

codex-bot added 11 commits 2026-10-30 10:19:48 +00:00

Classify remaining directory profiles using official business evidence 0e5ccafa30

Resolve four launch candidates through operator and app history evidence d971362a97

Separate legacy launches from unresolved Happycapy entity lineage e075eee8a5

Fix Peec team bounds regression assertion 677cd73945

Reconcile Tapflow history and Atoms company-year evidence 347b9587c6

Add Goldfish with investor-backed founding-year evidence 96f1417cda

Resolve Utopai founding history and preserve Fundraisly entity gaps e65d90c78b

Classify Thrive services rollup and exclude Brila existing operator f156406265

feat: add scoped document API and resumable batch uploader 6bfeea4e7e

merge: integrate company categorization and deployment fixes from PR #23 2b3706c90d

merge: integrate document upload API from PR #24 083f532609