local-diff-reviewer 1.0.4 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # diff-review
 
-![Diff 审查台界面截图](./docs/images/diff-review-ui.jpg)
+![Diff 审查台界面截图](https://cdn.jsdelivr.net/npm/local-diff-reviewer@latest/docs/images/diff-review-ui.jpg)
 
 AI chat 里的本地代码审查工具。可以直接用 CLI 打开，也可以安装成 agent skill。
 
@@ -42,6 +42,7 @@ npx skills add Mone-Lee/diff-review
 local-diff-reviewer
 local-diff-reviewer staged
 local-diff-reviewer HEAD~1 HEAD
+local-diff-reviewer --repo /path/to/project
 ```
 
 这三种模式分别表示：
@@ -50,6 +51,22 @@ local-diff-reviewer HEAD~1 HEAD
 - `staged`：审查已经 `git add`、但还没有提交的改动。
 - `revision`：审查两个 revision 之间的差异，例如 `local-diff-reviewer HEAD~1 HEAD` 会比较 `HEAD~1..HEAD`。
 
+如果命令不是在目标项目目录里启动，可以用 `--repo <path>` 显式指定要审查的 Git 仓库：
+
+```bash
+local-diff-reviewer --repo /path/to/project
+local-diff-reviewer --repo /path/to/project staged
+```
+
+每次启动都会创建独立的本地 review 会话。多个项目里分别执行 `local-diff-reviewer` 或 `/diff-review` 时，打开的页面会分别绑定启动时的项目，不会被最后一次启动覆盖。默认优先使用 `127.0.0.1:4966`；如果端口已被占用，会自动选择一个空闲端口。
+
+```text
+项目 A /diff-review -> http://127.0.0.1:4966  -> 项目 A diff
+项目 B /diff-review -> http://127.0.0.1:<空闲端口> -> 项目 B diff
+```
+
+注意：本地开发的 `--dev` 模式仍使用 Vite dev server，端口和 API proxy 是固定的；多项目并行审查请使用默认的构建页面模式。
+
 ## Skill 使用方式
 
 在 AI chat 中使用：
@@ -66,7 +83,7 @@ local-diff-reviewer HEAD~1 HEAD
 npx skills add Mone-Lee/diff-review
 ```
 
-skill 会从目标 workspace 运行 `npx --yes local-diff-reviewer [args...]`。
+skill 会以目标 workspace 作为命令工作目录运行 `npx --yes local-diff-reviewer [args...]`，因此 `/diff-review` 会审查当前项目，而不是 skill 安装目录。
 
 ### 预置 agent 评论
 

package/SKILL.md

@@ -16,12 +16,14 @@ Use this skill when the user asks for `/diff-review`, wants to inspect current w
 - `/diff-review staged`: review staged diff.
 - `/diff-review <base> <target>`: review diff between two Git revisions.
 
-Do not ask the user to run a shell CLI manually. Run the package command from the workspace root:
+Do not ask the user to run a shell CLI manually. Determine the target workspace/repository from the user's active environment context, then run the package command with that repository as the command working directory:
 
 ```bash
 npx --yes local-diff-reviewer [args...]
 ```
 
+Set the shell/tool `cwd` to `/absolute/path/to/target/workspace` before running the command. Do not pass `--repo` from this skill; older published CLI versions treat unknown args as revision args. Do not use the skill package directory or this skill's install directory as the review target unless that is the workspace the user asked to review.
+
 When you have concrete review findings or answers to existing review comments, preload them with one `--comment` JSON argument per comment before launching the viewer:
 
 ```bash

package/dist/cli/start.js

@@ -860,12 +860,22 @@ async function startServer(state, port = 4966) {
   app.use((error, _req, res, _next) => {
     res.status(500).json({ error: error.message });
   });
-  return new Promise((resolve3) => {
+  return listen(app, port);
+}
+function listen(app, port) {
+  return new Promise((resolve3, reject) => {
     const server = app.listen(port, "127.0.0.1", () => {
       const address = server.address();
       const actualPort = typeof address === "object" && address ? address.port : port;
       resolve3(`http://127.0.0.1:${actualPort}`);
     });
+    server.once("error", (error) => {
+      if (error.code === "EADDRINUSE" && port !== 0) {
+        listen(app, 0).then(resolve3, reject);
+        return;
+      }
+      reject(error);
+    });
   });
 }
 function selectPromptThreads(threads, scope) {
@@ -880,9 +890,9 @@ function selectPromptThreads(threads, scope) {
 var packageRoot = resolve2(dirname2(fileURLToPath(import.meta.url)), "../..");
 var builtWebDist = join4(packageRoot, "dist", "web");
 async function main() {
-  const { dev, reviewArgs, comments } = parseCliOptions(process.argv.slice(2));
+  const { dev, repo, reviewArgs, comments } = parseCliOptions(process.argv.slice(2));
   const mode = parseReviewMode(reviewArgs);
-  const repoRoot = await getRepoRoot(process.cwd());
+  const repoRoot = await getRepoRoot(repo ?? process.cwd());
   const diff = await getDiff(mode, repoRoot);
   const diffFiles = parseUnifiedDiff(diff);
   const session = {
@@ -914,6 +924,7 @@ async function main() {
 function parseCliOptions(args) {
   const reviewArgs = [];
   const comments = [];
+  let repo;
   let dev = false;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
@@ -921,6 +932,19 @@ function parseCliOptions(args) {
       dev = true;
       continue;
     }
+    if (arg === "--repo") {
+      const value = args[index + 1];
+      if (!value) throw new Error("--repo requires a path value");
+      repo = resolve2(value);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--repo=")) {
+      const value = arg.slice("--repo=".length);
+      if (!value) throw new Error("--repo requires a path value");
+      repo = resolve2(value);
+      continue;
+    }
     if (arg === "--comment") {
       const comment = args[index + 1];
       if (!comment) throw new Error("--comment requires a JSON value");
@@ -936,7 +960,7 @@ function parseCliOptions(args) {
     }
     reviewArgs.push(arg);
   }
-  return { dev, reviewArgs, comments };
+  return { dev, repo, reviewArgs, comments };
 }
 function modeLabel(mode) {
   if (mode.kind === "revision") return `${mode.base}..${mode.target}`;
@@ -944,7 +968,7 @@ function modeLabel(mode) {
 }
 function startVite() {
   const child = spawn("npm", ["run", "web:dev"], {
-    cwd: process.cwd(),
+    cwd: packageRoot,
     stdio: "inherit",
     shell: process.platform === "win32",
     env: { ...process.env, BROWSER: "none" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-diff-reviewer",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "private": false,
   "description": "Open a local GitHub-style diff review Web UI for the current repository.",
   "repository": {
@@ -20,6 +20,7 @@
   },
   "files": [
     "dist",
+    "docs/images",
     "SKILL.md",
     "README.md"
   ],