Development
Plugin
csswitch
帮你的 Claude Science 一键接入你自己的 API：DeepSeek / 通义千问 / 智谱 GLM / Kimi / MiniMax / 小米 MiMo / 硅基流动 / OpenRouter / 任意 OpenAI·Anthropic 兼容端点
Plugin Signal57/100Fair
maintained98
capable14
documented50
adopted56
Install
$ npx -y skills add SuperJJ007/CSSwitch --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
README
1Linux x64 用户可以使用 CSSwitch v0.8.1 Linux x64 预发布版，提供 amd64
.deb安装包。
功能介绍
| 功能 | 当前状态 | 说明 |
|---|---|---|
| Provider 与模型 | 已支持 | 连接内置 Provider、中转站和自定义兼容端点，自由填写并严格映射 Science 使用的模型。 |
| Codex | 实验功能 | 使用 CSSwitch 独立浏览器登录和账号动态模型目录；默认关闭，不读取或修改原生 ~/.codex 登录。 |
| Skill | 已支持 | 查看当前 Science 组织中的 Skill，从本地包导入，或让 Agent 从准确的公开 GitHub URL 安装。 |
| MCP | 即将支持 | v0.8.4 尚未提供面向用户的通用 MCP 添加、配置和运行管理；后续版本会继续完善。 |
社区
安装与启动
需要一台 Apple Silicon Mac、已安装的 Claude Science，以及可用的第三方模型 API Key 或 Codex 账号。
第一次安装
- 下载
CSSwitch_0.8.4_aarch64.dmg，打开后将 CSSwitch 拖入「应用程序」。可按 v0.8.4 发布证据 核对公开附件 SHA-256。 - 确认电脑上已经安装 Claude Science，然后打开 CSSwitch。
- 首次打开如被 macOS 阻止，请在 Finder 中右键 CSSwitch，选择「打开」。当前公开包为 ad-hoc 签名，不是 Developer ID / 公证 / Gatekeeper 结论。
连接第三方模型
- 进入「模型连接」，点击「新增配置」。
- 选择一个内置 Provider；使用中转站或自建服务时，选择对应的兼容端点并填写
base_url。 - 填写 API Key 和模型名称。默认模型必须填写；高质量、快速和 Fable 模型可以留空，也可以直接填写上游提供的精确模型 ID。
- 保存配置并点击「设为当前」。
- 回到首页，保持「第三方模型」模式，点击「一键开始」。
- Science 打开后，在顶部模型选择器中选择需要的模型。CSSwitch 显示的是你配置的真实模型名。
需要回到原来的 Claude 账号和官方模型时，在首页切换到「官方 Claude」并打开 Science；CSSwitch 会先停止自己管理的第三方链路。
使用 Codex
- 进入「设置」，打开「启用 Codex 实验入口」。
- 点击「浏览器登录 Codex」，在系统浏览器完成 CSSwitch 自己的独立授权。
- 登录成功后，Codex 配置会自动出现在「模型连接」中，但不会自动替换当前 Provider。
- 将 Codex 配置「设为当前」，回到首页点击「一键开始」。
- 在 Science 的模型选择器中选择
Codex / …模型。模型列表来自当前账号的动态目录，CSSwitch 不会补造账号中不存在的模型。
安装与查看 Skill
- 先通过「一键开始」启动隔离 Science，等待运行状态正常。
- 打开「Skill & MCP」，点击「刷新」查看当前 Science 组织中发现的 Skill、来源和绑定状态。
- 本地包可以点击「导入本地 Skill 包」，选择
.zip或.skill；公开 GitHub Skill 则在 Science 中把准确 URL 交给 Agent，由 CSSwitch connector 完成安装。 - 页面显示“已绑定”后，仍建议在当前 Agent 会话调用对应的
skill()，确认它已经实际加载。
Provider 与模型
- 内置 Provider： DeepSeek、通义千问、智谱 GLM、小米 MiMo、硅基流动、Kimi、MiniMax、OpenRouter。
- 自定义端点： Anthropic Messages、OpenAI Chat Completions 和 OpenAI Responses 兼容 API；模型名称可以直接填写，不依赖自动发现。
- 模型选择： 普通配置可只填一个模型，也可以分别设置质量、均衡、快速和 Fable。Science 显示真实模型名，不使用
default占位名称。 - Codex： 使用 CSSwitch 独立浏览器登录和动态账号模型目录；不读取或修改原生
~/.codex登录。
不同 Provider 对工具调用、thinking、图片、长上下文和流式输出的支持并不相同。CSSwitch 会严格按当前配置映射模型，未知模型不会静默切换到别的模型。
Skill
CSSwitch 当前聚焦于安全地把外部 Skill 接入隔离 Science，而不是再造一个 Skill 市场或通用 MCP 管理器。
- 查看现有 Skill： 页面读取当前 Science 组织中真实存在的 Skill，展示来源、单 Skill / bundle 形态，以及
attached、detached、unknown三种 OPERON 绑定状态。Science 未运行或身份无法确认时不会猜测结果。 - 导入本地包： 通过系统文件选择器导入
.zip或.skill，自动识别单 Skill 与多 Skill bundle；前端不接收或提交本地文件路径。 - 从 GitHub 安装： 可以让 Science Agent 通过 CSSwitch 的专用安装桥接安装准确的公开 GitHub 仓库、集合或 Skill 目录 URL。CSSwitch 宿主负责匿名下载、固定 commit、校验、提交和绑定，不使用 Science 或用户的 GitHub 凭证。
- 安全提交： 安装前检查 archive 大小、文件数量、路径穿越、符号链接、特殊文件和名称冲突；提交过程保持原子性，同名或已被修改的内容不会被静默覆盖。
- 区分发现、绑定与加载： 列表中“已绑定”只代表 OPERON 实时回读成功，不等于当前 Agent 会话已经加载。单 Skill 安装后仍应在 Science 中调用
skill()做最终验证。 - bundle 生命周期： bundle 会保留
_shared和支持资源；从任一成员发起卸载都必须先展示完整影响列表并由用户确认，随后才整包 detach 和隔离回收，不做成员级静默删除。
公开 GitHub Skill 安装在内部使用一个窄范围 connector，只负责安装、卸载和长任务状态查询；它是 Skill 安装链路的一部分，不代表 CSSwitch 已经支持通用 MCP。详细合同见外部 Skill bridge。
MCP
通用 MCP 支持正在开发中。当前 v0.8.4 还不能让用户在 CSSwitch 中添加、编辑或管理自己的 MCP server，也不应把 Skill 安装所用的内部 connector 当成完整 MCP 功能。后续支持范围以对应版本的 README 和更新日志为准。
安全与隔离
- 第三方模式使用独立 HOME、data-dir 和本地回环 Gateway，不读取或修改真实 Claude 登录与 Science 数据。
- API Key 保存在本机
~/.csswitch/config.json，文件权限为0600；凭据不会写入日志。 - 官方 Claude 模式会停止第三方代理链路，再打开真实 Science。
- CSSwitch 不下载或自动升级 Claude Science；新启动会优先采用本机官方 updater 已下载并通过本地身份校验的 runtime snapshot，否则使用当前安装的官方 App。
当前边界
- 当前 macOS Apple Silicon 正式版本为 v0.8.4；分层发布证据见 v0.8.4 发布证据。公开桌面包目前只支持 macOS Apple Silicon。
- 第三方模式不提供 Anthropic 账号权限，托管 MCP、目录连接器和部分云端能力可能不可用。
- Codex 仍是默认关闭的实验能力，当前只支持单账号浏览器登录。
- Rust Gateway 已随应用打包，不需要单独安装 Python runtime。
- source/unit、最终附件、安装身份、签名与 live provider/账号是不同证据层；下载页或 source gate 通过不能外推为全部真实 provider、SSH 或 Science 领域能力已验证。
升级、回滚和已知限制见项目文档。问题反馈请使用 GitHub Issues。
开发
cd desktop
npm install
npm run tauri dev
完整检查：
GATE_ROOT="$(mktemp -d /private/tmp/csswitch-source-gate.XXXXXX)"
chmod 700 "$GATE_ROOT"
bash test/run_all.sh --output-root "$GATE_ROOT"
File tree
410SuperJJ007/CSSwitchView on GitHub
.agents/
context/
current-main.md
current-release.md
known-issues.md
README.md
verified-state.md
handoffs/
README.md
rules/
documentation.md
external-skills.md
git-worktrees.md
README.md
release.md
reviewing.md
safety.md
science-runtime.md
system-ssh.md
testing-and-evidence.md
.github/
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
.gitignore
.gitleaks.toml
AGENTS.md
catalog/
capabilities.v1.json
model-presets.v1.json
opencode-go-model-routes.v1.json
provider-contracts.v1.json
CHANGELOG.md
CLAUDE.md
desktop/
.gitignore
.vscode/
extensions.json
codex-network/
.gitignore
Cargo.toml
src/
lib.rs
gateway/
Cargo.lock
Cargo.toml
src/
anthropic_compat.rs
anthropic_sse.rs
auth.rs
codex_auth/
cli.rs
login_async.rs
mod.rs
oauth.rs
storage.rs
codex_models.rs
codex_network.rs
codex_protocol.rs
codex_transport.rs
config.rs
connect.rs
dsml_shim.rs
lib.rs
main.rs
messages.rs
models.rs
openai_chat.rs
openai_responses.rs
policy.rs
provider_contracts.rs
science_control.rs
server.rs
skill_install.rs
static_profile.rs
tests/
codex_auth_cli.rs
package-lock.json
package.json
skill-package/
Cargo.lock
Cargo.toml
src/
archive.rs
bundle.rs
github.rs
install.rs
lib.rs
listing.rs
science.rs
src/
src-tauri/
.gitignore
build.rs
capabilities/
default.json
Cargo.lock
Cargo.toml
icons/
128x128.png
128x128@2x.png
32x32.png
64x64.png
icon.icns
icon.ico
icon.png
Square107x107Logo.png
Square142x142Logo.png
Square150x150Logo.png
Square284x284Logo.png
Square30x30Logo.png
Square310x310Logo.png
Square44x44Logo.png
Square71x71Logo.png
Square89x89Logo.png
StoreLogo.png
tray_template.rgba
resources/
skills/
csswitch-external-skill-tools/
legacy-bundle-pre-progress.md
legacy-bundle-progress-v1.md
legacy-revision2.md
legacy-split-connectors.md
SKILL.md
src/
codex_auth_supervisor.rs
commands/
codex.rs
diagnostics.rs
mod.rs
profiles.rs
runtime.rs
skill_install.rs
skill_listing.rs
skills.rs
config_legacy.rs
config.rs
lib.rs
lifecycle.rs
main.rs
model_catalog.rs
oauth_forge.rs
opencode_go_models.rs
proc.rs
provider_contracts.rs
runtime/
capability_catalog.rs
diagnostics.rs
external_skill_route.rs
legacy_proxy.rs
mod.rs
model_discovery.rs
operation.rs
profile_switch.rs
profile.rs
provider.rs
proxy_lifecycle.rs
proxy.rs
sandbox_session.rs
science.rs
settings.rs
skill_install_bridge_e2e.rs
skill_install_bridge.rs
ssh_bridge.rs
system.rs
transaction.rs
scratch.rs
skill_manager/
compatibility.rs
deployment.rs
discovery.rs
error.rs
external.rs
inspection.rs
mod.rs
model.rs
requirements.rs
store.rs
workspace_ingress.rs
templates.rs
tauri.conf.json
assets/
javascript.svg
model-icons/
anthropic.svg
deepseek.svg
generic.svg
glm.svg
kimi.svg
LICENSES.md
minimax.svg
openai.svg
openrouter.svg
qwen.svg
siliconflow.svg
xiaomi.svg
tauri.svg
codex-auth-protocol.js
index.html
main.js
model-catalog-state.js
runtime-status-state.js
skill-page-state.js
skill-page.js
styles.css
docs/
architecture/
ARCHITECTURE.md
desktop-control-plane.md
gateway-provider-routing.md
overview.md
README.md
runtime-state-transactions.md
science-capability-dependencies.md
science-runtime.md
assets/
csswitch-v0.8-ui-demo.gif
social-preview.png
wechat-group.jpg
audits/
2026-07-29-v084-main-baseline.md
2026-07-30-v084-architecture-reconnaissance.md
2026-07-30-v084-document-structure.md
v080-change-audit.md
v081-change-audit.md
v082-change-audit.md
v083-current-document-manifest.v1.json
v083-legacy-document-manifest.v1.json
v083-test-system-audit.md
DEVELOPMENT.md
evidence/
investigations/
2026-07-13-science-runtime-and-skill-bridge.md
2026-07-16-codex-acceptance-preparation.md
2026-07-16-codex-science-bridge-baseline.md
2026-07-16-codex-science-model-compat.md
2026-07-17-codex-browser-only-acceptance.md
2026-07-18-v070-model-catalog-gateway-review.md
2026-07-18-v070-model-catalog-lifecycle-science-review.md
2026-07-18-v070-model-catalog-schema-review.md
2026-07-18-v070-model-catalog-scoped-final-review.md
2026-07-18-v070-model-catalog-stage0.md
2026-07-18-v070-model-catalog-ui-acceptance-review.md
2026-07-18-v070-ui-redesign-api-provider-review.md
2026-07-18-v070-ui-redesign-codex-review.md
2026-07-18-v070-ui-redesign-review.md
2026-07-18-v070-ui-redesign-runtime-security-review.md
2026-07-18-v070-ui-redesign-skill-mcp-review.md
2026-07-18-v070-ui-redesign-ui-packaging-review.md
2026-07-28-claude-science-0.1.25-compatibility.md
2026-07-28-v083-ssh-late-source-repair.md
2026-07-30-claude-science-0.1.25-a-evidence-01.md
2026-07-30-claude-science-0.1.25-a-ipc-01.md
2026-07-30-claude-science-0.1.25-a-plugin-01.md
2026-07-30-claude-science-0.1.25-a-ssh-01.md
2026-07-30-claude-science-0.1.25-b-runtime-01.md
2026-07-30-csswitch-refactor-priorities.md
2026-07-30-csswitch-science-association-and-design.md
README.md
README.md
releases/
README.md
v0.4.2.md
v0.5.0.md
v0.6.0.md
v0.7.0.md
v0.8.0.md
v0.8.1-linux-x64.md
v0.8.1.md
v0.8.2.md
v0.8.3.md
v0.8.4.md
EXTERNAL_SKILL_INSTALL.md
features/
codex-browser-login-models-implementation-plan.md
codex-science-bridge.md
external-skill-bridge.md
product-science-capability-map.md
README.md
system-ssh.md
ui-information-architecture.md
v081-provider-compatibility.md
operations/
development.md
document-lifecycle.md
quality-kernel.md
quality-source-gate.md
README.md
real-machine-acceptance.md
release.md
science-probe-spec.md
testing.md
upgrade-and-rollback.md
README.md
references/
CSNATIVE.md
external/
csnative.md
README.md
README.md
release-evidence-v0.4.2.md
RELEASE.md
SCIENCE_RUNTIME.md
upgrade-and-rollback.md
LICENSE
quality/
bugs/
BUG-083-ARTIFACT-GATE.json
BUG-083-DATABASE-ERROR.json
BUG-083-DEEPSEEK-THINKING.json
BUG-083-GATEWAY-RECOVERY.json
BUG-083-GITHUB-BUNDLE.json
BUG-083-MCP-BOUNDARY.json
BUG-083-OPENCODE-65.json
BUG-083-ORPHANS.json
BUG-083-RC.json
BUG-083-READINESS.json
BUG-083-RESPONSES-CORE.json
BUG-083-RETRY.json
BUG-083-RUST-COVERAGE.json
BUG-083-SCIENCE-MACHO.json
BUG-083-SCIENCE-REATTACH.json
BUG-083-SCIENCE-UPDATER.json
BUG-083-SSH-LATE.json
BUG-083-TOOL-ARG-EXCLUSIVITY.json
changes/
v0.8.3/
CHG-DATABASE-ERROR.json
CHG-DEEPSEEK-THINKING.json
CHG-GATEWAY-RECOVERY.json
CHG-GITHUB-BUNDLE.json
CHG-MCP-BOUNDARY.json
CHG-OPENCODE-65.json
CHG-QUALITY-KERNEL.json
CHG-RESPONSES-CORE.json
CHG-SCIENCE-MACHO.json
CHG-SCIENCE-REATTACH.json
CHG-SCIENCE-UPDATER.json
CHG-SOURCE-GATE.json
CHG-SSH-LATE.json
CHG-TOOL-ARG-EXCLUSIVITY.json
core-contract-matrix.v1.json
production-paths.v1.json
release-gates.v1.json
release-lineage.v1.json
requirements.v1.json
schema/
adapter-result.v1.schema.json
change-set.v1.schema.json
completion-seal.v1.schema.json
evidence-manifest.v1.schema.json
quality-kernel.v1.schema.json
release-candidate.v1.schema.json
run-failure.v1.schema.json
run-manifest.v1.schema.json
source-observation.v1.schema.json
source-snapshot-manifest.v1.schema.json
test-result.v1.schema.json
test-catalog.v1.json
README.en.md
README.md
scripts/
clean-bundle-resources.sh
doctor.sh
launch-virtual-sandbox.sh
self-test.sh
ssh-bridge/
ssh
stop-science-sandbox.sh
verify-proxy.sh
test/
_capability.py
_loopback_ports.py
codex_auth_ui.test.mjs
fake_science_runtime.c
golden/
anthropic_nonstream.json
dsml_nonstream.json
openai_responses.json
qwen_openai_chat.json
relay_anthropic.json
installed_provider_matrix.py
mock_upstream.py
model_catalog_coverage_acceptance.py
model_catalog_state.test.mjs
profile_preview_mock.test.mjs
provider_mock_scenarios.py
provider_mock_scenarios.v1.json
quality/
fixtures/
run_evidence/
attempt0_fixture.py
source_gate/
expected_test_ids.v1.json
run_evidence/
aggregation_runner.py
atomic_store.py
attempt0_runner.py
... 66 moreFAQ
csswitch is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes csswitch-external-skill-tools. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is csswitch?
- 帮你的 Claude Science 一键接入你自己的 API：DeepSeek / 通义千问 / 智谱 GLM / Kimi / MiniMax / 小米 MiMo / 硅基流动 / OpenRouter / 任意 OpenAI·Anthropic 兼容端点
- How do I install csswitch?
- Run these in Claude Code: npx -y skills add SuperJJ007/CSSwitch --agent claude-code. Then prompt normally.
- Does csswitch auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is csswitch free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.