guanwei 1.1.1

package/scripts/install.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# ============================================================
+# 观微 Guanwei · 一键安装脚本（备用方式）
+# 用法（复制这一行到终端执行）：
+#   curl -fsSL https://raw.githubusercontent.com/RubyCcll/guanwei/main/scripts/install.sh | bash
+#
+# 【推荐方式】一行命令（国内走 npmmirror，几秒装完）：
+#   npm i -g guanwei
+#   guanwei setup --key 你的APIKey
+#   guanwei start
+#
+# 本脚本做什么：拉取项目 → 安装依赖 → 全局安装 guanwei 命令
+# 装完：guanwei setup 配置 Key → guanwei start 启动
+# 只想快速跑？装好 Docker 后（不装本脚本也行）：
+#   docker run -d --name guanwei -p 5173:80 -e LLM_DEEPSEEK_KEY=你的Key ghcr.io/rubyccll/guanwei:latest
+# ============================================================
+set -euo pipefail
+
+echo "=============================================="
+echo "  观微 Guanwei · 一键安装（源码方式）"
+echo "=============================================="
+
+# 0. 优先推荐 npm 方式（国内最快）
+if command -v npm >/dev/null 2>&1; then
+  echo ""
+  echo "检测到 npm——【推荐】直接用一行命令安装（几秒完成）："
+  echo ""
+  echo "    npm i -g guanwei"
+  echo "    guanwei setup --key 你的APIKey"
+  echo "    guanwei start"
+  echo ""
+  read -r -p "是否继续源码安装？[y/N] " answer
+  if [[ ! "${answer:-}" =~ ^[Yy]$ ]]; then
+    echo "已取消。用上面 npm 三行命令即可安装 ✓"
+    exit 0
+  fi
+fi
+
+REPO="https://github.com/RubyCcll/guanwei.git"
+INSTALL_DIR="${GUANWEI_DIR:-$HOME/guanwei}"
+BRANCH="main"
+
+# 1. 检查 git / node
+if ! command -v git >/dev/null 2>&1; then
+  echo "❌ 未检测到 git——请先安装：https://git-scm.com/downloads"
+  echo "   或者用 npm 方式：npm i -g guanwei"
+  exit 1
+fi
+
+# 2. 拉取/更新项目
+if [[ -d "$INSTALL_DIR/.git" ]]; then
+  echo "📦 检测到已有项目，更新到最新..."
+  git -C "$INSTALL_DIR" fetch origin >/dev/null 2>&1 || true
+  git -C "$INSTALL_DIR" merge --ff-only origin/$BRANCH >/dev/null 2>&1 || git -C "$INSTALL_DIR" pull --rebase origin $BRANCH >/dev/null 2>&1 || true
+else
+  echo "📦 拉取项目到 $INSTALL_DIR ..."
+  git clone --depth 1 -b $BRANCH "$REPO" "$INSTALL_DIR"
+fi
+cd "$INSTALL_DIR"
+
+# 3. 安装依赖
+echo "📦 安装依赖（首次约 1-3 分钟）..."
+npm install --no-fund --no-audit >/dev/null 2>&1 || echo "   ⚠️  前端依赖安装警告"
+(cd server && npm install --no-fund --no-audit >/dev/null 2>&1) || echo "   ⚠️  后端依赖安装警告"
+
+# 4. 全局安装 guanwei 命令
+echo "🔗 安装 guanwei 全局命令..."
+npm link >/dev/null 2>&1 || echo "   ⚠️  npm link 失败（可手动：cd $INSTALL_DIR && npm link）"
+
+echo "=============================================="
+echo "🎉 安装完成！项目位于：$INSTALL_DIR"
+echo ""
+echo "下一步："
+echo "  1) 配置 API Key：   guanwei setup --key 你的APIKey"
+echo "  2) 启动：           guanwei start（或 guanwei start --docker）"
+echo "  3) 浏览器打开：     http://localhost:5173"
+echo ""
+echo "常用命令：guanwei status / doctor / update / stop"
+echo "=============================================="

package/scripts/release.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# ============================================================
+# 观微发版脚本：升级版本号 → 同步 lockfile → 打 tag → 推送
+# 用法：./scripts/release.sh 1.1.2        （新版本号，不带 v 前缀）
+# 要求：工作区无未提交改动；CHANGELOG.md 已写好本次版本条目
+# ============================================================
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+NEW_VER="${1:-}"
+if [[ -z "$NEW_VER" ]] || ! [[ "$NEW_VER" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "用法: ./scripts/release.sh <版本号>   例如: ./scripts/release.sh 1.1.2"; exit 1
+fi
+
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo "⚠️  工作区有未提交改动，先提交或 stash 再发版"; exit 1
+fi
+
+echo "1️⃣  更新 package.json / server/package.json -> ${NEW_VER}"
+node -e "
+const fs = require('fs');
+for (const p of ['package.json', 'server/package.json', 'package-lock.json', 'server/package-lock.json']) {
+  const d = JSON.parse(fs.readFileSync(p, 'utf-8'));
+  d.version = '${NEW_VER}';
+  fs.writeFileSync(p, JSON.stringify(d, null, 2) + '\n');
+}
+"
+echo "   ✅ 版本号与 lockfile 已同步"
+
+echo "2️⃣  检查 CHANGELOG.md 是否已有 [${NEW_VER}] 条目..."
+if ! grep -q "^## \[${NEW_VER}\]" CHANGELOG.md; then
+  echo "   ⚠️  CHANGELOG.md 缺少 [${NEW_VER}] 条目——请补上后再继续（Ctrl+C 中断）"
+  read -rp "   已补好？回车继续: " _
+fi
+
+echo "3️⃣  提交 + 打 tag + 推送"
+git add package.json package-lock.json server/package.json server/package-lock.json CHANGELOG.md
+git commit -m "chore: 版本升级 ${NEW_VER}"
+git tag "v${NEW_VER}"
+git push origin main
+git push origin "v${NEW_VER}"
+echo "🎉 v${NEW_VER} 已推送——CI / Release / 镜像 / Pages 将自动执行"

package/scripts/setup.bat

@@ -0,0 +1,36 @@
+@echo off
+REM 观微一键配置与启动（Windows）—— 用法：setup.bat --key sk-xxx [--docker]
+setlocal
+set KEY=
+set MODE=local
+
+:parse
+if "%~1"=="" goto done
+if "%~1"=="--key" (set KEY=%~2 & shift & shift & goto parse)
+if "%~1"=="--docker" (set MODE=docker & shift & goto parse)
+echo 未知参数: %~1
+exit /b 1
+:done
+
+if "%KEY%"=="" (
+  echo 请用: setup.bat --key 你的APIKey [--docker]
+  echo 或先手动创建 server\.env（参考 server\.env.example）
+  exit /b 1
+)
+
+echo 生成 server\.env ...
+> server\.env echo LLM_PROVIDER=deepseek
+>> server\.env echo LLM_DEEPSEEK_KEY=%KEY%
+>> server\.env echo LLM_DEEPSEEK_MODEL=deepseek-chat
+
+if "%MODE%"=="docker" (
+  docker compose up -d --build
+  echo 已启动: http://localhost:5173
+) else (
+  call npm install
+  pushd server
+  call npm install
+  popd
+  start "guanwei-backend" cmd /c "cd server && npm run dev"
+  call npm run dev
+)

package/scripts/setup.sh

@@ -0,0 +1,123 @@
+#!/usr/bin/env bash
+# ============================================================
+# 观微 Guanwei · 一键配置与启动
+# 用法：
+#   ./scripts/setup.sh                          # 交互式：选择服务商 → 输入 API Key → 自动装依赖并启动
+#   ./scripts/setup.sh --key sk-xxx             # 非交互（默认 DeepSeek）
+#   ./scripts/setup.sh --provider gemini --key xxxx
+#   ./scripts/setup.sh --key sk-xxx --docker    # 用 Docker 启动（无需本机 Node）
+#   ./scripts/setup.sh --link                    # 额外：全局安装 guanwei 命令（之后任意目录可用）
+# ============================================================
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+PROVIDER=""
+KEY=""
+MODE="local"   # local | docker
+
+LINK=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --provider) PROVIDER="$2"; shift 2 ;;
+    --key)      KEY="$2"; shift 2 ;;
+    --docker)   MODE="docker"; shift ;;
+    --link)     LINK="1"; shift ;;
+    -h|--help)
+      sed -n '1,12p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;
+    *) echo "未知参数: $1（--provider / --key / --docker / --help）"; exit 1 ;;
+  esac
+done
+
+# ---------- 1. 选择服务商与 Key ----------
+if [[ -z "$PROVIDER" ]]; then
+  if [[ -n "$KEY" ]]; then
+    # 只给了 --key：默认 DeepSeek
+    PROVIDER=deepseek
+  else
+    echo "=============================================="
+    echo "  观微 Guanwei · 一键配置"
+    echo "=============================================="
+    echo "选择 AI 服务商："
+    echo "  1) DeepSeek（推荐，性价比高）"
+    echo "  2) Gemini（Google）"
+    echo "  3) Groq（免费额度）"
+    echo "  4) 通义千问（阿里云）"
+    echo "  5) 自定义 OpenAI 兼容端点"
+    read -rp "请输入编号 [1]: " CHOICE
+    case "${CHOICE:-1}" in
+      1) PROVIDER=deepseek ;;
+      2) PROVIDER=gemini ;;
+      3) PROVIDER=groq ;;
+      4) PROVIDER=qwen ;;
+      5) PROVIDER=custom ;;
+      *) echo "无效编号"; exit 1 ;;
+    esac
+  fi
+fi
+if [[ -z "$KEY" ]]; then
+  read -rsp "请输入你的 ${PROVIDER} API Key（输入不回显）: " KEY; echo
+fi
+if [[ -z "$KEY" ]]; then
+  echo "错误：API Key 不能为空"; exit 1
+fi
+
+# ---------- 2. 生成 server/.env ----------
+mkdir -p server
+cat > server/.env <<EOF
+# 由 scripts/setup.sh 生成（$(date '+%Y-%m-%d %H:%M')）
+LLM_PROVIDER=${PROVIDER}
+EOF
+case "$PROVIDER" in
+  deepseek) echo "LLM_DEEPSEEK_KEY=${KEY}" >> server/.env
+            echo "LLM_DEEPSEEK_MODEL=deepseek-chat" >> server/.env ;;
+  gemini)   echo "LLM_GEMINI_KEY=${KEY}" >> server/.env ;;
+  groq)     echo "LLM_GROQ_KEY=${KEY}" >> server/.env ;;
+  qwen)     echo "LLM_QWEN_KEY=${KEY}" >> server/.env ;;
+  custom)
+    echo "LLM_CUSTOM_KEY=${KEY}" >> server/.env
+    read -rp "自定义端点 URL [https://your-endpoint/v1/chat/completions]: " EP
+    echo "LLM_CUSTOM_ENDPOINT=${EP:-https://your-endpoint/v1/chat/completions}" >> server/.env ;;
+esac
+echo "✅ server/.env 已生成（API Key 仅存本地，已 gitignore）"
+
+# ---------- 3. 前端环境 ----------
+if [[ ! -f .env.development ]] && [[ -f .env.development.example ]]; then
+  cp .env.development.example .env.development
+  echo "✅ .env.development 已就绪"
+fi
+
+# ---------- 3.5 可选：全局安装 guanwei 命令 ----------
+if [[ -n "$LINK" ]]; then
+  echo "🔗 全局安装 guanwei 命令（npm link，之后任意目录可用）..."
+  npm link 2>&1 | tail -1
+  echo "   现在可以直接运行：guanwei status"
+fi
+
+# ---------- 4. 安装依赖并启动 ----------
+if [[ "$MODE" == "docker" ]]; then
+  if ! command -v docker >/dev/null 2>&1; then
+    echo "错误：未检测到 Docker，请先安装 https://www.docker.com/"; exit 1
+  fi
+  # 兼容 docker compose 插件与独立 docker-compose
+  if docker compose version >/dev/null 2>&1; then
+    COMPOSE="docker compose"
+  elif command -v docker-compose >/dev/null 2>&1; then
+    COMPOSE="docker-compose"
+  else
+    echo "错误：未找到 docker compose 插件（docker-compose）"; exit 1
+  fi
+  echo "🐳 正在构建并启动（首次构建需几分钟）..."
+  $COMPOSE up -d --build
+  echo "✅ 已启动：前端 http://localhost:5173 · 后端 http://localhost:3018"
+  echo "   停止：$COMPOSE down"
+else
+  echo "📦 安装依赖（首次较慢）..."
+  npm install --no-fund --no-audit
+  (cd server && npm install --no-fund --no-audit)
+  echo "🚀 启动服务..."
+  echo "   后端 :3018（tsx watch）"
+  echo "   前端 :5173（vite dev）"
+  echo "   Ctrl+C 停止"
+  (cd server && npm run dev) &
+  npm run dev
+fi