yswj-internal-cli 0.1.0__tar.gz

yswj_internal_cli-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: yswj-internal-cli
+Version: 0.1.0
+Summary: Command-line client for 元生无界内部管理系统
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: keyring<26,>=25.7
+
+# 元生无界内部管理系统 CLI
+
+命令名：`yswj-internal`。CLI 通过系统开放 API 读取数据，权限仍由 API Key 和服务端账号权限控制。
+
+## 安装
+
+需要 Python 3.10 或更新版本。发布到 PyPI 后，建议用 `pipx` 安装隔离环境：
+
+```bash
+pipx install yswj-internal-cli
+```
+
+也可以在虚拟环境中安装：
+
+```bash
+python -m pip install yswj-internal-cli
+```
+
+在本仓库开发时，也可以从本地目录安装：
+
+```bash
+pipx install ./cli
+```
+
+给 AI 助手配置时，请先阅读 `src/yswj_internal_cli/AI_SETUP.md`。安装后的 Python 包中也包含 `yswj_internal_cli/AI_SETUP.md`。
+
+## 配置
+
+先在系统的“API Key 管理”页面申请 Key，再设置站点地址和密钥：
+
+```bash
+yswj-internal --profile prod config set-server http://39.107.72.34:6611 --activate
+yswj-internal --profile prod config set-key
+yswj-internal config show
+```
+
+`set-key` 会隐藏输入内容。若系统密钥库可用，Key 会保存到系统密钥库；否则保存到本地配置文件，并在 macOS/Linux 上限制为当前用户可读写。配置文件位于 `~/.config/yswj-internal/config.json`，可用 `YSWJ_INTERNAL_CONFIG` 覆盖。
+
+当前线上地址使用 HTTP。HTTP 不加密传输，请优先使用 HTTPS 地址；配置 HTTP 地址时 CLI 会显示提醒。
+
+脚本环境也可以通过 `YSWJ_INTERNAL_PROFILE`、`YSWJ_INTERNAL_BASE_URL` 和 `YSWJ_INTERNAL_API_KEY` 临时覆盖配置。不要把 Key 放在 URL、代码仓库或命令行参数中。
+
+## 数据命令
+
+列表默认输出表格；需要程序处理时选择 JSON，需要电子表格时选择 CSV。
+
+```bash
+yswj-internal leads list
+yswj-internal --profile prod leads list --all --updated-since 2026-11-01T00:00:00+08:00 --format json
+yswj-internal contacts get 201 --format json
+yswj-internal projects export --format csv --output projects.csv --updated-since 2026-11-01T00:00:00+08:00
+yswj-internal activities list --created-since 2026-11-01T00:00:00+08:00 --limit 50
+```
+
+支持 `leads`、`channels`、`contacts`、`activities`、`follow-up-tasks` 和 `projects`。普通列表默认只取 100 条，最多 500 条；全量导出默认每页 500 条并顺序翻页，减少请求次数。全量读取仅在显式使用 `--all` 或 `export` 时进行。商机、渠道、联系人、待跟进任务和项目支持 `--updated-since`；跟进记录支持 `--created-since`。时间必须包含时区；定期同步建议优先使用增量时间筛选。
+
+`export` 会顺序读取所有页并写入指定文件；CSV 按页流式写盘，避免大批数据占满内存，交互终端会显示读取进度。大数据集建议使用 CSV 和增量时间筛选。联系人私密字段、项目财务字段以及各数据范围仍遵循该 Key 的权限；CLI 不会扩大 Key 权限。
+
+## 命令帮助
+
+```bash
+yswj-internal --help
+yswj-internal leads list --help
+yswj-internal config --help
+```

yswj_internal_cli-0.1.0/README.md

@@ -0,0 +1,65 @@
+# 元生无界内部管理系统 CLI
+
+命令名：`yswj-internal`。CLI 通过系统开放 API 读取数据，权限仍由 API Key 和服务端账号权限控制。
+
+## 安装
+
+需要 Python 3.10 或更新版本。发布到 PyPI 后，建议用 `pipx` 安装隔离环境：
+
+```bash
+pipx install yswj-internal-cli
+```
+
+也可以在虚拟环境中安装：
+
+```bash
+python -m pip install yswj-internal-cli
+```
+
+在本仓库开发时，也可以从本地目录安装：
+
+```bash
+pipx install ./cli
+```
+
+给 AI 助手配置时，请先阅读 `src/yswj_internal_cli/AI_SETUP.md`。安装后的 Python 包中也包含 `yswj_internal_cli/AI_SETUP.md`。
+
+## 配置
+
+先在系统的“API Key 管理”页面申请 Key，再设置站点地址和密钥：
+
+```bash
+yswj-internal --profile prod config set-server http://39.107.72.34:6611 --activate
+yswj-internal --profile prod config set-key
+yswj-internal config show
+```
+
+`set-key` 会隐藏输入内容。若系统密钥库可用，Key 会保存到系统密钥库；否则保存到本地配置文件，并在 macOS/Linux 上限制为当前用户可读写。配置文件位于 `~/.config/yswj-internal/config.json`，可用 `YSWJ_INTERNAL_CONFIG` 覆盖。
+
+当前线上地址使用 HTTP。HTTP 不加密传输，请优先使用 HTTPS 地址；配置 HTTP 地址时 CLI 会显示提醒。
+
+脚本环境也可以通过 `YSWJ_INTERNAL_PROFILE`、`YSWJ_INTERNAL_BASE_URL` 和 `YSWJ_INTERNAL_API_KEY` 临时覆盖配置。不要把 Key 放在 URL、代码仓库或命令行参数中。
+
+## 数据命令
+
+列表默认输出表格；需要程序处理时选择 JSON，需要电子表格时选择 CSV。
+
+```bash
+yswj-internal leads list
+yswj-internal --profile prod leads list --all --updated-since 2026-11-01T00:00:00+08:00 --format json
+yswj-internal contacts get 201 --format json
+yswj-internal projects export --format csv --output projects.csv --updated-since 2026-11-01T00:00:00+08:00
+yswj-internal activities list --created-since 2026-11-01T00:00:00+08:00 --limit 50
+```
+
+支持 `leads`、`channels`、`contacts`、`activities`、`follow-up-tasks` 和 `projects`。普通列表默认只取 100 条，最多 500 条；全量导出默认每页 500 条并顺序翻页，减少请求次数。全量读取仅在显式使用 `--all` 或 `export` 时进行。商机、渠道、联系人、待跟进任务和项目支持 `--updated-since`；跟进记录支持 `--created-since`。时间必须包含时区；定期同步建议优先使用增量时间筛选。
+
+`export` 会顺序读取所有页并写入指定文件；CSV 按页流式写盘，避免大批数据占满内存，交互终端会显示读取进度。大数据集建议使用 CSV 和增量时间筛选。联系人私密字段、项目财务字段以及各数据范围仍遵循该 Key 的权限；CLI 不会扩大 Key 权限。
+
+## 命令帮助
+
+```bash
+yswj-internal --help
+yswj-internal leads list --help
+yswj-internal config --help
+```

yswj_internal_cli-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yswj-internal-cli"
+version = "0.1.0"
+description = "Command-line client for 元生无界内部管理系统"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = ["keyring>=25.7,<26"]
+
+[project.scripts]
+yswj-internal = "yswj_internal_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+yswj_internal_cli = ["AI_SETUP.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

yswj_internal_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yswj_internal_cli-0.1.0/src/yswj_internal_cli/AI_SETUP.md

@@ -0,0 +1,160 @@
+# AI 助手配置指南：元生无界内部管理系统 CLI
+
+本文供 AI 助手读取并按步骤配置 `yswj-internal-cli`。CLI 包名是 `yswj-internal-cli`，实际命令名是 `yswj-internal`。
+
+## 目标和边界
+
+- 配置 CLI 连接用户有权访问的元生无界内部管理系统，并做最小化连通性验证。
+- CLI 仅通过开放 API 读取数据。API Key 的数据范围和权限由系统服务端执行，CLI 不会增加账号权限。
+- 默认只验证配置和认证，不读取、导出或汇总业务数据。只有用户另行提出数据任务时，才读取所需数据。
+- API Key 是凭据。不得让用户把完整 Key 发在 AI 对话中；不得把 Key 放在命令参数、URL、代码、日志、仓库或普通输出中，也不得读取配置文件来查看 Key。
+
+## 需要用户完成的事项
+
+1. 若尚未安装，请在可访问系统的电脑上连接公司的 OpenVPN。线上系统地址为 `http://39.107.72.34:6611`。连接失败时先确认 VPN 状态和网络路由，再排查 CLI。
+2. 用户在系统的“API Key 管理”页面创建自己的 Key，选择实际需要的数据范围、只读权限和有效期。完整 Key 创建后只显示一次。
+3. 用户在 AI 能访问的本地终端中直接输入 Key。优先使用 CLI 的隐藏输入提示，不要在 AI 聊天窗口粘贴 Key。
+
+若用户使用的是测试或其他环境，使用用户明确给出的站点根地址。站点地址只包含协议、主机和可选端口；不要附加 `/api`、`/api/open/v1`、路径、查询参数或片段。
+
+## AI 配置流程
+
+### 1. 检查或安装 CLI
+
+先检查命令是否已安装：
+
+```bash
+yswj-internal --version
+```
+
+若命令不存在，在联网且允许访问 PyPI 的环境中，优先使用已有的隔离安装工具：
+
+```bash
+pipx install yswj-internal-cli
+```
+
+或：
+
+```bash
+uv tool install yswj-internal-cli
+```
+
+没有上述工具时，可在用户自己的 Python 环境中安装：
+
+```bash
+python3 -m pip install --user yswj-internal-cli
+```
+
+安装后重新检查 `yswj-internal --version`。若 shell 找不到命令，确认安装目录已加入 `PATH`，或重新打开终端。不要在未经用户同意时使用管理员权限安装。
+
+若 PyPI 尚未发布此包或当前环境无法访问 PyPI，不要安装同名的其他包；说明原因，并请用户提供可信的内部安装来源。
+
+### 2. 配置服务地址
+
+生产环境配置为 `prod` profile：
+
+```bash
+yswj-internal --profile prod config set-server http://39.107.72.34:6611 --activate
+```
+
+当前线上入口使用 HTTP，因此 CLI 会提示传输未加密。连接线上系统时先确认 OpenVPN 已连接，并只在受信任的 VPN 网络内使用。若用户提供了 HTTPS 站点地址，则按用户提供的 HTTPS 地址配置。
+
+### 3. 安全保存 API Key
+
+引导用户在本地终端运行：
+
+```bash
+yswj-internal --profile prod config set-key
+```
+
+CLI 会隐藏输入并要求确认。AI 不应代替用户收集或回显 Key。如果 AI 不能安全地把终端提示交给用户，应暂停在此步骤，请用户自己运行上面的命令；不要改用在聊天中发送密钥的方式。
+
+`config set-key --stdin` 仅供已有安全密钥管理器直接提供标准输入时使用。不要用会将 Key 写入 shell 历史、进程参数或日志的 `echo`、`printf`、命令替换或重定向来拼接输入。
+
+CLI 优先将 Key 保存到操作系统密钥库；密钥库不可用时，会将 Key 保存到权限受限的配置文件。默认位置为：
+
+- macOS/Linux：`~/.config/yswj-internal/config.json`（或 `$XDG_CONFIG_HOME/yswj-internal/config.json`）
+- Windows：`%APPDATA%\yswj-internal\config.json`
+
+可用 `YSWJ_INTERNAL_CONFIG` 指定其他配置文件路径。AI 可运行 `config path` 查看路径，但不得打开文件读取密钥。
+
+### 4. 检查配置
+
+```bash
+yswj-internal --profile prod config show
+```
+
+确认显示正确的服务地址，且 API Key 状态为“系统密钥库”“本地权限受限配置文件”或“环境变量已设置”。此命令不会显示完整 Key。不要通过 `cat`、`type`、编辑器或脚本读取配置文件。
+
+支持多个环境；其他环境使用单独的 profile，例如 `staging`：
+
+```bash
+yswj-internal --profile staging config set-server https://staging.example.com --activate
+yswj-internal --profile staging config set-key
+```
+
+不要把上面的示例测试地址当作真实地址。使用用户给出的环境地址。
+
+### 5. 最小化验证连接和权限
+
+CLI 没有独立的认证探测接口。只有在用户已知某个被 Key 授权的数据范围时，才使用对应模块验证。一次只取一条记录、只输出 ID：
+
+```bash
+yswj-internal --profile prod projects list --limit 1 --columns id
+```
+
+可选模块为 `leads`、`channels`、`contacts`、`activities`、`follow-up-tasks` 和 `projects`。将示例中的 `projects` 换成 Key 明确获准的模块。如果用户未说明授权模块，不要轮流探测所有模块；仅检查 `config show`，并说明需要一个已授权模块才能验证 API 权限。
+
+单条列表请求可能返回空结果；只要命令成功，仍可证明服务可达且 Key 有该模块的读取权限。不要自动加 `--all`、`export`，也不要输出其他业务字段作为连通性检查。
+
+## 高效读取规则
+
+- 普通 `list` 默认最多请求 100 条；明确需要完整集合时才使用 `--all` 或 `export`。
+- 查询一个资源时优先设置有时区的增量条件，减少数据库和网络负担。例如：
+
+  ```bash
+  yswj-internal --profile prod leads list --updated-since 2026-11-01T00:00:00+08:00 --limit 100
+  ```
+
+- 商机、渠道、联系人、待跟进任务和项目支持 `--updated-since`；跟进记录使用 `--created-since`。时间须为带时区的 ISO 8601 格式。
+- 大批量数据优先使用 CSV 导出和增量时间筛选。导出文件包含业务数据，应保存在用户指定的位置，不要未经请求上传、提交代码或发送给第三方。
+- JSON 适合后续程序处理；表格输出适合人工查看。只请求任务所需字段时可使用 `--columns`（仅适用于表格列表）。
+- 对 401、403 或网络错误进行诊断时，不要重试密钥猜测或扩大数据范围。
+
+## 常见错误处理
+
+| CLI 结果 | AI 应采取的动作 |
+| --- | --- |
+| 无法连接、超时、连接被拒绝 | 先确认 OpenVPN 已连接，再确认服务地址为站点根地址；必要时做一次重试。不要修改 API Key。 |
+| HTTP 401 | Key 无效、已撤销或过期。让用户在系统页面检查或重新签发，然后通过隐藏提示更新。不要要求用户把 Key 发到聊天中。 |
+| HTTP 403 | Key 未获准访问当前模块或字段。确认测试模块确实在 Key 范围内；请用户通过系统页面调整授权，不要尝试其他模块来枚举数据。 |
+| HTTP 404 | 确认地址没有多余路径，ID 和资源名称正确；API 路径由 CLI 自动添加。 |
+| HTTP 500 或非 JSON 响应 | 可能是服务端异常或站点地址不正确。保留状态码和不含密钥的错误内容，提示用户联系系统维护人员。 |
+| 配置未设置 | 先设置 profile 的站点地址，再通过隐藏提示保存 Key。 |
+
+诊断或汇报时不得复制 Authorization 请求头、完整 URL 中的凭据、完整 Key 或业务记录内容。
+
+## 参考命令
+
+```bash
+# 查看命令说明
+yswj-internal --help
+yswj-internal leads list --help
+
+# 仅列出一页，默认 100 条
+yswj-internal --profile prod leads list --limit 50
+
+# 读取一条记录
+yswj-internal --profile prod contacts get 201 --format json
+
+# 在用户要求导出时，按增量时间筛选并写入 CSV
+yswj-internal --profile prod projects export \
+  --updated-since 2026-11-01T00:00:00+08:00 \
+  --format csv --output projects.csv
+
+# 更换或删除当前 profile 的密钥
+yswj-internal --profile prod config set-key
+yswj-internal --profile prod config remove-key
+```
+
+脚本也可使用 `YSWJ_INTERNAL_PROFILE`、`YSWJ_INTERNAL_BASE_URL` 和 `YSWJ_INTERNAL_API_KEY` 覆盖配置。优先使用隐藏提示保存 Key；若确需环境变量，应通过秘密管理器注入，避免将其写入持久化 shell 配置或日志。

yswj_internal_cli-0.1.0/src/yswj_internal_cli/__init__.py

@@ -0,0 +1,3 @@
+"""CLI client for 元生无界内部管理系统."""
+
+__version__ = "0.1.0"

yswj_internal_cli-0.1.0/src/yswj_internal_cli/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+
+raise SystemExit(main())

yswj_internal_cli-0.1.0/src/yswj_internal_cli/cli.py

@@ -0,0 +1,301 @@
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from datetime import datetime
+from getpass import getpass
+
+from . import __version__
+from .client import APIClient, APIError
+from .config import ConfigError, ConfigStore, normalize_server_url
+from .output import pagination_summary, render_result, stream_csv_export, write_result
+
+
+RESOURCE_FILTERS = {
+    "leads": "updated_since",
+    "channels": "updated_since",
+    "contacts": "updated_since",
+    "activities": "created_since",
+    "follow-up-tasks": "updated_since",
+    "projects": "updated_since",
+}
+RESOURCES = tuple(RESOURCE_FILTERS)
+MAX_PAGE_SIZE = 500
+
+
+def _page_limit(value: str) -> int:
+    try:
+        parsed = int(value)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("每页条数必须是整数。") from exc
+    if not 1 <= parsed <= MAX_PAGE_SIZE:
+        raise argparse.ArgumentTypeError("每页条数范围为 1 到 500。")
+    return parsed
+
+
+def _offset(value: str) -> int:
+    try:
+        parsed = int(value)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("偏移量必须是整数。") from exc
+    if parsed < 0:
+        raise argparse.ArgumentTypeError("偏移量不能小于 0。")
+    return parsed
+
+
+def _record_id(value: str) -> int:
+    try:
+        parsed = int(value)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("记录 ID 必须是整数。") from exc
+    if parsed <= 0:
+        raise argparse.ArgumentTypeError("记录 ID 必须大于 0。")
+    return parsed
+
+
+def _aware_timestamp(value: str) -> str:
+    text = value.strip()
+    normalized = f"{text[:-1]}+00:00" if text.endswith(("Z", "z")) else text
+    try:
+        parsed = datetime.fromisoformat(normalized)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("时间请使用 ISO 8601 格式，例如 2026-11-01T00:00:00+08:00。") from exc
+    if parsed.tzinfo is None or parsed.utcoffset() is None:
+        raise argparse.ArgumentTypeError("时间必须包含时区，例如 +08:00 或 Z。")
+    return text
+
+
+def _columns(value: str) -> list[str]:
+    columns = [column.strip() for column in value.split(",") if column.strip()]
+    if not columns:
+        raise argparse.ArgumentTypeError("至少指定一个字段名。")
+    return columns
+
+
+def _add_list_options(parser: argparse.ArgumentParser, resource: str, *, export: bool = False) -> None:
+    parser.add_argument("--limit", type=_page_limit, default=None, help="每页条数（1–500；默认列表 100，全量导出 500）")
+    parser.add_argument("--offset", type=_offset, default=0, help="起始偏移量，默认 0")
+    filter_name = RESOURCE_FILTERS[resource]
+    option_name = "--updated-since" if filter_name == "updated_since" else "--created-since"
+    parser.add_argument(option_name, dest=filter_name, type=_aware_timestamp, help="只读取此时间及之后的变更，时间必须含时区")
+    if not export:
+        parser.add_argument("--all", action="store_true", help="自动读取后续分页；普通列表默认只读取一页")
+        parser.add_argument("--format", choices=("table", "json", "csv"), default="table", help="输出格式，默认 table")
+        parser.add_argument("--columns", type=_columns, help="表格字段，例如 id,name,updated_at")
+        parser.add_argument("--output", help="将结果写入文件")
+    else:
+        parser.add_argument("--format", choices=("json", "csv"), default="csv", help="导出格式，默认 csv")
+        parser.add_argument("--output", required=True, help="导出文件路径")
+
+
+def create_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="yswj-internal",
+        description="元生无界内部管理系统只读数据 CLI。",
+    )
+    parser.add_argument("--version", action="version", version=f"yswj-internal {__version__}")
+    parser.add_argument(
+        "--profile",
+        default=os.environ.get("YSWJ_INTERNAL_PROFILE"),
+        help="使用指定环境，例如 prod；默认使用当前环境，也可设置 YSWJ_INTERNAL_PROFILE",
+    )
+    parser.add_argument("--config", help="配置文件路径，也可通过 YSWJ_INTERNAL_CONFIG 指定")
+    root = parser.add_subparsers(dest="command", required=True)
+
+    config_parser = root.add_parser("config", help="配置服务地址、API Key 和环境")
+    config_commands = config_parser.add_subparsers(dest="config_action", required=True)
+
+    set_server = config_commands.add_parser("set-server", help="设置当前环境的系统站点地址")
+    set_server.add_argument("url", help="系统站点根地址，例如 http://39.107.72.34:6611")
+    set_server.add_argument("--activate", action="store_true", help="设置后将此环境设为当前环境")
+
+    set_key = config_commands.add_parser("set-key", help="安全保存 API Key")
+    set_key.add_argument("--stdin", action="store_true", help="从标准输入读取 Key，供密钥管理脚本调用")
+
+    use_profile = config_commands.add_parser("use", help="切换当前环境")
+    use_profile.add_argument("name", help="环境名称")
+    config_commands.add_parser("show", help="显示环境配置和 Key 保存状态（不会显示完整 Key）")
+    config_commands.add_parser("remove-key", help="删除当前环境保存的 API Key")
+    config_commands.add_parser("path", help="显示配置文件路径")
+
+    for resource in RESOURCES:
+        resource_parser = root.add_parser(resource, help=f"读取 {resource} 数据")
+        actions = resource_parser.add_subparsers(dest="action", required=True)
+
+        list_parser = actions.add_parser("list", help="读取列表")
+        _add_list_options(list_parser, resource)
+
+        get_parser = actions.add_parser("get", help="读取单条记录")
+        get_parser.add_argument("id", type=_record_id, help="记录 ID")
+        get_parser.add_argument("--format", choices=("json", "table"), default="json", help="输出格式，默认 json")
+        get_parser.add_argument("--output", help="将结果写入文件")
+
+        export_parser = actions.add_parser("export", help="读取所有分页并导出")
+        _add_list_options(export_parser, resource, export=True)
+
+    return parser
+
+
+def _selected_profile(store: ConfigStore, requested: str | None) -> str:
+    return store.active_profile(requested)
+
+
+def _config_command(args: argparse.Namespace, store: ConfigStore) -> int:
+    profile = _selected_profile(store, args.profile)
+
+    if args.config_action == "set-server":
+        server_url = normalize_server_url(args.url)
+        store.set_server(profile, server_url, activate=args.activate)
+        suffix = "，并设为当前环境" if args.activate else ""
+        print(f"已设置环境 {profile} 的服务地址：{server_url}{suffix}")
+        if server_url.startswith("http://"):
+            print("警告：HTTP 连接未加密，API Key 可能被网络中间人读取；生产环境建议使用 HTTPS。", file=sys.stderr)
+        return 0
+
+    if args.config_action == "set-key":
+        if args.stdin:
+            secret = sys.stdin.readline().rstrip("\r\n")
+        else:
+            if not sys.stdin.isatty():
+                raise ConfigError("非交互环境请使用 `config set-key --stdin`。")
+            secret = getpass("请输入 API Key：")
+            confirmation = getpass("请再次输入 API Key：")
+            if secret != confirmation:
+                raise ConfigError("两次输入的 API Key 不一致。")
+        storage = store.set_api_key(profile, secret)
+        if storage == "keyring":
+            print(f"已为环境 {profile} 保存 API Key 到系统密钥库。")
+        else:
+            print(f"系统密钥库不可用，API Key 已保存到权限受限的配置文件：{store.path}")
+        return 0
+
+    if args.config_action == "use":
+        store.set_active_profile(args.name)
+        print(f"当前环境已切换为 {args.name}。")
+        return 0
+
+    if args.config_action == "remove-key":
+        removed = store.remove_api_key(profile)
+        print(f"已删除环境 {profile} 的 API Key。" if removed else f"环境 {profile} 没有保存 API Key。")
+        return 0
+
+    if args.config_action == "path":
+        print(store.path)
+        return 0
+
+    if args.config_action == "show":
+        data = store.load()
+        names = [profile] if args.profile else sorted(data["profiles"])
+        if not names:
+            print(f"尚未配置环境。配置文件：{store.path}")
+            return 0
+        active = data.get("active_profile", "default")
+        for name in names:
+            item = store.profile(name)
+            marker = "（当前）" if name == active else ""
+            server_url = item.get("server_url", "未设置")
+            if os.environ.get("YSWJ_INTERNAL_API_KEY") and name == profile:
+                key_state = "环境变量已设置"
+            elif item.get("key_storage") == "keyring":
+                key_state = "系统密钥库"
+            elif item.get("api_key"):
+                key_state = "本地权限受限配置文件"
+            else:
+                key_state = "未设置"
+            print(f"{name}{marker}\n  服务地址：{server_url}\n  API Key：{key_state}")
+        print(f"配置文件：{store.path}")
+        return 0
+
+    return 0
+
+
+def _api_client(args: argparse.Namespace, store: ConfigStore) -> tuple[APIClient, str]:
+    profile = _selected_profile(store, args.profile)
+    item = store.profile(profile)
+    raw_url = os.environ.get("YSWJ_INTERNAL_BASE_URL") or item.get("server_url")
+    if not raw_url:
+        raise ConfigError(
+            f"环境 {profile} 未设置服务地址。运行 `yswj-internal --profile {profile} config set-server <系统站点根地址>`。"
+        )
+    server_url = normalize_server_url(raw_url)
+
+    api_key = os.environ.get("YSWJ_INTERNAL_API_KEY") or store.api_key(profile)
+    if not api_key:
+        raise ConfigError(
+            f"环境 {profile} 未设置 API Key。请先在系统申请 Key，再运行 `yswj-internal --profile {profile} config set-key`。"
+        )
+    return APIClient(server_url=server_url, api_key=api_key), profile
+
+
+def _query_params(args: argparse.Namespace, *, export: bool = False) -> dict:
+    if args.limit is not None:
+        limit = args.limit
+    elif export or getattr(args, "all", False):
+        limit = MAX_PAGE_SIZE
+    else:
+        limit = 100
+    params = {"limit": limit, "offset": args.offset}
+    resource = getattr(args, "resource", args.command)
+    filter_name = RESOURCE_FILTERS[resource]
+    filter_value = getattr(args, filter_name, None)
+    if filter_value:
+        params[filter_name] = filter_value
+    return params
+
+
+def _data_command(args: argparse.Namespace, store: ConfigStore) -> int:
+    client, profile = _api_client(args, store)
+    resource = getattr(args, "resource", args.command)
+
+    if args.action == "get":
+        payload = client.get_json(f"{resource}/{args.id}")
+        content = render_result(payload, args.format, resource, is_list=False)
+        write_result(content, args.output, args.format)
+        return 0
+
+    is_export = args.action == "export"
+    params = _query_params(args, export=is_export)
+    output_format = args.format
+    output_path = args.output
+    stream_csv = output_format == "csv" and (is_export or getattr(args, "all", False))
+
+    if getattr(args, "columns", None) and output_format != "table":
+        raise ConfigError("--columns 仅适用于 table 输出。")
+
+    if stream_csv:
+        count = stream_csv_export(client, resource, params, output_path)
+        if output_path:
+            print(f"已导出 {count} 条记录到 {output_path}（环境：{profile}）。", file=sys.stderr)
+        return 0
+
+    payload = client.list_records(resource, params, all_pages=is_export or getattr(args, "all", False))
+    columns = getattr(args, "columns", None)
+    content = render_result(payload, output_format, resource, is_list=True, columns=columns)
+    if output_format == "table":
+        summary = pagination_summary(payload, all_pages=is_export or getattr(args, "all", False))
+        content = f"{content.rstrip()}\n{summary}\n" if payload["data"] else f"{summary}\n"
+    write_result(content, output_path, output_format)
+    if output_format == "csv" and not is_export and not getattr(args, "all", False):
+        print(pagination_summary(payload, all_pages=False), file=sys.stderr)
+    if is_export:
+        print(f"已导出 {len(payload['data'])} 条记录到 {output_path}（环境：{profile}）。", file=sys.stderr)
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = create_parser()
+    args = parser.parse_args(argv)
+    store = ConfigStore(args.config)
+    try:
+        if args.command == "config":
+            return _config_command(args, store)
+        return _data_command(args, store)
+    except (APIError, ConfigError, OSError, ValueError) as exc:
+        print(f"错误：{exc}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())