@sswl/ai-manager 0.1.0 → 0.1.1

package/README.md

@@ -16,7 +16,9 @@ SSWL AI Manager CLI。
 ```bash
 npx @sswl/ai-manager
 npx @sswl/ai-manager update
-npx @sswl/ai-manager apply --tool claude-code --scope project --project /path/to/project --profile full-enterprise
+npx @sswl/ai-manager use --tool claude-code --scope project --project /path/to/project --profile full-enterprise
+npx @sswl/ai-manager profiles --tool claude-code
+npx @sswl/ai-manager assets --tool codex
 ```
 
 ## Publish

package/lib/cli.js

@@ -36,6 +36,14 @@ function truncateText(text, width) {
   return `${raw.slice(0, Math.max(0, width - 1))}…`;
 }
 
+function padPlainText(text, width) {
+  const raw = stripAnsi(text);
+  if (raw.length >= width) {
+    return truncateText(text, width);
+  }
+  return `${text}${" ".repeat(width - raw.length)}`;
+}
+
 function usage(commandName = "ai-manager") {
   console.log(`${color("SSWL AI Manager CLI", "bold")}
 
@@ -43,11 +51,17 @@ Usage:
   ${commandName}
   ${commandName} init [--repo-url URL] [--repo-dir PATH]
   ${commandName} sync [--repo-url URL] [--repo-dir PATH]
+  ${commandName} use --tool TOOL [--scope project|global] [--project PATH] [--profile ID | --asset ID ...]
+  ${commandName} update [--project PATH] [--tool TOOL]
+  ${commandName} remove --tool TOOL [--scope project|global] [--project PATH]
+  ${commandName} doctor [--project PATH]
+  ${commandName} profiles [--tool TOOL] [--project PATH]
+  ${commandName} assets [--tool TOOL] [--project PATH]
+
+兼容命令:
   ${commandName} list [--project PATH]
   ${commandName} doctor [--project PATH]
   ${commandName} apply --tool TOOL [--scope project|global] [--project PATH] [--profile ID | --asset ID ...]
-  ${commandName} update [--project PATH] [--tool TOOL]
-  ${commandName} remove --tool TOOL [--scope project|global] [--project PATH]
 `);
 }
 
@@ -220,6 +234,18 @@ function createPrompt() {
   }
 
   return {
+    renderFrame,
+    async pause(label = "继续", subtitle = "按回车继续") {
+      renderFrame({
+        eyebrow: "流程暂停",
+        title: label,
+        subtitle,
+        bodyLines: [],
+        footerLines: ["回车继续"]
+      });
+      setRawMode(false);
+      await ask(`${color(">", "green")} ${label}，直接回车继续: `);
+    },
     async input(label, defaultValue = "", subtitle = "") {
       renderFrame({
         eyebrow: "文本输入",
@@ -618,8 +644,87 @@ function summarizeAssets(state, assetIds) {
   });
 }
 
+function summarizeProjectState(state, projectRoot, currentTool = "") {
+  const projectTools = state.project?.tools || [];
+  const toolState = currentTool
+    ? projectTools.find((tool) => tool.tool === currentTool) || state.tools.find((tool) => tool.tool === currentTool)
+    : null;
+  const summary = [
+    `项目: ${projectRoot}`,
+    `仓库: ${state.settings.repo_dir}`,
+    `模式: ${state.settings.asset_source_mode}`
+  ];
+  if (toolState) {
+    summary.push(`工具: ${toolState.tool} / ${toolState.enabled ? `已装 ${toolState.installed_asset_ids.length} 项` : "未安装"}`);
+  }
+  return summary;
+}
+
+function buildWorkspaceBoardLines({
+  state,
+  projectRoot,
+  selectedTool = "",
+  scope = "",
+  profileId = "",
+  selectionMode = "",
+  inheritGlobal = false,
+  selectedAssetIds = [],
+  previewAssetIds = []
+}) {
+  const lines = [];
+  const currentToolState = selectedTool
+    ? (state.project?.tools || []).find((item) => item.tool === selectedTool) || state.tools.find((item) => item.tool === selectedTool)
+    : null;
+  lines.push(color("上下文", "dim"));
+  lines.push(`  项目        ${projectRoot || "-"}`);
+  lines.push(`  仓库        ${state.settings.repo_dir || "-"}`);
+  lines.push(`  模式        ${state.settings.asset_source_mode || "-"}`);
+  lines.push("");
+  lines.push(color("当前选择", "dim"));
+  lines.push(`  工具        ${selectedTool || "-"}`);
+  lines.push(`  作用域      ${scope ? (scope === "project" ? "项目级" : "全局") : "-"}`);
+  lines.push(`  档位/模式   ${profileId || (selectionMode === "custom" ? "自定义资产" : "-")}`);
+  lines.push(`  继承全局    ${scope === "project" ? (inheritGlobal ? "是" : "否") : "-"}`);
+  lines.push("");
+  lines.push(color("状态摘要", "dim"));
+  lines.push(`  已选资产    ${selectedAssetIds.length} 项`);
+  lines.push(`  实际安装    ${previewAssetIds.length} 项`);
+  if (currentToolState) {
+    lines.push(`  当前已装    ${(currentToolState.installed_asset_ids || []).length} 项`);
+    lines.push(`  检测结果    ${currentToolState.detected_installed ? "已检测到本机安装" : "未检测到本机安装"}`);
+  }
+  return lines;
+}
+
+function buildAssetsPreviewLines(state, assetIds, limit = 10) {
+  const items = summarizeAssets(state, assetIds);
+  if (items.length <= limit) {
+    return items.map((item) => `  • ${item}`);
+  }
+  return [
+    ...items.slice(0, limit).map((item) => `  • ${item}`),
+    `  … 共 ${items.length} 项`
+  ];
+}
+
+function buildTwoColumnLines(leftTitle, leftLines, rightTitle, rightLines) {
+  const leftBody = [color(leftTitle, "dim"), ...(leftLines.length ? leftLines : ["  -"])];
+  const rightBody = [color(rightTitle, "dim"), ...(rightLines.length ? rightLines : ["  -"])];
+  const totalRows = Math.max(leftBody.length, rightBody.length);
+  const lines = [];
+  const leftWidth = 45;
+  for (let index = 0; index < totalRows; index += 1) {
+    const left = padPlainText(leftBody[index] || "", leftWidth);
+    const right = rightBody[index] || "";
+    lines.push(`${left}  ${color("│", "dim")}  ${right}`);
+  }
+  return lines;
+}
+
 function filterProfilesByTool(state, tool) {
-  return (state.profiles || []).filter((profile) => (profile.supported_tools || []).includes(tool));
+  return (state.profiles || [])
+    .filter((profile) => (profile.supported_tools || []).includes(tool))
+    .sort((left, right) => left.id.localeCompare(right.id));
 }
 
 function filterInstallableAssetsByTool(state, tool) {
@@ -628,6 +733,39 @@ function filterInstallableAssetsByTool(state, tool) {
     .filter((asset) => asset.installable !== false);
 }
 
+function buildDiffSummary(baseAssetIds, finalAssetIds, selectedAssetIds) {
+  const base = new Set(baseAssetIds || []);
+  const finalSet = new Set(finalAssetIds || []);
+  const selected = new Set(selectedAssetIds || []);
+  return {
+    added: [...finalSet].filter((id) => !base.has(id)).sort(),
+    removed: [...base].filter((id) => !finalSet.has(id)).sort(),
+    kept: [...finalSet].filter((id) => base.has(id)).sort(),
+    autoDependencies: [...finalSet].filter((id) => !selected.has(id)).sort()
+  };
+}
+
+async function selectAssetsForCustomMode(prompt, state, tool) {
+  const allAssets = filterInstallableAssetsByTool(state, tool);
+  const keyword = await prompt.input(
+    "资产筛选关键字",
+    "",
+    "可选。支持按资产 ID、类型、Domain、状态筛选；留空则展示全部可安装资产"
+  );
+  const normalizedKeyword = String(keyword || "").trim().toLowerCase();
+  const filteredAssets = normalizedKeyword
+    ? allAssets.filter((asset) => [asset.id, asset.type, asset.domain, asset.status, asset.description].join(" ").toLowerCase().includes(normalizedKeyword))
+    : allAssets;
+  if (!filteredAssets.length) {
+    throw new Error(`没有命中关键字 "${normalizedKeyword}" 的可安装资产`);
+  }
+  return prompt.multiSelect("选择需要同步到项目的资产", filteredAssets.map((asset) => ({
+    label: `${asset.id}`,
+    hint: `${asset.type} / ${asset.domain} / ${asset.status}`,
+    value: asset.id
+  })));
+}
+
 async function interactiveInstall(options = {}) {
   const prompt = createPrompt();
   try {
@@ -640,6 +778,25 @@ async function interactiveInstall(options = {}) {
       repoDir: syncedState.settings.repo_dir,
       projectRoot
     });
+    prompt.renderFrame({
+      eyebrow: "AI Manager Workspace",
+      title: "项目工作台",
+      subtitle: "这是当前项目的安装上下文。接下来会依次完成工具、作用域、档位和资产选择。",
+      bodyLines: buildTwoColumnLines(
+        "当前上下文",
+        buildWorkspaceBoardLines({ state, projectRoot }),
+        "下一步",
+        [
+          "  1. 选择目标工具",
+          "  2. 选择项目级或全局",
+          "  3. 选择档位或自定义资产",
+          "  4. 预览新增、依赖和移除项",
+          "  5. 确认后执行安装"
+        ]
+      ),
+      footerLines: ["Enter 继续"]
+    });
+    await prompt.pause("进入选择流程", "当前上下文已确认，按回车继续进入工具与作用域选择");
     const projectTools = state.project?.tools || [];
     const availableTools = projectTools.filter((toolState) => toolState.manageable && SUPPORTED_TOOLS.includes(toolState.tool));
     printSection("工具选择");
@@ -657,6 +814,30 @@ async function interactiveInstall(options = {}) {
     if (scope === "project" && (state.tools.find((item) => item.tool === selectedTool)?.installed_asset_ids || []).length) {
       inheritGlobal = await prompt.confirm("项目级安装是否继承当前全局已安装资产", true);
     }
+    prompt.renderFrame({
+      eyebrow: "Workspace Context",
+      title: "已确认安装上下文",
+      subtitle: "下面开始选择档位或自定义资产。",
+      bodyLines: buildTwoColumnLines(
+        "当前配置",
+        buildWorkspaceBoardLines({
+          state,
+          projectRoot,
+          selectedTool,
+          scope,
+          inheritGlobal
+        }),
+        "提示",
+        [
+          "  • 选 profile 时会直接带出资产组合",
+          "  • 自定义模式支持关键字筛选",
+          "  • 依赖会在执行前自动补齐",
+          "  • 项目级可按需继承全局安装"
+        ]
+      ),
+      footerLines: ["Enter 继续"]
+    });
+    await prompt.pause("继续选择资产", "当前工具与作用域已确认，按回车继续进入档位或资产选择");
     const profiles = filterProfilesByTool(state, selectedTool);
     printSection("资产组合");
     const profileChoices = profiles.map((profile) => ({
@@ -674,12 +855,7 @@ async function interactiveInstall(options = {}) {
     let selectionMode = "profile";
     let planName = profileId;
     if (profileId === "__custom__") {
-      const assets = filterInstallableAssetsByTool(state, selectedTool);
-      selectedAssetIds = await prompt.multiSelect("选择需要同步到项目的资产", assets.map((asset) => ({
-        label: `${asset.id}`,
-        hint: `${asset.type} / ${asset.domain} / ${asset.status}`,
-        value: asset.id
-      })));
+      selectedAssetIds = await selectAssetsForCustomMode(prompt, state, selectedTool);
       selectionMode = "custom";
       planName = "custom-selection";
     } else {
@@ -690,12 +866,46 @@ async function interactiveInstall(options = {}) {
       ? (state.tools.find((item) => item.tool === selectedTool)?.installed_asset_ids || [])
       : [];
     const previewAssetIds = resolveAssetDependencies(state.assets || [], normalizeAssetSet([...globalInstalled, ...selectedAssetIds]));
-    printSection("执行预览");
-    printKeyValue("目标项目", projectRoot);
-    printKeyValue("目标工具", selectedTool, "cyan");
-    printKeyValue("安装作用域", scope === "project" ? "项目级" : "全局");
-    printKeyValue("选择模式", selectionMode === "profile" ? `档位 ${profileId}` : "自定义资产");
-    printBulletList("即将同步的资产", summarizeAssets(state, previewAssetIds));
+    const diffSummary = buildDiffSummary(toolState.installed_asset_ids || [], previewAssetIds, selectedAssetIds);
+    prompt.renderFrame({
+      eyebrow: "Execution Preview",
+      title: "应用预览",
+      subtitle: "确认后会开始同步仓库、构建组合包并写入目标项目或全局目录。",
+      bodyLines: [
+        ...buildTwoColumnLines(
+          "安装上下文",
+          buildWorkspaceBoardLines({
+            state,
+            projectRoot,
+            selectedTool,
+            scope,
+            profileId: selectionMode === "profile" ? profileId : "",
+            selectionMode,
+            inheritGlobal,
+            selectedAssetIds,
+            previewAssetIds
+          }),
+          "差异摘要",
+          [
+            `  新增        ${diffSummary.added.length} 项`,
+            `  自动依赖    ${diffSummary.autoDependencies.length} 项`,
+            `  移除        ${diffSummary.removed.length} 项`,
+            `  最终安装    ${previewAssetIds.length} 项`
+          ]
+        ),
+        "",
+        ...buildTwoColumnLines(
+          "最终安装资产",
+          buildAssetsPreviewLines(state, previewAssetIds, 8),
+          "新增与移除",
+          [
+            ...buildAssetsPreviewLines(state, diffSummary.added, 4),
+            ...buildAssetsPreviewLines(state, diffSummary.removed, 4)
+          ]
+        )
+      ],
+      footerLines: ["Enter 确认执行    Ctrl+C 退出"]
+    });
     const confirmed = options.yes || await prompt.confirm("确认继续执行安装", true);
     if (!confirmed) {
       printWarning("已取消。");
@@ -768,6 +978,49 @@ async function runList(options = {}) {
   });
 }
 
+async function runProfiles(options = {}) {
+  printBanner();
+  ensureGitMode(options);
+  const projectRoot = options.project ? path.resolve(options.project) : "";
+  const state = core.getAppState({ projectRoot });
+  const targetTools = options.tool ? [options.tool] : SUPPORTED_TOOLS;
+  for (const tool of targetTools) {
+    if (!SUPPORTED_TOOLS.includes(tool)) {
+      throw new Error(`--tool 必须是 ${SUPPORTED_TOOLS.join(" / ")}`);
+    }
+    printSection(`${tool} 可用档位`);
+    const profiles = filterProfilesByTool(state, tool);
+    if (!profiles.length) {
+      printWarning("当前没有可用档位");
+      continue;
+    }
+    profiles.forEach((profile) => {
+      console.log(`  ${color("•", "green")} ${profile.id}  ${color(`${profile.name || profile.id} / ${profile.asset_ids.length} 项`, "dim")}`);
+    });
+  }
+}
+
+async function runAssets(options = {}) {
+  printBanner();
+  ensureGitMode(options);
+  const projectRoot = options.project ? path.resolve(options.project) : "";
+  const state = core.getAppState({ projectRoot });
+  const tool = options.tool || SUPPORTED_TOOLS[0];
+  if (!SUPPORTED_TOOLS.includes(tool)) {
+    throw new Error(`--tool 必须是 ${SUPPORTED_TOOLS.join(" / ")}`);
+  }
+  const assets = filterInstallableAssetsByTool(state, tool);
+  printSection(`${tool} 可安装资产`);
+  if (!assets.length) {
+    printWarning("当前没有可安装资产");
+    return;
+  }
+  assets.forEach((asset) => {
+    console.log(`  ${color("•", "green")} ${asset.id}`);
+    console.log(`    ${color(`${asset.type} / ${asset.domain} / ${asset.status}`, "dim")}`);
+  });
+}
+
 async function runDoctor(options = {}) {
   printBanner();
   ensureGitMode(options);
@@ -790,7 +1043,7 @@ async function runDoctor(options = {}) {
   });
 }
 
-async function runApply(options = {}) {
+async function runUse(options = {}) {
   printBanner();
   if (!options.tool || !SUPPORTED_TOOLS.includes(options.tool)) {
     throw new Error(`--tool 必须是 ${SUPPORTED_TOOLS.join(" / ")}`);
@@ -895,12 +1148,20 @@ async function runCli(argv = process.argv, options = {}) {
     await runList(normalizedOptions);
     return;
   }
+  if (command === "profiles") {
+    await runProfiles(normalizedOptions);
+    return;
+  }
+  if (command === "assets") {
+    await runAssets(normalizedOptions);
+    return;
+  }
   if (command === "doctor") {
     await runDoctor(normalizedOptions);
     return;
   }
-  if (command === "apply") {
-    await runApply(normalizedOptions);
+  if (command === "apply" || command === "use") {
+    await runUse(normalizedOptions);
     return;
   }
   if (command === "update") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sswl/ai-manager",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SSWL AI Manager CLI",
   "license": "UNLICENSED",
   "bin": {