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 +18 -10
- package/dist/webui.js +17 -10
- package/package.json +1 -1
- package/src/starter.js +89 -1
- package/src/world.js +14 -2
- package/src/writer.js +0 -2
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/
|
|
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
|
|
182
|
-
| `
|
|
183
|
-
| `
|
|
184
|
-
| `tools/
|
|
185
|
-
| `tools/
|
|
186
|
-
|
|
187
|
-
|
|
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
|
-
|
|
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}
|
|
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
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 = [];
|