@mjh-odoo/cli 0.1.0 → 0.1.6

package/src/archive.mjs

@@ -0,0 +1,260 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+
+function catalogFile() {
+  const home = os.homedir();
+  const appData = process.platform === 'darwin' ? path.join(home, 'Library', 'Application Support')
+    : process.platform === 'win32' ? process.env.APPDATA || path.join(home, 'AppData', 'Roaming')
+      : process.env.XDG_CONFIG_HOME || path.join(home, '.config');
+  return process.env.ODOO_MANAGER_CATALOG || path.join(appData, 'Odoo Manager', 'manager.sqlite');
+}
+
+function gitCommonDirectory(root) {
+  try {
+    const value = execFileSync('git', ['rev-parse', '--path-format=absolute', '--git-common-dir'],
+      {cwd: root, encoding: 'utf8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore']});
+    return fs.realpathSync(value.trim());
+  } catch { return null; }
+}
+
+function resolveProject(db, root, optional) {
+  const direct = db.prepare('SELECT * FROM projects WHERE root = ?').get(root);
+  if (direct) return direct;
+  const common = gitCommonDirectory(root);
+  if (!common && optional) return null;
+  if (!common) throw new Error('请先在 Odoo Manager 接入当前项目。');
+  const matches = db.prepare('SELECT * FROM projects').all()
+    .filter(project => gitCommonDirectory(project.root) === common);
+  if (!matches.length && optional) return null;
+  if (matches.length !== 1) throw new Error(matches.length ? '当前工作树匹配了多个项目，请从已接入的项目目录执行。' : '请先在 Odoo Manager 接入当前项目。');
+  return matches[0];
+}
+
+export async function withArchiveCatalog(root, write, action, {optional = false} = {}) {
+  const file = catalogFile();
+  if (!fs.statSync(file, {throwIfNoEntry: false})?.isFile()) {
+    if (optional) return null;
+    throw new Error('找不到本机存档库，请先在 Odoo Manager 接入项目。');
+  }
+  const {DatabaseSync} = await import('node:sqlite');
+  const db = new DatabaseSync(file, {readOnly: !write});
+  try {
+    db.exec('PRAGMA busy_timeout = 5000; PRAGMA foreign_keys = ON;');
+    const project = resolveProject(db, root, optional);
+    if (!project) return null;
+    if (write) ensureArchiveTags(db);
+    return await action(db, project);
+  } finally { db.close(); }
+}
+
+const hasTable = (db, name) => !!db.prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = ?").get(name);
+
+export function transaction(db, action) {
+  db.exec('BEGIN IMMEDIATE');
+  try {
+    const result = action();
+    db.exec('COMMIT');
+    return result;
+  } catch (error) {
+    db.exec('ROLLBACK');
+    throw error;
+  }
+}
+
+export function ensureArchiveTags(db) {
+  transaction(db, () => {
+    db.exec(`CREATE TABLE IF NOT EXISTS archive_tags (
+      projectId TEXT NOT NULL REFERENCES projects(id),
+      tag TEXT NOT NULL,
+      archiveId TEXT NOT NULL REFERENCES archives(id),
+      PRIMARY KEY (projectId, tag)
+    );
+    CREATE TABLE IF NOT EXISTS project_seeds (
+      projectId TEXT PRIMARY KEY REFERENCES projects(id), reference TEXT NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS project_runtimes (
+      root TEXT PRIMARY KEY, projectId TEXT NOT NULL REFERENCES projects(id), composeProject TEXT NOT NULL
+    )`);
+    if (hasTable(db, 'archive_defaults')) {
+      db.exec(`INSERT OR IGNORE INTO archive_tags
+        SELECT projectId, 'latest', archiveId FROM archive_defaults;
+        DROP TABLE archive_defaults;`);
+    }
+  });
+}
+
+export function projectTags(db, projectId) {
+  if (hasTable(db, 'archive_tags')) {
+    return db.prepare('SELECT tag, archiveId FROM archive_tags WHERE projectId = ? ORDER BY tag').all(projectId);
+  }
+  if (hasTable(db, 'archive_defaults')) {
+    return db.prepare("SELECT 'latest' AS tag, archiveId FROM archive_defaults WHERE projectId = ?").all(projectId);
+  }
+  return [];
+}
+
+export async function archiveList(root, {json}) {
+  const result = await withArchiveCatalog(root, false, (db, project) => {
+    const tags = projectTags(db, project.id);
+    const rows = db.prepare('SELECT id, title, note, environment, database, bytes, created, revision, source FROM archives WHERE projectId = ? ORDER BY created DESC').all(project.id);
+    return rows.map(archive => ({...archive, tags: tags.filter(tag => tag.archiveId === archive.id).map(tag => tag.tag)}));
+  });
+  if (json) console.log(JSON.stringify(result, null, 2));
+  else if (!result.length) console.log('此项目还没有数据库存档。');
+  else for (const archive of result) console.log([archive.id, archive.title, archive.database, archive.tags.join(', ')].filter(Boolean).join('  '));
+}
+
+function findArchive(db, projectId, id, requireFile = true) {
+  const row = db.prepare('SELECT * FROM archives WHERE projectId = ? AND id = ?').get(projectId, id);
+  if (!row) throw new Error('此项目没有该存档：' + id);
+  if (requireFile && (!path.isAbsolute(row.file) || !fs.statSync(row.file, {throwIfNoEntry: false})?.isFile())) {
+    throw new Error('存档 ZIP 已丢失或不可用：' + id + '。请在 Odoo Manager 检查存档。');
+  }
+  return row;
+}
+
+export function tagName(value) {
+  if (!/^[a-z][a-z0-9._-]{0,63}$/.test(value)) throw new Error('标签须以小写字母开头，最多 64 字符，可包含小写字母、数字、点、下划线和短横线。');
+  return value;
+}
+
+function findReference(db, projectId, reference) {
+  if (reference.startsWith('id:')) return findArchive(db, projectId, reference.slice(3));
+  const tags = projectTags(db, projectId);
+  const explicitTag = reference.startsWith('tag:');
+  const tag = explicitTag ? tagName(reference.slice(4)) : reference === 'default' ? 'latest' : reference;
+  const selected = tags.find(row => row.tag === tag);
+  if (!selected && (explicitTag || reference === 'default' || reference === 'latest')) throw new Error('此项目尚未设置标签：' + tag);
+  return findArchive(db, projectId, selected?.archiveId || reference);
+}
+
+export async function resolveArchive(root, reference) {
+  return withArchiveCatalog(root, false, (db, project) => findReference(db, project.id, reference));
+}
+
+export async function archiveSeed(root, reference, {json} = {}) {
+  const result = await withArchiveCatalog(root, reference !== undefined, (db, project) => {
+    if (reference !== undefined) transaction(db, () => {
+      if (reference.startsWith('tag:')) tagName(reference.slice(4));
+      else if (reference.startsWith('id:')) findReference(db, project.id, reference);
+      else if (reference !== 'empty') throw new Error('数据来源使用 tag:<标签>、id:<存档ID> 或 empty。');
+      db.prepare('INSERT INTO project_seeds VALUES (?, ?) ON CONFLICT(projectId) DO UPDATE SET reference = excluded.reference')
+        .run(project.id, reference);
+    });
+    return hasTable(db, 'project_seeds') ? db.prepare('SELECT reference FROM project_seeds WHERE projectId = ?').get(project.id)?.reference : null;
+  });
+  console.log(json ? JSON.stringify({reference: result || 'empty'}) : (result || 'empty'));
+}
+
+export async function startupSeed(root, values, preview = false) {
+  if (values.ENV === 'PROD' || values.ODOO_SEED_MODE === 'empty' ||
+      (values.ODOO_SEED && values.ODOO_SEED_MODE !== 'first-start')) return {reference: null, source: 'env'};
+  const configured = values.ODOO_SEED && values.ODOO_SEED_MODE === 'first-start' ? values.ODOO_SEED : null;
+  return await withArchiveCatalog(root, false, (db, project) => {
+    const projectSeed = root !== project.root && hasTable(db, 'project_seeds') ? db.prepare('SELECT reference FROM project_seeds WHERE projectId = ?').get(project.id)?.reference : null;
+    const reference = configured || projectSeed || null;
+    const source = configured ? 'env' : 'project';
+    if (!reference || reference === 'empty') return {reference: null, source};
+    if (!preview) return {reference, source};
+    try {
+      const archive = findReference(db, project.id, reference);
+      return {reference, source, archive: {id: archive.id, title: archive.title}};
+    } catch (error) { return {reference, source, issue: error.message}; }
+  }, {optional: true}) || {reference: configured, source: configured ? 'env' : 'project',
+    ...(configured && preview ? {issue: '请先在 Odoo Manager 接入当前项目。'} : {})};
+}
+
+export async function rememberRuntime(root, composeProject) {
+  return withArchiveCatalog(root, true, (db, project) => {
+    if (root === project.root) return;
+    db.prepare('INSERT INTO project_runtimes VALUES (?, ?, ?) ON CONFLICT(root) DO UPDATE SET composeProject = excluded.composeProject')
+      .run(root, project.id, composeProject);
+  }, {optional: true});
+}
+
+export async function archiveTags(root, {json}) {
+  const rows = await withArchiveCatalog(root, false, (db, project) =>
+    projectTags(db, project.id).map(row => ({...row, title: findArchive(db, project.id, row.archiveId, false).title})));
+  if (json) console.log(JSON.stringify(rows, null, 2));
+  else for (const row of rows) console.log(row.tag + ' → ' + row.title + ' (' + row.archiveId + ')');
+}
+
+export async function archiveTag(root, tag, id) {
+  tagName(tag);
+  await withArchiveCatalog(root, true, (db, project) => transaction(db, () => {
+    if (!id) {
+      db.prepare('DELETE FROM archive_tags WHERE projectId = ? AND tag = ?').run(project.id, tag);
+      console.log('已移除标签：' + tag);
+      return;
+    }
+    const row = findArchive(db, project.id, id);
+    pointTag(db, project.id, tag, row.id);
+    console.log(tag + ' → ' + row.title + ' (' + row.id + ')');
+  }));
+}
+
+export async function archiveDefault(root, id) {
+  if (id) return archiveTag(root, 'latest', id);
+  const selected = await withArchiveCatalog(root, false, (db, project) => projectTags(db, project.id).find(row => row.tag === 'latest'));
+  console.log(selected?.archiveId || '此项目尚未设置 latest。');
+}
+
+export async function deleteArchive(root, id) {
+  await withArchiveCatalog(root, true, (db, project) => transaction(db, () => {
+    const row = findArchive(db, project.id, id, false);
+    const tags = projectTags(db, project.id).filter(tag => tag.archiveId === id);
+    if (tags.length) throw new Error('请先移动或移除标签：' + tags.map(row => row.tag).join(', '));
+    if (db.prepare('SELECT 1 FROM project_seeds WHERE projectId = ? AND reference = ?').get(project.id, 'id:' + id)) {
+      throw new Error('该存档用于新工作树首次启动，请先更改项目的数据来源。');
+    }
+    if (!path.isAbsolute(row.file) || path.basename(row.file) !== row.id + '.zip') throw new Error('无法确认存档文件位置。');
+    fs.rmSync(row.file, {force: true});
+    db.prepare('DELETE FROM archives WHERE projectId = ? AND id = ?').run(project.id, id);
+    console.log('已删除存档：' + row.title);
+  }));
+}
+
+export function pointTag(db, projectId, tag, id) {
+  db.prepare('INSERT INTO archive_tags VALUES (?, ?, ?) ON CONFLICT(projectId, tag) DO UPDATE SET archiveId = excluded.archiveId')
+    .run(projectId, tag, id);
+}
+
+export function insertArchive(db, archive) {
+  const {id, projectId, title, note, environment, database, file, bytes, created, revision, source} = archive;
+  db.prepare('INSERT INTO archives (id, projectId, title, note, environment, database, file, bytes, created, revision, source) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)')
+    .run(id, projectId, title, note, environment, database, file, bytes, created, revision, source);
+}
+
+export function saveArchive(db, archive, tag) {
+  transaction(db, () => {
+    insertArchive(db, archive);
+    if (tag) pointTag(db, archive.projectId, tag, archive.id);
+  });
+}
+
+export function archiveLocation(db, root, id) {
+  const settings = JSON.parse(db.prepare('SELECT value FROM settings WHERE id = 1').get()?.value || '{}');
+  if (typeof settings.archiveRoot !== 'string' || !path.isAbsolute(settings.archiveRoot)) {
+    throw new Error('请在 Odoo Manager 设置存档目录。');
+  }
+  fs.mkdirSync(settings.archiveRoot, {recursive: true});
+  const directory = fs.realpathSync(settings.archiveRoot);
+  const roots = [root, ...db.prepare('SELECT root FROM environments').all().map(env => env.root)];
+  if (roots.some(checkout => {
+    const relative = path.relative(checkout, directory);
+    return !relative || (!path.isAbsolute(relative) && relative !== '..' && !relative.startsWith('..' + path.sep));
+  })) throw new Error('请选择项目和工作树之外的存档目录。');
+  return path.join(directory, id + '.zip');
+}
+
+export function archiveSource(db, project, root) {
+  const name = db.prepare('SELECT name FROM environments WHERE projectId = ? AND root = ?').get(project.id, root)?.name;
+  let revision = '';
+  try {
+    const git = args => execFileSync('git', args, {cwd: root, encoding: 'utf8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore']}).trim();
+    revision = git(['rev-parse', 'HEAD']) + (git(['status', '--porcelain']) ? '（有未提交改动）' : '');
+  } catch { /* Git metadata is optional. */ }
+  return {environment: name || path.basename(root), revision};
+}

package/src/archived-worktrees.mjs

@@ -0,0 +1,65 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { projectNameForPath } from './lib/environment.mjs';
+import { execFileSync } from 'node:child_process';
+import { withArchiveCatalog } from './archive.mjs';
+
+const managedVolumes = ['db-data', 'odoo-data'];
+
+async function retired(root) {
+  return await withArchiveCatalog(root, false, (db, project) => {
+    const roots = db.prepare("SELECT root, name FROM environments WHERE projectId = ? AND kind = 'worktree'").all(project.id);
+    const names = new Map(roots.map(row => [row.root, row.name]));
+    const runtimes = db.prepare("SELECT 1 FROM sqlite_master WHERE name = 'project_runtimes'").get()
+      ? db.prepare('SELECT root, composeProject FROM project_runtimes WHERE projectId = ?').all(project.id) : [];
+    const rows = new Map(roots.map(row => [row.root, projectNameForPath(row.root)]));
+    for (const row of runtimes) rows.set(row.root, row.composeProject);
+    return [...rows].filter(([directory]) => directory !== project.root && !fs.existsSync(directory))
+      .map(([directory, composeProject]) => ({
+        root: directory, composeProject, name: names.get(directory) || path.basename(directory),
+        managed: composeProject === projectNameForPath(directory), repository: project.root,
+      }));
+  }) || [];
+}
+
+async function exactVolumes(docker, composeProject) {
+  const raw = await docker(['volume', 'ls', '--quiet', '--filter', 'label=com.docker.compose.project=' + composeProject]);
+  return managedVolumes.map(kind => composeProject + '_' + kind).filter(name => raw.split(/\r?\n/).includes(name));
+}
+
+export async function archivedWorktrees(root, docker) {
+  const rows = await retired(root);
+  if (!rows.length) return [];
+  const usage = await docker(['system', 'df', '-v', '--format', 'json']).then(raw => JSON.parse(raw).Volumes || []).catch(() => []);
+  const sizes = new Map(usage.map(row => [row.Name, row.Size]));
+  return Promise.all(rows.map(async row => {
+    const volumes = row.managed ? await exactVolumes(docker, row.composeProject) : [];
+    return {...row, volumes: volumes.map(name => ({name, size: sizes.get(name) || null}))};
+  }));
+}
+
+export async function cleanArchivedWorktree(root, composeProject, docker) {
+  const row = (await retired(root)).find(row => row.composeProject === composeProject);
+  if (!row?.managed) throw new Error('仅可清理路径已移除且使用自动 Compose 标识的已归档工作树。');
+  const check = () => {
+    if (fs.existsSync(row.root)) throw new Error('工作树已恢复，请刷新列表。');
+    const registered = execFileSync('git', ['worktree', 'list', '--porcelain', '-z'], {
+      cwd: row.repository, timeout: 5000, encoding: 'utf8',
+    }).split('\0');
+    if (registered.includes('worktree ' + row.root)) throw new Error('Git 仍登记此工作树，请先完成归档。');
+  };
+  check();
+  const containers = await docker(['ps', '-a', '-q', '--filter', 'label=com.docker.compose.project=' + composeProject]);
+  if (containers) throw new Error('该环境仍有 Docker 容器，请先完成停止和归档。');
+  const volumes = await exactVolumes(docker, composeProject);
+  if (volumes.length) {
+    const inspected = JSON.parse(await docker(['volume', 'inspect', ...volumes]));
+    if (inspected.length !== volumes.length || inspected.some(row =>
+      row.Labels?.['com.docker.compose.project'] !== composeProject ||
+      row.Name !== composeProject + '_' + row.Labels?.['com.docker.compose.volume'] ||
+      !volumes.includes(row.Name))) throw new Error('卷归属发生变化，请刷新后再试。');
+    check();
+    await docker(['volume', 'rm', ...volumes]);
+  }
+  return volumes;
+}

package/src/cli.mjs

@@ -1,9 +1,15 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseEnv } from 'node:util';
 import { Command, Option, InvalidArgumentError } from 'commander';
 import { findProject, openProject, databaseName, runDocker, projectVersion } from './project.mjs';
 import { readEnv } from './lib/environment.mjs';
 import { parseLogOptions, executeLogs } from './lib/logs.mjs';
 import { imageBuildPlan, executeImageBuild } from './lib/image.mjs';
+import { archivedWorktrees, cleanArchivedWorktree } from './archived-worktrees.mjs';
+import { exportLibrary, importLibrary } from './archive-library.mjs';
 import * as commands from './commands.mjs';
+import { archiveDefault, archiveList, archiveTag, archiveTags, deleteArchive, tagName, archiveSeed, startupSeed } from './archive.mjs';
 
 function integer(value) {
   if (!/^\d+$/.test(value) || +value > 3600) throw new InvalidArgumentError('请输入 0..3600 的整数。');
@@ -18,7 +24,7 @@ function argumentsFor(options, names) {
   return names.flatMap(name => {
     const key = name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
     const value = options[key];
-    return value === true ? ['--' + name] : value === undefined || value === false ? [] : ['--' + name, String(value)];
+    return value === true ? ['--' + name] : value === undefined || value === false ? [] : ['--' + name + '=' + String(value)];
   });
 }
 
@@ -52,10 +58,10 @@ export function createProgram({version, cwd = process.cwd(), runner = runDocker}
     .option('-f, --follow', '持续查看，Ctrl+C 只退出查看').option('-n, --tail <lines>', '每容器行数，支持 0 或 all', '200')
     .option('--since <time>', '起始时间，如 10m 或带时区 RFC3339').option('--until <time>', '截止时间')
     .option('--level <level>', '最低级别：debug/info/warning/error/critical').option('--match <text>', '不区分大小写的字面筛选')
-    .option('--context <events>', '筛选结果前后事件数，默认 2').option('--json', '输出完整 JSON 快照').option('--file <path>', '保存快照，拒绝覆盖已有文件');
+    .option('--hide-health', '隐藏成功的 Odoo 健康检查').option('--context <events>', '筛选结果前后事件数，默认 2').option('--json', '输出完整 JSON 快照').option('--file <path>', '保存快照，拒绝覆盖已有文件');
   logs.addHelpText('after', '\n筛选、JSON 和文件用于有限快照，不能与 -f 同用。保留完整异常堆栈；--tail 起点仍可能截到异常中间。');
   logs.action(async (services, options) => {
-    const parsed = parseLogOptions([...(services || []), ...argumentsFor(options, ['follow', 'tail', 'since', 'until', 'level', 'match', 'context', 'json', 'file'])]);
+    const parsed = parseLogOptions([...(services || []), ...argumentsFor(options, ['follow', 'tail', 'since', 'until', 'level', 'match', 'context', 'hide-health', 'json', 'file'])]);
     process.exitCode = await executeLogs(parsed, await context(false));
   });
 
@@ -71,11 +77,92 @@ export function createProgram({version, cwd = process.cwd(), runner = runDocker}
 
   const db = program.command('db').description('数据库查询及标准 ZIP 备份恢复');
   db.command('list').description('列出项目 PostgreSQL 中的数据库').option('--json', '输出 JSON；current 表示当前配置的数据库').action(async options => commands.listDatabases(await context(false), options));
-  databaseOption(db.command('backup').description('导出数据库及附件 ZIP').option('--file <path>', '输出路径；默认保存到工作树之外')).action(async options => commands.backup(await context(false), options));
-  databaseOption(db.command('restore').description('恢复 ZIP，默认中和外发任务').requiredOption('--file <path>', '已有的 Odoo 20 ZIP')
-    .option('--force', '允许覆盖已有目标数据库').option('--no-restart', '恢复后保持 Odoo 停止')).action(async options => commands.restore(await context(false), options));
+  databaseOption(db.command('backup').description('导出数据库及附件 ZIP')
+    .addOption(new Option('--file <path>', '输出到指定路径').conflicts('name'))
+    .option('--name <title>', '按名称保存到 Odoo Manager 存档库').option('--note <text>', '存档备注（与 --name 一起使用）')
+    .option('--json', '输出存档 JSON（与 --name 一起使用）')).action(async options => {
+    if (options.name === undefined && (options.note !== undefined || options.json)) throw new Error('--note 和 --json 需要 --name。');
+    await commands.backup(await context(false), options);
+  });
+  databaseOption(db.command('restore').description('恢复 Odoo ZIP，默认中和外发任务')
+    .argument('[reference]', '本项目的标签或存档 ID')
+    .option('--to <name>', '恢复目标库', databaseName)
+    .option('--use', '恢复成功后切换到新库')
+    .addOption(new Option('--file <path>', '已有的 Odoo 20 ZIP').conflicts('archive'))
+    .option('--archive <reference>', '兼容入口，指定项目存档')
+    .option('--force', '允许覆盖已有目标数据库').option('--no-restart', '恢复后保持 Odoo 停止')).action(async (reference, options) => {
+    if ([reference, options.file, options.archive].filter(Boolean).length !== 1) throw new Error('请指定标签、存档 ID 或 --file <path>。');
+    if (options.to && options.database) throw new Error('请选择 --to 或 --database 中的一个。');
+    const database = options.to || options.database;
+    if ((reference || options.use) && !database) throw new Error('请用 --to 指定新的目标数据库名称。');
+    if (options.use && options.force) throw new Error('恢复并切换需要一个新库，不能同时指定 --force。');
+    await commands.restore(await context(false), {...options, archive: reference || options.archive, database, legacy: !reference});
+  });
+  db.command('recover').description('清理本次恢复产生的残留库').option('--yes', '确认清理')
+    .action(async options => {
+      if (!options.yes) throw new Error('清理恢复残留需要 --yes。');
+      await commands.recoverDatabase(await context(false));
+    });
+  db.command('use').description('切换当前环境使用的数据库').argument('<database>', '已有数据库', databaseName)
+    .action(async name => commands.useDatabase(await context(false), name));
+  db.command('delete').description('删除指定数据库及其附件')
+    .argument('<database>', '目标数据库', databaseName).option('--yes', '确认删除')
+    .action(async (name, options) => {
+      if (!options.yes) throw new Error('删除数据库及附件需要 --yes。');
+      await commands.deleteDatabase(await context(false), name);
+    });
   db.action(() => db.help());
 
+  const archive = program.command('archive').description('管理项目数据库存档');
+  archive.command('seed').description('查看或设置项目的首次启动数据来源')
+    .argument('[reference]', 'tag:<标签>、id:<存档ID> 或 empty').option('--json', '输出 JSON')
+    .action((reference, options) => archiveSeed(root(), reference, options));
+  archive.command('source').description('预览当前环境首次启动的数据来源')
+    .action(async () => {
+      const directory = root();
+      const values = fs.existsSync(path.join(directory, '.env')) ? readEnv(directory) : parseEnv(fs.readFileSync(path.join(directory, '.env.example'), 'utf8'));
+      console.log(JSON.stringify(await startupSeed(directory, values, true)));
+    });
+  archive.command('list').description('列出本项目的存档、标签和 ID').option('--json', '输出 JSON').action(options => archiveList(root(), options));
+  databaseOption(archive.command('save').description('保存当前环境的 Odoo ZIP').argument('<title>', '存档名称')
+    .option('--note <text>', '存档备注').option('--tag <name>', '保存成功后创建或移动标签', tagName).option('--json', '输出 JSON'))
+    .action(async (name, options) => commands.backup(await context(false), {...options, name}));
+  archive.command('import').description('校验并导入 Odoo ZIP').argument('<file>', 'ZIP 文件')
+    .option('--name <title>', '存档名称').option('--json', '输出 JSON')
+    .action(async (file, options) => commands.importArchive(await context(true), file, options));
+  archive.command('delete').description('删除存档 ZIP').argument('<id>', '存档 ID').option('--yes', '确认删除')
+    .action((id, options) => {
+      if (!options.yes) throw new Error('删除存档 ZIP 需要 --yes。');
+      return deleteArchive(root(), id);
+    });
+  archive.command('default', {hidden: true}).argument('[id]').action(id => archiveDefault(root(), id));
+  const library = archive.command('library').description('迁移项目存档、标签和备注');
+  library.command('export').argument('<directory>', '新建的导出目录').description('导出项目存档库')
+    .action(async directory => console.log(JSON.stringify(await exportLibrary(root(), directory))));
+  library.command('import').argument('<directory>', '存档库目录').description('导入项目存档库')
+    .action(async directory => console.log(JSON.stringify(await importLibrary(root(), directory))));
+  library.action(() => library.help());
+  const tag = archive.command('tag').description('管理项目存档标签');
+  tag.command('list').description('列出标签及指向的存档').option('--json', '输出 JSON').action(options => archiveTags(root(), options));
+  tag.command('set').description('创建或移动标签').argument('<tag>').argument('<id>', '存档 ID').action((name, id) => archiveTag(root(), name, id));
+  tag.command('remove').description('移除标签').argument('<tag>').action(name => archiveTag(root(), name));
+  tag.action(() => tag.help());
+  archive.action(() => archive.help());
+
+  const worktree = program.command('worktree').description('查看已归档工作树的本地数据');
+  const runLocalDocker = (directory, args) => runner(args, {root: directory, env: process.env, capture: true});
+  worktree.command('archived').description('列出已归档工作树和数据卷').action(async () => {
+    const directory = root();
+    console.log(JSON.stringify(await archivedWorktrees(directory, args => runLocalDocker(directory, args))));
+  });
+  worktree.command('clean').description('删除已归档工作树的数据库和附件卷')
+    .argument('<compose-project>').option('--yes', '确认删除').action(async (project, options) => {
+      if (!options.yes) throw new Error('清理归档数据卷需要 --yes。');
+      const directory = root();
+      console.log(JSON.stringify(await cleanArchivedWorktree(directory, project, args => runLocalDocker(directory, args))));
+    });
+  worktree.action(() => worktree.help());
+
   const image = program.command('image').description('构建基础镜像、项目镜像和离线包');
   image.command('build').description('默认构建本地基础镜像')
     .option('--platform <platforms>', 'amd64、arm64 或 amd64,arm64')