dsh-llm-roster 0.0.0-stage → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/LICENSE +25 -0
  2. package/README.md +564 -2
  3. package/README.zh-CN.md +390 -0
  4. package/art/CREDITS.md +65 -0
  5. package/art/claude/chibi.webp +0 -0
  6. package/art/claude/face-chibi.webp +0 -0
  7. package/art/claude/face-high.webp +0 -0
  8. package/art/claude/face-middle.webp +0 -0
  9. package/art/claude/face-university.webp +0 -0
  10. package/art/claude/face.webp +0 -0
  11. package/art/claude/high.webp +0 -0
  12. package/art/claude/middle.webp +0 -0
  13. package/art/claude/university.webp +0 -0
  14. package/art/deepseek/chibi.webp +0 -0
  15. package/art/deepseek/face-chibi.webp +0 -0
  16. package/art/deepseek/face-high.webp +0 -0
  17. package/art/deepseek/face-middle.webp +0 -0
  18. package/art/deepseek/face-university.webp +0 -0
  19. package/art/deepseek/face.webp +0 -0
  20. package/art/deepseek/high.webp +0 -0
  21. package/art/deepseek/middle.webp +0 -0
  22. package/art/deepseek/university.webp +0 -0
  23. package/art/doubao/chibi.webp +0 -0
  24. package/art/doubao/face-chibi.webp +0 -0
  25. package/art/doubao/face-high.webp +0 -0
  26. package/art/doubao/face-middle.webp +0 -0
  27. package/art/doubao/face-university.webp +0 -0
  28. package/art/doubao/high.webp +0 -0
  29. package/art/doubao/middle.webp +0 -0
  30. package/art/doubao/university.webp +0 -0
  31. package/art/gemini/chibi.webp +0 -0
  32. package/art/gemini/face-chibi.webp +0 -0
  33. package/art/gemini/face-high.webp +0 -0
  34. package/art/gemini/face-middle.webp +0 -0
  35. package/art/gemini/face-university.webp +0 -0
  36. package/art/gemini/face.webp +0 -0
  37. package/art/gemini/high.webp +0 -0
  38. package/art/gemini/middle.webp +0 -0
  39. package/art/gemini/university.webp +0 -0
  40. package/art/glm/chibi.webp +0 -0
  41. package/art/glm/face-chibi.webp +0 -0
  42. package/art/glm/face-high.webp +0 -0
  43. package/art/glm/face-middle.webp +0 -0
  44. package/art/glm/face-university.webp +0 -0
  45. package/art/glm/high.webp +0 -0
  46. package/art/glm/middle.webp +0 -0
  47. package/art/glm/university.webp +0 -0
  48. package/art/gpt/chibi.webp +0 -0
  49. package/art/gpt/face-chibi.webp +0 -0
  50. package/art/gpt/face-high.webp +0 -0
  51. package/art/gpt/face-middle.webp +0 -0
  52. package/art/gpt/face-university.webp +0 -0
  53. package/art/gpt/face.webp +0 -0
  54. package/art/gpt/high.webp +0 -0
  55. package/art/gpt/middle.webp +0 -0
  56. package/art/gpt/university.webp +0 -0
  57. package/art/grok/chibi.webp +0 -0
  58. package/art/grok/face-chibi.webp +0 -0
  59. package/art/grok/face-high.webp +0 -0
  60. package/art/grok/face-middle.webp +0 -0
  61. package/art/grok/face-university.webp +0 -0
  62. package/art/grok/face.webp +0 -0
  63. package/art/grok/high.webp +0 -0
  64. package/art/grok/middle.webp +0 -0
  65. package/art/grok/university.webp +0 -0
  66. package/art/hunyuan/chibi.webp +0 -0
  67. package/art/hunyuan/face-chibi.webp +0 -0
  68. package/art/hunyuan/face-high.webp +0 -0
  69. package/art/hunyuan/face-middle.webp +0 -0
  70. package/art/hunyuan/face-university.webp +0 -0
  71. package/art/hunyuan/high.webp +0 -0
  72. package/art/hunyuan/middle.webp +0 -0
  73. package/art/hunyuan/university.webp +0 -0
  74. package/art/kimi/chibi.webp +0 -0
  75. package/art/kimi/face-chibi.webp +0 -0
  76. package/art/kimi/face-high.webp +0 -0
  77. package/art/kimi/face-middle.webp +0 -0
  78. package/art/kimi/face-university.webp +0 -0
  79. package/art/kimi/high.webp +0 -0
  80. package/art/kimi/middle.webp +0 -0
  81. package/art/kimi/university.webp +0 -0
  82. package/art/llama/chibi.webp +0 -0
  83. package/art/llama/face-chibi.webp +0 -0
  84. package/art/llama/face-high.webp +0 -0
  85. package/art/llama/face-middle.webp +0 -0
  86. package/art/llama/face-university.webp +0 -0
  87. package/art/llama/high.webp +0 -0
  88. package/art/llama/middle.webp +0 -0
  89. package/art/llama/university.webp +0 -0
  90. package/art/minimax/chibi.webp +0 -0
  91. package/art/minimax/face-chibi.webp +0 -0
  92. package/art/minimax/face-high.webp +0 -0
  93. package/art/minimax/face-middle.webp +0 -0
  94. package/art/minimax/face-university.webp +0 -0
  95. package/art/minimax/high.webp +0 -0
  96. package/art/minimax/middle.webp +0 -0
  97. package/art/minimax/university.webp +0 -0
  98. package/art/mistral/chibi.webp +0 -0
  99. package/art/mistral/face-chibi.webp +0 -0
  100. package/art/mistral/face-high.webp +0 -0
  101. package/art/mistral/face-middle.webp +0 -0
  102. package/art/mistral/face-university.webp +0 -0
  103. package/art/mistral/high.webp +0 -0
  104. package/art/mistral/middle.webp +0 -0
  105. package/art/mistral/university.webp +0 -0
  106. package/art/pack.json +88 -0
  107. package/art/perplexity/chibi.webp +0 -0
  108. package/art/perplexity/face-chibi.webp +0 -0
  109. package/art/perplexity/face-high.webp +0 -0
  110. package/art/perplexity/face-middle.webp +0 -0
  111. package/art/perplexity/face-university.webp +0 -0
  112. package/art/perplexity/high.webp +0 -0
  113. package/art/perplexity/middle.webp +0 -0
  114. package/art/perplexity/university.webp +0 -0
  115. package/art/qwen/chibi.webp +0 -0
  116. package/art/qwen/face-chibi.webp +0 -0
  117. package/art/qwen/face-high.webp +0 -0
  118. package/art/qwen/face-middle.webp +0 -0
  119. package/art/qwen/face-university.webp +0 -0
  120. package/art/qwen/high.webp +0 -0
  121. package/art/qwen/middle.webp +0 -0
  122. package/art/qwen/university.webp +0 -0
  123. package/cordis.patch.yml +3 -0
  124. package/data/aa-2026-11-10.json +1 -0
  125. package/data/openrouter-2026-11-10.json +1 -0
  126. package/package.json +48 -4
  127. package/packs/original.zip +0 -0
  128. package/plugin/client.js +4035 -0
  129. package/plugin/failures.js +121 -0
  130. package/plugin/index.js +58 -0
  131. package/plugin/models.json +80 -0
  132. package/plugin/packs.js +613 -0
  133. package/plugin/providers.js +217 -0
  134. package/plugin/rankings.js +261 -0
  135. package/plugin/roster.js +285 -0
  136. package/plugin/server.js +399 -0
  137. package/plugin/stars.js +99 -0
  138. package/plugin/thumbs.js +84 -0
  139. package/plugin/zip.js +102 -0
package/LICENSE ADDED
@@ -0,0 +1,25 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 RustColeone
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
22
+
23
+ The pictures in art/ are not covered by this license: they are adaptations of character designs by ZipZipPipe
24
+ (DeepSeek-chan, the original character, by 上善无形), shared under CC BY-NC-SA 4.0 (see art/CREDITS.md). data/
25
+ holds Artificial Analysis's data, used under their terms with credit to them.
package/README.md CHANGED
@@ -1,3 +1,565 @@
1
- # Temporary Holding Version
1
+ # dsh-llm-roster
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ English · [简体中文](README.zh-CN.md)
4
+
5
+ A gacha-style character roster for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). Your
6
+ models become characters: an avatar sits just left of the composer's model picker, and a click opens the roster, where
7
+ picking a card switches the session to that model.
8
+
9
+ DSH runs one agent on one model at a time, so there are no teams here. Picking a card does exactly what DSH's own
10
+ model picker does. The two share one model directory, so they always agree, and reasoning effort stays in DSH's picker.
11
+
12
+ ## Install
13
+
14
+ ```sh
15
+ dsh plugin --profile web add github:RustColeone/dsh-llm-roster
16
+ ```
17
+
18
+ The package's bundle patch adds the plugin to the profile (`- id: llm-roster`). Start DSH again (`dsh web`) and open
19
+ a conversation: the avatar is beside the model name under the message box.
20
+
21
+ ## What it shows
22
+
23
+ **The avatar.** The face of the session's model at its tier: each tier of each character has its own face, so you
24
+ can tell at a glance which model you are on. It is ringed in the tier's rarity colour, and it opens the roster.
25
+
26
+ **Roster.** Every model DSH's picker offers, plus the roster's lineup of mainstream models, each as a card with:
27
+
28
+ - the character's art for the model's tier, and the rarity of that tier;
29
+ - the model's Artificial Analysis Intelligence Index, and its rank among the models they measure;
30
+ - a **…** button that opens the character's page;
31
+ - a red **⚠** when a call to its model (or its provider's key) failed lately, with why on hover (see **Why calls
32
+ failed lately**, below).
33
+
34
+ A click on a ready card switches the session to that model. A card that can't be used yet says why:
35
+
36
+ | Card | Meaning |
37
+ | --- | --- |
38
+ | **Not available**: please add an API key | No key for the provider was found. A click opens the page where you can add one. |
39
+ | **API key rejected** | The provider refused the key when the roster asked it for usage. |
40
+ | **Not in use** | The key works, but the model isn't one of the provider's Used models yet. Its page adds it. |
41
+
42
+ Each key is tested by asking the provider for usage: its balance where it reports one, otherwise the models the key
43
+ can call. A result is kept for ten minutes, and the **Test key** button asks again. DeepSeek models need no key when
44
+ you're signed in to a DeepSeek account in DSH. They then come through the account, and a DeepSeek card's page lets
45
+ you choose the account or the API key instead.
46
+
47
+ The roster opens on **Available**: the models you can use now. **All** shows every character, with what each one
48
+ needs, and a provider's chip shows its models alone.
49
+
50
+ You can sort by provider, by rank, or by release date. By provider, a line with each provider's name (▸ DeepSeek ───)
51
+ heads its cards. **Divide by provider** turns the lines off and on again, and the roster keeps your choice in this
52
+ browser. DeepSeek's account and her API key are one provider there: each DeepSeek model is one card, through the one or
53
+ the other, and its card says which. In the release-date sort, newest comes first and each card
54
+ shows its date. A model's release date is, in this order:
55
+
56
+ 1. Artificial Analysis's, where they measure it.
57
+ 2. The day OpenRouter listed the model, whichever provider you use it through (Volcengine's
58
+ `doubao-seed-2-1-turbo-260628` gets OpenRouter's date for Seed 2.1 Turbo).
59
+ 3. For a lineup model neither of them lists, the date the roster gives it in
60
+ [`plugin/models.json`](plugin/models.json): the day its maker announced it (Seed 2.1 Pro, 2026-06-23).
61
+ 4. The date written in its id, if there is one (`claude-3-5-haiku-20241022`, or a build stamp like Volcengine's
62
+ `doubao-seed-2-1-pro-260628`).
63
+ 5. Otherwise, **the day the roster first saw it**, shown with a `~` (`~2026-11-12`). A model in none of the lists we
64
+ have can only be newer than them, so a "Claude Fable 5.5" turning up tomorrow counts as released tomorrow. That
65
+ day is kept in your DSH home, so it doesn't move, until Artificial Analysis or OpenRouter publish a date for the
66
+ model. Their date then replaces it.
67
+
68
+ The plugin ships snapshots of both lists, and **Fetch again** on the Rankings tab updates them. OpenRouter's list is
69
+ public, so its part needs no key. A character's page shows her release date under her name. One limit: a model that
70
+ OpenRouter has stopped listing, and that carries no date in its id, also gets the day it was first seen.
71
+
72
+ **A character's page** (the **…** button) has:
73
+
74
+ - **Showcase and gallery:** the big card art, and every picture the art pack has of the character (her four tiers,
75
+ and any more). Click one to preview it, then **Equip this art**.
76
+ - **Stats**, from Artificial Analysis:
77
+ - bars for the Intelligence Index and their six capability indexes (engineering, finance, economics, legal, health,
78
+ strategy & ops);
79
+ - her rank;
80
+ - the cost of one Intelligence Index task, and of the whole index;
81
+ - with a Pro key, the time and tokens a task takes;
82
+ - price, speed, and how long until the first answer token (thinking included);
83
+ - every effort they measured, with its index and cost per task.
84
+ - **Equipment:** the card art and the avatar, each changeable on its own. Pick any picture the art pack has, her own
85
+ listed first (her tiers' and any more in her folder), any other character's, or upload a picture (PNG, JPEG, WebP or
86
+ GIF, up to 4 MB). Your choices are changes to the pack in use, written into it when you export it (see **Art
87
+ packs**).
88
+ - **In the roster:** whether the model is Used or Ignored, with **Move to Ignored**.
89
+ - **Served through** (for a lineup model): which provider and key serve the character. The choices are her own
90
+ provider, OpenRouter, or an OpenAI-compatible endpoint of yours, and **+ OpenAI-compatible endpoint** adds one.
91
+ - Her models are matched by name among the ones that provider offers, so OpenRouter's `anthropic/claude-opus-5.5`
92
+ is Anthropic's `claude-opus-5-5`. A family name in front and a build stamp at the end don't count, so
93
+ Volcengine's `doubao-seed-2-1-turbo-260628` is Seed 2.1 Turbo (with several builds, the newest).
94
+ - A model it doesn't offer says **Not offered there**. So does a lineup model OpenRouter doesn't list, for a
95
+ character who comes through OpenRouter by default.
96
+ - So with only an OpenRouter key, every character can still be played: GPT, Claude, Kimi, GLM and the rest.
97
+ - **Provider:** the provider's key, with a test and the balance, and why its calls failed lately (this model's
98
+ marked).
99
+ - **Use this model**, or **Add and use this model** for one not in use yet.
100
+
101
+ **The + card** adds a model the lineup doesn't have. Choose a provider, or a new OpenAI-compatible endpoint (a
102
+ provider you haven't set up is added, with a key field). Type the model id or pick it from the catalog or the
103
+ provider's live list, give it a name, and choose its art and avatar. It joins the provider's Used models, so DSH's
104
+ picker offers it too.
105
+
106
+ **An OpenAI-compatible endpoint** is any service that speaks OpenAI's Chat Completions API: a relay, a gateway, or a
107
+ server of your own. Give it a name, its base URL and its key (or the environment variable holding it), let DSH find
108
+ its models, and choose the ones to use. It becomes a provider route in DSH's settings like any other, and its key is
109
+ stored write-only. The roster doesn't try to support every provider's own API itself: DSH already speaks them natively
110
+ (Anthropic Messages for Claude, Google's API for Gemini, Mistral's, OpenAI's Responses, Chat Completions for Kimi, GLM
111
+ and DeepSeek), and anything else can come in as an OpenAI-compatible key.
112
+
113
+ | Tier | Art | Rarity |
114
+ | --- | --- | --- |
115
+ | Chibi | a chibi | R |
116
+ | Middle-schooler | middle-school uniform | SR |
117
+ | High-schooler | high-school blazer | SSR |
118
+ | University student | grown-up, on campus | UR |
119
+
120
+ Those are the bundled art pack's names and pictures. Another pack can call the tiers anything (Squire, Page, Knight,
121
+ Paladin) and draw the characters any way: see **Art packs** below.
122
+
123
+ Fourteen characters ship, each with a card picture and a face for every tier:
124
+
125
+ - GPT, Claude, Gemini, DeepSeek and Grok, from their own providers;
126
+ - Kimi, GLM, Qwen, Mistral, MiniMax, Llama, Doubao, Perplexity and Hunyuan, through OpenRouter by default.
127
+
128
+ Doubao is ByteDance's Seed family. OpenRouter lists Seed 2.1 Turbo, 2.0 Code, 2.0 Lite and 2.0 Mini. ByteDance's
129
+ flagship, Seed 2.1 Pro, is only on its own cloud, Volcengine Ark, so its card says **Not offered there**. To play it,
130
+ add Ark as an OpenAI-compatible endpoint on Doubao's page (base URL `https://ark.cn-beijing.volces.com/api/v3`, your
131
+ Ark key) and send her through it. Ark's own ids, such as `doubao-seed-2-1-pro-260628`, are matched to the lineup and
132
+ keep its tiers. Artificial Analysis doesn't measure the Seed models, so their cards have no rankings.
133
+
134
+ [`plugin/models.json`](plugin/models.json) says which mainstream model is which character and tier (GPT-6 Luna a chibi, GPT-6.1
135
+ Sol a high-schooler, Claude Fable a university student, Kimi K3 a high-schooler and K3.1 Pro a university student, …),
136
+ and those models are the roster's lineup. A few more are named there by pattern (Kimi's K3 256K, `kimi-k3*256k*`, is
137
+ a chibi). Any other model is matched by its id (`gpt…`, `claude…`, `kimi…`, `glm…`, `qwen…`, `sonar…`, …, also
138
+ behind OpenRouter's `vendor/` prefix) or by its provider. It gets its tier from the words in its id: flash, mini and
139
+ haiku are chibis; pro and opus are high-schoolers; prime, fable and deep research are university students; and so on.
140
+
141
+ Last generation's models are left out until you choose them: Kimi for Coding's (`kimi-for-coding*`). A provider that
142
+ serves its whole catalog shows them under Ignored on Models & keys, and counts them below the cards; moving one to
143
+ Used brings its card back.
144
+
145
+ A provider that serves its whole catalog (OpenRouter with no model list, which has hundreds) shows only the models the
146
+ roster knows as characters. A note counts the rest, which DSH's picker still offers, and links to Models & keys to
147
+ choose the ones you use.
148
+
149
+ **Models & keys.** Each provider you have configured in DSH gets a card:
150
+
151
+ - **API key.** You can paste a key, which is stored write-only in DSH's credential store, exactly as DSH's Models page
152
+ stores it. Or you can name the environment variable that holds it, which sets the provider's `apiKeyEnv`. A dot says
153
+ whether the key is set and where it comes from. **Test key** asks the provider whether it works.
154
+ - **Balance**, for providers whose API reports one: DeepSeek, OpenRouter and Moonshot.
155
+ - **Spend or credit**, for OpenAI, Anthropic and xAI, shown under the API key as soon as the card opens. These
156
+ providers tell it only to a key allowed to read it, which usually may not call the models (an Anthropic
157
+ organization key needs a workspace DSH doesn't name), so it gets a field of its own, folded away under the API key
158
+ since it's seldom needed: **▸ Admin key (spend)** or **▸ Management key (credit)**, which says when one is set. It's
159
+ optional; paste it (stored write-only in DSH's credential store, like the API key)
160
+ or set its variable. The roster only reads with it; without one, it asks with the API key. A key that may not read it
161
+ shows nothing and isn't kept as a failure; its **Test key** says why, and which key it asked with.
162
+
163
+ | Provider | Shows | Spend key | Variable |
164
+ | --- | --- | --- | --- |
165
+ | OpenAI | spent this month (its Costs API) | an admin key, or a key with the `api.usage.read` permission | `OPENAI_ADMIN_KEY` |
166
+ | Anthropic | spent this month (its cost report) | an Admin key, or an organization-scoped key allowed to read costs | `ANTHROPIC_ADMIN_KEY` |
167
+ | xAI | prepaid credit left | a team's management key | `XAI_MANAGEMENT_KEY` (or `XAI_MANAGEMENT_API_KEY`) |
168
+
169
+ Google tells neither to any key: Gemini's spend is on AI Studio's and Google Cloud's billing pages only. A spend key
170
+ can do more than read costs; the roster only reads with it, and where the provider lets a key be limited (xAI's
171
+ management keys can be), limit it to billing.
172
+ - **Why calls failed lately**, below.
173
+ - **Used and Ignored models, as pills.** A click moves a model from one to the other.
174
+ - Used is the provider's model list in DSH's settings (`providers.<route>.models` for pi-ai providers, `models` for
175
+ DeepSeek), so the Used models are exactly what DSH's model picker and the roster offer. A provider with no list
176
+ uses its whole catalog until you first move one out.
177
+ - Ignored shows what **Fetch catalog** found: DSH's installed catalog, with no network call.
178
+ - Ignored is sorted newest first, each model with its release date (models of no known date last). A long list
179
+ such as OpenRouter's therefore opens on the models that just came out. **A–Z** sorts it by name instead. The
180
+ models found for a new OpenAI-compatible endpoint, and the + card's suggestions, come newest first too.
181
+ - **Fetch live list** asks the provider itself which models your key can call. That finds models newer than DSH's
182
+ catalog, such as Claude Fable 5.2 on its release day. Picture, speech and embedding models are left out.
183
+ - The small face on each Used pill changes that model's avatar.
184
+ - **Use all and Ignore all.**
185
+ - **For DeepSeek**, Ignore all leaves its model list empty, and Use all gives DSH's own list back.
186
+ - **For a pi-ai provider**, a provider with no model list serves its whole catalog. So Ignore all sets the provider
187
+ aside: it leaves DSH's settings, with its key reference and model list kept in the roster's file. **Use again**
188
+ puts it back exactly as it was.
189
+ - **Remove provider** takes a provider you added out of DSH's settings, after a confirmation. It can also delete the
190
+ key stored for it in DSH. Providers that are part of DSH's own setup can't be removed or set aside here.
191
+
192
+ **DeepSeek account** shows whether you're signed in. Signed in, DeepSeek's models need no API key, and the card shows
193
+ the account's balance (topped up and granted) as DSH itself reads it, the same as Settings → Account.
194
+
195
+ **Why calls failed lately.** The roster watches every model call DSH makes (it passes DSH's `llm/stream` along
196
+ untouched) and keeps the ones that failed, with why: DSH's code for it (key not accepted, out of quota or balance,
197
+ rate limited, timed out, …), the HTTP status and the provider's message, by provider and model. A failed key check is
198
+ kept too. They show on the provider's card in Models & keys, on a character's page (her model's marked), and as a red
199
+ **⚠** on a card. A call that succeeds again lets them go: that model's failures, and the ones that were the
200
+ provider's as a whole (its key, its balance, its rate, its service). **Clear** lets them go by hand. A call you stopped
201
+ is no failure. They are kept in DSH's home (`failures.json`, the newest 12 for each provider), with anything that looks
202
+ like a key in a provider's message hidden.
203
+
204
+ **Add a provider…** adds any provider DSH can route but you haven't set up yet, or a new OpenAI-compatible endpoint.
205
+ An endpoint's key is tested by DSH itself, which lists its models with the key it keeps.
206
+
207
+ The roster speaks English and Chinese, following DSH's language.
208
+
209
+ **Rankings.** Artificial Analysis's leaderboard: every model they measure, each listed once at its best effort, or
210
+ with **Every effort**, each effort as its own entry. The columns are:
211
+
212
+ - the Intelligence Index;
213
+ - the cost of one task of the index;
214
+ - with a Pro key, the time and the tokens a task takes;
215
+ - speed, price, and release date.
216
+
217
+ Click a column to sort by it, and again to reverse it. Type to find a model or its maker, and **In your roster**
218
+ narrows the list to your models, which are highlighted anyway. The plugin ships a snapshot (the date is shown).
219
+
220
+ Artificial Analysis no longer publishes a Coding or an Agentic index (their API returns both as empty), so the roster
221
+ shows their six capability indexes instead. Their free list has the cost of a task but not its time or tokens, which
222
+ are in their Pro list. With a Pro key, **Fetch again** reads the Pro list, and those two columns appear. The tokens of
223
+ a task are what it writes, reasoning included: the output part of a task's cost, divided by the price of an output
224
+ token.
225
+
226
+ **Fetch again** downloads the current list, which needs your own free key from
227
+ [artificialanalysis.ai](https://artificialanalysis.ai). Paste it on the Rankings tab, where it is stored write-only in
228
+ DSH's credential store like a provider's key. Or name the environment variable that holds it. Otherwise the roster
229
+ reads `ARTIFICIAL_ANALYSIS_API_KEY`, then `AA_API_TOKEN`. Their terms ask that they be credited wherever their data
230
+ appears, and the roster does.
231
+
232
+ **Summon.** A gacha has to have a gacha. Summon draws cards from the roster's own pool, just for fun. The ✦ are free,
233
+ nothing is bought and no model is called. A summoned character doesn't give you its model: using one still takes its
234
+ key. The pool is the lineup's models as characters (university students ★5, high-schoolers ★4, the rest ★3), plus 19
235
+ pieces of LLM-themed equipment (Infinite Context, No Rate Limit, Valid JSON, Em Dash, …), and the art pack's outfits:
236
+ every picture in the pack in use that no other card shows (Original's café, at-home and festival pictures, a tier's
237
+ card no model wears, the pictures you uploaded) is equipment too, ★4 unless the pack gives it other stars. The numbers
238
+ are Fate/Grand
239
+ Order's published summon rates:
240
+
241
+ | | Character | Equipment |
242
+ | --- | --- | --- |
243
+ | ★5 | 1% | 4% |
244
+ | ★4 | 3% | 12% |
245
+ | ★3 | 40% | 40% |
246
+
247
+ - A single summon costs 3 ✦. A ×10 costs 30 ✦ and deals 11 cards, at least one of them ★4 or better and at least
248
+ one a character.
249
+ - Each banner has a pickup ★5, which is 0.8% of that 1%. It is the newest university student unless you choose
250
+ another. You can add a pickup ★4, which is 1.5% of its 3%.
251
+ - If the pickup ★5 hasn't come in 329 summons on its banner, the 330th is it, once per banner.
252
+
253
+ **Free or Earned ✦.** In **Free** (where it starts) the ✦ are as many as you like. In **Earned** you have a balance,
254
+ and a summon spends from it. The ✦ come as you work in DSH: each model call that succeeds rolls once, and once more
255
+ for every 2,000 tokens it writes (its reasoning too, up to 25 rolls), so a long, high-effort call earns as its work
256
+ does. A roll may drop 1 ✦ (30%), 3 ✦ (6%) or 10 ✦ (1%), about 0.6 ✦ a roll. They're kept in DSH's home, so they come
257
+ while the roster is closed, and a rise shows by the balance when it does.
258
+
259
+ **Cheat codes**, in the **Cheat code** field (any case, spaces don't matter):
260
+
261
+ | Code | Does |
262
+ | --- | --- |
263
+ | `HESOYAM` | +25 ✦ |
264
+ | `showmethemoney` | +10 ✦ |
265
+ | `blacksheepwall` | reveals the whole album |
266
+
267
+ A summon plays out in two beats:
268
+
269
+ 1. **The charge.** The stars rush past and tokens stream into a ring that draws itself in. At the core, the ring's
270
+ light turns with a shockwave: rainbow, with rays, for a ★5 character; gold for a ★4 character or ★5 equipment.
271
+ Then it bursts into a flash.
272
+ 2. **The deal.** The cards fly out of the ring face down, their backs already glowing with what they are. They flip
273
+ one by one, and a light sweeps each card. A ★4 or ★5 pops and throws off stars, and a ★5 keeps a rainbow glow.
274
+
275
+ A click skips ahead. Each card you get goes into the album, and a summoned character opens its page.
276
+
277
+ **The album** has two parts, **Characters** and **Equipment** (the outfits among the equipment), each with how many
278
+ you have. Each art pack's outfits are its own, so switching packs shows that pack's. A picture you have (or every
279
+ one, revealed) opens over everything at a click. The wheel zooms where it points: the part of the picture under the
280
+ pointer stays under it. Drag to move it (two fingers pinch to zoom), and let go while moving to fling it on;
281
+ double-click to zoom in there or fit it again; **+**, **−** and **Fit** in the bar; ← → for the album's others. Every
282
+ zoom and move eases there (at once if your system asks for reduced motion). **×** (right after the zoom), a click
283
+ beside the picture, or Esc closes it.
284
+
285
+ **The feel.** Cards behave like boxed games on a shelf. Under the pointer a card lifts and leans toward it, a
286
+ glossy band and a highlight follow the pointer across it, and ★4 and ★5 cards have a foil that shifts as they lean.
287
+ The same goes for a character's big art, the album and the summon banner, whose art moves a little with the
288
+ pointer. All of this, and every animation, is off when your system asks for reduced motion.
289
+
290
+ **Art packs.** How the characters look, and what they and their tiers are called, come from an art pack. A pack
291
+ doesn't change who a model is (her character, her tier and its rarity, the lineup), only how she's dressed and named.
292
+ Two packs come with the roster, and are yours from the first time it starts:
293
+
294
+ - **Academy**, the student pack, in use until you choose another: every one of the fourteen characters from chibi to
295
+ middle-schooler, high-schooler and university student, drawn after ZipZipPipe's designs. It is also the bundled
296
+ pictures (`art/`): what any pack doesn't have comes from them.
297
+ - **Original**, an extra: every one of the fourteen characters in her art stages, the tiers (Stage 2, Stage 3, and
298
+ the awakened Stage 4), with her chibi as the chibi. Her bond pictures (a café, at home, a summer festival) are more
299
+ cards to choose from on her page, and her mood faces (happy, calm, worried, sad) more avatars. The first five (GPT,
300
+ Claude, Gemini, DeepSeek and Grok) are as ChimeraArchiveHarness first drew them; the other nine were drawn for this
301
+ pack with the same prompts. It ships as [`packs/original.zip`](packs). (A roster before 0.5.3 added it as **Original Students**,
302
+ with the first five alone; that one stays in your packs until you remove it.)
303
+
304
+ **Switch packs on the go** with the **Art pack** menu on the Roster tab, or start a **New empty pack** there. Every
305
+ card, avatar, gallery and the summon change at once. The **Art packs** tab lists your packs:
306
+
307
+ - **Use** one.
308
+ - **Export .zip** saves one, with your changes to it (below).
309
+ - **Remove** deletes one. A pack that comes with the roster stays removed until you add it again under **Comes with
310
+ the roster**. When an update of the roster brings a newer version of it, the button there says **Update**.
311
+ - **Import a .zip or pack.json** adds one.
312
+ - **Fetch** adds one from a link: a GitHub repository (`https://github.com/you/your-pack`), a folder in one
313
+ (`…/tree/main/packs/knights`), a .zip on GitHub (`…/blob/main/packs/knights.zip`), or any link to a .zip.
314
+
315
+ Importing a pack of the same name again replaces it, which is how you update one.
316
+
317
+ **Your changes.** On a character's page you choose the card and the avatar of a model: any picture of the pack's, or
318
+ one you upload. A pack is never written to once you have it, so it can't be broken. What you choose and upload is
319
+ kept beside it, as your changes to that pack, and worn over it. The pack's card on the Art packs tab says how many
320
+ there are. **Export .zip** writes them into the export:
321
+
322
+ - its `pack.json` names the pictures you chose for each model,
323
+ - and the .zip holds every picture: the pack's own, the ones you uploaded, and any bundled picture you chose.
324
+
325
+ So if a pack has ten pictures of DeepSeek and you choose the second for DeepSeek V4 Pro, the exported `pack.json` has
326
+ `"deepseek-v4-pro": { "art": "deepseek/image2.webp" }` and the .zip has all ten. **Discard changes** lets them go,
327
+ and the pack is as it came.
328
+
329
+ A pack is a folder: a `pack.json` that names every picture by its file, and folders of pictures, one per character.
330
+
331
+ ```
332
+ knights/
333
+ pack.json
334
+ claude/
335
+ knight.png her card at the high tier (which pack.json says)
336
+ knight-face.png her avatar there
337
+ opus.png any more pictures: more to choose from on her page
338
+ festival.png
339
+ deepseek/
340
+ image1.webp … image10.webp
341
+ face-2.webp
342
+ ```
343
+
344
+ ```json
345
+ {
346
+ "name": "Knights",
347
+ "zh-CN": "骑士团",
348
+ "version": "1.0.0",
349
+ "author": "you",
350
+ "license": "CC BY 4.0",
351
+ "description": { "name": "The roster as an order of knights.", "zh-CN": "把名册变成骑士团。" },
352
+ "tiers": {
353
+ "chibi": "Squire",
354
+ "middle": { "name": "Page", "zh-CN": "侍从" },
355
+ "high": { "name": "Knight", "zh-CN": "骑士" },
356
+ "university": { "name": "Paladin", "zh-CN": "圣骑士" }
357
+ },
358
+ "characters": {
359
+ "claude": {
360
+ "name": "Sir Claude",
361
+ "zh-CN": "克劳德爵士",
362
+ "art": { "high": "claude/knight.png" },
363
+ "face": { "high": "claude/knight-face.png" }
364
+ }
365
+ },
366
+ "models": {
367
+ "deepseek-v4-pro": { "art": "deepseek/image2.webp", "face": "deepseek/face-2.webp" },
368
+ "claude-opus-*": { "art": "claude/opus.png" }
369
+ },
370
+ "pictures": {
371
+ "claude/festival.png": { "name": "Summer festival", "zh-CN": "夏日祭", "stars": 5 }
372
+ }
373
+ }
374
+ ```
375
+
376
+ - **Every picture is named by its file,** one folder deep (`claude/knight.png`): `.webp`, `.png`, `.jpg` or `.gif`.
377
+ Or by a pattern, as `ls` takes one: `*` for any run of characters and `?` for one, neither across a `/`; `[abc]`
378
+ for one of them, `[!abc]` for none of them. It is the first file that matches, in `ls` order (`b10.png` before
379
+ `b2.png`): the pack's own pictures (and yours) first, else the bundled ones. So `deepseek/image*.webp` is
380
+ `deepseek/image1.webp`, and `*/opus.png` the first folder's `opus.png`.
381
+ - **`characters`**: each character's name, and her card (`art`) and avatar (`face`) at each tier (`chibi`, `middle`,
382
+ `high`, `university`).
383
+ - **`models`**: a model's own card and avatar, either or both, by its id (`deepseek-v4-pro`) or by a pattern
384
+ (`claude-opus-*` is every Opus, the ones still to come included; `*-flash` every Flash; `gpt-6.[01]-*`). The first entry that fits a model, in the order they are written, is its; the
385
+ pictures you choose come before them all. A model none fits wears its character's at its tier. An id fits as the
386
+ provider writes it or as the roster matches models (`gpt-6.1-*` and `gpt-6-1-*` are the same).
387
+ - **The pictures in a character's folder are hers to choose** on her page: in her gallery, and first under **Change**
388
+ for her card and her avatar. A picture whose file name starts with `face` is an avatar; any other is a card. The
389
+ folders are named after the characters: `gpt`, `claude`, `gemini`, `deepseek`, `grok`, `kimi`, `glm`, `qwen`,
390
+ `mistral`, `minimax`, `llama`, `doubao`, `perplexity` and `hunyuan`.
391
+ - **`pictures`** names a picture, by its file; else it is called by its file's name (`image2.webp` is Image2). Its
392
+ `stars` (3, 4 or 5) are its rarity as an outfit in the summon (else ★4). A character's mood faces and avatars are no
393
+ outfits.
394
+ - **Names** are a plain string, or a `name` with other languages beside it by their language codes: `zh-CN`, `zh-TW`,
395
+ `ja`, … in any case. A page in Chinese takes `zh-CN`, else a plain `zh`, else another Chinese one, else `name`. The
396
+ pack's own name and its `description` are given the same way.
397
+ - **`version`** is the pack's own, shown beside its name; for a pack that comes with the roster, it is how the roster
398
+ tells that an update brought a newer one. `roster` is the roster's version it was exported from, written in on
399
+ export.
400
+ - **Nothing has to be there.** A tier's name, a character's name or picture the pack doesn't have comes from the
401
+ bundled pictures (Academy). A new empty pack wears them all until you choose.
402
+ - **A mistake is said, not hidden.** A file that is not there, a pattern no file matches, or something that is no
403
+ picture's file at all is listed on the pack's card on the Art packs tab (`models.gpt-6-astra.art: "claude/zzz*.png"
404
+ matches no picture`), and that line is worn as if it were not written.
405
+
406
+ **Picture sizes.** Any size works: a picture is scaled and cropped to fill its place. These keep the crop where you
407
+ want it:
408
+
409
+ | Picture | Ratio | Suggested size | What shows |
410
+ | --- | --- | --- | --- |
411
+ | A card | 2:3, portrait | 768 × 1152 to 1024 × 1536, as the bundled ones (sharp on high-DPI screens and in the album's viewer) | The whole card on her page. On the roster's cards the rarity sits top left and her name over the bottom quarter, so keep her face in the upper third. Another ratio is cropped to 2:3, keeping the top. |
412
+ | A chibi card | 2:3, transparent background | 512 × 768 to 1024 × 1536 | The figure standing in the lower half, as the bundled chibis do. |
413
+ | An avatar | 1:1, square | 256 × 256, as the bundled ones (192 × 192 at least) | A circle. Keep the face centred, with a little room around it; another ratio is cropped around a point 30% from the top. |
414
+
415
+ `.webp` keeps packs smallest (the bundled cards are about 100–450 KB each, at quality 86); `.png`, `.jpg` and `.gif`
416
+ work too. A picture in a .zip is at most 16 MB, and one you upload at most 4 MB.
417
+
418
+ **Thumbnails.** Where pictures show small (the roster's cards, the album, the summon's cards, the pickers), the roster
419
+ sends a thumbnail 320 wide, made from the picture with [sharp](https://sharp.pixelplumbing.com) and kept in DSH's home
420
+ (`llm-roster/thumbs/`). A pack's are made in the background as it is added or chosen, any other as it is first shown;
421
+ a picture that changes gets a new one. Her page, the summon's banner and the album's viewer show the picture itself.
422
+ sharp is an optional dependency, installed with the roster where it has a build for the machine (Linux, macOS and
423
+ Windows on x64 and Arm); without it, every picture is sent whole.
424
+
425
+ To make a pack by hand, export one (or start a new empty one, choose pictures and export it), change what you like,
426
+ zip it again and import it. To share a pack, put its folder on GitHub; anyone can fetch it by its link. Your packs are
427
+ kept in `~/.dsh/llm-roster/packs/<name>/` and your changes in `~/.dsh/llm-roster/changes/<name>/`; a pack's files can
428
+ be edited there too, and the roster shows them the next time it opens.
429
+
430
+ **A new character.** A pack dresses the characters the roster knows; it can't add one. Who the characters are, which
431
+ models are each one's and at which tier, is the roster's own list, [`plugin/models.json`](plugin/models.json), and you
432
+ can add to it yourself. Add her under `characters`, with her home provider, the patterns of her model ids and her
433
+ providers, and put her models in `lineup` by tier (a model you don't want as a card of its own, by id or pattern, in
434
+ `models`; one to leave out until chosen in `ignored`):
435
+
436
+ ```json
437
+ "characters": {
438
+ "phi": { "home": "openrouter", "vendor": "microsoft", "match": ["^phi"], "providers": ["azure"] }
439
+ },
440
+ "lineup": {
441
+ "phi-5": "phi/high"
442
+ }
443
+ ```
444
+
445
+ Then give her pictures and a name in a pack (`"characters": { "phi": { "name": "Phi", "art": { "high": "phi/high.webp" } } }`).
446
+ Until a pack draws her, her cards show her initials. The file is the installed plugin's
447
+ (`~/.dsh/profiles/web/node_modules/dsh-llm-roster/plugin/models.json`), and an update of the roster replaces it, so
448
+ keep a copy of your changes, or send them as a pull request.
449
+
450
+ Models & keys, Rankings and Art packs are also on DSH's Plugins page, under **dsh-llm-roster**.
451
+
452
+ ## Settings
453
+
454
+ In the profile's patch, `~/.dsh/profiles/web/cordis.patch.yml`:
455
+
456
+ ```yaml
457
+ - id: llm-roster
458
+ config:
459
+ aliases: # a model Artificial Analysis lists under another name
460
+ my-gateway/fast-one: gpt-6-luna
461
+ aaKeyEnv: MY_AA_KEY # where your Artificial Analysis key is (one named on the Rankings tab wins;
462
+ # then ARTIFICIAL_ANALYSIS_API_KEY, AA_API_TOKEN)
463
+ ```
464
+
465
+ ## Where things are kept
466
+
467
+ Everything about your providers is in DSH's own settings and credential store; the roster keeps nothing of it.
468
+ The roster keeps its own files in `$DSH_HOME/llm-roster/` (`~/.dsh/llm-roster/`):
469
+
470
+ | File | What it holds |
471
+ | --- | --- |
472
+ | `roster.json` | the art pack in use, the provider each character goes through, the providers you set aside with Ignore all (as they were in DSH's settings), the packs that came with the roster already added once, and the variable your Artificial Analysis key is in, if you named one |
473
+ | `packs/<name>/` | your art packs, each as its folder (`pack.json` and folders of pictures), as you got them: the ones that came with the roster, new empty ones, and the ones you imported or fetched |
474
+ | `changes/<name>/` | your changes to a pack: the pictures you chose for models (a `pack.json` of `models`) and the ones you uploaded |
475
+ | `aa.json` | the rankings, once fetched again |
476
+ | `openrouter.json` | the release dates from OpenRouter, once fetched again |
477
+ | `seen.json` | the day each model with no published release date was first seen (let go once one is published) |
478
+ | `failures.json` | why calls failed lately, by provider and model, until a call succeeds again |
479
+ | `stars.json` | the summon's Earned ✦: the balance, and how many were earned in all |
480
+ | `thumbs/` | the pictures' thumbnails (the newest 2,000), each named by its picture's file, size and time |
481
+
482
+ What you summon is kept in your browser instead (`localStorage`, under `dsh-llm-roster.summon`), so each browser has
483
+ its own album (the Earned ✦ are DSH's, in `stars.json`, so every browser shares them).
484
+
485
+ ## How it works
486
+
487
+ | File | What it does |
488
+ | --- | --- |
489
+ | [`plugin/client.js`](plugin/client.js) | The web half (React from DSH). It puts the avatar in the `conversation.input.right` slot and renders the roster dialog and the Plugins page. It switches models through `modelDirectories.directoryFor(session).select()`. It writes model lists and `apiKeyEnv` with `remote.settings.mutate`, stores keys with `remote.credentials.set`, and reads catalogs with `remote.llm.discoverModels`. |
490
+ | [`plugin/index.js`](plugin/index.js) | The DSH plugin (`llm-roster`). It mounts the routes on DSH's API, resolves keys through DSH's credential store, then the environment, and watches DSH's model calls (`llm/stream`, passed along untouched) for why they fail. |
491
+ | [`plugin/stars.js`](plugin/stars.js) | The summon's Earned ✦: dropped by model calls that work, spent on summons, added by cheat codes. |
492
+ | [`plugin/thumbs.js`](plugin/thumbs.js) | The pictures' thumbnails, made with sharp (when it is installed) and kept in DSH's home. |
493
+ | [`plugin/failures.js`](plugin/failures.js) | Why calls failed lately: kept by provider and model, counted, let go when a call succeeds again. |
494
+ | [`plugin/server.js`](plugin/server.js) | The routes, below. |
495
+ | [`plugin/roster.js`](plugin/roster.js) | Which character and tier each model is, the lineup, the picture and avatar each one wears, the pack in use, set-aside providers, and the provider each character goes through. |
496
+ | [`plugin/models.json`](plugin/models.json) | Who each model is: each character's ids, providers and home provider, the lineup by tier, more models by pattern, the ones left out until chosen, the words that tell a tier, and the release dates of lineup models no list has. |
497
+ | [`plugin/packs.js`](plugin/packs.js) | Art packs: reading one (its names and pictures by file, with your changes over it, over the bundled pictures), keeping one from a .zip or a GitHub link, adding the ones that come with the roster, making an empty one, your changes, and exporting a pack with them. |
498
+ | [`plugin/zip.js`](plugin/zip.js) | .zip files, read and written with Node's own zlib: no file outside the archive, no encrypted or ZIP64 entries, and size limits. |
499
+ | [`plugin/rankings.js`](plugin/rankings.js) | The Artificial Analysis list: matching a model to its slug, ranks, the leaderboard, and fetching the list again (the Pro list with a Pro key). |
500
+ | [`plugin/providers.js`](plugin/providers.js) | Each provider's balance, spend (with a key allowed to read it) and live-list endpoints, at fixed official addresses, and the key check built on them. |
501
+ | [`art/`](art) | The bundled art pack, *Academy*: [`pack.json`](art/pack.json) and a folder of pictures per character. Credits are in [`art/CREDITS.md`](art/CREDITS.md). |
502
+ | [`packs/`](packs) | The packs that come with the roster, as .zip files: [`original.zip`](packs/original.zip), made by [`original-pack.py`](tools/original-pack.py). Its credits are in the .zip (`CREDITS.md`). |
503
+ | [`tools/`](tools) | [`import-art.py`](tools/import-art.py) brings in the five ChimeraArchiveHarness characters. [`draw-art.py`](tools/draw-art.py) draws the others from [`characters.yml`](tools/characters.yml) with OpenAI's image model (Academy's tiers, and with `--original` the Original pack's stages, bond pictures and mood faces). [`original-pack.py`](tools/original-pack.py) makes the Original pack. [`aa-snapshot.mjs`](tools/aa-snapshot.mjs) refreshes the rankings and release-date snapshots. |
504
+ | [`data/`](data) | The shipped snapshots: Artificial Analysis's rankings, and OpenRouter's release dates. |
505
+
506
+ Keys never reach the page. A key check, a balance or a live list is asked by the server, using the key DSH resolves
507
+ for the provider's credential reference. It is sent only to that provider's official address, never to an address the page
508
+ names. An OpenAI-compatible endpoint of yours is asked by DSH itself, at the address in its settings.
509
+
510
+ The routes are on DSH's API, behind its sign-in and for its owner only:
511
+
512
+ | Route | |
513
+ | --- | --- |
514
+ | `GET /api/llm-roster.state` | the tiers and characters as the art pack in use names and pictures them, the pack, the lineup, your uploads, set-aside providers, the rankings' date and key names, what each provider offers |
515
+ | `POST /api/llm-roster.resolve` | `{models: [{provider, id}]}` → each one's art, avatar, character, tier, name and rankings |
516
+ | `POST /api/llm-roster.pick` | `{model: 'provider/model', art?: 'deepseek/image2.webp' \| null, face?: 'deepseek/face-2.webp' \| null}`: a change to the pack in use |
517
+ | `POST /api/llm-roster.upload?name=&character=` | the picture as the body → `{file}`, added to the pack in use as a change |
518
+ | `POST /api/llm-roster.forget` | `{file}`: a picture you added, taken back |
519
+ | `POST /api/llm-roster.settings` | `{aaKeyEnv: '<variable>' \| null}`: where your Artificial Analysis key is |
520
+ | `POST /api/llm-roster.park` / `unpark` | `{provider, ns, path, profile}` / `{provider}`: a provider set aside by Ignore all, and put back |
521
+ | `POST /api/llm-roster.route` | `{character, provider \| null}`: the provider a character's lineup goes through |
522
+ | `GET /api/llm-roster.image` | `?art=<folder>/<file>` (a picture of the pack in use, `deepseek/high.webp`; `&pack=<id>` for another pack's); `&size=thumb` for its thumbnail |
523
+ | `GET /api/llm-roster.packs` | the art packs you have, the one in use, and the ones that come with the roster |
524
+ | `POST /api/llm-roster.packs` | `{use: id}`, `{create: name}`, `{remove: id}`, `{discard: id}` (your changes to it), `{fetch: '<GitHub or .zip link>'}`, or `{add: 'academy' \| '<file>'}` for one that comes with the roster |
525
+ | `POST /api/llm-roster.pack-import?name=` | a pack's .zip, or a lone `pack.json`, as the body |
526
+ | `GET /api/llm-roster.pack-export?id=` | the pack as a .zip, with your changes to it |
527
+ | `GET /api/llm-roster.released` | every release date known, by model slug (Artificial Analysis's over OpenRouter's), and the days models were first seen |
528
+ | `POST /api/llm-roster.released` | `{ids}` → `{dates: {id: {date, seen}}}`: the release dates of a list of models, a model of no published date stamped as first seen today |
529
+ | `GET/POST /api/llm-roster.rankings` | the leaderboard (`?top=`, `&sort=released` for the newest, `&efforts=1` for every effort), or fetch the release dates and the rankings again |
530
+ | `GET/POST /api/llm-roster.stars` | the summon's Earned ✦ (`{balance, earned, last}`); `{spend: n}` for a summon, `{code}` for a cheat code |
531
+ | `GET/POST /api/llm-roster.failures` | why calls failed lately, the newest first; `{clear: provider \| null}` lets them go |
532
+ | `GET /api/llm-roster.check` | `?provider=<route>&ref=<credential reference>&fresh=1`: does the key work (`ok`, `missing`, `rejected`, `error`, `untested`) |
533
+ | `GET /api/llm-roster.balance` | `?provider=<route>&ref=<credential reference>` |
534
+ | `GET /api/llm-roster.usage` | `?provider=<route>&ref=<credential reference>&fresh=1`: what the account spent this month, or has left, read with the spend key, else the API key (`ok` with `spent` and/or `credit` and the `key` read with, `missing`, `rejected`, `error`, `untested`) |
535
+ | `GET /api/llm-roster.live` | `?provider=<route>&ref=<credential reference>` |
536
+
537
+ ## Development
538
+
539
+ ```sh
540
+ npm install # sharp, for the thumbnails (optional: their tests are skipped without it)
541
+ npm test # node --test: the server half, art packs and the summon odds, no DSH or network needed
542
+ python3 tools/import-art.py ~/Projects/DiscordStudyBot # art/ again from a ChimeraArchiveHarness checkout
543
+ python3 tools/draw-art.py --dry-run # the other characters' tiers: what it would draw
544
+ python3 tools/draw-art.py --env-file .env # draw what is missing (OPENAI_API_KEY; needs openai, pillow, pyyaml)
545
+ python3 tools/draw-art.py --faces-only # crop the avatars again after tuning `faces` in characters.yml
546
+ python3 tools/draw-art.py --original --env-file .env # the other characters' Original pictures
547
+ python3 tools/original-pack.py ~/Projects/DiscordStudyBot # packs/original.zip again (needs pillow)
548
+ AA_API_TOKEN=... node tools/aa-snapshot.mjs # new snapshots in data/ (release dates even with no key)
549
+ ```
550
+
551
+ To add a character, give her an entry in [`tools/characters.yml`](tools/characters.yml) (her standing art, look,
552
+ motif and role). Then add her to [`plugin/models.json`](plugin/models.json) (her home provider, the ids that are hers,
553
+ and her lineup by tier) and her name to [`art/pack.json`](art/pack.json). Draw her with `draw-art.py`, and check her
554
+ faces.
555
+
556
+ For a local checkout, `dsh plugin --profile web add link:/path/to/dsh-llm-roster` uses it in place.
557
+
558
+ ## License
559
+
560
+ - **Code:** [MIT](LICENSE).
561
+ - **Art (`art/` and the packs in `packs/`):** CC BY-NC-SA 4.0, so non-commercial only. These are AI-generated adaptations of character
562
+ designs by [ZipZipPipe](https://space.bilibili.com/4168597/). DeepSeek-chan, the original character, is by
563
+ [上善无形](https://space.bilibili.com/4456176). See [`art/CREDITS.md`](art/CREDITS.md).
564
+ - **Data (`data/`):** the rankings are Artificial Analysis's, used under their terms with credit to them; the release
565
+ dates are from OpenRouter's public model list.