# Trueloving Pixuli Pixuli

> Storage Provider

- Skill: `tomevault-io/trueloving-pixuli-pixuli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/trueloving-pixuli-pixuli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/trueloving-pixuli-pixuli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/trueloving-pixuli-pixuli

---


# 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

1. Read `docs/02-system-design/03-plugin-system.md` §第二部分
2. In provider package: `manifest.ts`（含可选 `hostIntegrations`）→
   `*StorageProvider.ts` → `register.ts` → `package.json` `exports`（REF-416：
   `development` + `dist`）
3. Register in both app `registry.ts` bootstrap functions
4. Extend `createConfiguredStorageProvider` if new `pluginId` / config type
5. Add Vitest: `register.test.ts` + provider behavior tests
6. **Do not** add UI or depend on `@pixuli/ui` from provider or core

## ProviderContext

```typescript
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

```bash
pnpm test --filter @pixuli/provider-github
pnpm test --filter @pixuli/provider-gitee
pnpm test --filter @pixuli/core
```

---
> Source: [trueLoving/Pixuli](https://github.com/trueLoving/Pixuli) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-29 -->