local-cmd-runner 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,44 @@
+# Local Cmd Runner
+
+💻 **Local Cmd Runner** 是一个将终端命令行能力搬进网页的可视化工具。当你运行它后，它会自动唤起系统浏览器并提供一个极具现代审美（支持暗黑风全景视效）的本地版的网页控制台。完美兼容 Windows (cmd) 以及 Linux/Mac (shell)。
+
+## 特性 (Features)
+
+- 🚀 **开箱即用**: 一键启动，无需复杂环境配置，自动启服并唤开系统默认浏览器。
+- 🎨 **精美极客 UI**: 告别枯燥的黑白框，专为极客重构的半透明模糊面板。
+- 📌 **记录置顶显示**: 最新的命令运行结果永远在顶部首位出现，告别辛苦下拉滚动条的折磨。
+- ⚡ **毫秒级实时响应**: 跨越底层调用 WebSockets 结合 Node 原生的 `child_process.spawn`，完美实时透传你的耗时命令输出，不会有断层。
+- 🛠️ **一键式预设**: 已原生预置类似 `openclaw` 快捷操作面板，点一点即可快速触发高频任务（例如启动、部署等）。
+
+---
+
+## 怎么使唤 (Usage)
+
+直接跳到你要跑命令的任意项目目录下，用下面的方式拉起工具。
+
+### 方式一：不安装直接云端拉起（推荐）
+
+不需要任何前置的手动安装，只需使用 `npx`：
+
+```bash
+npx local-cmd-runner
+```
+
+### 方式二：全局安装到系统
+
+如果觉得工具很趁手想随时用：
+
+1. 先全局安装：
+```bash
+npm install -g local-cmd-runner
+```
+2. 随后在任何目录下都能敲这个注册好的命令：
+```bash
+local-cmd
+```
+
+---
+
+## 协议 (License)
+
+ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-cmd-runner",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Run local shell commands from a web page",
   "homepage": "https://github.com/codewoow/local_cmd#readme",
   "bugs": {
@@ -25,4 +25,4 @@
     "socket.io": "^4.7.5"
   },
   "devDependencies": {}
-}
+}

package/server.js

@@ -9,36 +9,36 @@ const app = express();
 const httpServer = createServer(app);
 const io = new Server(httpServer);
 
-const PORT = process.env.PORT || 3000;
+const PORT = process.env.PORT || 3500;
 
 app.use(express.static(path.join(__dirname, 'public')));
 
 io.on('connection', (socket) => {
   console.log('Client connected');
-  
+
   socket.on('run_command', (payload) => {
     // If the old app.js sends a string, handle it. Otherwise handle the new object format.
     const cmd = typeof payload === 'string' ? payload : payload.cmd;
     const runId = typeof payload === 'string' ? cmd : payload.runId;
     console.log(`Running command: ${cmd}`);
-    
+
     // execute the command inside the native OS shell
     const child = spawn(cmd, [], { shell: true });
-    
+
     socket.emit('cmd_start', { id: cmd, runId: runId });
 
     child.stdout.on('data', (data) => {
       socket.emit('cmd_output', { type: 'stdout', data: data.toString(), id: cmd, runId: runId });
     });
-    
+
     child.stderr.on('data', (data) => {
       socket.emit('cmd_output', { type: 'stderr', data: data.toString(), id: cmd, runId: runId });
     });
-    
+
     child.on('close', (code) => {
       socket.emit('cmd_close', { code, id: cmd, runId: runId });
     });
-    
+
     child.on('error', (err) => {
       socket.emit('cmd_error', { error: err.toString(), id: cmd, runId: runId });
     });
@@ -48,7 +48,7 @@ io.on('connection', (socket) => {
 httpServer.listen(PORT, () => {
   const url = `http://localhost:${PORT}`;
   console.log(`Server is running at ${url}`);
-  
+
   // Use platform-specific command to open the browser
   const startCmd = os.platform() === 'win32' ? 'start' : (os.platform() === 'darwin' ? 'open' : 'xdg-open');
   spawn(startCmd, [url], { shell: true });