Skip to content

chore: 重新同步公开契约;project_urls 指向 s1.dev (v0.2.1) - #2

Merged
fatwang2 merged 1 commit into
mainfrom
chore/resync-contract-and-urls
Aug 19, 2026
Merged

chore: 重新同步公开契约;project_urls 指向 s1.dev (v0.2.1)#2
fatwang2 merged 1 commit into
mainfrom
chore/resync-contract-and-urls

Conversation

@fatwang2

Copy link
Copy Markdown
Member

vendored 的 openapi 快照已落后 canonical 一个版本,而 tests/test_client.pytest_sdk_covers_every_public_openapi_operation 正是拿它做契约覆盖校验 —— 校验的是一份过期契约。

端点 canonical 本仓库快照
POST /search 无 404 仍声明 404
POST /news 无 404 仍声明 404
POST /screenshot 有 403 缺 403
POST /crawl、/screenshot requestBody 更深层也有差异

新快照同时带上了每个 operation 的 description —— 上游刚补的选型指引(什么时候该用这个端点、和兄弟端点怎么配合、成本多少)。

project_urls

此前没有 Homepage,且 Documentation 指向已迁走的 www.search1api.com —— PyPI 页面上那个链接靠 301 才活着。

  • 补上 Homepage = https://s1.dev —— agent 确认「官方 SDK」而非同名第三方包的依据
  • Documentation 改到 https://s1.dev/docs/integrations/sdks

版本

0.2.0 → 0.2.1(__version__ 同步)。10 项测试通过,含契约覆盖测试。

⚠️ 合并顺序

等 fatwang2/search1api#171 合并、gateway 自动部署之后再打 tag,否则 vendored 快照会领先线上契约。

相关

fatwang2/search1api#171 · search1api-cli#8 · search1api-mcp#28 · search1api-js#2

🤖 Generated with Claude Code

vendored 的 openapi 快照已落后 canonical 一个版本,而 tests/test_client.py
的 test_sdk_covers_every_public_openapi_operation 正是拿它做契约覆盖校验:

- POST /search、/news 仍声明了 canonical 已移除的 404
- POST /screenshot 缺少 canonical 新增的 403
- /crawl、/screenshot 的 requestBody 也有更深层差异

新快照同时带上了每个 operation 的 description(上游刚补的选型指引)。

project_urls 此前没有 Homepage,且 Documentation 指向已迁走的
www.search1api.com —— PyPI 页面上那个链接靠 301 才活着。补上
Homepage = https://s1.dev(agent 确认「官方 SDK」的依据),Documentation
改到 s1.dev。

0.2.0 → 0.2.1(__version__ 同步)。10 项测试通过,含契约覆盖测试。

⚠️ 需等 gateway 部署后再打 tag,否则 vendored 快照会领先线上契约。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@fatwang2
fatwang2 merged commit 9dcc7f3 into main Aug 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant