fima-cli 1.3.0 → 1.4.0

package/README.md

@@ -14,7 +14,34 @@ fima --help
 
 也可以使用 `pnpm add -g fima-cli` 安装，或直接运行 `npx fima-cli --help`。
 
-启动 `fima-web` 后，执行 `fima login` 登录，再使用业务指令。
+启动 `fima-web` 后，先设置服务器地址，再执行 `fima login` 登录。
+
+## 服务器地址配置
+
+首次使用必须设置服务器地址；没有配置时，业务命令会提示设置并退出，不会自动连接本机默认服务。
+
+```bash
+# 首次设置：支持 IP:端口，未写协议时补全为 http://
+fima config set-url 127.0.0.1:8000
+
+# 更换服务器：使用同一条命令覆盖已保存的地址
+fima config set-url https://fima.example.com
+
+# 查看已保存地址及当前生效地址
+fima config show
+fima login
+```
+
+配置保存在 `~/.fima/config.json`，重开终端仍有效；可用 `FIMA_CONFIG_FILE` 指定其他配置文件。支持 HTTP/HTTPS URL、域名、IPv4 和方括号形式的 IPv6（如 `[::1]:8000`），也支持部署在子路径下的服务（如 `https://fima.example.com/expenses`）。地址不得包含账号密码、查询参数或片段，端口范围为 1–65535。
+
+地址优先级为 **`--url` > `FIMA_URL` > 已保存配置**。前两种方式仅临时覆盖，不会修改配置文件：
+
+```bash
+fima --url 192.168.1.10:8000 whoami
+FIMA_URL=https://fima.example.com fima whoami
+```
+
+登录 Cookie 与服务器地址绑定，更换服务器后需重新登录，旧 Cookie 不会发往新地址。升级前保存的、未绑定地址的旧会话也需要重新登录。`--help`、`--version` 和设置配置的命令无需服务器地址。
 
 ## 从源码运行
 
@@ -23,6 +50,7 @@ fima --help
 ```bash
 ./fima -v
 ./fima -h
+./fima config set-url 127.0.0.1:8000
 ./fima login
 ./fima whoami
 ./fima create --json '{"title":"上海客户拜访","category":"差旅费","amount":1280,"date":"2026-07-12","invoice":"./invoice.pdf","submit":true}'
@@ -41,7 +69,7 @@ fima --help
 fima -h
 ```
 
-服务默认地址为 `http://127.0.0.1:8000`，可设置 `FIMA_URL`，或在子命令前传入 `--url`，例如 `fima --url https://your-fima.example.com login`。请使用服务管理员提供的账号登录。执行 `login` 会拉起浏览器中的专用登录框，账号密码只在网页中填写；CLI 会自动检测登录完成并把会话 Cookie 保存在 `~/.fima/session.json`（可用 `FIMA_COOKIE_FILE` 覆盖）。网页会明确提示“CLI 登录已完成”，此时直接关闭当前页面即可。可通过 `--timeout` 调整等待时长（默认 5 分钟）。后续业务请求会自动携带 Cookie；可通过 `whoami` 查看当前登录账号，`logout` 会退出登录并清除本地会话 Cookie。
+请使用服务管理员提供的账号登录。执行 `login` 会拉起浏览器中的专用登录框，账号密码只在网页中填写；CLI 会自动检测登录完成并把会话 Cookie 保存在 `~/.fima/session.json`（可用 `FIMA_COOKIE_FILE` 覆盖）。网页会明确提示“CLI 登录已完成”，此时直接关闭当前页面即可。可通过 `--timeout` 调整等待时长（默认 5 分钟）。后续业务请求会自动携带与当前服务器匹配的 Cookie；可通过 `whoami` 查看当前登录账号，`logout` 会退出登录并清除本地会话 Cookie。
 
 ## 参数传递
 

package/fima.py

@@ -1,22 +1,107 @@
 #!/usr/bin/env python3
 """Fima CLI - 通过命令行操作 Fima 财务报销系统。"""
 from __future__ import annotations
-import argparse, json, math, mimetypes, os, sys, time, webbrowser
+import argparse, json, math, mimetypes, os, sys, tempfile, time, webbrowser
 from http.cookies import SimpleCookie
 from pathlib import Path
-from urllib.parse import quote
+from urllib.parse import quote, urlsplit, urlunsplit
 from urllib.error import HTTPError, URLError
 from urllib.request import Request, urlopen
 
-VERSION="1.3.0"; DEFAULT_URL=os.environ.get("FIMA_URL","http://127.0.0.1:8000")
+VERSION="1.4.0"
+
+def config_file(): return Path(os.environ.get("FIMA_CONFIG_FILE", Path.home() / ".fima" / "config.json"))
+
+def normalize_url(value):
+    if not isinstance(value, str) or not value.strip():
+        fail("服务器地址不能为空，请提供 URL 或 IP:端口")
+    value=value.strip()
+    if any(c.isspace() or ord(c)<32 or ord(c)==127 for c in value) or "\\" in value:
+        fail("服务器地址不能包含空白、控制字符或反斜杠")
+    if "://" not in value:
+        value="http://"+value
+    try:
+        parsed=urlsplit(value)
+        host=parsed.hostname
+        port=parsed.port
+    except ValueError:
+        fail("服务器地址格式不正确，端口必须是 1–65535 的整数，IPv6 地址请使用方括号")
+    if parsed.scheme not in ("http", "https") or not host:
+        fail("服务器地址必须是有效的 HTTP/HTTPS URL 或 IP:端口")
+    if parsed.username is not None or parsed.password is not None:
+        fail("服务器地址不能包含账号密码，请使用 fima login 登录")
+    if "?" in value or "#" in value:
+        fail("服务器地址不能包含查询参数或片段")
+    if port == 0 or parsed.netloc.endswith(":"):
+        fail("服务器端口必须是 1–65535 的整数")
+    try:
+        host=host.encode("idna").decode("ascii")
+    except UnicodeError:
+        fail("服务器主机名格式不正确")
+    if ":" not in host and any(not (c.isalnum() or c in ".-_") for c in host):
+        fail("服务器主机名格式不正确")
+    authority=f"[{host}]" if ":" in host else host
+    if port is not None and (parsed.scheme, port) not in (("http", 80), ("https", 443)):
+        authority+=f":{port}"
+    return urlunsplit((parsed.scheme, authority, parsed.path.rstrip("/"), "", ""))
+
+def read_config():
+    try:
+        data=json.loads(config_file().read_text(encoding="utf-8"))
+    except FileNotFoundError:
+        return {}
+    except (OSError, UnicodeError, json.JSONDecodeError):
+        fail("无法读取服务器配置，请运行 fima config set-url <地址> 重新设置")
+    if not isinstance(data, dict) or not isinstance(data.get("url"), str):
+        fail("服务器配置格式不正确，请运行 fima config set-url <地址> 重新设置")
+    return data
+
+def resolve_url(override=None):
+    if override is not None:
+        return normalize_url(override)
+    if "FIMA_URL" in os.environ:
+        return normalize_url(os.environ["FIMA_URL"])
+    saved=read_config().get("url")
+    if saved is None:
+        fail("尚未设置服务器地址，请先执行：fima config set-url <URL或IP:端口>\n例如：fima config set-url 127.0.0.1:8000")
+    return normalize_url(saved)
+
+def set_url(a):
+    url=normalize_url(a.server_url)
+    target=config_file(); temporary=None
+    try:
+        target.parent.mkdir(parents=True, exist_ok=True)
+        with tempfile.NamedTemporaryFile(mode="w", encoding="utf-8", dir=target.parent, delete=False) as f:
+            temporary=Path(f.name)
+            json.dump({"url":url}, f, ensure_ascii=False)
+            f.write("\n")
+        temporary.replace(target)
+    except OSError:
+        fail("无法保存服务器配置，请检查配置目录的写入权限")
+    finally:
+        if temporary is not None and temporary.exists():
+            temporary.unlink()
+    print(f"已保存服务器地址：{url}")
+    print("后续命令将使用该地址；新服务器请先执行 fima login。")
+    if a.url is not None or "FIMA_URL" in os.environ:
+        print("提示：--url 和 FIMA_URL 的优先级高于保存的配置。")
+
+def show_config(a):
+    saved=read_config().get("url")
+    print(f"已保存地址：{normalize_url(saved) if saved is not None else '未设置'}")
+    print(f"当前生效地址：{resolve_url(a.url)}")
 
 def cookie_file(): return Path(os.environ.get("FIMA_COOKIE_FILE", Path.home() / ".fima" / "session.json"))
 def load_cookie():
-    try: return json.loads(cookie_file().read_text(encoding="utf-8"))["cookie"]
-    except (OSError, KeyError, json.JSONDecodeError): return None
+    try:
+        session=json.loads(cookie_file().read_text(encoding="utf-8"))
+        if isinstance(session,dict) and session.get("url")==ARGS.url and isinstance(session.get("cookie"),str):
+            return session["cookie"]
+    except (OSError, UnicodeError, json.JSONDecodeError): pass
+    return None
 def save_cookie(value):
     target=cookie_file(); target.parent.mkdir(parents=True, exist_ok=True)
-    target.write_text(json.dumps({"cookie":value}),encoding="utf-8"); target.chmod(0o600)
+    target.write_text(json.dumps({"url":ARGS.url,"cookie":value}),encoding="utf-8"); target.chmod(0o600)
 def clear_cookie():
     try: cookie_file().unlink()
     except FileNotFoundError: pass
@@ -40,7 +125,7 @@ def request(method,path,data=None,file=None,include_headers=False):
         try: msg=json.loads(e.read()).get("error",str(e))
         except Exception: msg=str(e)
         fail(msg)
-    except URLError: fail(f"无法连接 Fima Web：{url}\n请先运行：cd fima-web && python3 app.py")
+    except URLError: fail(f"无法连接 Fima Web：{url}\n请检查服务是否启动，或执行 fima config set-url <地址> 更换服务器。")
 
 def fail(msg): print(f"错误：{msg}",file=sys.stderr);raise SystemExit(1)
 def json_object(value):
@@ -125,8 +210,14 @@ def whoami(a):
 
 parser=argparse.ArgumentParser(prog="fima",description="Fima 财务报销命令行工具",epilog="多字段命令使用 JSON：fima create --json '{\"title\": \"客户拜访\", \"amount\": 280, \"date\": \"2026-07-12\"}'")
 parser.add_argument("-v","--version",action="version",version=f"fima {VERSION}")
-parser.add_argument("--url",default=DEFAULT_URL,help=f"Fima Web 地址（默认：{DEFAULT_URL}）")
+parser.add_argument("--url",help="本次请求的服务器 URL 或 IP:端口；优先级：--url > FIMA_URL > 保存的配置")
 sub=parser.add_subparsers(dest="command",title="支持的指令",required=True)
+p=sub.add_parser("config",help="设置、更换或查看服务器地址")
+config_sub=p.add_subparsers(dest="config_command",required=True)
+c=config_sub.add_parser("set-url",help="保存或更换服务器 URL / IP:端口",description="保存服务器地址供后续命令使用；未写协议时默认 HTTP，更换服务器后需登录新服务器。")
+c.add_argument("server_url",metavar="ADDRESS",help="例如 https://fima.example.com 或 192.168.1.10:8000")
+c.set_defaults(func=set_url)
+c=config_sub.add_parser("show",help="查看保存的地址及当前生效地址");c.set_defaults(func=show_config)
 p=sub.add_parser("login",help="打开浏览器登录并保存 Cookie");p.add_argument("--timeout",type=int,default=300,help="等待网页登录完成的秒数（默认：300）");p.set_defaults(func=login)
 p=sub.add_parser("logout",help="退出登录并清除本地 Cookie");p.set_defaults(func=logout)
 p=sub.add_parser("whoami",help="查看当前登录账号");p.set_defaults(func=whoami)
@@ -138,4 +229,7 @@ for cmd,help_text,default_operator in [("submit","提交报销单","王小明"),
     json_help='JSON 对象；必填 id；可选 operator、comment' if cmd!="reject" else 'JSON 对象；必填 id、comment；可选 operator'
     p=sub.add_parser(cmd,help=f"{help_text}（使用 JSON 传递字段）");p.add_argument("--json",dest="payload",required=True,type=json_object,metavar="JSON",help=json_help);p.set_defaults(func=action,default_operator=default_operator,default_comment=help_text)
 ARGS=parser.parse_args()
-if __name__=="__main__": ARGS.func(ARGS)
+if __name__=="__main__":
+    if ARGS.command != "config":
+        ARGS.url=resolve_url(ARGS.url)
+    ARGS.func(ARGS)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fima-cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Command-line client for the Fima expense reimbursement system",
   "license": "UNLICENSED",
   "repository": {