@cjwddz/mirror 0.0.1

package/README.md

@@ -0,0 +1,125 @@
+# Mirror —— 开发态远程工作空间镜像工具
+
+开发态远程工作空间镜像工具，将本地项目目录镜像到远程服务器，并在远程执行命令。
+
+## 功能特性
+
+- ✅ 全量文件同步（SNAPSHOT）
+- ✅ 增量文件同步（FILE_DIFF）
+- ✅ 远程命令执行（PTY 支持）
+- ✅ 文件变更实时监听
+- ✅ 状态机保证一致性
+- ✅ 一次性 workspace，完全可丢弃
+
+## 安装
+
+```bash
+npm install -g @cjwddz/mirror
+```
+
+## 使用方法
+
+### 1. 启动 Host（远程服务器）
+
+```bash
+mirror host --port 7331
+```
+
+或者指定 token：
+
+```bash
+mirror host --port 7331 --token my-custom-token
+```
+
+可选参数：
+
+- `--port <port>`: 端口号（默认: 7331）
+- `--tmp-dir <dir>`: 临时目录（默认: /tmp）
+- `--ignore <patterns>`: 忽略的文件模式，逗号分隔（默认: node_modules,.git）
+- `--token <token>`: 指定 session token（不指定则自动生成）
+
+启动后会显示连接地址：
+
+```
+Mirror host started
+Listening on :7331
+
+Connect using:
+mirror link 192.168.1.100:7331?token=KJ82mZpX...
+```
+
+### 2. 连接 Client（本地开发机）
+
+在项目目录中执行：
+
+```bash
+mirror link 192.168.1.100:7331?token=KJ82mZpX...
+```
+
+连接成功后：
+
+1. 自动进行全量文件同步
+2. 启动文件监听（增量同步）
+3. 进入交互式终端
+
+在交互式终端中输入命令，命令会在远程服务器的工作空间中执行。
+
+输入 `exit` 或 `quit` 退出。
+
+## 工作原理
+
+### 状态机
+
+Host 维护以下状态：
+
+- `EMPTY`: 无 client 连接
+- `SYNCING`: 文件同步中（禁止 exec）
+- `READY`: 文件一致，可 exec
+- `RUNNING`: 命令执行中
+
+### Workspace Version
+
+- version 为单调递增整数
+- 由 client 生成
+- exec 时必须声明 version
+- host 仅在 `exec.version === currentVersion` 时允许执行
+
+### 文件同步
+
+- **全量同步（SNAPSHOT）**: 连接时一次性同步所有文件
+- **增量同步（FILE_DIFF）**: 文件变更时实时同步
+  - `READY` 状态：立即应用
+  - `RUNNING` 状态：放入 pending 队列，命令结束后按顺序应用
+
+### 进程管理
+
+- 使用 PTY 支持交互式命令
+- 命令执行在独立的进程组中
+- 断开连接时自动清理所有进程
+
+## 注意事项
+
+- ⚠️ 仅用于开发阶段，不适用于生产环境
+- ⚠️ 不支持多 client 并发（新连接会抢占旧连接）
+- ⚠️ workspace 是临时的，断开连接后自动清理
+- ⚠️ 不支持恢复，需要重新连接
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 测试
+npm test
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT

package/dist/cli/host-impl.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Host 实现类
+ */
+interface HostOptions {
+    port: number;
+    tmpDir?: string;
+    ignore?: string[];
+    token?: string;
+}
+export declare class Host {
+    private transport;
+    private stateMachine;
+    private workspace;
+    private processManager;
+    private currentClientId;
+    private sessionToken;
+    private options;
+    private snapshotFiles;
+    private isSnapshotInProgress;
+    constructor(options: HostOptions);
+    private generateToken;
+    start(): Promise<void>;
+    private getHostname;
+    private handleConnection;
+    private handleMessage;
+    private handleHello;
+    private handleSnapshotStart;
+    private handleFile;
+    private handleSnapshotEnd;
+    private handleFileDiff;
+    private handleExec;
+    private sendError;
+    private cleanup;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=host-impl.d.ts.map

package/dist/cli/host-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-impl.d.ts","sourceRoot":"","sources":["../../src/cli/host-impl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,IAAI;IACf,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,aAAa,CAA6D;IAClF,OAAO,CAAC,oBAAoB,CAAkB;gBAElC,OAAO,EAAE,WAAW;IAShC,OAAO,CAAC,aAAa;IAIf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,OAAO,CAAC,WAAW;YAoBL,gBAAgB;YA0BhB,aAAa;YAyBb,WAAW;YAcX,mBAAmB;YAanB,UAAU;YAkBV,iBAAiB;YAiBjB,cAAc;YAmCd,UAAU;IAiExB,OAAO,CAAC,SAAS;YAUH,OAAO;IAiBf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}

package/dist/cli/host-impl.js

@@ -0,0 +1,264 @@
+/**
+ * Host 实现类
+ */
+import { randomBytes } from 'crypto';
+import { networkInterfaces } from 'os';
+import { WebSocketTransport } from '../transport/websocket.js';
+import { StateMachine, HostState } from '../core/state-machine.js';
+import { Workspace } from '../core/workspace.js';
+import { ProcessManager } from '../core/process-manager.js';
+import { computeHash } from '../core/file-sync.js';
+export class Host {
+    transport;
+    stateMachine;
+    workspace = null;
+    processManager;
+    currentClientId = null;
+    sessionToken;
+    options;
+    snapshotFiles = new Map();
+    isSnapshotInProgress = false;
+    constructor(options) {
+        this.transport = new WebSocketTransport();
+        this.stateMachine = new StateMachine();
+        this.processManager = new ProcessManager();
+        this.options = options;
+        // 如果提供了 token 就使用，否则自动生成
+        this.sessionToken = options.token || this.generateToken();
+    }
+    generateToken() {
+        return randomBytes(32).toString('base64url');
+    }
+    async start() {
+        const port = this.options.port;
+        await this.transport.createServer(port, (ws) => {
+            this.handleConnection(ws);
+        });
+        const hostname = this.getHostname();
+        console.log('Mirror host started');
+        console.log(`Listening on :${port}`);
+        console.log('');
+        console.log('Connect using:');
+        console.log(`mirror link ${hostname}:${port}?token=${this.sessionToken}`);
+    }
+    getHostname() {
+        // 尝试获取本机 IP
+        const interfaces = networkInterfaces();
+        for (const name of Object.keys(interfaces)) {
+            const ifaces = interfaces[name];
+            if (!ifaces)
+                continue;
+            for (const iface of ifaces) {
+                // 跳过内部（即 127.0.0.1）和非 IPv4 地址
+                if (iface.family === 'IPv4' && !iface.internal) {
+                    return iface.address;
+                }
+            }
+        }
+        // 如果没有找到外部 IP，返回 localhost
+        return 'localhost';
+    }
+    async handleConnection(ws) {
+        // 清理旧连接
+        if (this.currentClientId) {
+            await this.cleanup();
+        }
+        ws.on('message', async (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                await this.handleMessage(ws, message);
+            }
+            catch (error) {
+                console.error('Failed to handle message:', error);
+                this.sendError(ws, 'Failed to handle message');
+            }
+        });
+        ws.on('close', async () => {
+            await this.cleanup();
+        });
+        ws.on('error', async (error) => {
+            console.error('WebSocket error:', error);
+            await this.cleanup();
+        });
+    }
+    async handleMessage(ws, message) {
+        switch (message.type) {
+            case 'HELLO':
+                await this.handleHello(ws, message);
+                break;
+            case 'SNAPSHOT_START':
+                await this.handleSnapshotStart(ws, message);
+                break;
+            case 'FILE':
+                await this.handleFile(ws, message);
+                break;
+            case 'SNAPSHOT_END':
+                await this.handleSnapshotEnd(ws, message);
+                break;
+            case 'FILE_DIFF':
+                await this.handleFileDiff(ws, message);
+                break;
+            case 'EXEC':
+                await this.handleExec(ws, message);
+                break;
+            default:
+                this.sendError(ws, `Unknown message type: ${message.type}`);
+        }
+    }
+    async handleHello(ws, message) {
+        // 验证 token
+        if (message.token !== this.sessionToken) {
+            this.sendError(ws, 'Invalid token');
+            ws.close();
+            return;
+        }
+        this.currentClientId = message.clientId;
+        this.stateMachine.transitionTo(HostState.SYNCING);
+        this.snapshotFiles.clear();
+        this.isSnapshotInProgress = false;
+    }
+    async handleSnapshotStart(ws, _message) {
+        if (this.stateMachine.getState() !== HostState.SYNCING) {
+            this.sendError(ws, 'Invalid state for SNAPSHOT_START');
+            return;
+        }
+        // 创建 workspace
+        const tmpDir = this.options.tmpDir || '/tmp';
+        this.workspace = await Workspace.create(tmpDir);
+        this.isSnapshotInProgress = true;
+        this.snapshotFiles.clear();
+    }
+    async handleFile(ws, message) {
+        if (!this.isSnapshotInProgress || !this.workspace) {
+            this.sendError(ws, 'SNAPSHOT not in progress');
+            return;
+        }
+        const content = Buffer.from(message.content, 'base64');
+        const hash = computeHash(content);
+        // 验证 hash
+        if (hash !== message.hash) {
+            this.sendError(ws, `Hash mismatch for ${message.path}`);
+            return;
+        }
+        this.snapshotFiles.set(message.path, { hash, content });
+    }
+    async handleSnapshotEnd(ws, message) {
+        if (!this.isSnapshotInProgress || !this.workspace) {
+            this.sendError(ws, 'SNAPSHOT not in progress');
+            return;
+        }
+        // 写入所有文件
+        for (const [path, { content }] of this.snapshotFiles) {
+            await this.workspace.writeFile(path, content);
+        }
+        this.workspace.setVersion(message.version);
+        this.stateMachine.transitionTo(HostState.READY);
+        this.isSnapshotInProgress = false;
+        this.snapshotFiles.clear();
+    }
+    async handleFileDiff(ws, message) {
+        if (!this.workspace) {
+            this.sendError(ws, 'Workspace not initialized');
+            return;
+        }
+        const state = this.stateMachine.getState();
+        if (state === HostState.READY) {
+            // 立即应用
+            if (message.op === 'update' && message.content) {
+                const content = Buffer.from(message.content, 'base64');
+                const hash = computeHash(content);
+                if (hash !== message.hash) {
+                    this.sendError(ws, `Hash mismatch for ${message.path}`);
+                    return;
+                }
+                await this.workspace.writeFile(message.path, content);
+            }
+            else if (message.op === 'delete') {
+                await this.workspace.deleteFile(message.path);
+            }
+            this.workspace.setVersion(message.version);
+        }
+        else if (state === HostState.RUNNING) {
+            // 放入 pending 队列
+            this.workspace.addPendingDiff({
+                version: message.version,
+                op: message.op,
+                path: message.path,
+                content: message.content,
+            });
+        }
+        else {
+            this.sendError(ws, `Invalid state for FILE_DIFF: ${state}`);
+        }
+    }
+    async handleExec(ws, message) {
+        if (!this.workspace) {
+            this.sendError(ws, 'Workspace not initialized');
+            return;
+        }
+        // 验证状态
+        if (!this.stateMachine.canExec()) {
+            this.sendError(ws, `Cannot exec in state: ${this.stateMachine.getState()}`);
+            return;
+        }
+        // 验证版本
+        if (message.version !== this.workspace.getCurrentVersion()) {
+            this.sendError(ws, `Version mismatch: expected ${this.workspace.getCurrentVersion()}, got ${message.version}`);
+            return;
+        }
+        // 启动进程
+        const ptyProcess = await this.processManager.spawn(message.execId, message.command, this.workspace.getPath());
+        this.stateMachine.transitionTo(HostState.RUNNING);
+        // 监听输出
+        ptyProcess.onData((data) => {
+            ws.send(JSON.stringify({
+                type: 'EXEC_OUTPUT',
+                execId: message.execId,
+                stream: 'stdout',
+                data,
+            }));
+        });
+        // 监听退出
+        ptyProcess.onExit(async (exit) => {
+            ws.send(JSON.stringify({
+                type: 'EXEC_EXIT',
+                execId: message.execId,
+                code: exit.exitCode,
+            }));
+            // 清理进程
+            this.processManager.removeProcess(message.execId);
+            // 应用 pending diffs
+            if (this.workspace) {
+                await this.workspace.applyPendingDiffs();
+            }
+            // 回到 READY 状态
+            this.stateMachine.transitionTo(HostState.READY);
+        });
+    }
+    sendError(ws, message, code) {
+        ws.send(JSON.stringify({
+            type: 'ERROR',
+            message,
+            code,
+        }));
+    }
+    async cleanup() {
+        // 清理进程
+        await this.processManager.killAll();
+        // 清理 workspace
+        if (this.workspace) {
+            await this.workspace.cleanup();
+            this.workspace = null;
+        }
+        // 重置状态
+        this.stateMachine.reset();
+        this.currentClientId = null;
+        this.snapshotFiles.clear();
+        this.isSnapshotInProgress = false;
+    }
+    async stop() {
+        await this.cleanup();
+        this.transport.close();
+    }
+}
+//# sourceMappingURL=host-impl.js.map

package/dist/cli/host-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-impl.js","sourceRoot":"","sources":["../../src/cli/host-impl.ts"],"names":[],"mappings":"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"}

package/dist/cli/host.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Host CLI 命令处理
+ */
+export declare function hostCommand(options: {
+    port: string;
+    tmpDir?: string;
+    ignore?: string;
+    token?: string;
+}): Promise<void>;
+//# sourceMappingURL=host.d.ts.map

package/dist/cli/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/cli/host.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB"}

package/dist/cli/host.js

@@ -0,0 +1,33 @@
+/**
+ * Host CLI 命令处理
+ */
+import { Host } from './host-impl.js';
+export async function hostCommand(options) {
+    const port = parseInt(options.port, 10);
+    if (isNaN(port) || port < 1 || port > 65535) {
+        console.error('Invalid port number');
+        process.exit(1);
+    }
+    const ignore = options.ignore?.split(',').map((s) => s.trim()) || ['node_modules', '.git'];
+    const host = new Host({
+        port,
+        tmpDir: options.tmpDir,
+        ignore,
+        token: options.token,
+    });
+    // 处理退出信号
+    const cleanup = async () => {
+        await host.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    try {
+        await host.start();
+    }
+    catch (error) {
+        console.error('Failed to start host:', error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/cli/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/cli/host.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAKjC;IACC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAE3F,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;QACpB,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,SAAS;IACT,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Mirror CLI 入口
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * Mirror CLI 入口
+ */
+import { Command } from 'commander';
+import { hostCommand } from './host.js';
+import { linkCommand } from './link.js';
+const program = new Command();
+program.name('mirror').description('开发态远程工作空间镜像工具').version('0.0.0');
+program
+    .command('host')
+    .description('启动远程 host 服务')
+    .option('-p, --port <port>', '端口号', '7331')
+    .option('--tmp-dir <dir>', '临时目录', '/tmp')
+    .option('--ignore <patterns>', '忽略的文件模式（逗号分隔）', 'node_modules,.git')
+    .option('--token <token>', '指定 session token（不指定则自动生成）')
+    .action(hostCommand);
+program
+    .command('link')
+    .description('连接到远程 host')
+    .argument('<url>', '连接地址，格式: host:port?token=xxx')
+    .action(linkCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAErE,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,cAAc,CAAC;KAC3B,MAAM,CAAC,mBAAmB,EAAE,KAAK,EAAE,MAAM,CAAC;KAC1C,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC;KACzC,MAAM,CAAC,qBAAqB,EAAE,eAAe,EAAE,mBAAmB,CAAC;KACnE,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;KACvD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,YAAY,CAAC;KACzB,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAC;KACjD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/link.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Link CLI 命令处理
+ */
+export declare function linkCommand(url: string): Promise<void>;
+//# sourceMappingURL=link.d.ts.map

package/dist/cli/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/cli/link.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD5D"}