cortico-world-extra-actions 0.3.0 → 0.3.2

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.
package/README.md CHANGED
@@ -173,15 +173,23 @@ export default [
173
173
  | 路径 | 作用 |
174
174
  |---|---|
175
175
  | `src/index.js` | World 定义(`id` / `label` / `defaults` / `create` / `describe`) |
176
- | `src/world.js` | 面板方法、形象包发现、保存/清空/重载、合并清单、参数校验 |
176
+ | `src/world.js` | 面板方法、形象包发现、保存/清空、扫库清单、参数校验 |
177
177
  | `src/writer.js` | 纯落盘逻辑 + 注入面防护(面板和命令行共用) |
178
- | `src/importer.js` | 「添加更多动作」:校验一套帧、收进动作库、追加清单 |
179
- | `src/pet.js` | 本地桌宠服务的**只读**客户端(/api/state、/api/figures) |
178
+ | `src/importer.js` | 「添加更多动作」:校验一套帧、收进动作库、重建清单 |
179
+ | `src/starter.js` | 自带素材落地 + 「恢复空的形象包」 |
180
+ | `src/pet.js` | 本地桌宠服务的**只读**客户端(`/api/state`、`/api/figures`) |
180
181
  | `dist/webui.js` | 面板(无 import 的纯 ESM,`export default { panels: { picker } }`) |
181
- | `assets/catalog.json` | 105 个动作的清单 + 缩略图(data URL) |
182
- | `tools/extra-actions-cli.mjs` | 命令行 |
183
- | `tools/test_writer.mjs` / `test_security.mjs` / `test_importer.mjs` / `test_blob_path.mjs` | 自测:保存语义、注入面、导入、播放器 |
184
- | `tools/test_world.mjs` / `verify_installed.mjs` | 对真机:协议应答、装好的包是否只做勾选的 |
185
- | `tools/install-extension.mjs` | 一键装到 Coopanion |
186
-
187
- 许可:MIT。素材来自 `MerZlin/dsh-pet-indesktop`(角色与动画),形象包代码与封装来自 DSH-PET 工作区。
182
+ | `assets/catalog.json` | 105 段动作的清单 + 缩略图 |
183
+ | `assets/starter/` | 自带的形象包与示例动作库(首次启动落地) |
184
+ | `assets/icon.webp` | 扩展封面(`cortico.icon`) |
185
+ | `tools/install-extension.mjs` | 装到 Coopanion(拷包 + link 依赖 + junction),需要 `--extensions` |
186
+ | `tools/extra-actions-cli.mjs` | 命令行:list / state / save / remove / clear / add / prune / reindex |
187
+ | `tools/check-registered.mjs` | 自检:宿主能不能按 name 解析到这个包、config 里有没有它 |
188
+ | `tools/verify_installed.mjs` | 对真机:装好的包是不是只做勾选的那些 |
189
+ | `tools/test_writer.mjs` | 保存 / 删除 / 清空 / 瘦身的落盘语义 |
190
+ | `tools/test_security.mjs` | 注入面:路径、白名单、符号链接 |
191
+ | `tools/test_importer.mjs` | 「添加更多动作」 |
192
+ | `tools/test_catalog.mjs` | 清单以磁盘为准、index 可重建 |
193
+ | `tools/test_panel_guard.mjs` | 面板模板缺节点会当场报错 |
194
+ | `tools/test_starter.mjs` | 自带素材的首次落地 |
195
+ | `tools/test_restore.mjs` | 「恢复空的形象包」与查重 |
package/dist/webui.js CHANGED
@@ -214,13 +214,13 @@ const panel = {
214
214
  </div>
215
215
  <div class="tools">
216
216
  <span class="ea-badge" data-role="badge"><span class="dot"></span>准备中</span>
217
- <button class="ea-btn" data-act="reload">重新加载形象</button>
218
- </div>
217
+ </div>
219
218
  </div>
220
219
  <div class="ea-bar">
221
220
  <select class="ea-sel" data-role="pack"></select>
222
221
  <input class="ea-inp" data-role="q" placeholder="搜名字 / id…">
223
222
  <button class="ea-btn" data-act="library">选择动作库…</button>
223
+ <button class="ea-btn" data-act="restore-pack" title="创建一个空的深深形象包(只有身体状态)">恢复空的形象包</button>
224
224
  <span class="ea-lib" data-role="lib"></span>
225
225
  </div>
226
226
  <div class="ea-note" data-role="note" hidden></div>
@@ -262,7 +262,7 @@ const panel = {
262
262
  const REQUIRED = [
263
263
  '[data-role=pack]', '[data-role=q]', '[data-role=lib]', '[data-role=note]',
264
264
  '[data-role=installed]', '[data-role=chips]', '[data-role=list]', '[data-role=sum]',
265
- '.ea-foot', '[data-act=save]', '[data-act=clear]', '[data-act=add]', '[data-act=prune]', '[data-act=library]',
265
+ '.ea-foot', '[data-act=save]', '[data-act=clear]', '[data-act=add]', '[data-act=prune]', '[data-act=library]', '[data-act=restore-pack]',
266
266
  ];
267
267
  const missing = REQUIRED.filter((sel) => !wrap.querySelector(sel));
268
268
  if (missing.length) throw new Error('面板模板缺少节点:' + missing.join(', '));
@@ -289,7 +289,7 @@ const panel = {
289
289
  const list = (state?.figures ?? []).filter((f) => f.supported && !f.builtin);
290
290
  packSel.innerHTML = '';
291
291
  if (!list.length) {
292
- packSel.appendChild(el('option', null, '没有可写的形象包'));
292
+ packSel.appendChild(el('option', null, '没有可写的形象包(点「恢复空的形象包」)'));
293
293
  packSel.disabled = true;
294
294
  return;
295
295
  }
@@ -531,7 +531,7 @@ const panel = {
531
531
  state = await ctx.invoke('state');
532
532
  const p = state.figures?.find((f) => f.id === packId);
533
533
  selected = new Set(r.copied.concat(r.skipped).filter((id) => catalog.actions.some((a) => a.id === id)));
534
- say(`已写入 ${r.count} 段,${mb(r.bytes)};词表 +${r.vocab.added.length} −${r.vocab.removed.length}${r.reloaded ? ',桌宠已重新加载' : ''}`);
534
+ say(`已写入 ${r.count} 段,${mb(r.bytes)};词表 +${r.vocab.added.length} −${r.vocab.removed.length};去装扮页重新点一下这个形象才会生效`);
535
535
  libEl.textContent = state.library.ok ? `${state.library.count} 段可用` : '动作库未设置';
536
536
  renderPack(); packSel.value = packId; renderList(); renderInstalled(); renderSum(); renderNote();
537
537
  if (p) p.extra = { ids: [...selected], count: r.count, bytes: r.bytes, updatedAt: r.updatedAt };
@@ -567,6 +567,18 @@ const panel = {
567
567
  ? `已删除「${a?.zh ?? id}」,包里没有额外动作了,词表已还原`
568
568
  : `已删除「${a?.zh ?? id}」,还剩 ${r.remaining} 段`);
569
569
  renderPack(); packSel.value = packId; renderList(); renderInstalled(); renderSum(); renderNote();
570
+ } else if (act === 'restore-pack') {
571
+ if (!confirm('在形象包目录里创建一个「空的深深形象包」?\n\n只有 4 段身体状态,没有额外动作、词表空。\n如果已经有同 id 的包,只检查并补齐缺失文件,不会再建第二个。')) return;
572
+ busy(true); say('正在准备形象包…');
573
+ const r = await ctx.invoke('restore-pack', []);
574
+ if (r.created) say('已创建空的深深形象包');
575
+ else if (r.repaired) say('形象包缺文件,已补齐');
576
+ else say('形象包已存在,没有重复创建');
577
+ if (r.duplicates && r.duplicates.length) {
578
+ say(`另外发现 ${r.duplicates.length} 个重复的同 id 包,请手动删掉:` + r.duplicates.map((p) => String(p).split(/[\\/]/).pop()).join('、'), true);
579
+ }
580
+ await loadAll();
581
+ if (r.dir) { packSel.value = r.dir; renderNote(); renderList(); renderInstalled(); renderSum(); }
570
582
  } else if (act === 'add') {
571
583
  let dir = null;
572
584
  try {
@@ -586,11 +598,6 @@ const panel = {
586
598
  ? r.added.map((x) => `${x.zh}(${x.frames} 帧 / ${x.seconds}s)`).join('、')
587
599
  : (r.skipped.map((x) => `${x.dir}:${x.reason}`).join(';') || '');
588
600
  }
589
- } else if (act === 'reload') {
590
- if (!packId) return;
591
- busy(true);
592
- await ctx.invoke('reload', [packId]);
593
- say('桌宠已重新加载形象');
594
601
  } else if (act === 'library') {
595
602
  // 协议里 PathPickerOptions.kind 只有 'file' | 'directory'
596
603
  const dir = await ctx.pickPath({ kind: 'directory', title: '选择动作库目录(里面要有 actions/)' });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cortico-world-extra-actions",
3
- "version": "0.3.0",
3
+ "version": "0.3.2",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "勾选动作库里的动作,写进形象包的「额外动作拓展」文件夹,让桌宠照着做。自带入门形象包与示例动作,装完即用。",
package/src/starter.js CHANGED
@@ -6,7 +6,7 @@
6
6
  *
7
7
  * 这样装完插件就有东西可勾;105 段全量动作库仍然可以在面板里「选择动作库…」指过去。
8
8
  */
9
- import { cpSync, existsSync, mkdirSync } from 'node:fs';
9
+ import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
10
10
  import { join } from 'node:path';
11
11
 
12
12
  const PACK_ID = 'shenshen-actions';
@@ -14,6 +14,94 @@ const PACK_ID = 'shenshen-actions';
14
14
  /** 内置素材的根目录:<包>/assets/starter */
15
15
  const starterRoot = (pkgDir) => join(pkgDir, 'assets', 'starter');
16
16
 
17
+ const readJson = (file, fallback = null) => {
18
+ try { return JSON.parse(readFileSync(file, 'utf8').replace(/^\uFEFF/, '')); } catch { return fallback; }
19
+ };
20
+
21
+ /** 这个包里该有的东西齐不齐。 */
22
+ function packHealth(dir) {
23
+ const fig = readJson(join(dir, 'figure.json'), null);
24
+ const states = ['state-idle', 'state-walk', 'state-drag', 'look-around']
25
+ .filter((s) => existsSync(join(dir, 'actions', 'core', s, 'action.json')));
26
+ return {
27
+ figureJson: !!fig && fig.id === PACK_ID,
28
+ player: existsSync(join(dir, 'figure.js')),
29
+ states,
30
+ ok: !!fig && fig.id === PACK_ID && existsSync(join(dir, 'figure.js')) && states.length === 4,
31
+ };
32
+ }
33
+
34
+ /** figures 目录下所有声明自己是 shenshen-actions 的文件夹(用于查重)。 */
35
+ function packsClaimingId(figures) {
36
+ const out = [];
37
+ if (!existsSync(figures)) return out;
38
+ for (const e of readdirSync(figures, { withFileTypes: true })) {
39
+ if (!e.isDirectory() || e.name.startsWith('.')) continue;
40
+ const fig = readJson(join(figures, e.name, 'figure.json'), null);
41
+ if (fig && fig.id === PACK_ID) out.push({ dir: e.name, path: join(figures, e.name), bot: packHealth(join(figures, e.name)) });
42
+ }
43
+ return out;
44
+ }
45
+
46
+ /**
47
+ * 一键得到「空的深深形象包」:只有 4 段身体状态,没有额外动作、词表也是空的。
48
+ *
49
+ * 保证同时只有一个:
50
+ * - 已经有(哪怕文件夹被改了名)→ 绝不再造一个,只把缺的东西补上;
51
+ * - 找到多个 → 不动任何文件,把重复的报出来让人自己删。
52
+ */
53
+ export function restorePack({ pkgDir, figuresDir, log }) {
54
+ const figures = figuresDir();
55
+ const src = join(starterRoot(pkgDir), 'figure');
56
+ if (!existsSync(join(src, 'figure.js'))) throw new Error('插件里没有自带形象包(assets/starter/figure 缺失)');
57
+
58
+ const found = packsClaimingId(figures);
59
+ const canonical = found.find((p) => p.dir === PACK_ID) ?? null;
60
+ const others = found.filter((p) => p.dir !== PACK_ID);
61
+
62
+ /* 已经有:修一修(缺了才补),绝不重复造 */
63
+ if (found.length) {
64
+ const target = canonical ?? found[0];
65
+ const before = target.bot;
66
+ if (!before.ok) {
67
+ // 只补缺的那部分:figure.js / figure.json / 状态段
68
+ if (!before.player) cpSync(join(src, 'figure.js'), join(target.path, 'figure.js'));
69
+ if (!before.figureJson) {
70
+ const fig = readJson(join(src, 'figure.json'), { id: PACK_ID });
71
+ writeFileSync(join(target.path, 'figure.json'), JSON.stringify(fig, null, 2) + '\n', 'utf8');
72
+ }
73
+ for (const s of ['state-idle', 'state-walk', 'state-drag', 'look-around']) {
74
+ if (!existsSync(join(target.path, 'actions', 'core', s, 'action.json'))) {
75
+ cpSync(join(src, 'actions', 'core', s), join(target.path, 'actions', 'core', s), { recursive: true, force: false });
76
+ }
77
+ }
78
+ }
79
+ const after = packHealth(target.path);
80
+ log?.(`形象包已存在,未重复创建:${target.path}`);
81
+ return {
82
+ ok: true,
83
+ created: false,
84
+ repaired: !before.ok && after.ok,
85
+ path: target.path,
86
+ dir: target.dir,
87
+ duplicates: others.map((p) => p.path),
88
+ health: after,
89
+ };
90
+ }
91
+
92
+ /* 没有:造一个空的 */
93
+ mkdirSync(figures, { recursive: true });
94
+ const dst = join(figures, PACK_ID);
95
+ cpSync(src, dst, { recursive: true, force: false, errorOnExist: false });
96
+ // 清空额外动作与词表 —— "空的"形象包
97
+ rmSync(join(dst, '额外动作拓展'), { recursive: true, force: true });
98
+ const fig = readJson(join(dst, 'figure.json'), { id: PACK_ID });
99
+ fig.vocab = [];
100
+ writeFileSync(join(dst, 'figure.json'), JSON.stringify(fig, null, 2) + '\n', 'utf8');
101
+ log?.(`空的形象包已创建:${dst}`);
102
+ return { ok: true, created: true, repaired: false, path: dst, dir: PACK_ID, duplicates: [], health: packHealth(dst) };
103
+ }
104
+
17
105
  /**
18
106
  * @param {{ pkgDir: string, figuresDir: () => string, dataDir: string, libraryDir: () => string, saveSettings: (patch: object) => void, log?: (msg: string, extra?: object) => void }} o
19
107
  */
package/src/world.js CHANGED
@@ -13,7 +13,7 @@ import { dirname, isAbsolute, join, normalize, resolve } from 'node:path';
13
13
  import { fileURLToPath } from 'node:url';
14
14
  import { EXTRA_DIR, clear, inspect, isInside, packLooksSupported, prunePack, readExtra, removeOne, save } from './writer.js';
15
15
  import { addModules, rebuildIndex, scanLibrary } from './importer.js';
16
- import { ensureStarter } from './starter.js';
16
+ import { ensureStarter, restorePack } from './starter.js';
17
17
  import { petFigures, petState } from './pet.js';
18
18
 
19
19
  const ID = 'extra-actions';
@@ -22,7 +22,6 @@ const CATALOG_FILE = join(HERE, '..', 'assets', 'catalog.json');
22
22
  const PANEL = 'picker';
23
23
  /** 保存之后要说的话:插件不碰桌宠,重载交给用户。 */
24
24
  const RELOAD_HINT = '保存已生效。去 Coopanion 的装扮页重新点一下该形象,桌宠才会加载新的动作表。';
25
- /** 分类显示名;导入的自定义动作落在 extra。 */
26
25
  /** 模块目录里的 preview.webp 直接转 data URL 当缩略图(不重编码,够用)。 */
27
26
  function previewThumb(lib, clip) {
28
27
  try {
@@ -282,6 +281,8 @@ export class ExtraActionsWorld {
282
281
  return this.prune(this.cleanPackId(a[0]));
283
282
  case 'reindex':
284
283
  return this.reindex();
284
+ case 'restore-pack':
285
+ return this.restoreShenshenPack();
285
286
  case 'save': {
286
287
  const packId = this.cleanPackId(a[0]);
287
288
  const ids = Array.isArray(a[1]) ? a[1].slice(0, MAX_SELECTION).map((v) => String(v).slice(0, 40)) : [];
@@ -371,6 +372,17 @@ export class ExtraActionsWorld {
371
372
  return { ok: true, libraryDir: this.libraryDir() };
372
373
  }
373
374
 
375
+ /** 一键(重新)得到一个空的深深形象包;同时只允许存在一个。 */
376
+ async restoreShenshenPack() {
377
+ const r = restorePack({
378
+ pkgDir: join(HERE, '..'),
379
+ figuresDir: () => this.figuresDir(),
380
+ log: (msg) => this.host?.log?.info?.(msg),
381
+ });
382
+ this.bustCatalog();
383
+ return r;
384
+ }
385
+
374
386
  /** 由 action.json 重生成 actions/index.js —— 清单和磁盘对不上时的万能修复。 */
375
387
  async reindex() {
376
388
  const lib = this.libraryDir();
package/src/writer.js CHANGED
@@ -546,8 +546,6 @@ export function prunePack(packDir) {
546
546
  return { kept: [...keep], removed, freed, left: dirBytes(root) };
547
547
  }
548
548
 
549
- /** 体检:包目录 + 库目录能不能用。给面板在保存前提示。 */
550
-
551
549
  /** 体检:包目录 + 库目录能不能用。给面板在保存前提示。 */
552
550
  export function inspect({ packDir, libraryDir, catalog }) {
553
551
  const problems = [];