Skip to content

docs(moonshot): update provider docs for model picker, refresh, and .ai/.cn base URL#14

Open
grizmin wants to merge 2 commits into
Zoo-Code-Org:mainfrom
grizmin:feat/moonshot-provider
Open

docs(moonshot): update provider docs for model picker, refresh, and .ai/.cn base URL#14
grizmin wants to merge 2 commits into
Zoo-Code-Org:mainfrom
grizmin:feat/moonshot-provider

Conversation

@grizmin

@grizmin grizmin commented Jul 20, 2026

Copy link
Copy Markdown

Closes: #12

Description

Updates the Moonshot provider documentation to reflect the changes in Zoo-Code PR #857, which reimplements the Moonshot provider with a live model picker, Refresh Models button, and base URL selection.

Changes:

  • Added base URL selection section describing api.moonshot.ai (global) vs api.moonshot.cn (China) endpoints
  • Added dynamic model picker section explaining the Refresh Models flow
  • Replaced generic model reference with a detailed model lineup table (kimi-k2-0905-preview, kimi-k2-thinking, kimi-k2-turbo-preview, kimi-k2.5, kimi-k2.6, kimi-k2.7-code, kimi-k2.7-code-highspeed)
  • Updated configuration steps to include base URL selection and model refresh
  • Updated website links to reference both platforms

Test Procedure

  • Verified the rendered markdown formatting
  • Confirmed all model metadata matches the static model definitions in the Zoo-Code codebase

Pre-Submission Checklist

@taltas

taltas commented Jul 20, 2026

Copy link
Copy Markdown
Collaborator

@zoomote, please review this

@zoomote

zoomote Bot commented Jul 20, 2026

Copy link
Copy Markdown

I started a PR review task for this request. See task

@zoomote

zoomote Bot commented Jul 20, 2026

Copy link
Copy Markdown

3 issues outstanding. See task

Reviewed against the Zoo-Code implementation in Zoo-Code PR #857. Model metadata, base URL values, max_tokens behavior, and the Refresh Models flow all match the code. The findings below are documentation accuracy issues:

  • docs/providers/moonshot.md:34 and docs/providers/moonshot.md:77 — The docs refer to a "Moonshot Base URL" dropdown, but the actual settings label in Zoo-Code PR #857 is "Moonshot Entrypoint" (webview-ui/src/i18n/locales/en/settings.json: "moonshotBaseUrl": "Moonshot Entrypoint"). Users won't find a dropdown named "Moonshot Base URL". Suggest renaming both references to "Moonshot Entrypoint".
  • docs/providers/moonshot.md:67 — "The Refresh Models button will show an error if no key is configured" is inaccurate: in Moonshot.tsx the button is disabled when no API key is set (disabled={refreshStatus === "loading" || !apiConfiguration.moonshotApiKey}), so users can't click it to trigger an error. Suggest: "The Refresh Models button is disabled until an API key is entered."
  • docs/providers/moonshot.md:49-57 — The model table states "Zoo Code supports the following Moonshot models" but omits kimi-k2-0711-preview (128K context, 32K max output, text only), which is still in the static model list in packages/types/src/providers/moonshot.ts on PR #857. Either add a row for it or reword the intro to note the table covers the current K2 lineup.

Reviewed c944b2f

@taltas

taltas commented Jul 20, 2026

Copy link
Copy Markdown
Collaborator

Can you verify the three points above @grizmin ?

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.

Update Moonshot provider docs for model picker, refresh, and .ai/.cn base URL

2 participants