# Xrk Subserver

> 子服插件开发；配置全在主服 CommonConfig，子服只读 data/；AgentRuntime.callSubserver 用 runtimeConfig.subserver。

- Skill: `sunflowermm/xrk-subserver` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sunflowermm/xrk-subserver`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sunflowermm/xrk-subserver/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: sunflowermm (https://skillmd.com/u/sunflowermm)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sunflowermm/xrk-subserver

---


## 配置（必读）

**[docs/subserver-commonconfig.md](../../docs/subserver-commonconfig.md)**

| 类型 | 主服编辑 | 子服 |
|------|----------|------|
| 子服 host/port | AiWorkflow → 子服务端（`runtimeConfig.subserver`） | 被连接 |
| 业务插件 | `apis/<group>/core/commonconfig/*.js` | `load_plugin_config` 只读 yaml |

## 插件结构

```
apis/<group>/
  service.*
  default_config.yaml
  core/commonconfig/<group>.js
  core/plugin/*.js
```

## 文档

- [subserver-plugin-development.md](../../docs/subserver-plugin-development.md)
- [subserver/CONTRACT.md](../../subserver/CONTRACT.md)

参考：`subserver/pyserver/apis/jmcomic/`、`media-tools/`。