Repository navigation
Conversation
Three terms the docs already lean on in other definitions have no glossary sections of their own: budget, tier, and turn. Add pointer entries so readers land on the existing authorities: - Budget: per-turn gates (LLM calls, tokens, cost, tool errors) plus the separate attachment-disk axis. - Tier: the four text tiers c0-c3, legacy t0-t3 aliases and R0-R3 route classes, plus the T0-T3 reasoning-level overload note. - Turn: one user-visible request including its nested LLM and tool calls; budgets and cost rollups count turns. Entries stay two-line pointers without thresholds or model names. Tests: docs-only; `uv run ruff check src tests` clean; docs-consistency suite passes (70 passed, 2 skipped); full-suite local results documented in the pull request.
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Scope
Scope boundary: 只改
docs/glossary.md(纯文档)。按文件既有格式(2~3 行定义 +Read:指针指向已有用户文档)新增三节,位置保持字母序,条目数 17 → 20:## Budget:每回合(turn)检查的额度上限;六个 per-turn 门计数 LLM 调用、输入/输出 token、成本(billed 及估算同族)与工具错误,附件磁盘是另一根轴、另有自己的预算。## Tier:SquillaRouter 路由用的四个文本档位c0–c3;t0–t3是归一化到它们的 legacy 名,R0–R3是同一映射的路由类;并注明T0–T3另被推理档位复用(同名字母、另一根轴)。## Turn:一次用户可见请求及智能体为回答它做的全部动作(重复 LLM 调用、工具调用、推理);预算与成本汇总以 turn 计数。三节都写成指针、不复述门限数字与具体模型名——三个词的实质定义已各有一处权威:
docs/providers-and-models.md(Turn and Router Budget Gates)、docs/features/squilla-router.md(C0–C3 档位表)、docs/diagnostics-and-replay.md。Non-goals: 不改代码、不改其他文档;不在 glossary 里正式裁决 tier 别名债(issue #1874 里已提出"三套别名 id 是否该在
docs/features/squilla-router.md正式裁决"的开放问题),也不新增Adjudication point一节(该词没有.md归宿,issue 中列为需维护者先裁决的开放点)。Branch
Base branch: main
Target exception: N/A
Issue
Linked issue: Fixes #1874
If None, reason: N/A
Release Note
Release note: NONE
Tests
Ruff:
uv run ruff check src tests— All checks passedPytest:
uv run pytest tests/test_release_consistency.py -q— 70 passed, 2 skippedBuild:
npm --prefix opensquilla-webui run build— 通过(Web UI artifact verified: 156 files,已按仓库流程 stage 给打包);uv build --wheel— 成功(opensquilla-0.5.6-py3-none-any.whl)Regression tests: not needed
Notes: 纯文档改动(只在
docs/glossary.md新增三节),不涉及行为;三个新增Read:链接目标均已存在于仓库。本机为中文 Windows,另外完整跑了 CI 同款两相全量(marker 过滤与 CI 三处 job 逐字一致;并行相
-n 8 --dist loadfile):-m "<CI 过滤> and not ci_serial"):31981 passed / 728 skipped / 38 failed-m "<CI 过滤> and ci_serial"):313 passed / 5 skipped38 条失败的逐条归因(全部与本次改动无关;对照实验:`git stash push -- docs/glossary.md` 后同机复跑同一批 38 条,失败集合逐条一致,pop 后恢复)
WinError 1314(客户端没有所需的特权):本机没有创建符号链接的权限(未开开发者模式)/tmp路径互操作(test_prestage_release_to_oss×2、test_release_oss_mirror_workflow×2)python3(test_workspace_write_deny_levers的用例硬编码python3命令)gh不在 PATH(test_skill_catalog_projection:github技能声明requires: bins: ["gh"],本机 gh 装在 PATH 之外)test_bounded_output_capture的行计数用例)test_live_tokenrhythm_transport期望的 Mock 挂载被遮蔽)tests/test_ci/test_workflows.py::test_release_jobs_share_one_rerun_stable_verified_webui_artifact——wheelhouse-release.yml中 fix(release): validate existing Draft upgrades without rebuilding #1871 新增的两个 upload-artifact@v4 步缺overwrite: true,而该提交[skip ci]合入未跑 CI;本 PR 不涉该文件,供维护者参考本机跑 pytest 另需
PYTHONUTF8=1(GBK 区域默认编码会让tests/contracts/test_page_context_contract.py在收集期抛 UnicodeDecodeError;UTF-8 环境不触发)。The default test path remains offline, deterministic, credential-free, and safe for forks.
Maintainer Live Check
Maintainer live check: no
Surface: N/A
Maintainer-only note: contributors are not expected to provide secrets or run credentialed live checks. Maintainers may run
Live Release E2Efor provider, browser, gateway, channel, or release smoke coverage.Safety
Secrets, local-only artifacts, private prompts/transcripts, channel identifiers, AI session artifacts, non-public fixtures, and tests/_private/ contents must not be committed.
Third-Party Origin
Third-party origin: none
Details if non-none: N/A
Documentation Changes