| name | storage-provider |
| description | Implements or modifies Pixuli StorageProvider plugins (register, manifest, registry.create). Use when adding providers, editing @pixuli/provider-*, storageRegistry, createConfiguredStorageProvider, or StoragePluginRegistry. |
Storage Provider
Quick map
| What | Where |
|---|
| Registry factory | createStoragePluginRegistry() — @pixuli/core/plugins |
| App registry | apps/pixuli/src/storage/registry.ts |
| Create + configure | createConfiguredStorageProvider() — apps/*/storage/createProvider.ts |
| GitHub register | registerGitHubProvider — @pixuli/provider-github/register |
| Gitee register | registerGiteeProvider — @pixuli/provider-gitee/register |
Add or change a provider
- Read
docs/02-system-design/03-plugin-system.md §第二部分
- In provider package:
manifest.ts（含可选 hostIntegrations）→
*StorageProvider.ts → register.ts → package.json exports（REF-416：
development + dist）
- Register in both app
registry.ts bootstrap functions
- Extend
createConfiguredStorageProvider if new pluginId / config type
- Add Vitest:
register.test.ts + provider behavior tests
- Do not add UI or depend on
@pixuli/ui from provider or core
ProviderContext
storageRegistry.create(pluginId, {
platform: 'web' | 'desktop' | 'mobile',
platformAdapter: new DefaultPlatformAdapter(),
});
Gitee-specific
- REF-607 P7：无 Host 图片代理；
buildPublicUrl / getRawUrl 返回公网 raw 直链
- 复制链接：
image.publicUrl || image.githubUrl || image.url
Verify
pnpm test --filter @pixuli/provider-github
pnpm test --filter @pixuli/provider-gitee
pnpm test --filter @pixuli/core
