ywxzm03 opened a new pull request, #921:
URL: https://github.com/apache/dubbo-go-pixiu/pull/921
**What this PR does**:
Adds four Pixiu skills for working with Apache dubbo-go-pixiu:
- `pixiu-filter-author`: guides HTTP / Network filter authoring, SPI
registration, config wiring, and test decisions.
- `pixiu-http-to-dubbo`: guides REST/HTTP to Dubbo route configuration
through `conf.yaml` and `api_config.yaml`.
- `pixiu-llm-gateway`: guides Pixiu LLM gateway configuration, including LLM
proxy, tokenizer metrics, KV cache routing, retry/fallback, and Nacos LLM
discovery.
- `pixiu-mcp-integration`: guides MCP gateway configuration, including
Streamable HTTP/SSE, tools, OAuth/JWT protection, and Nacos MCP tool discovery.
Each skill includes focused reference documents for schema details,
troubleshooting, validation rules, and common pitfalls.
**Which issue(s) this PR fixes**:
Fixes #913
**Special notes for your reviewer**:
This PR only adds skill documentation and references. It does not change
dubbo-go-pixiu runtime code.
The skills are written to match current Pixiu configuration and extension
patterns, including:
- current filter Kind names
- HTTP filter registration via `pkg/pluginregistry/registry.go`
- current `api_config.yaml` mapping rules
- current LLM `llm_meta` and Nacos metadata conventions
- current MCP filter/auth behavior and known limitations
**Does this PR introduce a user-facing change?**:
```release-note
Added four Pixiu skills for filter authoring, HTTP-to-Dubbo configuration,
LLM gateway setup, and MCP gateway integration.
```
## Summary by Sourcery
Add Pixiu-focused skills, reference docs, and validation/scaffolding scripts
to guide configuration of HTTP-to-Dubbo routes, filter authoring, LLM gateway
setup, and MCP gateway integration without changing runtime behavior.
Enhancements:
- Add shell scripts to scaffold new HTTP filters, validate api_config.yaml,
and validate LLM and MCP gateway conf.yaml files, improving configuration
correctness and developer workflows.
Documentation:
- Document the pixiu-http-to-dubbo skill for configuring HTTP routes to
Dubbo backends via conf.yaml and api_config.yaml, including mapping rules,
validation workflow, and troubleshooting guidance.
- Document the pixiu-filter-author skill for authoring and registering HTTP
and network filters in dubbo-go-pixiu, with guidance on SPI usage, config
wiring, and testing conventions.
- Document the pixiu-llm-gateway skill for configuring Pixiu as an LLM
gateway, covering LLM proxy, tokenizer, KV cache routing, and Nacos-based LLM
discovery from conf.yaml.
- Document the pixiu-mcp-integration skill for configuring Pixiu as an MCP
gateway, including tools/resources/prompts, auth, Nacos-based tool discovery,
and transport expectations.
- Add detailed reference documents for filter interfaces, context API,
plugin registry usage, testing patterns, api_config schema and mapping rules,
generic invoke types, and troubleshooting for HTTP-to-Dubbo, LLM, and MCP
gateways.
<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit
* **Documentation**
* Added comprehensive filter-authoring guides (interfaces, context API,
lifecycle, testing, registration, templates, and verification checklists).
* Added HTTP→Dubbo mapping docs with schema, param-mapping, generic-invoke
guidance, validation, and troubleshooting.
* Added LLM gateway guides (kvcache, endpoints, registry, tokenizer
metrics, troubleshooting).
* Added MCP integration docs (auth, transport, server config, registry,
and troubleshooting).
* **Chores**
* Added scaffolding, registry-import generator, and multiple validation
scripts for filter, API-config, LLM, and MCP configurations.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
