2026-09-30 12:00:34 +00:00
3 changed files with 69 additions and 10 deletions
@@ -35,3 +35,4 @@
 | 同步前验收 | fcddfee5be45870071c18d921173f58bfab9e851 | f0e7831ed1cddc67621f873c2e49cba02f81fc3c | 2026-09-30T11:38:44Z |
 | 同步前验收 | 1174431ee6953ddc6e319f8fdbd8ecbf18576dbf | e3ba86aa16ceaa052bd5f9c2568e9a6c9cdd90d0 | 2026-09-30T11:50:25Z |
 | 同步前验收 | f832f0413e0baa358e7422db5edacb180188635a | 5c2fa4562b3010a94bbaa4731299223e70953ee4 | 2026-09-30T11:56:42Z |
+| 同步前验收 | 251bd94847595dcb01c5571448b28ee3d75da956 | 52d0e45c81edd4e8ea2226439766301610d8faa3 | 2026-09-30T12:00:26Z |
@@ -0,0 +1,20 @@
+# feature/svc-envfile 任务卡
+
+任务主记录：<PR 链接，task-finish 时填写>；状态：已完成；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0 = 251bd94847595dcb01c5571448b28ee3d75da956
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-svc-envfile；分支：feature/svc-envfile
+- 授权与交付终点：用户要求 --env 指定环境配置文件（如 ./.env.dev）且 --port 等 CLI 参数可覆盖文件配置 → 实现并实测后自主闭环合入。
+
+## 目标与非目标
+
+- 目标：--env FILE（任意位置，支持 = 形式）；dotenv 安全解析（# 注释、成对引号、export 前缀、仅合法变量名、不执行文件内容）；优先级 CLI > --env > .svc.env > 系统环境变量 > 默认；与播种机制贯通。
+- 非目标：不做多文件合并语法；不引入真实 dotenv 依赖。
+
+## 结果与验证
+
+- 结果：svc.sh 预扫 --env + load_env_file 安全解析 + help 更新。
+- 验证（全实测）：.env.dev（含 export/引号/注释）地址与模型生效并播种（ss 验证 *:8830）；--port 8831 覆盖文件端口、host 仍取文件（*:8831）；缺文件快速报错；.svc.env 与 --env 分层（重叠键 --env 赢、非重叠键合并，tavily 保留）。
+- 影响与剩余项：.env.* 文件含密钥需自行 gitignore（.svc.env 已内置，示例文件已在 help 标注建议）。
@@ -6,7 +6,10 @@
 #   action：deploy（默认）| stop | start | restart | status | logs [行数]
 #   scripts/svc.sh status                # 全环境总览
 #
-# 参数（优先级：命令行 > 环境变量 > 默认值）：
+# 参数（优先级：命令行 > --env 配置文件 > 环境变量/.svc.env > 默认值）：
+#   --env FILE        环境配置文件（dotenv：KEY=VALUE，支持 # 注释、成对引号、
+#                     export 前缀；只识别合法变量名，不执行文件内容）。
+#                     文件里写 SVC_DEV_ADDR/SVC_MODEL_* 等，CLI 参数可覆盖其中任意项
 #   --addr host:port   监听地址（整体覆盖）
 #   --host host        只改主机部分（如 0.0.0.0 对外开放）
 #   --port port        只改端口部分
@@ -28,14 +31,18 @@
 #   dev:  127.0.0.1:8788  数据 runtime/dev/data；SVC_DEV_ADDR/DATA/MOCK=1 可覆盖
 #   prod: 127.0.0.1:8787  数据 runtime/prod/data；SVC_PROD_ADDR/DATA/DSN/AUTH 可覆盖
 #
-# 一次性配置：把 SVC_MODEL_BASE/SVC_MODEL_KEY/SVC_MODEL_NAME 等写入 <repo>/.svc.env
-#（已 gitignore），此后每次 start/deploy 自动播种，服务起来即可用。
+# 一次性配置：.svc.env（自动加载）或 --env 指定文件（如 .env.dev/.env.prod，
+# 均建议 gitignore）。文件示例（.env.dev）：
+#   SVC_DEV_ADDR=0.0.0.0:8790
+#   SVC_MODEL_BASE=https://api.xxx.com/v1
+#   SVC_MODEL_KEY=sk-xx
+#   SVC_MODEL_NAME=glm-4.7
 #
 # 示例：
-#   scripts/svc.sh dev --port 9000 --mock
+#   scripts/svc.sh dev --env ./.env.dev                # 用配置文件启动
+#   scripts/svc.sh dev --env ./.env.dev --port 9000    # CLI 覆盖文件里的端口
 #   scripts/svc.sh prod --host 0.0.0.0 --dsn postgres://u:p@127.0.0.1:5432/as
-#   scripts/svc.sh dev --model-base https://api.xxx.com/v1 --model-key sk-xx --model-name glm-4.7
-#   make svc ENV=dev ARGS="--port 9000"
+#   make svc ENV=dev ARGS="--env .env.dev --port 9000"
 #
 # 安全约束：
 #   - 只停自己启动过的进程（pidfile + /proc/<pid>/cmdline 双重校验），绝不动他人现场；
@@ -46,9 +53,6 @@ ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 RUNTIME="$ROOT/runtime"
 BIN="$ROOT/bin/agent-system"

-# 一次性配置文件（含密钥，已 gitignore）：SVC_MODEL_* 等在此设好后每次启动自动生效。
-# shellcheck disable=SC1090
-[ -f "$ROOT/.svc.env" ] && . "$ROOT/.svc.env"

 c_info() { printf '\033[1;34m[svc]\033[0m %s\n' "$*"; }
 c_ok()   { printf '\033[1;32m[svc]\033[0m %s\n' "$*"; }
@@ -56,7 +60,27 @@ c_warn() { printf '\033[1;33m[svc]\033[0m %s\n' "$*"; }
 c_err()  { printf '\033[1;31m[svc]\033[0m %s\n' "$*" >&2; }

 usage() {
-  sed -n '2,36p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
+  sed -n '2,46p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'
+}
+
+# load_env_file FILE：dotenv 安全解析——逐行 KEY=VALUE 赋值（剥 export 前缀与成对
+# 引号，忽略注释/空行/非法行），不 source 执行文件内容。
+load_env_file() {
+  local f="$1" line k v
+  [ -f "$f" ] || { c_err "环境配置文件不存在：$f"; exit 2; }
+  while IFS= read -r line || [ -n "$line" ]; do
+    line="${line%$'\r'}"
+    case "$line" in ''|'#'*) continue ;; esac
+    [[ "$line" =~ ^[[:space:]]*(export[[:space:]]+)?[A-Za-z_][A-Za-z0-9_]*= ]] || continue
+    k="${line%%=*}"
+    k="${k#"${k%%[![:space:]]*}"}"          # 左去空白
+    k="${k#export}"
+    k="${k#"${k%%[![:space:]]*}"}"
+    v="${line#*=}"
+    v="${v#"${v%%[![:space:]]*}"}"          # 值左去空白
+    v="${v%\"}"; v="${v%\'}"; v="${v#\"}"; v="${v#\'}"  # 剥成对引号
+    printf -v "$k" '%s' "$v"
+  done < "$f"
 }

 # ---- 命令行参数（覆盖层）----
@@ -280,6 +304,20 @@ env_status_line() {

 main() {
  [ $# -ge 1 ] || { usage; exit 2; }
+  # 预扫 --env（支持 --env FILE 与 --env=FILE，可出现在任意位置）：
+  # 配置层优先级 = CLI 参数 > --env 文件 > .svc.env > 系统环境变量 > 默认值。
+  local svc_envfile="" a
+  local pre=()
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --env)   [ $# -ge 2 ] || { c_err "--env 需要文件路径"; exit 2; }; svc_envfile="$2"; shift 2 ;;
+      --env=*) svc_envfile="${1#--env=}"; shift ;;
+      *)       pre+=("$1"); shift ;;
+    esac
+  done
+  set -- ${pre[@]+"${pre[@]}"}
+  [ -f "$ROOT/.svc.env" ] && load_env_file "$ROOT/.svc.env"
+  [ -n "$svc_envfile" ] && load_env_file "$svc_envfile"
  if [ "$1" = "status" ] && [ $# -eq 1 ]; then
    c_info "服务总览（root: $ROOT）"
    for e in dev prod; do ENV_NAME="$e"; env_config "$e"; env_status_line; done