@coralwisdom/anybuilder 0.1.0

package/README.md

@@ -0,0 +1,118 @@
+# anybuilder 守护进程项目
+
+基于 Go 语言实现的客户端守护进程与命令行工具。参考了 mature 守护进程的脱离终端自拉起、跨平台会话隔离、日志大小滚动轮转、本地 HTTP 探活、防重入以及平台身份鉴权体系。
+
+编译生成的主二进制命令为 `anybuilder`。
+
+## 目录结构
+
+```text
+.
+├── cmd/
+│   └── anybuilder/
+│       ├── main.go               # 命令根入口，注册 daemon / login / auth / version
+│       ├── cmd_daemon.go         # 守护进程 start/stop/restart/status/logs 核心实现
+│       ├── cmd_daemon_unix.go    # Unix/macOS 平台系统适配 (Setsid 终端会话脱离)
+│       ├── cmd_daemon_windows.go # Windows 平台适配 (进程组与退出处理)
+│       ├── cmd_login.go          # 支持浏览器 OAuth 回调换 Token 与 Token 凭证直接登录
+│       ├── cmd_auth.go           # auth status 与 auth logout 凭证管理
+│       └── cmd_version.go        # 版本信息输出
+├── internal/
+│   ├── auth/                     # JWT 解析、BFF 换 Token 接口与浏览器唤醒
+│   ├── config/                   # 目录与配置持久化 (~/.anybuilder/config.json)
+│   ├── daemon/                   # 本地 HTTP 探活服务 (/health) 与主调度循环
+│   ├── logger/                   # 基于 slog 与 lumberjack 的大小轮转日志
+│   └── version/                  # 编译构建元信息
+├── Makefile                      # 编译与构建脚本
+└── go.mod                        # Go 模块文件
+```
+
+## 快速开始
+
+### 1. 编译构建
+
+```bash
+make build
+# 编译产物位于 bin/anybuilder
+```
+
+### 2. 身份认证与登录
+
+支持两种登录方式：
+
+#### 方式一：浏览器授权登录（默认推荐）
+
+```bash
+./bin/anybuilder login
+```
+
+- 自动在本地启动轻量临时回调服务并随机分配空闲端口；
+- 自动打开浏览器跳转至职阅授权中心（Yeeauth OAuth）；
+- 授权完成后自动重定向回本地回调接口；
+- CLI 自动携带 `code` 调用 BFF 接口 `POST /bff/auth/codeLogin` 换取 Access Token 与 Refresh Token 并安全保存在 `~/.anybuilder/config.json`。
+
+#### 方式二：Token 凭证登录（无头服务器 / CI / 自动化脚本）
+
+支持传入 **PAT（个人访问令牌）** 或 **OAuth 临时凭据**，登录时会严格请求服务端进行有效性校验（无效/已过期凭证会直接阻断报错，杜绝伪造放行）：
+
+```bash
+# 1. 仅传 Token（适合 PAT 长期令牌或短暂 CI 构建任务）
+./bin/anybuilder login --token "<YOUR_PAT_OR_ACCESS_TOKEN>"
+
+# 2. 交互式安全输入 Token（不污染 Shell 历史记录）
+./bin/anybuilder login --token
+
+# 3. 同时提供 Token 与 RefreshToken（适合后台常驻守护进程，开启自动平滑续期）
+./bin/anybuilder login --token "<ACCESS_TOKEN>" --refresh-token "<REFRESH_TOKEN>"
+
+# 4. 仅提供 RefreshToken（自动向服务端换发全新有效的 Access Token 与用户信息）
+./bin/anybuilder login --refresh-token "<REFRESH_TOKEN>"
+```
+
+> **参数说明**：
+> - **PAT 个人令牌**（如控制台生成的 UUID 令牌）：属于长期有效凭证，**不需要填 `refresh-token`**；
+> - **OAuth 临时 Token**（通常 1~2 小时过期）：若需守护进程长期在后台常驻运行，**建议配合 `--refresh-token`**，以便后台到期前自动续期；
+> - **鉴权安全校验**：无论输入何种 Token，系统均会在线向服务端鉴权并解析真实成员信息；若凭据无效，直接拦截退出。
+
+#### 凭证管理与自动续期
+
+```bash
+# 查看当前登录状态与有效时长
+./bin/anybuilder auth status
+./bin/anybuilder auth status --json
+
+# 手动触发凭证平滑刷新（使用 refresh_token 向服务端换发新凭证）
+./bin/anybuilder auth refresh
+
+# 退出登录并清理本地凭证
+./bin/anybuilder auth logout
+```
+
+> **平滑续期机制**：守护进程在后台运行时，会自动启动后台巡检协程（默认每 5 分钟检查一次）。若发现 Token 有效期剩余小于 30 分钟，会自动通过 Refresh Token 无感续期并写回本地配置；同时在建立 WebSocket 长连接前也会自动检测并确保凭证新鲜。
+
+### 3. 守护进程管理
+
+```bash
+# 启动守护进程（已登录环境下，后台脱离终端运行）
+./bin/anybuilder daemon start
+
+# 绕过登录强校验启动（本地离线调试时可用）
+./bin/anybuilder daemon start --allow-unauthenticated
+
+# 前台调试启动（实时控制台日志）
+./bin/anybuilder daemon start --foreground
+
+# 查看守护进程运行状态（PID、运行时长、探针地址）
+./bin/anybuilder daemon status
+./bin/anybuilder daemon status --json
+
+# 查看守护进程运行日志
+./bin/anybuilder daemon logs
+./bin/anybuilder daemon logs -f -n 50
+
+# 重启守护进程
+./bin/anybuilder daemon restart
+
+# 优雅停止守护进程
+./bin/anybuilder daemon stop
+```

package/bin/run.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+const path = require('path');
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+const platformMap = {
+  darwin: 'darwin',
+  linux: 'linux',
+  win32: 'win32',
+};
+
+const archMap = {
+  x64: 'x64',
+  arm64: 'arm64',
+};
+
+const platform = platformMap[process.platform];
+const arch = archMap[process.arch];
+
+if (!platform || !arch) {
+  console.error(`不支持当前系统架构: ${process.platform} ${process.arch}`);
+  process.exit(1);
+}
+
+const exeSuffix = platform === 'win32' ? '.exe' : '';
+const binaryName = `anybuilder-${platform}-${arch}${exeSuffix}`;
+const binaryPath = path.join(__dirname, 'dist', binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(`未找到对应平台的二进制可执行文件: ${binaryPath}`);
+  console.error(`请确认 npm 包完整性或在本地执行 make build-all`);
+  process.exit(1);
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+});
+
+if (result.error) {
+  console.error(`执行失败: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@coralwisdom/anybuilder",
+  "version": "0.1.0",
+  "description": "anybuilder daemon CLI cross-platform distribution",
+  "bin": {
+    "anybuilder": "./bin/run.js"
+  },
+  "files": [
+    "bin/run.js",
+    "bin/dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prepublishOnly": "make build-all"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}