Commit Graph
3 Commits
Author SHA1 Message Date
openbot-coder c4dd61665b docs: 建立 MkDocs 文档站与 AI 层文档
- 新增 MkDocs + Material 文档站(19 页):入门、CLI、场景示例、FAQ、
  Contributing、Changelog、API 参考(mkdocstrings 自动渲染)、内部原理
  (架构 / 协议 / 三池路由 / 缓存)
- 新增 docs/llms.txt:面向 LLM 的结构化摘要(枚举取值、方法速查、常见陷阱)
- 新增 scripts/check_docs.py:校验文档与 api.py 公开方法清单是否漂移
- 新增根 CHANGELOG.md 作为版本记录唯一来源,docs/changelog.md 用 snippet 引入
- 新增 .github/workflows/docs.yml:push main 自动构建并部署 GitHub Pages
- 修正文档口径:TdxData 公开方法 53 个(51 数据方法 + start/close);
  API_REFERENCE 版本号 v0.3.2 -> v0.4.0
- pyproject.toml 新增 docs 依赖组;.gitignore 忽略 site/
2026-09-15 13:57:31 +08:00
openbot-coder 1379060482 ci: 修正 setup-uv 引用,astral-sh/setup-uv 没有 v10 滚动标签
astral-sh/setup-uv 仓库只维护到 v7 的滚动大版本标签,v10 仅有精确版本
标签(v10.0.1 / v10.1.0)。此前写成 @v10 会 404,导致 ci.yml 与
release.yml 的所有作业在「安装 uv」这一步就失败。

改为精确版本 @v10.1.0,并逐条核验所有 uses 引用的 ref 均真实存在。
2026-09-15 12:05:15 +08:00
openbot-coder 92a03951c7 ci: 新增 GitHub Actions 工作流,发布改用 PyPI Trusted Publishing
- .github/workflows/ci.yml:push/PR 触发,Python 3.11 + 3.13 矩阵跑 pytest,
  另做一次构建与 twine check 校验
- .github/workflows/release.yml:推送 v* 标签触发,测试 → 构建 → 发布到 PyPI
  - 含 git tag 与 pyproject 版本一致性校验,防止标签与版本号错位
  - publish 作业使用 environment: pypi + id-token: write,走 OIDC 免密钥发布
- uv.lock:同步 pytdxdata 版本 0.3.2 → 0.4.0(此前 lockfile 落后于 pyproject.toml)
2026-09-15 12:00:02 +08:00