chore: remove obsolete GitHub workflows and update documentation commands
Some checks failed
Test / test (push) Failing after 11m14s

This commit is contained in:
2026-09-19 00:29:42 +08:00
parent 580fe84275
commit 1e5fa4e6ba
10 changed files with 328 additions and 119 deletions

View File

@@ -46,11 +46,20 @@ uv run pytest
# 构建 Windows、macOS、Linux 扩展包到 dist/
uv run pack
# 本地构建多版本静态页面(只提交到本地 gh-pages 分支,不推送)
uv run docs build
# 本地热更新预览当前文档
uv run docs dev
# 用 pyproject.toml 中的 major.minor.x 发布文档并让 latest 指向它
uv run docs deploy
# 构建并验证 Blender 节点资产
uv run node-group build
# 准备、校验并同步 ONNX 模型到 R2
uv run sync-models
uv run models sync
```
## 命名规范
@@ -76,6 +85,8 @@ uv run sync-models
- `README.md` 面向用户,不在其中堆叠内部细节。实现原理放入 `docs/internals` 对应主题
- 文档只正面描述当前主题的职责与实现,不记录无关模块、未采用路径、历史差异、边界辩解、“不做什么”的排除性信息。
- 根据内容选择最清晰的表达方式,优先简洁文字;复杂流程或关系在有助于理解时使用图表。Mermaid 流程图默认从上到下。
- 文档版本只使用 `pyproject.toml` 中的 major.minor,写成 `x.y.x` 系列标识,不写具体 patch;`uv run docs build` 和 `uv run docs deploy` 都构建到该版本并更新 `latest`
- mike 默认只提交不推送,`--push` 不能省;内容没有变化时 mike 会跳过提交并连带跳过推送,所以 `uv run docs deploy` 额外带 `--allow-empty`;mike 默认推送到 `origin`,本仓库的远端名是 `omoolab`
## Blender 开发规范