fnos-plugin-dev

fnos-plugin-dev

Claude Code plugin for scaffolding 飞牛OS (fnOS) native .fpk plugins.

Install

claude plugin add /path/to/fnos-plugin-dev

Or add to a marketplace.

Usage

/fnos-plugin my-app "My App" 8590

Creates a complete fnOS plugin project with:

• All config files (manifest, privilege, resource, firewall, wizard, ui)
• Python 3 HTTP backend (stdlib only, no dependencies)
• Vue 3 CDN frontend (single HTML file)
• fnOS lifecycle scripts (install/uninstall/upgrade/start/stop)
• One-click build.sh → produces .fpk installer

What's Inside

fnos-plugin-dev/
├── .claude-plugin/
│   └── plugin.json                              # Plugin metadata
├── skills/
│   └── fnos-plugin/
│       ├── SKILL.md                             # Main skill definition
│       └── references/
│           ├── config-templates.md              # All fnOS config file templates
│           ├── service-setup-template.md        # Lifecycle hooks template
│           └── build-script.md                  # Complete build.sh reference
└── README.md

Key Knowledge Encoded

This plugin encodes hard-won knowledge from real fnOS plugin development:

1. ui/ symlink fix — fnOS doesn't auto-extract ui/ from fpk; must be in app.tgz + symlinked in service_postinst()
2. Complete lifecycle framework — 300+ line shared/cmd/common inlined in build script
3. Deployment path mapping — where fnOS puts each file and how symlinks work
4. All config formats — manifest alignment, privilege JSON, resource JSON, wizard JSON, firewall .sc

License

MIT