Repository navigation
Conversation
Complete guide to running ZCode on a free stack: Z.ai plan -> CCR router fallback chain (ChatGPT/Codex login, Gemini free key, OpenRouter free models) -> local qwen2.5-coder as unlimited last resort. Ships three companion skills: free-api-key-setup, auto-model-fallback, token-counter. No secrets included (verified).
Collaborator
|
✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically. |
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.
Plugin type (required) / 插件类型(必填)
Affected plugin name(s) / 涉及的插件名称:free-guide (Standard)
What / 改动内容
New community plugin in the currently-empty
guidescategory: a complete, battle-tested guide to running ZCode on a free stack with a quota-safe fallback chain, so a session never hard-stops when a cloud quota dies:Structure (
external_plugins/free-guide/, 80 KB):.zcode-plugin/plugin.json— manifest, categoryguidesdocs-guide.md— the complete setup guide (install CCR, provider setup per provider, fallback chain config, ZCode wiring, OmniRoute bonus, security checklist, troubleshooting lessons)skills/free-api-key-setup/— wire any new API key into ZCode correctly (key-prefix table, api.type gotchas; never echoes the key)skills/auto-model-fallback/— on model errors (429/401/404/5xx), classify and walk the fallback chainskills/token-counter/+scripts/token-usage.py— live per-provider quota status (exits 1 at warn threshold → time to fall back)README.md+README_CN.md— equivalent bilingual docsNo secrets included. The package was scrubbed: no API keys, no key fragments, no machine-specific paths. Free-tier lineups and caveats are dated (October 2026) and flagged in the docs for re-checking.
Self-check / 自查清单
external_plugins/<name>/; existing fixes retain ownershipcategoryis set independently of publisher ownership (guides)versionbumped in BOTHplugin.jsonandmarketplace.json(both1.0.0, new plugin)README.md(EN) andREADME_CN.md(中文) both updated and equivalentdescription_i18nhas bothenandzh-CN(in manifest and marketplace entry)python3 scripts/validate.pypasses (OK: 56 plugin(s) validated)python3 scripts/build_dist.pyfails on pre-existingexcalidrawet al. in a plain source checkout (UI plugins need compileddist/which only the release pipeline builds — per the README). The free-guide plugin itself contains no build artifacts and validates cleanly.