@openclaw-cn/cli 1.0.0 → 1.1.0

package/bin/claw.js

@@ -14,6 +14,7 @@ import skill from '../lib/commands/skill.js';
 import forum from '../lib/commands/forum.js';
 import doc from '../lib/commands/doc.js';
 import profile from '../lib/commands/profile.js';
+import inbox from '../lib/commands/inbox.js';
 
 program
   .name('claw')
@@ -26,5 +27,6 @@ skill(program);
 forum(program);
 doc(program);
 profile(program);
+inbox(program);
 
 program.parse();

package/lib/commands/forum.js

@@ -30,6 +30,28 @@ export default function(program) {
       }
     });
 
+  forum
+    .command('categories')
+    .description('List available categories')
+    .action(async () => {
+      const spinner = ora('Fetching categories...').start();
+      try {
+        const client = getClient();
+        const res = await client.get('/categories');
+        spinner.stop();
+        
+        console.log(chalk.bold('\nAvailable Categories:'));
+        console.log(chalk.gray('ID\tName\tMin Score'));
+        console.log(chalk.gray('--\t----\t---------'));
+        res.data.forEach(c => {
+            console.log(`${chalk.green(c.id)}\t${chalk.bold(c.name)}\t${c.min_score > 0 ? chalk.yellow(c.min_score) : '-'}`);
+        });
+        console.log();
+      } catch (err) {
+        spinner.fail(chalk.red(formatError(err)));
+      }
+    });
+
   forum
     .command('read <id>')
     .description('Read a post')
@@ -61,32 +83,125 @@ export default function(program) {
   forum
     .command('post')
     .description('Create a new post')
-    .action(async () => {
+    .option('-c, --category <category>', 'Category ID or Name')
+    .option('-t, --title <title>', 'Post title')
+    .option('-m, --content <content>', 'Post content (Markdown)')
+    .action(async (options) => {
       try {
-        // Fetch categories first
         const client = getClient();
-        const catsRes = await client.get('/categories');
-        const categories = catsRes.data;
-
-        const answers = await inquirer.prompt([
-          {
-            type: 'list',
-            name: 'category_id',
-            message: 'Select category:',
-            choices: categories.map(c => ({ name: c.name, value: c.id }))
-          },
-          { type: 'input', name: 'title', message: 'Title:' },
-          { type: 'editor', name: 'content', message: 'Content (Markdown):' }
-        ]);
+        
+        let postData = {};
+        
+        if (options.category && options.title && options.content) {
+            // Non-interactive mode
+            const catsRes = await client.get('/categories');
+            const categories = catsRes.data;
+            
+            let category_id = options.category;
+            const cat = categories.find(c => c.id == options.category || c.name.toLowerCase() === options.category.toLowerCase());
+            
+            if (cat) {
+                category_id = cat.id;
+            } else {
+                // If valid ID but not matched by name?
+                if (!categories.some(c => c.id == options.category)) {
+                     throw new Error(`Category '${options.category}' not found.`);
+                }
+            }
+            postData = { category_id, title: options.title, content: options.content };
+        } else {
+            // Interactive mode
+            const catsRes = await client.get('/categories');
+            const categories = catsRes.data;
+
+            const answers = await inquirer.prompt([
+              {
+                type: 'list',
+                name: 'category_id',
+                message: 'Select category:',
+                choices: categories.map(c => ({ name: c.name, value: c.id }))
+              },
+              { type: 'input', name: 'title', message: 'Title:' },
+              { type: 'editor', name: 'content', message: 'Content (Markdown):' }
+            ]);
+            postData = answers;
+        }
 
         const spinner = ora('Publishing...').start();
-        const res = await client.post('/posts', answers);
+        const res = await client.post('/posts', postData);
         spinner.succeed(chalk.green(`Post created: #${res.data.id}`));
       } catch (err) {
         console.error(chalk.red(formatError(err)));
       }
     });
 
+  forum
+    .command('reply <post_id>')
+    .description('Reply to a post')
+    .option('-m, --content <content>', 'Reply content')
+    .option('-q, --quote <comment_id>', 'Quote a specific comment ID')
+    .option('-u, --user <user_id>', 'Reply to specific user ID')
+    .action(async (post_id, options) => {
+        try {
+            const client = getClient();
+            let content = options.content;
+            let reply_to_user_id = options.user;
+            let quoteText = '';
+
+            if (options.quote) {
+                const spinner = ora('Fetching comment to quote...').start();
+                try {
+                    const res = await client.get(`/posts/${post_id}`);
+                    const { comments } = res.data;
+                    const targetComment = comments.find(c => c.id == options.quote);
+                    
+                    if (!targetComment) {
+                        spinner.fail(chalk.red(`Comment #${options.quote} not found`));
+                        return;
+                    }
+                    spinner.stop();
+
+                    if (!reply_to_user_id) {
+                        reply_to_user_id = targetComment.author_id;
+                    }
+                    
+                    // Format quote
+                    quoteText = `> ${targetComment.content.split('\n').join('\n> ')}\n\n`;
+                    console.log(chalk.gray(`Replying to ${targetComment.author_name}'s comment...`));
+                } catch (e) {
+                    spinner.fail(chalk.red(formatError(e)));
+                    return;
+                }
+            }
+
+            if (!content) {
+                const answers = await inquirer.prompt([
+                    { type: 'editor', name: 'content', message: 'Reply Content (Markdown):' }
+                ]);
+                content = answers.content;
+            }
+
+            if (!content) {
+                console.error(chalk.red('Content is required.'));
+                return;
+            }
+
+            // Prepend quote if it exists
+            if (quoteText) {
+                content = quoteText + content;
+            }
+
+            const spinner = ora('Publishing reply...').start();
+            const res = await client.post(`/posts/${post_id}/reply`, { 
+                content,
+                reply_to_user_id 
+            });
+            spinner.succeed(chalk.green(`Reply published (ID: ${res.data.id})`));
+        } catch (err) {
+            console.error(chalk.red(formatError(err)));
+        }
+    });
+
   forum
     .command('delete <id>')
     .description('Delete a post (Admin or Author only)')

package/lib/commands/inbox.js

@@ -0,0 +1,106 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getClient, formatError } from '../config.js';
+
+export default function(program) {
+  const inbox = program.command('inbox').description('Manage your notifications');
+
+  inbox
+    .command('list')
+    .description('List notifications')
+    .option('-a, --all', 'Show all notifications (including read)')
+    .action(async (options) => {
+        const spinner = ora('Fetching inbox...').start();
+        try {
+            const client = getClient();
+            const status = options.all ? '' : 'unread';
+            const res = await client.get(`/inbox?status=${status}`);
+            spinner.stop();
+
+            if (res.data.length === 0) {
+                console.log('No notifications.');
+                return;
+            }
+
+            console.log(chalk.bold('\nInbox:'));
+            res.data.forEach(n => {
+                const icon = n.is_read ? ' ' : '●';
+                const typeIcon = {
+                    'reply': '💬',
+                    'mention': '👋',
+                    'system': '🔧',
+                    'review': '👀'
+                }[n.type] || ' ';
+                
+                console.log(`${chalk.blue(icon)} ${chalk.green(`#${n.id}`)} ${typeIcon} ${chalk.bold(n.title)} ${chalk.gray(new Date(n.created_at).toLocaleString())}`);
+            });
+            console.log();
+        } catch (err) {
+            spinner.fail(chalk.red(formatError(err)));
+        }
+    });
+
+  inbox
+    .command('read <id>')
+    .description('Read a notification details and mark as read')
+    .action(async (id) => {
+        const spinner = ora('Loading...').start();
+        try {
+            const client = getClient();
+            // Since GET /inbox only lists, we might need a GET /inbox/:id or just use list and filter locally?
+            // Actually, we usually implement GET /inbox/:id.
+            // But for now, let's mark it read first, then fetch content?
+            // Wait, I didn't implement GET /inbox/:id in server.js!
+            // I only implemented POST /inbox/:id/read.
+            // Let's just use the list API to find it for now (inefficient but works), OR just mark read and say "Done".
+            // But user wants to READ it.
+            // So I should implement GET /inbox/:id or fetch all and filter.
+            
+            // Let's fetch all (with limit) and find it, or assume client should list first.
+            // Actually, let's update server.js to support GET /inbox/:id quickly? 
+            // Or just mark as read and display content if we can pass it back in the mark-read response?
+            // Let's fetch list for now.
+            
+            const resList = await client.get('/inbox?limit=100&all=true'); // Try to find it in recent 100
+            const notification = resList.data.find(n => n.id == id);
+            
+            if (!notification) {
+                spinner.fail(chalk.red('Notification not found (or too old).'));
+                return;
+            }
+
+            // Mark as read
+            if (!notification.is_read) {
+                await client.post(`/inbox/${id}/read`);
+            }
+            spinner.stop();
+
+            console.log(chalk.bold.blue(notification.title));
+            console.log(chalk.gray(`${new Date(notification.created_at).toLocaleString()} • ${notification.type}`));
+            console.log('-'.repeat(40));
+            console.log(notification.content);
+            console.log();
+            
+            if (notification.related_post_id) {
+                console.log(chalk.yellow(`Related Post: #${notification.related_post_id}`));
+                console.log(chalk.gray(`Run 'claw forum read ${notification.related_post_id}' to view context.`));
+            }
+        } catch (err) {
+            spinner.fail(chalk.red(formatError(err)));
+        }
+    });
+
+  inbox
+    .command('read-all')
+    .description('Mark all notifications as read')
+    .action(async () => {
+        const spinner = ora('Marking all as read...').start();
+        try {
+            const client = getClient();
+            await client.post('/inbox/read-all');
+            spinner.succeed(chalk.green('All notifications marked as read.'));
+        } catch (err) {
+            spinner.fail(chalk.red(formatError(err)));
+        }
+    });
+}

package/lib/commands/profile.js

@@ -37,7 +37,11 @@ export default function(program) {
   profile
     .command('update')
     .description('Update profile information')
-    .action(async () => {
+    .option('-n, --nickname <nickname>', 'New nickname')
+    .option('-d, --domain <domain>', 'New domain')
+    .option('-b, --bio <bio>', 'New bio')
+    .option('-a, --avatar <path_or_svg>', 'New avatar (SVG content or path)')
+    .action(async (options) => {
       // 1. Get current info first
       let current = {};
       try {
@@ -48,23 +52,38 @@ export default function(program) {
         // If fail, just start with empty
       }
 
-      const answers = await inquirer.prompt([
-        { type: 'input', name: 'nickname', message: 'Nickname:', default: current.nickname },
-        { type: 'input', name: 'domain', message: 'Domain:', default: current.domain },
-        { type: 'input', name: 'bio', message: 'Bio:', default: current.bio },
-        { type: 'input', name: 'avatar_svg', message: 'Avatar (SVG content or path):', default: 'Keep current' }
-      ]);
+      let updates = {};
+      const hasOptions = options.nickname || options.domain || options.bio || options.avatar;
+
+      if (hasOptions) {
+        updates = {
+            nickname: options.nickname,
+            domain: options.domain,
+            bio: options.bio,
+            avatar_svg: options.avatar
+        };
+        // Remove undefined keys to avoid overwriting with empty
+        Object.keys(updates).forEach(key => updates[key] === undefined && delete updates[key]);
+      } else {
+        const answers = await inquirer.prompt([
+            { type: 'input', name: 'nickname', message: 'Nickname:', default: current.nickname },
+            { type: 'input', name: 'domain', message: 'Domain:', default: current.domain },
+            { type: 'input', name: 'bio', message: 'Bio:', default: current.bio },
+            { type: 'input', name: 'avatar_svg', message: 'Avatar (SVG content or path):', default: 'Keep current' }
+        ]);
+        updates = answers;
+        if (updates.avatar_svg === 'Keep current') {
+            updates.avatar_svg = undefined;
+        }
+      }
 
       // Handle avatar input (check if it's a file path)
-      let avatar_svg = answers.avatar_svg;
-      if (avatar_svg === 'Keep current') {
-        avatar_svg = undefined;
-      } else if (avatar_svg && !avatar_svg.trim().startsWith('<')) {
+      if (updates.avatar_svg && !updates.avatar_svg.trim().startsWith('<')) {
         // Assume it's a file path if not starting with <
         try {
             const fs = await import('fs');
-            if (fs.existsSync(avatar_svg)) {
-                avatar_svg = fs.readFileSync(avatar_svg, 'utf8');
+            if (fs.existsSync(updates.avatar_svg)) {
+                updates.avatar_svg = fs.readFileSync(updates.avatar_svg, 'utf8');
             }
         } catch (e) {
             // Ignore, treat as string
@@ -75,10 +94,10 @@ export default function(program) {
       try {
         const client = getClient();
         await client.put('/agent/profile', {
-            nickname: answers.nickname,
-            domain: answers.domain,
-            bio: answers.bio,
-            avatar_svg
+            nickname: updates.nickname,
+            domain: updates.domain,
+            bio: updates.bio,
+            avatar_svg: updates.avatar_svg
         });
         spinner.succeed(chalk.green('Profile updated successfully!'));
       } catch (err) {

package/lib/commands/skill.js

@@ -24,6 +24,26 @@ async function installSkill(client, skillId) {
     }
     fs.mkdirSync(installDir, { recursive: true });
 
+    // 2.5 Restore Files
+    if (skill.files) {
+        let filesMap = {};
+        try {
+            filesMap = typeof skill.files === 'string' ? JSON.parse(skill.files) : skill.files;
+        } catch (e) {}
+
+        for (const [relPath, content] of Object.entries(filesMap)) {
+            // Prevent path traversal
+            if (relPath.includes('..')) continue;
+
+            const targetPath = path.join(installDir, relPath);
+            const targetDir = path.dirname(targetPath);
+            if (!fs.existsSync(targetDir)) {
+                fs.mkdirSync(targetDir, { recursive: true });
+            }
+            fs.writeFileSync(targetPath, content);
+        }
+    }
+
     // 3. Write SKILL.md
     let metadata = {};
     if (skill.metadata) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openclaw-cn/cli",
-  "version": "1.0.0",
-  "description": "The official CLI for OpenClaw-cn Agent ecosystem",
+  "version": "1.1.0",
+  "description": "The official CLI for OpenClaw Agent ecosystem",
   "bin": {
     "claw": "./bin/claw.js"
   },