helloloop 0.2.0 → 0.2.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "HelloLoop 的 Claude Code 原生插件元数据，用于多 CLI 宿主分发。",
   "author": {
     "name": "HelloLoop"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件，Codex 路径为首发与参考实现。",
   "author": {
     "name": "HelloLoop"

package/README.md

@@ -112,7 +112,7 @@ pwsh -NoLogo -NoProfile -File .\scripts\install-home-plugin.ps1 -CodexHome <CODE
 安装完成后：
 
 - Codex 会写入 `<CODEX_HOME>/plugins/helloloop`
-- Claude 会写入 `<CLAUDE_HOME>/marketplaces/helloloop-local`
+- Claude 会写入 `<CLAUDE_HOME>/plugins/marketplaces/helloloop-local`，并生成 `<CLAUDE_HOME>/plugins/cache/helloloop-local/helloloop/<VERSION>`
 - Gemini 会写入 `<GEMINI_HOME>/extensions/helloloop`
 
 如果你想在安装后做一次全宿主环境检查：

package/hosts/claude/marketplace/.claude-plugin/marketplace.json

@@ -3,10 +3,12 @@
   "owner": {
     "name": "HelloLoop"
   },
+  "metadata": {
+    "description": "HelloLoop 的 Claude Code 本地 marketplace，提供基于开发文档的分析、确认与自动接续开发工作流。"
+  },
   "plugins": [
     {
       "name": "helloloop",
-      "displayName": "HelloLoop",
       "description": "基于开发文档分析当前进度、展示确认单，并在确认后继续接续开发的 Claude Code 原生插件。",
       "source": "./plugins/helloloop"
     }

package/hosts/claude/marketplace/plugins/helloloop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "HelloLoop 的 Claude Code 原生插件。",
   "author": {
     "name": "HelloLoop"

package/hosts/gemini/extension/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "HelloLoop 的 Gemini CLI 原生扩展，用于按开发文档接续推进项目开发。",
   "contextFileName": "GEMINI.md",
   "excludeTools": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件",
   "author": "HelloLoop",
   "license": "Apache-2.0",

package/src/cli_support.mjs

@@ -151,16 +151,36 @@ function collectClaudeDoctorChecks(context, options = {}) {
 
   if (options.claudeHome) {
     const settingsFile = path.join(options.claudeHome, "settings.json");
+    const knownMarketplacesFile = path.join(options.claudeHome, "plugins", "known_marketplaces.json");
+    const installedPluginsFile = path.join(options.claudeHome, "plugins", "installed_plugins.json");
     const settings = fileExists(settingsFile) ? readJson(settingsFile) : {};
+    const installedPlugins = fileExists(installedPluginsFile) ? readJson(installedPluginsFile) : {};
+    const installs = Array.isArray(installedPlugins?.plugins?.["helloloop@helloloop-local"])
+      ? installedPlugins.plugins["helloloop@helloloop-local"]
+      : [];
+    const installedPluginRoot = installs[0]?.installPath
+      ? String(installs[0].installPath)
+      : path.join(options.claudeHome, "plugins", "cache", "helloloop-local", "helloloop");
+
     checks.push({
       name: "claude installed marketplace",
-      ok: fileExists(path.join(options.claudeHome, "marketplaces", "helloloop-local", ".claude-plugin", "marketplace.json")),
-      detail: path.join(options.claudeHome, "marketplaces", "helloloop-local", ".claude-plugin", "marketplace.json"),
+      ok: fileExists(path.join(options.claudeHome, "plugins", "marketplaces", "helloloop-local", ".claude-plugin", "marketplace.json")),
+      detail: path.join(options.claudeHome, "plugins", "marketplaces", "helloloop-local", ".claude-plugin", "marketplace.json"),
+    });
+    checks.push({
+      name: "claude marketplace registry",
+      ok: fileExists(knownMarketplacesFile),
+      detail: knownMarketplacesFile,
+    });
+    checks.push({
+      name: "claude installed plugin index",
+      ok: fileExists(installedPluginsFile),
+      detail: installedPluginsFile,
     });
     checks.push({
       name: "claude installed plugin",
-      ok: fileExists(path.join(options.claudeHome, "marketplaces", "helloloop-local", "plugins", "helloloop", ".claude-plugin", "plugin.json")),
-      detail: path.join(options.claudeHome, "marketplaces", "helloloop-local", "plugins", "helloloop", ".claude-plugin", "plugin.json"),
+      ok: fileExists(path.join(installedPluginRoot, ".claude-plugin", "plugin.json")),
+      detail: path.join(installedPluginRoot, ".claude-plugin", "plugin.json"),
     });
     checks.push({
       name: "claude settings enabled",

package/src/install.mjs

@@ -3,7 +3,7 @@ import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-import { ensureDir, fileExists, readJson, writeJson } from "./common.mjs";
+import { ensureDir, fileExists, nowIso, readJson, writeJson } from "./common.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -28,6 +28,8 @@ const codexBundleEntries = runtimeBundleEntries.filter((entry) => ![
 ].includes(entry));
 
 const supportedHosts = ["codex", "claude", "gemini"];
+const CLAUDE_MARKETPLACE_NAME = "helloloop-local";
+const CLAUDE_PLUGIN_KEY = "helloloop@helloloop-local";
 
 function resolveHomeDir(homeDir, defaultDirName) {
   return path.resolve(homeDir || path.join(os.homedir(), defaultDirName));
@@ -118,15 +120,57 @@ function updateClaudeSettings(settingsFile, marketplaceRoot) {
   settings.extraKnownMarketplaces = settings.extraKnownMarketplaces || {};
   settings.enabledPlugins = settings.enabledPlugins || {};
 
-  settings.extraKnownMarketplaces["helloloop-local"] = {
-    source: "directory",
-    path: marketplaceRoot.replaceAll("\\", "/"),
+  settings.extraKnownMarketplaces[CLAUDE_MARKETPLACE_NAME] = {
+    source: {
+      source: "directory",
+      path: marketplaceRoot,
+    },
   };
-  settings.enabledPlugins["helloloop@helloloop-local"] = true;
+  settings.enabledPlugins[CLAUDE_PLUGIN_KEY] = true;
 
   writeJson(settingsFile, settings);
 }
 
+function updateClaudeKnownMarketplaces(knownMarketplacesFile, marketplaceRoot, updatedAt) {
+  const knownMarketplaces = fileExists(knownMarketplacesFile)
+    ? readJson(knownMarketplacesFile)
+    : {};
+
+  knownMarketplaces[CLAUDE_MARKETPLACE_NAME] = {
+    source: {
+      source: "directory",
+      path: marketplaceRoot,
+    },
+    installLocation: marketplaceRoot,
+    lastUpdated: updatedAt,
+  };
+
+  writeJson(knownMarketplacesFile, knownMarketplaces);
+}
+
+function updateClaudeInstalledPlugins(installedPluginsFile, pluginRoot, pluginVersion, updatedAt) {
+  const installedPlugins = fileExists(installedPluginsFile)
+    ? readJson(installedPluginsFile)
+    : {
+        version: 2,
+        plugins: {},
+      };
+
+  installedPlugins.version = 2;
+  installedPlugins.plugins = installedPlugins.plugins || {};
+  installedPlugins.plugins[CLAUDE_PLUGIN_KEY] = [
+    {
+      scope: "user",
+      installPath: pluginRoot,
+      version: pluginVersion,
+      installedAt: updatedAt,
+      lastUpdated: updatedAt,
+    },
+  ];
+
+  writeJson(installedPluginsFile, installedPlugins);
+}
+
 function installCodexHost(bundleRoot, options) {
   const resolvedCodexHome = resolveHomeDir(options.codexHome, ".codex");
   const targetPluginsRoot = path.join(resolvedCodexHome, "plugins");
@@ -165,7 +209,13 @@ function installClaudeHost(bundleRoot, options) {
   const resolvedClaudeHome = resolveHomeDir(options.claudeHome, ".claude");
   const sourceMarketplaceRoot = path.join(bundleRoot, "hosts", "claude", "marketplace");
   const sourceManifest = path.join(bundleRoot, ".claude-plugin", "plugin.json");
-  const targetMarketplaceRoot = path.join(resolvedClaudeHome, "marketplaces", "helloloop-local");
+  const pluginVersion = readJson(sourceManifest).version || readJson(path.join(bundleRoot, "package.json")).version;
+  const targetPluginsRoot = path.join(resolvedClaudeHome, "plugins");
+  const targetMarketplaceRoot = path.join(targetPluginsRoot, "marketplaces", CLAUDE_MARKETPLACE_NAME);
+  const targetCachePluginsRoot = path.join(targetPluginsRoot, "cache", CLAUDE_MARKETPLACE_NAME, "helloloop");
+  const targetInstalledPluginRoot = path.join(targetCachePluginsRoot, pluginVersion);
+  const knownMarketplacesFile = path.join(targetPluginsRoot, "known_marketplaces.json");
+  const installedPluginsFile = path.join(targetPluginsRoot, "installed_plugins.json");
   const settingsFile = path.join(resolvedClaudeHome, "settings.json");
 
   if (!fileExists(sourceManifest)) {
@@ -176,16 +226,24 @@ function installClaudeHost(bundleRoot, options) {
   }
 
   assertPathInside(resolvedClaudeHome, targetMarketplaceRoot, "Claude marketplace 目录");
+  assertPathInside(resolvedClaudeHome, targetInstalledPluginRoot, "Claude 插件缓存目录");
   removeTargetIfNeeded(targetMarketplaceRoot, options.force);
+  removeTargetIfNeeded(targetCachePluginsRoot, options.force);
 
   ensureDir(path.dirname(targetMarketplaceRoot));
+  ensureDir(path.dirname(targetInstalledPluginRoot));
   copyDirectory(sourceMarketplaceRoot, targetMarketplaceRoot);
+  copyDirectory(path.join(sourceMarketplaceRoot, "plugins", "helloloop"), targetInstalledPluginRoot);
+  ensureDir(targetPluginsRoot);
+  const updatedAt = nowIso();
   updateClaudeSettings(settingsFile, targetMarketplaceRoot);
+  updateClaudeKnownMarketplaces(knownMarketplacesFile, targetMarketplaceRoot, updatedAt);
+  updateClaudeInstalledPlugins(installedPluginsFile, targetInstalledPluginRoot, pluginVersion, updatedAt);
 
   return {
     host: "claude",
     displayName: "Claude",
-    targetRoot: path.join(targetMarketplaceRoot, "plugins", "helloloop"),
+    targetRoot: targetInstalledPluginRoot,
     marketplaceFile: path.join(targetMarketplaceRoot, ".claude-plugin", "marketplace.json"),
     settingsFile,
   };