From 41ebc6b643499efe7bd0f87c75646af6fa512035 Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Tue, 17 Mar 2026 23:59:01 -0400 Subject: [PATCH] docs: recommend pi-dashscope extension for DashScope models (#1056) * docs: add Node LTS pinning guide for macOS Homebrew users New doc (docs/node-lts-macos.md) explains how to pin Node 24 LTS via Homebrew to avoid running on odd-numbered development releases. Covers brew install/link/pin, version managers as alternatives, and verification steps. Added notice banner in README linking to the guide. * docs: recommend pi-dashscope extension for DashScope models The built-in alibaba-coding-plan provider uses the Anthropic-compat endpoint and lacks per-model thinking format and compatibility flags, causing issues like #1003 (MiniMax-M2.5 thinking loop). The community pi-dashscope extension uses the correct OpenAI-compat endpoint, sets thinkingFormat per model (qwen/zai), includes compat flags (supportsDeveloperRole, supportsReasoningEffort), and provides an interactive /dashscope-configure command. Added Community Provider Extensions section to configuration docs recommending pi-dashscope over the built-in provider. --- docs/configuration.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/configuration.md b/docs/configuration.md index c71bd56a6..b4db57641 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -99,6 +99,16 @@ models: When a model fails to switch (provider unavailable, rate limited, credits exhausted), GSD automatically tries the next model in the `fallbacks` list. +### Community Provider Extensions + +For providers not built into GSD, community extensions can add full provider support with proper model definitions, thinking format configuration, and interactive API key setup. + +| Extension | Provider | Models | Install | +|-----------|----------|--------|---------| +| [`pi-dashscope`](https://www.npmjs.com/package/pi-dashscope) | Alibaba DashScope (ModelStudio) | Qwen3, GLM-5, MiniMax M2.5, Kimi K2.5 | `gsd install npm:pi-dashscope` | + +Community extensions are recommended over the built-in `alibaba-coding-plan` provider for DashScope models — they use the correct OpenAI-compatible endpoint and include per-model compatibility flags for thinking mode. + ### `token_profile` Coordinates model selection, phase skipping, and context compression. See [Token Optimization](./token-optimization.md).