openclawmp 0.1.1 → 0.1.3

package/bin/openclawmp.js

@@ -16,16 +16,24 @@ const { printHelp } = require(path.join(libDir, 'help.js'));
 // Command handlers (lazy-loaded)
 const cmdDir = path.join(libDir, 'commands');
 const commands = {
-  install:    () => require(path.join(cmdDir, 'install.js')),
-  uninstall:  () => require(path.join(cmdDir, 'uninstall.js')),
-  search:     () => require(path.join(cmdDir, 'search.js')),
-  list:       () => require(path.join(cmdDir, 'list.js')),
-  info:       () => require(path.join(cmdDir, 'info.js')),
-  publish:    () => require(path.join(cmdDir, 'publish.js')),
-  login:      () => require(path.join(cmdDir, 'login.js')),
-  authorize:  () => require(path.join(cmdDir, 'login.js')),  // alias
-  whoami:     () => require(path.join(cmdDir, 'whoami.js')),
-  help:       () => ({ run: () => printHelp() }),
+  install:          () => require(path.join(cmdDir, 'install.js')),
+  uninstall:        () => require(path.join(cmdDir, 'uninstall.js')),
+  search:           () => require(path.join(cmdDir, 'search.js')),
+  list:             () => require(path.join(cmdDir, 'list.js')),
+  info:             () => require(path.join(cmdDir, 'info.js')),
+  publish:          () => require(path.join(cmdDir, 'publish.js')),
+  login:            () => require(path.join(cmdDir, 'login.js')),
+  authorize:        () => require(path.join(cmdDir, 'login.js')),  // alias
+  whoami:           () => require(path.join(cmdDir, 'whoami.js')),
+  star:             () => ({ run: (a, f) => require(path.join(cmdDir, 'star.js')).runStar(a, f) }),
+  unstar:           () => ({ run: (a, f) => require(path.join(cmdDir, 'star.js')).runUnstar(a, f) }),
+  comment:          () => ({ run: (a, f) => require(path.join(cmdDir, 'comment.js')).runComment(a, f) }),
+  comments:         () => ({ run: (a, f) => require(path.join(cmdDir, 'comment.js')).runComments(a, f) }),
+  issue:            () => ({ run: (a, f) => require(path.join(cmdDir, 'issue.js')).runIssue(a, f) }),
+  issues:           () => ({ run: (a, f) => require(path.join(cmdDir, 'issue.js')).runIssues(a, f) }),
+  'delete-account': () => require(path.join(cmdDir, 'delete-account.js')),
+  unbind:           () => require(path.join(cmdDir, 'unbind.js')),
+  help:             () => ({ run: () => printHelp() }),
 };
 
 async function main() {

package/lib/api.js

@@ -1,6 +1,7 @@
 // ============================================================================
 // api.js — HTTP request helpers for the OpenClaw Marketplace API
 //
+// Uses V1 API endpoints for lightweight responses (AssetCompact).
 // Uses Node.js built-in fetch (available since Node 18)
 // ============================================================================
 
@@ -22,7 +23,7 @@ function authHeaders() {
 
 /**
  * Make a GET request to the API
- * @param {string} apiPath - API path (e.g., '/api/assets')
+ * @param {string} apiPath - API path (e.g., '/api/v1/assets')
  * @param {object} [params] - Query parameters
  * @returns {Promise<object>} Parsed JSON response
  */
@@ -107,40 +108,53 @@ async function download(apiPath) {
 }
 
 /**
- * Search assets
+ * Search assets via V1 API (returns lightweight AssetCompact items).
+ *
+ * V1 response shape: { query, total, items: AssetCompact[], nextCursor }
+ * AssetCompact fields: id, name, displayName, type, description, tags,
+ *   installs, rating, author (string), authorId, version, installCommand,
+ *   updatedAt, category
+ *
  * @param {string} query
  * @param {object} [opts] - { type, limit }
- * @returns {Promise<object>}
+ * @returns {Promise<object>} V1 search response
  */
 async function searchAssets(query, opts = {}) {
   const params = { q: query, limit: opts.limit || 20 };
   if (opts.type) params.type = opts.type;
-  return get('/api/assets', params);
+  return get('/api/v1/search', params);
 }
 
 /**
- * Find an asset by type and slug (with optional author filter)
+ * Find an asset by type and slug (with optional author filter).
+ * Uses V1 list endpoint for lightweight data.
+ *
  * @param {string} type
  * @param {string} slug
- * @param {string} [authorFilter]
+ * @param {string} [authorFilter] - author ID or author name to filter by
  * @returns {Promise<object|null>}
  */
 async function findAsset(type, slug, authorFilter) {
-  const result = await get('/api/assets', { q: slug, limit: 50 });
-  const assets = result?.data?.assets || [];
+  const result = await get('/api/v1/assets', { q: slug, type, limit: 50 });
+  const assets = result?.items || [];
 
-  // Exact match on type + name
-  let matches = assets.filter(a => a.type === type && a.name === slug);
+  // Exact match on name
+  let matches = assets.filter(a => a.name === slug);
   if (authorFilter) {
-    const authorMatches = matches.filter(a => (a.author?.id || '') === authorFilter);
+    // authorFilter could be an authorId or author name
+    const authorMatches = matches.filter(a =>
+      a.authorId === authorFilter || a.author === authorFilter
+    );
     if (authorMatches.length > 0) matches = authorMatches;
   }
 
-  // Fallback: partial match
+  // Fallback: partial match on name
   if (matches.length === 0) {
-    matches = assets.filter(a => a.type === type && a.name.includes(slug));
+    matches = assets.filter(a => a.name.includes(slug));
     if (authorFilter) {
-      const authorMatches = matches.filter(a => (a.author?.id || '') === authorFilter);
+      const authorMatches = matches.filter(a =>
+        a.authorId === authorFilter || a.author === authorFilter
+      );
       if (authorMatches.length > 0) matches = authorMatches;
     }
   }
@@ -148,15 +162,100 @@ async function findAsset(type, slug, authorFilter) {
   if (matches.length === 0) return null;
 
   // Prefer the one with an author ID
-  matches.sort((a, b) => (b.author?.id || '').localeCompare(a.author?.id || ''));
+  matches.sort((a, b) => (b.authorId || '').localeCompare(a.authorId || ''));
   return matches[0];
 }
 
+/**
+ * Get asset detail (L2) by ID via V1 API.
+ * Returns full detail including readme, files, versions.
+ *
+ * @param {string} id - Asset ID
+ * @returns {Promise<object|null>}
+ */
+async function getAssetById(id) {
+  try {
+    return await get(`/api/v1/assets/${id}`);
+  } catch (e) {
+    if (e.message.includes('404')) return null;
+    throw e;
+  }
+}
+
+/**
+ * Make a DELETE request to the API
+ * @param {string} apiPath
+ * @param {object} [body] - Optional JSON body
+ * @returns {Promise<{status: number, data: object}>}
+ */
+async function del(apiPath, body) {
+  const url = new URL(apiPath, config.getApiBase());
+
+  const opts = {
+    method: 'DELETE',
+    headers: { ...authHeaders() },
+  };
+  if (body) {
+    opts.headers['Content-Type'] = 'application/json';
+    opts.body = JSON.stringify(body);
+  }
+
+  const res = await fetch(url.toString(), opts);
+  const data = await res.json().catch(() => ({}));
+  return { status: res.status, data };
+}
+
+/**
+ * Resolve an asset reference to a full asset object.
+ * Accepts:
+ *   - Direct ID: "s-abc123", "tr-fc617094de29f938"
+ *   - type/@author/slug: "trigger/@xiaoyue/pdf-watcher"
+ *
+ * Uses V1 API: GET /api/v1/assets/:id for ID lookups,
+ * findAsset() (V1 search) for type/slug lookups.
+ *
+ * @param {string} ref
+ * @returns {Promise<object>} asset object with at least { id, name, ... }
+ */
+async function resolveAssetRef(ref) {
+  // Direct ID pattern: prefix + dash + hex
+  if (/^[a-z]+-[0-9a-f]{8,}$/.test(ref)) {
+    const result = await getAssetById(ref);
+    if (!result) throw new Error(`Asset not found: ${ref}`);
+    return result;
+  }
+
+  // type/@author/slug format
+  const parts = ref.split('/');
+  if (parts.length < 2) {
+    throw new Error(`Invalid asset reference: ${ref}. Use <id> or <type>/@<author>/<slug>`);
+  }
+
+  const type = parts[0];
+  let slug, authorFilter = '';
+
+  if (parts.length >= 3 && parts[1].startsWith('@')) {
+    authorFilter = parts[1].slice(1);
+    slug = parts.slice(2).join('/');
+  } else {
+    slug = parts.slice(1).join('/');
+  }
+
+  const asset = await findAsset(type, slug, authorFilter);
+  if (!asset) {
+    throw new Error(`Asset not found: ${ref}`);
+  }
+  return asset;
+}
+
 module.exports = {
   get,
   post,
+  del,
   postMultipart,
   download,
   searchAssets,
   findAsset,
+  getAssetById,
+  resolveAssetRef,
 };

package/lib/commands/comment.js

@@ -0,0 +1,119 @@
+// ============================================================================
+// commands/comment.js — Post / list comments on an asset
+// ============================================================================
+
+'use strict';
+
+const api = require('../api.js');
+const auth = require('../auth.js');
+const { ok, info, err, c, detail } = require('../ui.js');
+
+/**
+ * Format a timestamp to a readable date string
+ */
+function fmtDate(ts) {
+  if (!ts) return '?';
+  const d = new Date(ts);
+  if (isNaN(d.getTime())) return String(ts);
+  return d.toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' });
+}
+
+/**
+ * Render star rating: ★★★★☆
+ */
+function renderRating(rating) {
+  if (!rating) return '';
+  const n = Math.max(0, Math.min(5, Math.round(rating)));
+  return c('yellow', '★'.repeat(n)) + c('dim', '☆'.repeat(5 - n));
+}
+
+/**
+ * openclawmp comment <assetRef> <content> [--rating N] [--as-agent]
+ */
+async function runComment(args, flags) {
+  if (args.length < 2) {
+    err('Usage: openclawmp comment <assetRef> <content> [--rating 5] [--as-agent]');
+    console.log('  Example: openclawmp comment trigger/@xiaoyue/pdf-watcher "非常好用！"');
+    process.exit(1);
+  }
+
+  if (!auth.isAuthenticated()) {
+    err('Authentication required. Run: openclawmp login');
+    process.exit(1);
+  }
+
+  const asset = await api.resolveAssetRef(args[0]);
+  const content = args.slice(1).join(' ');
+  const displayName = asset.displayName || asset.name || args[0];
+
+  const body = {
+    content,
+    commenterType: flags['as-agent'] ? 'agent' : 'user',
+  };
+
+  if (flags.rating !== undefined) {
+    const rating = parseInt(flags.rating, 10);
+    if (isNaN(rating) || rating < 1 || rating > 5) {
+      err('Rating must be between 1 and 5');
+      process.exit(1);
+    }
+    body.rating = rating;
+  }
+
+  const { status, data } = await api.post(`/api/assets/${asset.id}/comments`, body);
+
+  if (status >= 200 && status < 300) {
+    const comment = data.comment || data;
+    console.log('');
+    ok(`评论已发布到 ${c('bold', displayName)}`);
+    if (body.rating) {
+      detail('评分', renderRating(body.rating));
+    }
+    detail('内容', content);
+    console.log('');
+  } else {
+    err(`评论失败 (${status}): ${data.error || data.message || JSON.stringify(data)}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * openclawmp comments <assetRef>
+ */
+async function runComments(args) {
+  if (args.length === 0) {
+    err('Usage: openclawmp comments <assetRef>');
+    console.log('  Example: openclawmp comments trigger/@xiaoyue/pdf-watcher');
+    process.exit(1);
+  }
+
+  const asset = await api.resolveAssetRef(args[0]);
+  const displayName = asset.displayName || asset.name || args[0];
+
+  const result = await api.get(`/api/assets/${asset.id}/comments`);
+  const comments = result?.data?.comments || result?.comments || [];
+
+  console.log('');
+  info(`${c('bold', displayName)} 的评论（${comments.length} 条）`);
+  console.log(`  ${'─'.repeat(50)}`);
+
+  if (comments.length === 0) {
+    console.log(`  ${c('dim', '暂无评论。成为第一个评论者吧！')}`);
+    console.log('');
+    console.log(`  openclawmp comment ${args[0]} "你的评论"`);
+  } else {
+    for (const cm of comments) {
+      const author = cm.author?.name || cm.authorName || cm.commenterType || 'anonymous';
+      const rating = cm.rating ? ` ${renderRating(cm.rating)}` : '';
+      const badge = cm.commenterType === 'agent' ? c('magenta', ' 🤖') : '';
+      const time = fmtDate(cm.createdAt || cm.created_at);
+
+      console.log('');
+      console.log(`  ${c('cyan', author)}${badge}${rating}  ${c('dim', time)}`);
+      console.log(`  ${cm.content}`);
+    }
+  }
+  console.log('');
+}
+
+module.exports = { runComment, runComments };

package/lib/commands/delete-account.js

@@ -0,0 +1,44 @@
+// ============================================================================
+// commands/delete-account.js — Delete (deactivate) account + unbind devices
+// ============================================================================
+
+'use strict';
+
+const api = require('../api.js');
+const { fish, ok, err, warn, c, detail } = require('../ui.js');
+
+async function run(args, flags) {
+  fish('Requesting account deletion...');
+
+  // Safety: require --confirm flag
+  if (!flags.confirm && !flags.yes && !flags.y) {
+    console.log('');
+    warn('This will permanently deactivate your account:');
+    console.log('');
+    console.log('  • 软删除账号（设置 deleted_at）');
+    console.log('  • 解绑所有设备');
+    console.log('  • 撤销所有 API Key');
+    console.log('  • 解除 OAuth 关联（GitHub/Google 可重新注册）');
+    console.log('  • 已发布的资产保留，不删除');
+    console.log('');
+    console.log(`  To confirm, run: ${c('bold', 'openclawmp delete-account --confirm')}`);
+    console.log('');
+    return;
+  }
+
+  const { status, data } = await api.del('/api/auth/account');
+
+  if (status >= 200 && status < 300 && data?.success) {
+    console.log('');
+    ok('账号已注销');
+    console.log('');
+    detail('状态', '设备已解绑，API Key 已撤销，OAuth 已解除关联');
+    detail('资产', '已发布的资产仍会保留');
+    console.log('');
+  } else {
+    err(data?.message || data?.error || `Account deletion failed (HTTP ${status})`);
+    process.exit(1);
+  }
+}
+
+module.exports = { run };

package/lib/commands/info.js

@@ -27,8 +27,9 @@ async function run(args) {
     process.exit(1);
   }
 
-  const authorName = asset.author?.name || 'unknown';
-  const authorId = asset.author?.id || '';
+  // V1 AssetCompact: author is a string, authorId is separate
+  const authorName = asset.author || 'unknown';
+  const authorId = asset.authorId || '';
   const tags = (asset.tags || []).join(', ');
 
   console.log('');
@@ -38,8 +39,7 @@ async function run(args) {
   console.log(`  Package:   ${asset.name}`);
   console.log(`  Version:   ${asset.version}`);
   console.log(`  Author:    ${c('cyan', authorName)} ${c('dim', `(${authorId})`)}`);
-  console.log(`  Score:     ${asset.hubScore || 0}`);
-  console.log(`  Downloads: ${asset.downloads || 0}`);
+  console.log(`  Installs:  ${asset.installs || 0}`);
   if (tags) {
     console.log(`  Tags:      ${tags}`);
   }

package/lib/commands/install.js

@@ -96,31 +96,6 @@ function countFiles(dir) {
   return count;
 }
 
-/**
- * Generate fallback SKILL.md from asset metadata
- */
-function generateSkillMd(asset, targetDir) {
-  const tags = (asset.tags || []).join(', ');
-  const content = `---
-name: ${asset.name}
-display-name: ${asset.displayName || ''}
-description: ${asset.description || ''}
-version: ${asset.version}
-author: ${asset.author?.name || ''}
-author-id: ${asset.author?.id || ''}
-tags: ${tags}
-category: ${asset.category || ''}
----
-
-# ${asset.displayName || asset.name}
-
-${asset.description || ''}
-
-${asset.readme || ''}
-`;
-  fs.writeFileSync(path.join(targetDir, 'SKILL.md'), content);
-}
-
 /**
  * Write manifest.json for the installed asset
  */
@@ -131,7 +106,8 @@ function writeManifest(asset, targetDir, hasPackage) {
     name: asset.name,
     displayName: asset.displayName || '',
     version: asset.version,
-    author: asset.author,
+    author: asset.author || '',
+    authorId: asset.authorId || '',
     description: asset.description || '',
     tags: asset.tags || [],
     category: asset.category || '',
@@ -145,26 +121,24 @@ function writeManifest(asset, targetDir, hasPackage) {
 /**
  * Post-install hints per asset type
  */
-function showPostInstallHints(type, slug) {
+function showPostInstallHints(type, slug, targetDir) {
   switch (type) {
     case 'skill':
       console.log(`   ${c('green', 'Ready!')} Will be loaded in the next agent session.`);
       break;
-    case 'config':
-      console.log(`   To activate: ${c('bold', `openclawmp apply config/${slug}`)}`);
-      break;
-    case 'trigger':
-      console.log(`   ${c('yellow', 'Check dependencies:')} fswatch (macOS) / inotifywait (Linux)`);
-      console.log('   Quick start: see SKILL.md in the installed directory');
-      break;
     case 'plugin':
       console.log(`   ${c('yellow', 'Requires restart:')} openclaw gateway restart`);
       break;
     case 'channel':
       console.log(`   ${c('yellow', 'Requires config:')} Set credentials in openclaw.json, then restart`);
       break;
-    case 'template':
-      console.log(`   To scaffold: ${c('bold', `openclawmp apply template/${slug} --workspace ./my-agent`)}`);
+    case 'trigger':
+      console.log(`   ${c('yellow', 'Manual setup:')} Read README.md for cron/heartbeat configuration`);
+      console.log(`   ${c('dim', `cat ${targetDir}/README.md`)}`);
+      break;
+    case 'experience':
+      console.log(`   ${c('yellow', 'Reference:')} Read README.md for setup instructions`);
+      console.log(`   ${c('dim', `cat ${targetDir}/README.md`)}`);
       break;
   }
 }
@@ -194,8 +168,8 @@ async function run(args, flags) {
 
   const displayName = asset.displayName || asset.name;
   const version = asset.version;
-  const authorName = asset.author?.name || 'unknown';
-  const authorId = asset.author?.id || '';
+  const authorName = asset.author || 'unknown';
+  const authorId = asset.authorId || '';
 
   console.log(`  ${c('bold', displayName)} ${c('dim', `v${version}`)}`);
   console.log(`  by ${c('cyan', authorName)} ${c('dim', `(${authorId})`)}`);
@@ -230,7 +204,7 @@ async function run(args, flags) {
 
   // Try downloading the actual package
   let hasPackage = false;
-  const pkgBuffer = await api.download(`/api/assets/${asset.id}/download`);
+  const pkgBuffer = await api.download(`/api/v1/assets/${asset.id}/download`);
 
   if (pkgBuffer && pkgBuffer.length > 0) {
     info('📦 Downloading package from registry...');
@@ -241,11 +215,12 @@ async function run(args, flags) {
     }
   }
 
-  // Fallback: generate from metadata if no package
+  // No package → error (no fallback generation)
   if (!hasPackage) {
-    info('No package available, generating from metadata...');
-    generateSkillMd(asset, targetDir);
-    console.log('  Generated: SKILL.md from metadata');
+    try { fs.rmSync(targetDir, { recursive: true, force: true }); } catch {}
+    err('该资产没有可安装的 package。');
+    console.log(`  请在水产市场查看详情：${config.getApiBase()}/asset/${asset.id}`);
+    process.exit(1);
   }
 
   // Always write manifest.json
@@ -263,7 +238,7 @@ async function run(args, flags) {
   detail('Command', `openclawmp install ${type}/@${authorId}/${slug}`);
   console.log('');
 
-  showPostInstallHints(type, slug);
+  showPostInstallHints(type, slug, targetDir);
   console.log('');
 }
 

package/lib/commands/issue.js

@@ -0,0 +1,125 @@
+// ============================================================================
+// commands/issue.js — Create / list issues on an asset
+// ============================================================================
+
+'use strict';
+
+const api = require('../api.js');
+const auth = require('../auth.js');
+const { ok, info, err, c, detail } = require('../ui.js');
+
+/**
+ * Format a timestamp to a readable date string
+ */
+function fmtDate(ts) {
+  if (!ts) return '?';
+  const d = new Date(ts);
+  if (isNaN(d.getTime())) return String(ts);
+  return d.toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' });
+}
+
+/**
+ * Render issue status with color
+ */
+function renderStatus(status) {
+  switch (status) {
+    case 'open':   return c('green', '● open');
+    case 'closed': return c('red', '● closed');
+    default:       return c('dim', status || 'open');
+  }
+}
+
+/**
+ * openclawmp issue <assetRef> <title> [--body "..."] [--labels "bug,help"] [--as-agent]
+ */
+async function runIssue(args, flags) {
+  if (args.length < 2) {
+    err('Usage: openclawmp issue <assetRef> <title> [--body "..."] [--labels "bug,help"] [--as-agent]');
+    console.log('  Example: openclawmp issue trigger/@xiaoyue/pdf-watcher "安装后无法启动" --body "详细描述..."');
+    process.exit(1);
+  }
+
+  if (!auth.isAuthenticated()) {
+    err('Authentication required. Run: openclawmp login');
+    process.exit(1);
+  }
+
+  const asset = await api.resolveAssetRef(args[0]);
+  const title = args.slice(1).join(' ');
+  const displayName = asset.displayName || asset.name || args[0];
+
+  const body = {
+    title,
+    authorType: flags['as-agent'] ? 'agent' : 'user',
+  };
+
+  if (flags.body) {
+    body.bodyText = flags.body;
+  }
+
+  if (flags.labels) {
+    body.labels = flags.labels.split(',').map(l => l.trim()).filter(Boolean);
+  }
+
+  const { status, data } = await api.post(`/api/assets/${asset.id}/issues`, body);
+
+  if (status >= 200 && status < 300) {
+    const issue = data.issue || data;
+    const issueNum = issue.number || issue.id || '?';
+
+    console.log('');
+    ok(`Issue #${issueNum} 已创建于 ${c('bold', displayName)}`);
+    detail('标题', title);
+    if (flags.body) {
+      detail('描述', flags.body.length > 60 ? flags.body.slice(0, 60) + '...' : flags.body);
+    }
+    if (flags.labels) {
+      detail('标签', flags.labels);
+    }
+    console.log('');
+  } else {
+    err(`创建 Issue 失败 (${status}): ${data.error || data.message || JSON.stringify(data)}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * openclawmp issues <assetRef>
+ */
+async function runIssues(args) {
+  if (args.length === 0) {
+    err('Usage: openclawmp issues <assetRef>');
+    console.log('  Example: openclawmp issues trigger/@xiaoyue/pdf-watcher');
+    process.exit(1);
+  }
+
+  const asset = await api.resolveAssetRef(args[0]);
+  const displayName = asset.displayName || asset.name || args[0];
+
+  const result = await api.get(`/api/assets/${asset.id}/issues`);
+  const issues = result?.data?.issues || result?.issues || [];
+
+  console.log('');
+  info(`${c('bold', displayName)} 的 Issues（${issues.length} 个）`);
+  console.log(`  ${'─'.repeat(50)}`);
+
+  if (issues.length === 0) {
+    console.log(`  ${c('dim', '暂无 Issues。')}`);
+  } else {
+    for (const iss of issues) {
+      const num = iss.number || iss.id || '?';
+      const status = renderStatus(iss.status);
+      const author = iss.author?.name || iss.authorName || iss.authorType || 'anonymous';
+      const badge = iss.authorType === 'agent' ? c('magenta', ' 🤖') : '';
+      const time = fmtDate(iss.createdAt || iss.created_at);
+      const labels = (iss.labels || []).map(l => c('yellow', `[${l}]`)).join(' ');
+
+      console.log('');
+      console.log(`  ${status}  ${c('bold', `#${num}`)} ${iss.title} ${labels}`);
+      console.log(`  ${c('dim', `by ${author}${badge} · ${time}`)}`);
+    }
+  }
+  console.log('');
+}
+
+module.exports = { runIssue, runIssues };

package/lib/commands/publish.js

@@ -186,11 +186,57 @@ async function run(args, flags) {
     }
   }
 
-  // Warn about missing description
-  if (!meta.description) {
-    warn('No description found — metadata may be incomplete');
-    console.log('  The server will attempt to extract from package contents.');
+  // ─── Validate package contents (hard block) ─────────────────────────
+  const valErrors = [];
+  switch (meta.type) {
+    case 'skill': {
+      const sp = path.join(skillDir, 'SKILL.md');
+      if (!fs.existsSync(sp)) { valErrors.push('缺少 SKILL.md — skill 类型必须包含此文件'); break; }
+      const { frontmatter: sfm, body: sbody } = parseFrontmatter(fs.readFileSync(sp, 'utf-8'));
+      if (!sfm.name && !sfm.displayName && !sfm['display-name']) valErrors.push('SKILL.md frontmatter 缺少 name');
+      if (!sfm.description) valErrors.push('SKILL.md frontmatter 缺少 description');
+      if (!sbody.trim()) valErrors.push('SKILL.md 正文为空（frontmatter 之后需要技能说明）');
+      break;
+    }
+    case 'plugin':
+    case 'channel': {
+      const pjp = path.join(skillDir, 'openclaw.plugin.json');
+      if (!fs.existsSync(pjp)) { valErrors.push(`缺少 openclaw.plugin.json — ${meta.type} 类型必须包含此文件`); break; }
+      try {
+        const pd = JSON.parse(fs.readFileSync(pjp, 'utf-8'));
+        if (!pd.id) valErrors.push('openclaw.plugin.json 缺少 id');
+        if (meta.type === 'channel' && (!Array.isArray(pd.channels) || !pd.channels.length)) {
+          valErrors.push('openclaw.plugin.json 缺少 channels 数组（channel 类型必须声明）');
+        }
+      } catch { valErrors.push('openclaw.plugin.json JSON 格式错误'); break; }
+      if (!fs.existsSync(path.join(skillDir, 'README.md'))) valErrors.push(`缺少 README.md — ${meta.type} 类型必须包含 README.md`);
+      if (!meta.displayName || !meta.description) valErrors.push('无法提取 displayName/description — 请在 openclaw.plugin.json 添加 name/description 或确保 README.md 有标题和描述');
+      break;
+    }
+    case 'trigger':
+    case 'experience': {
+      const rp = path.join(skillDir, 'README.md');
+      if (!fs.existsSync(rp)) { valErrors.push(`缺少 README.md — ${meta.type} 类型必须包含此文件`); break; }
+      const rc = fs.readFileSync(rp, 'utf-8');
+      let ht = false, hd = false;
+      for (const l of rc.split('\n')) {
+        const t = l.trim();
+        if (!ht && /^#\s+.+/.test(t)) { ht = true; continue; }
+        if (ht && !hd && t && !t.startsWith('#') && !t.startsWith('---') && !t.startsWith('>')) { hd = true; break; }
+      }
+      if (!ht) valErrors.push('README.md 缺少标题行（# 名称）');
+      if (!hd) valErrors.push('README.md 缺少描述段落（标题后需要有文字说明）');
+      break;
+    }
+  }
+
+  if (valErrors.length) {
     console.log('');
+    err('发布校验失败：');
+    for (const e of valErrors) console.log(`  ${c('red', '✗')} ${e}`);
+    console.log('');
+    info('请补全以上内容后重新发布。');
+    process.exit(1);
   }
 
   // Show preview

package/lib/commands/search.js

@@ -18,8 +18,8 @@ async function run(args) {
   console.log('');
 
   const result = await api.searchAssets(query);
-  const assets = result?.data?.assets || [];
-  const total = result?.data?.total || 0;
+  const assets = result?.items || [];
+  const total = result?.total || 0;
 
   if (assets.length === 0) {
     console.log('  No results found.');
@@ -31,12 +31,12 @@ async function run(args) {
 
   for (const a of assets) {
     const icon = typeIcon(a.type);
-    const score = a.hubScore || 0;
-    const author = a.author?.name || 'unknown';
-    const authorId = a.author?.id || 'unknown';
+    const installs = a.installs || 0;
+    const author = a.author || 'unknown';
+    const authorId = a.authorId || 'unknown';
 
     console.log(`  ${icon} ${c('bold', a.displayName)}`);
-    console.log(`     ${a.type}/@${authorId}/${a.name}  •  v${a.version}  •  by ${c('cyan', author)}  •  Score: ${score}`);
+    console.log(`     ${a.type}/@${authorId}/${a.name}  •  v${a.version}  •  by ${c('cyan', author)}  •  Installs: ${installs}`);
 
     const desc = (a.description || '').slice(0, 80);
     if (desc) {

package/lib/commands/star.js

@@ -0,0 +1,67 @@
+// ============================================================================
+// commands/star.js — Star / unstar an asset
+// ============================================================================
+
+'use strict';
+
+const api = require('../api.js');
+const auth = require('../auth.js');
+const { ok, err, c } = require('../ui.js');
+
+async function runStar(args) {
+  if (args.length === 0) {
+    err('Usage: openclawmp star <assetRef>');
+    console.log('  Example: openclawmp star trigger/@xiaoyue/pdf-watcher');
+    process.exit(1);
+  }
+
+  if (!auth.isAuthenticated()) {
+    err('Authentication required. Run: openclawmp login');
+    process.exit(1);
+  }
+
+  const asset = await api.resolveAssetRef(args[0]);
+  const displayName = asset.displayName || asset.name || args[0];
+
+  const { status, data } = await api.post(`/api/assets/${asset.id}/star`, {});
+
+  if (status >= 200 && status < 300) {
+    const totalStars = data.totalStars ?? data.stars ?? '?';
+    ok(`★ 已收藏 ${c('bold', displayName)}（共 ${c('cyan', String(totalStars))} 人收藏）`);
+  } else if (status === 409) {
+    // Already starred
+    ok(`★ 你已经收藏过 ${c('bold', displayName)} 了`);
+  } else {
+    err(`收藏失败 (${status}): ${data.error || data.message || JSON.stringify(data)}`);
+    process.exit(1);
+  }
+}
+
+async function runUnstar(args) {
+  if (args.length === 0) {
+    err('Usage: openclawmp unstar <assetRef>');
+    console.log('  Example: openclawmp unstar trigger/@xiaoyue/pdf-watcher');
+    process.exit(1);
+  }
+
+  if (!auth.isAuthenticated()) {
+    err('Authentication required. Run: openclawmp login');
+    process.exit(1);
+  }
+
+  const asset = await api.resolveAssetRef(args[0]);
+  const displayName = asset.displayName || asset.name || args[0];
+
+  const { status, data } = await api.del(`/api/assets/${asset.id}/star`);
+
+  if (status >= 200 && status < 300) {
+    ok(`☆ 已取消收藏 ${c('bold', displayName)}`);
+  } else if (status === 404) {
+    ok(`☆ 你还没有收藏 ${c('bold', displayName)}`);
+  } else {
+    err(`取消收藏失败 (${status}): ${data.error || data.message || JSON.stringify(data)}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { runStar, runUnstar };

package/lib/commands/unbind.js

@@ -0,0 +1,37 @@
+// ============================================================================
+// commands/unbind.js — Unbind a device from your account
+// ============================================================================
+
+'use strict';
+
+const api = require('../api.js');
+const config = require('../config.js');
+const { fish, ok, err, warn, c, detail } = require('../ui.js');
+
+async function run(args, flags) {
+  const deviceId = args[0] || config.getDeviceId();
+
+  if (!deviceId) {
+    err('No device ID specified and none found locally.');
+    console.log('');
+    console.log(`  Usage: openclawmp unbind [deviceId]`);
+    console.log(`  Without arguments, unbinds the current device.`);
+    process.exit(1);
+  }
+
+  fish(`Unbinding device ${c('dim', deviceId.slice(0, 12) + '...')} ...`);
+
+  const { status, data } = await api.del('/api/auth/device', { deviceId });
+
+  if (status >= 200 && status < 300 && data?.success) {
+    console.log('');
+    ok('设备已解绑');
+    detail('Device', deviceId.slice(0, 16) + '...');
+    console.log('');
+  } else {
+    err(data?.message || data?.error || `Unbind failed (HTTP ${status})`);
+    process.exit(1);
+  }
+}
+
+module.exports = { run };

package/lib/config.js

@@ -26,9 +26,9 @@ const DEVICE_JSON = path.join(OPENCLAW_STATE_DIR, 'identity', 'device.json');
 // Valid asset types and their install subdirectories
 const ASSET_TYPES = {
   skill:      'skills',
-  plugin:     'plugins',
+  plugin:     'extensions',
   trigger:    'triggers',
-  channel:    'channels',
+  channel:    'extensions',
   experience: 'experiences',
 };
 

package/lib/help.js

@@ -23,6 +23,19 @@ function printHelp() {
   console.log('    publish [path]                      Publish an asset to the market');
   console.log('    login                               Show device authorization info');
   console.log('    whoami                              Show current user / device info');
+  console.log('');
+  console.log('  Community:');
+  console.log('    star <assetRef>                     Star (收藏) an asset');
+  console.log('    unstar <assetRef>                   Remove star from an asset');
+  console.log('    comment <assetRef> <content>        Post a comment (--rating 1-5, --as-agent)');
+  console.log('    comments <assetRef>                 View comments on an asset');
+  console.log('    issue <assetRef> <title>            Create an issue (--body, --labels, --as-agent)');
+  console.log('    issues <assetRef>                   List issues on an asset');
+  console.log('');
+  console.log('  Account:');
+  console.log('    unbind [deviceId]                   Unbind a device (default: current device)');
+  console.log('    delete-account --confirm            Delete account (unbind all + revoke keys)');
+  console.log('');
   console.log('    help                                Show this help');
   console.log('');
   console.log('  Global options:');
@@ -37,6 +50,9 @@ function printHelp() {
   console.log('    openclawmp install skill/@cybernova/web-search');
   console.log('    openclawmp search "文件监控"');
   console.log('    openclawmp list');
+  console.log('    openclawmp star trigger/@xiaoyue/pdf-watcher');
+  console.log('    openclawmp comment trigger/@xiaoyue/pdf-watcher "好用！" --rating 5');
+  console.log('    openclawmp issues tr-fc617094de29f938');
   console.log('');
   console.log(`  Environment: ${c('dim', 'OPENCLAWMP_API — override API base URL')}`);
   console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclawmp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "\ud83d\udc1f OpenClaw Marketplace CLI \u2014 \u6c34\u4ea7\u5e02\u573a\u547d\u4ee4\u884c\u5de5\u5177",
   "bin": {
     "openclawmp": "./bin/openclawmp.js"