git-ai-control 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 本项目的所有重要变更都会记录在此文件中。
 
+## [0.3.1] - 2026-07-30
+
+### 修复
+
+- 重新生成前端依赖锁文件，修复 macOS、Linux 和 Windows CI 中 `npm ci` 无法复现安装的问题。
+- CI 仅在分支推送和 Pull Request 时运行，避免版本标签重复触发同一检查。
+
+## [0.3.0] - 2026-07-30
+
+### 新增
+
+- 支持通过同一条 `npx git-ai-control start` 命令安装到 macOS、Linux 和 Windows；
+- 新增 macOS LaunchAgent、Linux systemd user 和 Windows 任务计划程序适配；
+- 新增跨平台 Python、Git AI 二进制和 Git 可执行文件检测；
+- 新增 `npx git-ai-control uninstall` 跨平台卸载命令；
+- 新增 macOS、Ubuntu、Windows 的 GitHub Actions 检查矩阵和服务定义测试。
+
+### 变更
+
+- 控制页面的服务状态与重启接口改为按当前操作系统执行；
+- 安装、端点备份、运行时复制和健康检查统一由 Node.js 安装器管理；
+- 文档补充三平台安装条件、服务管理方式和文件位置。
+
 ## [0.2.0] - 2026-07-30
 
 ### 新增

package/COMPATIBILITY.md

@@ -1,5 +1,15 @@
 # Git AI 兼容性说明
 
+## 操作系统
+
+`npx git-ai-control start` 支持 macOS、Linux 和 Windows，三个系统共用相同的配置格式、过滤运行时和 Web 页面，仅用户级服务管理方式不同：
+
+- macOS：LaunchAgent；
+- Linux：systemd user；
+- Windows：任务计划程序。
+
+Linux 需要可用的 systemd 用户会话。Windows 需要当前用户拥有创建登录任务的权限。安装器会从 `PATH` 自动寻找 Python 3，并按当前系统检测 `git-ai` 或 `git-ai.exe`。
+
 ## 结论
 
 本项目同时支持两类 Git AI，但支持层级不同：

package/README.md

@@ -2,7 +2,7 @@
 
 公司统一安装了 Git AI，但不想让私人 GitHub 项目的仓库名、路径、分支或 Skill 使用情况被上报？可以试试 Git AI Control Panel。
 
-它是一个仅运行在 macOS 本机的 Git AI 配置与上传策略管理页面：不用手改 JSON，也不用为每条隐私规则编写脚本，就能按仓库主机控制允许上传的数据类型和字段。前端使用 React、Vite 与 shadcn/ui，Web 服务只监听 `127.0.0.1:38742`，不会向局域网或公网开放。
+它是一个支持 macOS、Linux 和 Windows 的 Git AI 本地配置与上传策略管理页面：不用手改 JSON，也不用为每条隐私规则编写脚本，就能按仓库主机控制允许上传的数据类型和字段。前端使用 React、Vite 与 shadcn/ui，Web 服务只监听 `127.0.0.1:38742`，不会向局域网或公网开放。
 
 > [!IMPORTANT]
 > 项目可以识别 `custom_metrics` 定制版和官方 [`git-ai-project/git-ai`](https://github.com/git-ai-project/git-ai)，但两者支持层级不同。仓库级事件开关、字段脱敏和 Skill 过滤目前需要 `custom_metrics` 扩展点；官方版只能管理 Git AI 已公开的原生配置。安装前请阅读[兼容性说明](COMPATIBILITY.md)。
@@ -34,10 +34,11 @@
 
 ### 1. 一条命令启动
 
-目前支持 macOS，并要求 Git AI 已安装在：
+支持 macOS、Linux 和 Windows，需要 Node.js 18+、Python 3，并要求 Git AI 已安装在默认目录：
 
 ```text
-~/.git-ai/bin/git-ai
+macOS / Linux: ~/.git-ai/bin/git-ai
+Windows:       %USERPROFILE%\.git-ai\bin\git-ai.exe
 ```
 
 确认文件存在后运行：
@@ -52,7 +53,7 @@ npx git-ai-control start
 2. 将原始上报端点备份到仅当前用户可读的本机配置；
 3. 安装控制页面和上传过滤运行时；
 4. 保留已有的 `config.json` 与 `filter_plugins.json`；
-5. 创建并启动两个 macOS LaunchAgent；
+5. 通过当前系统的用户级服务管理器创建并启动两个本机服务；
 6. 等待控制页面和过滤服务通过健康检查。
 
 如果浏览器没有自动打开，可以手动访问：
@@ -63,6 +64,14 @@ http://127.0.0.1:38742
 
 页面顶部会显示当前 Git AI 发行版、过滤接管状态和服务状态。
 
+各系统使用的服务管理方式：
+
+| 系统 | 服务管理器 | 使用条件 |
+| --- | --- | --- |
+| macOS | LaunchAgent | 当前图形用户会话 |
+| Linux | systemd user | 可用的 systemd 用户会话 |
+| Windows | 任务计划程序 | Windows 10/11，当前用户可创建登录任务 |
+
 ### 2. 配置仓库插件
 
 以“GitHub 私人仓库只允许上传 Token”为例：
@@ -122,23 +131,24 @@ Git AI
 | 内容 | 位置 |
 | --- | --- |
 | 过滤运行时源码 | `plugins/upload-filter/plugin_filter_runtime.py` |
-| LaunchAgent 模板 | `launchagents/*.plist.in` |
-| 安装与卸载脚本 | `scripts/install.sh`、`scripts/uninstall.sh` |
+| 跨平台安装器 | `scripts/install.mjs`、`scripts/uninstall.mjs` |
+| 服务适配器 | `scripts/platform-services.mjs` |
 | Git AI 原生配置 | `~/.git-ai/config.json` |
 | 插件策略 | `~/.git-ai/filter_plugins.json` |
 | 原上报端点本机备份 | `~/.git-ai/upstream_metrics.json` |
 | 过滤运行时安装副本 | `~/.git-ai/filters/plugin_filter_runtime.py` |
 | Web 服务安装副本 | `~/.git-ai/control-panel` |
-| Web 服务 LaunchAgent | `~/Library/LaunchAgents/com.git-ai.control-panel.plist` |
-| 过滤服务 LaunchAgent | `~/Library/LaunchAgents/com.git-ai.skill-usage-filter.plist` |
+| macOS 服务定义 | `~/Library/LaunchAgents/com.git-ai.*.plist` |
+| Linux 服务定义 | `~/.config/systemd/user/git-ai-*.service` |
+| Windows 服务定义 | `%USERPROFILE%\.git-ai\services\*.ps1` 与任务计划程序 |
 
 ## 卸载
 
 ```bash
-./scripts/uninstall.sh
+npx git-ai-control uninstall
 ```
 
-卸载脚本会停止两个服务、删除本项目安装的程序副本，并将上报端点恢复为 Git AI 原地址。`config.json`、`filter_plugins.json` 和日志会保留。
+卸载命令会停止两个服务、删除本项目安装的程序副本，并将上报端点恢复为 Git AI 原地址。`config.json`、`filter_plugins.json` 和日志会保留。
 
 ## 参与贡献
 
@@ -157,7 +167,7 @@ npm ci
 npm run lint
 npm run build
 cd ../..
-/usr/bin/python3 -m py_compile server.py plugins/upload-filter/plugin_filter_runtime.py
+npm run check
 ```
 
 提交 Pull Request 时请说明：

package/bin/git-ai-control.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 
-import { spawnSync } from "node:child_process"
-import { fileURLToPath } from "node:url"
+import {spawnSync} from "node:child_process"
 import path from "node:path"
+import {fileURLToPath} from "node:url"
+
+import {browserCommand} from "../scripts/platform-services.mjs"
 
 const command = process.argv[2]
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..")
@@ -13,6 +15,7 @@ function printHelp() {
 
 用法：
   git-ai-control start    安装或更新本机服务，并打开配置页面
+  git-ai-control uninstall 卸载本机服务并恢复上报端点
   git-ai-control --help   显示帮助`)
 }
 
@@ -21,37 +24,32 @@ if (command === "--help" || command === "-h" || !command) {
   process.exit(0)
 }
 
-if (command !== "start") {
+if (!["start", "uninstall"].includes(command)) {
   console.error(`未知命令：${command}`)
   printHelp()
   process.exit(1)
 }
 
-if (process.platform !== "darwin") {
-  console.error("git-ai-control 目前仅支持 macOS")
+try {
+  if (command === "uninstall") {
+    const {uninstall} = await import("../scripts/uninstall.mjs")
+    await uninstall()
+    process.exit(0)
+  }
+  const {install} = await import("../scripts/install.mjs")
+  await install()
+} catch (error) {
+  console.error(`${command === "start" ? "安装" : "卸载"}失败：${error.message}`)
   process.exit(1)
 }
 
-const installResult = spawnSync("/bin/sh", [path.join(packageRoot, "scripts/install.sh")], {
-  cwd: packageRoot,
-  env: process.env,
-  stdio: "inherit",
-})
-
-if (installResult.error) {
-  console.error(`安装失败：${installResult.error.message}`)
-  process.exit(1)
-}
-if (installResult.status !== 0) {
-  process.exit(installResult.status ?? 1)
-}
-
-const openResult = spawnSync("/usr/bin/open", [controlPanelUrl], {
+const opener = browserCommand(process.platform, controlPanelUrl)
+const openResult = opener && spawnSync(opener.command, opener.args, {
   stdio: "ignore",
 })
-if (openResult.error || openResult.status !== 0) {
+if (!openResult || openResult.error || openResult.status !== 0) {
   console.error(`服务已启动，请手动访问 ${controlPanelUrl}`)
-  process.exit(1)
+  process.exit(0)
 }
 
 console.log(`已打开 Git AI 配置中心：${controlPanelUrl}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-ai-control",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Git AI 本地配置与上传隐私控制面板",
   "type": "module",
   "bin": {
@@ -9,7 +9,6 @@
   "files": [
     "bin",
     "docs",
-    "launchagents",
     "plugins",
     "scripts",
     "static",
@@ -20,19 +19,19 @@
     "server.py"
   ],
   "scripts": {
-    "check": "node bin/git-ai-control.js --help && /usr/bin/python3 -m py_compile server.py plugins/upload-filter/plugin_filter_runtime.py && sh -n scripts/install.sh scripts/uninstall.sh"
+    "test": "node --test",
+    "check": "node bin/git-ai-control.js --help && node scripts/check.mjs && npm test"
   },
   "engines": {
     "node": ">=18"
   },
-  "os": [
-    "darwin"
-  ],
   "keywords": [
     "git-ai",
     "privacy",
     "telemetry",
-    "macos"
+    "macos",
+    "linux",
+    "windows"
   ],
   "repository": {
     "type": "git",

package/plugins/upload-filter/plugin_filter_runtime.py

@@ -32,8 +32,9 @@ EVENT_TYPES = {
 
 HOST = "127.0.0.1"
 PORT = 38741
-POLICY_CONFIG_PATH = Path.home() / ".git-ai" / "filter_plugins.json"
-UPSTREAM_CONFIG_PATH = Path.home() / ".git-ai" / "upstream_metrics.json"
+GIT_AI_ROOT = Path(os.environ.get("GIT_AI_ROOT", Path.home() / ".git-ai")).resolve()
+POLICY_CONFIG_PATH = GIT_AI_ROOT / "filter_plugins.json"
+UPSTREAM_CONFIG_PATH = GIT_AI_ROOT / "upstream_metrics.json"
 OWNER_REPOSITORY_PATTERN = re.compile(r"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+(?:\.git)?$")
 SKILL_KEYS = {"skillName", "skill", "name"}
 PATH_KEYS = {

package/scripts/check.mjs

@@ -0,0 +1,55 @@
+import {spawnSync} from "node:child_process"
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    encoding: "utf8",
+    stdio: options.capture ? "pipe" : "inherit",
+  })
+  if (result.error || result.status !== 0) {
+    return false
+  }
+  return true
+}
+
+const pythonCandidates = process.platform === "win32"
+  ? [["py", ["-3"]], ["python", []], ["python3", []]]
+  : [["python3", []], ["python", []]]
+const pythonCommand = pythonCandidates.find(([command, prefix]) =>
+  run(command, [...prefix, "--version"], {capture: true}),
+)
+
+if (!pythonCommand) {
+  console.error("检查失败：未找到 Python 3")
+  process.exit(1)
+}
+
+const [python, prefix] = pythonCommand
+if (
+  !run(python, [
+    ...prefix,
+    "-m",
+    "py_compile",
+    "server.py",
+    "plugins/upload-filter/plugin_filter_runtime.py",
+  ])
+) {
+  process.exit(1)
+}
+
+for (const file of [
+  "bin/git-ai-control.js",
+  "scripts/check.mjs",
+  "scripts/install.mjs",
+  "scripts/platform-services.mjs",
+  "scripts/uninstall.mjs",
+]) {
+  if (!run(process.execPath, ["--check", file])) {
+    process.exit(1)
+  }
+}
+
+if (process.platform !== "win32") {
+  if (!run("/bin/sh", ["-n", "scripts/install.sh", "scripts/uninstall.sh"])) {
+    process.exit(1)
+  }
+}