@dshfly/remote-connector 0.2.1 → 0.3.0

package/mobile-bridge/core/git-status.js

@@ -0,0 +1,121 @@
+// core/git-status.js —— Git 工作区状态探测（mobile.files.list 的 gitStatus 来源）。
+//
+// 设计（docs/file-tree-plan.md 的边界不后退）：
+//   - **PC 侧计算**：手机是薄终端，git 在 PC 上跑；本模块零依赖、纯 Node、可单测。
+//   - **只读**：只用 `git status --porcelain`（绝不 add/commit/checkout 等会 mutate 的命令）。
+//   - **只算当前浏览目录**：`git -C repo status --porcelain=v1 -z -uall -- <relDir>` 路径限定，
+//     只拿"当前目录子树"的变更，避免扫整个大仓库；映射回该层条目的绝对路径。
+//   - **优雅降级**：非 git 仓库 / git 未安装 / git 失败 → 返回空表（手机端不显示任何点）——
+//     绝不让 git 探测失败影响 files.list 主链路。
+//   - **安全**：仅给"当前层已出现在结果里的条目"注记，不额外暴露路径；错误不携带绝对路径。
+//
+// 分类（供 UI 渲染色点）：modified / added / renamed / copied / untracked / deleted / conflict。
+
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+
+const sepRe = new RegExp('\\' + path.sep, 'g'); // OS 分隔符 → '/' 的替换正则
+const pathRelative = (from, to) => path.relative(from, to);
+const joinPaths = (...ps) => path.join(...ps);
+
+/** 默认 git 执行器：execFile 超时保护 + 绝不经 shell。 */
+function defaultRunGit(args, { cwd }) {
+  return new Promise((resolve, reject) => {
+    execFile('git', args, { cwd, timeout: 8000, maxBuffer: 4 * 1024 * 1024 }, (err, stdout) => {
+      if (err) reject(err);
+      else resolve({ stdout: String(stdout || '') });
+    });
+  });
+}
+
+/** porcelain v1 双状态字符 → 分类（null=无需显示）。顺序即优先级。 */
+export function categorizeStatus(x, y) {
+  if (x === '?' && y === '?') return 'untracked';
+  if (x === 'U' || y === 'U') return 'conflict';
+  if (x === 'M' || y === 'M') return 'modified';
+  if (x === 'D' || y === 'D') return 'deleted';
+  if (x === 'A' || x === 'R' || x === 'C') return 'added';
+  return null;
+}
+
+/**
+ * 解析 `git status --porcelain=v1 -z` 输出（NUL 分隔）→ Map<repo相对path, 分类>。
+ * 路径用正斜杠（git 输出即如此）；重命名/复制有额外 old-path 字段需跳过。
+ */
+export function parsePorcelainZ(stdout) {
+  const map = new Map();
+  const parts = String(stdout || '').split('\0');
+  let i = 0;
+  while (i < parts.length) {
+    const line = parts[i];
+    i += 1;
+    if (!line) continue;
+    const x = line[0] || '';
+    const y = line[1] || '';
+    // "XY path"：XY 后必有空格；path 为 repo 相对路径（/ 分隔）
+    const rel = line.length > 3 ? line.slice(3) : '';
+    const cat = categorizeStatus(x, y);
+    if (cat && rel) map.set(rel, cat);
+    // 重命名/复制的第二段是 old-path，消费掉（不入表）
+    if (x === 'R' || x === 'C') i += 1;
+  }
+  return map;
+}
+
+/**
+ * GitStatusService：给出某目录的"变更文件→分类"映射（绝对路径键）。
+ * 缓存 repoRoot+relDir 的判定结果，TTL 内免重复 spawn git。
+ */
+export class GitStatusService {
+  /**
+   * @param {{runGit?: (args: string[], opts: {cwd: string}) => Promise<{stdout: string}>, ttlMs?: number}} opts
+   *   runGit：可注入（单测/CI 用假 git）；缺省 execFile 真跑。ttlMs：缓存时长（默认 4000）。
+   */
+  constructor({ runGit = defaultRunGit, ttlMs = 4000 } = {}) {
+    this._runGit = runGit;
+    this._ttlMs = ttlMs;
+    this._cache = new Map(); // key: absDir -> {at, map}
+  }
+
+  /** 清缓存（下拉刷新/外部变更时调用）。 */
+  invalidate() {
+    this._cache.clear();
+  }
+
+  /** 目录相对其 repo 根的路径（正斜杠；repo 根自身 → '.'）。 */
+  _relDir(repoRoot, absDir) {
+    const rel = pathRelative(repoRoot, absDir);
+    return rel === '' || rel === '.' ? '.' : rel.split(sepRe).join('/');
+  }
+
+  /**
+   * 返回 absDir 下"文件级"变更映射（绝对路径 → 分类）。非 git 仓库 / git 失败 → 空表。
+   * @param {string} absDir 已被 files 服务校验过、位于授权根内的绝对目录。
+   */
+  async statusForDir(absDir) {
+    const cached = this._cache.get(absDir);
+    if (cached && Date.now() - cached.at < this._ttlMs) return cached.map;
+    let map = new Map();
+    try {
+      const repo = await this._runGit(['-C', absDir, 'rev-parse', '--show-toplevel'], { cwd: absDir });
+      const repoRoot = String(repo.stdout || '').trim();
+      if (!repoRoot) return map;
+      const rel = this._relDir(repoRoot, absDir);
+      const out = await this._runGit(
+        ['-C', repoRoot, '-c', 'core.quotepath=false', 'status', '--porcelain=v1', '-z', '-uall', '--', rel],
+        { cwd: repoRoot },
+      );
+      const relMap = parsePorcelainZ(out.stdout);
+      // 相对路径 → 当前目录条目的绝对路径（仅保留本目录下、文件级的变更）
+      for (const [relp, cat] of relMap) {
+        const abs = joinPaths(repoRoot, relp);
+        map.set(abs, cat);
+      }
+    } catch {
+      // 非 git 仓库 / git 缺失 / 超时：静默返回空表（手机端不显示点）
+      map = new Map();
+    }
+    this._cache.set(absDir, { at: Date.now(), map });
+    return map;
+  }
+}

package/mobile-bridge/index.js

@@ -15,6 +15,7 @@ import os from 'node:os';
 export { MobileBridgeCore, MobileBridgeError } from './core/bridge-core.js';
 export { readProfileBundles, resolveBundleDir } from './core/enumerate.js';
 export { FilesService, FilesError } from './core/files.js';
+export { GitStatusService } from './core/git-status.js';
 export { createLoopbackRootsResolver } from './core/roots.js';
 
 /** 把 core 包装成服务对象（connector apply 里 ctx.provide('mobileBridge', ...) 用；也便于测试）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dshfly/remote-connector",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "DSH Fly remote connector as a DeepSeek Harness (DSH) cordis plugin — outbound relay tunnel + E2EE endpoint + loopback proxy into dsh web",
   "keywords": [
@@ -33,9 +33,9 @@
     "@deepseek-ai/schemastery": "^3.18.1",
     "qrcode": "^1.5.4",
     "ws": "^8.21.3",
+    "@dshfly/crypto": "0.1.0",
     "@dshfly/tunnel-protocol": "0.1.0",
-    "@dshfly/mobile-plugin-schema": "0.1.0",
-    "@dshfly/crypto": "0.1.0"
+    "@dshfly/mobile-plugin-schema": "0.1.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
@@ -80,8 +80,9 @@
     }
   },
   "scripts": {
+    "check:deps": "node core/deps-check-cli.js",
     "build:client": "node scripts/build-client.mjs",
     "test": "node --test test/*.test.js test/mobile-bridge/test/*.test.js",
-    "build": "node scripts/build-client.mjs"
+    "build": "node core/deps-check-cli.js && node scripts/build-client.mjs"
   }
 }