docs(operations): NewAPI 运营操作手册 v4（7 文件 / 1781 行） - #1
Merged
Conversation
Adds docs/operations/ as the consolidated operations handbook for
operators and customer-success engineers, derived from the architect's
fact-finding report under TES-69.
Sections:
- 01-platform-setup.md Vendor → Model → Pricing → Group → Channel
- 02-customer-onboarding.md User → Token → Topup/Redemption
- 03-billing.md Standard / Tiered / Audio / Task with plain-language
formulas, raw formulas, and unit conventions
- 04-logs-stats.md logs / quota_data tables, query entries, stat semantics
- 05-faq.md 13 high-frequency operator scenarios + grey-area action guide
- 99-pending-items.md Open tracker for grey areas requiring architect
follow-up
- README.md Index + reading guide
Baseline: origin/main HEAD 2d1ca15.
Branch policy follows v5: docs land on feature branch, no direct
push to main / develop.
Co-authored-by: multica-agent <github@multica.ai>
Round 2 sync per architect's evidence closure (TES-69 comment 87c3958d): - Rewrite 99-pending-items.md: all 12 grey-zone items closed-2026-05-21 with evidence chains + handling outcome; appendix lists 5 known improvements (audio/task gate parity, svip default, three frontend guards, RPM/TPM tooltip, quota_data cleanup) tracked by PJM separately - 03-billing.md #1: add 3.1.4 explaining text-path two gates (SelfUseMode + AcceptUnsetRatioModel) vs audio/task path no-gate asymmetry for unregistered models - 03-billing.md QuantumNous#2 (in 02): rewrite TopupGroupRatio as topup-side discount/markup multiplier, not billing-side; document formula, four payment paths, fallback 1.0 behavior - 03-billing.md QuantumNous#9: rewrite OtherRatios as active dynamic billing multiplier for task/image paths (seconds/size/n), list adapters, clarify text-path no-op semantics; remove "reserved field" wording - 01/02 QuantumNous#3 QuantumNous#4 QuantumNous#5 QuantumNous#6 QuantumNous#7: operational hints planted (group ref check, FixAbility low-peak single-instance, double-write reminder w/ note that automatic linkage check is not yet implemented, svip default workaround, ip log default-false with compliance rationale) - 05-faq QuantumNous#8 errata: actual error message is MsgDistributorTokenModelForbidden ("该 token 不允许使用模型 X"), not "token model limit is empty"; FAQ scene 4 rewritten as full troubleshooting chain - 05-faq QuantumNous#10 QuantumNous#11 QuantumNous#12: planted hints for usingGroup-only logs.group (open other.user_group / other.token_group after schema extension), RPM/TPM as 60s snapshot, quota_data cleanup via DBA - README, 5.2 summary table, 5.3 troubleshooting matrix, and inline anchors updated to match new 99-pending-items.md headings Co-authored-by: multica-agent <github@multica.ai>
…item ref - 03-billing.md: renumber duplicate 3.1.3 section to 3.1.4/3.1.5 - 01-platform-setup.md: sync anchor QuantumNous#314 -> QuantumNous#315 - 99-pending-items.md: sync section ref 3.1.4 -> 3.1.5 - 04-logs-stats.md: drop dangling ref to non-existent appendix item Co-authored-by: multica-agent <github@multica.ai>
- docs/operations/03-billing.md L42: '详见 3.1.3' → '详见 3.1.4' - docs/operations/99-pending-items.md L114: '第 3 章 3.1.3' → '第 3 章 3.1.4' QA spot-check round 3 caught these two leftover references after the previous renumbering (3.1.3 OtherRatios → 3.1.4). Verified globally: grep -rn '3\.1\.3' docs/operations/ | grep -i OtherRatios → 0 hits Section numbering monotonic 3.1.1 → 3.1.5 in 03-billing.md TES-69 Co-authored-by: multica-agent <github@multica.ai>
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
1 participant
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.
交付摘要
docs/operations/README.mddocs/operations/01-platform-setup.mddocs/operations/02-customer-onboarding.mddocs/operations/03-billing.mddocs/operations/04-logs-stats.mddocs/operations/05-faq.mddocs/operations/99-pending-items.md合计：7 文件 / 1781 行新增，0 删除，纯文档无代码改动。
验收链（v1 → v4）
灰区收口
附录⚠️ 详见末尾追踪表 #N」回链已校验。
99-pending-items.md中 13 条灰区全部 closed，正文「HARD-GATE 状态（7 道）
关联 issue
评审建议
请项目负责人 @jipeng.yu review；合并后回 issue 评论流附 merge commit hash。