precis-cli 0.1.4__tar.gz → 0.1.5__tar.gz

precis_cli-0.1.5/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: precis-cli
+Version: 0.1.5
+Summary: Precis - 可配置数据校验工具 CLI（校验 CSV/Excel/JSON 数据质量）
+Author: Precis Team
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/AirSaiga/Precis
+Project-URL: Repository, https://github.com/AirSaiga/Precis
+Project-URL: Bug Tracker, https://github.com/AirSaiga/Precis/issues
+Project-URL: Discussions, https://github.com/AirSaiga/Precis/discussions
+Keywords: data-quality,data-validation,csv,excel,json,yaml,cli,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: <3.14,>=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: pandas<3.0,>=2.2.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: xlrd>=2.0.1
+Requires-Dist: SQLAlchemy>=2.0.48
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: ruamel.yaml>=0.19.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: readchar>=4.2.0
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: simpleeval>=1.0.0
+Requires-Dist: filelock>=3.12.0
+Provides-Extra: api
+Requires-Dist: fastapi!=0.136.3,>=0.135.0; extra == "api"
+Requires-Dist: uvicorn>=0.42.0; extra == "api"
+Requires-Dist: email-validator>=2.3.0; extra == "api"
+Requires-Dist: uritemplate>=4.2.0; extra == "api"
+Requires-Dist: python-multipart>=0.0.26; extra == "api"
+Requires-Dist: cryptography>=44.0.0; extra == "api"
+Provides-Extra: ai
+Requires-Dist: openai>=1.6.0; extra == "ai"
+Requires-Dist: aiohttp>=3.9.0; extra == "ai"
+Requires-Dist: psutil>=5.9.6; extra == "ai"
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.30.0; extra == "mcp"
+Provides-Extra: completion
+Requires-Dist: pyreadline3>=0.1.8; sys_platform == "win32" and extra == "completion"
+Provides-Extra: full
+Requires-Dist: precis-cli[ai,api,completion,mcp]; extra == "full"
+Provides-Extra: dev
+Requires-Dist: precis-cli[ai,api,mcp]; extra == "dev"
+Requires-Dist: debugpy>=1.8.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Requires-Dist: pytest>=9.0.3; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: httpx>=0.27.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+
+# Precis CLI
+
+> Local-first data validation engine — define schemas and constraints in YAML, validate CSV / Excel / JSON with a single command.
+> 本地优先的数据校验引擎：用 YAML 定义表结构与约束规则，一条命令校验 CSV / Excel / JSON。
+
+**Alpha** — 核心功能稳定，配置格式有版本保障（V2）。
+
+## 安装
+
+```bash
+pip install precis-cli          # 需要 Python >= 3.12
+
+# 或免安装直接运行（需要 uv）
+uvx --from precis-cli precis --version
+```
+
+## 快速上手
+
+```bash
+# 1. 从数据文件推断 schema 草稿
+precis infer-schema orders.csv > schemas/orders.schema.yaml
+
+# 2. 在项目清单 project.precis.yaml 中登记 schema 与约束文件
+#    （格式见下方示例）
+
+# 3. 执行校验
+precis validate --manifest project.precis.yaml --format json
+```
+
+退出码契约（CI / AI agent 友好）：
+
+| 退出码 | 含义 |
+|--------|------|
+| `0` | 校验通过 |
+| `1` | 校验完成，发现数据违规（详情见 JSON 输出的 `errors`） |
+| `2` | 工具自身错误（参数错误、文件不存在、异常崩溃） |
+
+## 配置示例（V2 YAML）
+
+`project.precis.yaml`：
+
+```yaml
+version: 2
+project:
+  id: my-project
+  name: 订单数据校验
+schemas:
+  - id: orders
+    path: schemas/orders.schema.yaml
+constraints:
+  - id: orders_amount_range
+    path: constraints/orders_amount_range.constraint.yaml
+```
+
+`constraints/orders_amount_range.constraint.yaml`：
+
+```yaml
+version: 2
+id: orders_amount_range
+type: Range
+enabled: true
+refs:
+  table_id: orders
+  column_id: amount
+params:
+  min: 0
+  max: 1000000
+  boundary_mode: inclusive
+```
+
+## 10 种约束类型
+
+`NotNull` 非空 · `Unique` 唯一 · `AllowedValues` 枚举 · `Range` 数值区间 ·
+`ForeignKey` 跨表引用 · `Conditional` 条件约束 · `Scripted` 脚本表达式 ·
+`Charset` 字符集 · `DateLogic` 日期逻辑 · `Composite` 组合约束
+
+数据类型：`string` / `integer` / `float` / `decimal` / `boolean` / `date`。
+大文件（>500MB）自动分块加载。
+
+## 与 AI Agent 集成
+
+`--format json` 输出为机器可读契约（含行级错误定位与约束来源文件回溯），
+可直接被 AI 编程助手消费：
+
+- **MCP server**：`pip install "precis-cli[mcp]"` 后运行 `precis-mcp`（stdio），
+  提供 `validate_data` / `infer_schema` / `check_config` / `describe_constraints` 四个工具
+- **Kimi Code 插件**：`/plugins install https://github.com/AirSaiga/Precis`
+- **CLI 自带 AI 命令**（自然语言生成/修改校验配置，独立于宿主 agent）：
+  `pip install "precis-cli[ai]"`，然后 `precis ai chat` 或 `precis ai ask "..."`
+
+## 链接
+
+- 仓库与文档：<https://github.com/AirSaiga/Precis>
+- 问题反馈：<https://github.com/AirSaiga/Precis/issues>
+- 桌面 GUI 版本（画布式可视化编辑）见仓库 releases
+
+License: Apache-2.0

precis_cli-0.1.5/PYPI_README.md

@@ -0,0 +1,97 @@
+# Precis CLI
+
+> Local-first data validation engine — define schemas and constraints in YAML, validate CSV / Excel / JSON with a single command.
+> 本地优先的数据校验引擎：用 YAML 定义表结构与约束规则，一条命令校验 CSV / Excel / JSON。
+
+**Alpha** — 核心功能稳定，配置格式有版本保障（V2）。
+
+## 安装
+
+```bash
+pip install precis-cli          # 需要 Python >= 3.12
+
+# 或免安装直接运行（需要 uv）
+uvx --from precis-cli precis --version
+```
+
+## 快速上手
+
+```bash
+# 1. 从数据文件推断 schema 草稿
+precis infer-schema orders.csv > schemas/orders.schema.yaml
+
+# 2. 在项目清单 project.precis.yaml 中登记 schema 与约束文件
+#    （格式见下方示例）
+
+# 3. 执行校验
+precis validate --manifest project.precis.yaml --format json
+```
+
+退出码契约（CI / AI agent 友好）：
+
+| 退出码 | 含义 |
+|--------|------|
+| `0` | 校验通过 |
+| `1` | 校验完成，发现数据违规（详情见 JSON 输出的 `errors`） |
+| `2` | 工具自身错误（参数错误、文件不存在、异常崩溃） |
+
+## 配置示例（V2 YAML）
+
+`project.precis.yaml`：
+
+```yaml
+version: 2
+project:
+  id: my-project
+  name: 订单数据校验
+schemas:
+  - id: orders
+    path: schemas/orders.schema.yaml
+constraints:
+  - id: orders_amount_range
+    path: constraints/orders_amount_range.constraint.yaml
+```
+
+`constraints/orders_amount_range.constraint.yaml`：
+
+```yaml
+version: 2
+id: orders_amount_range
+type: Range
+enabled: true
+refs:
+  table_id: orders
+  column_id: amount
+params:
+  min: 0
+  max: 1000000
+  boundary_mode: inclusive
+```
+
+## 10 种约束类型
+
+`NotNull` 非空 · `Unique` 唯一 · `AllowedValues` 枚举 · `Range` 数值区间 ·
+`ForeignKey` 跨表引用 · `Conditional` 条件约束 · `Scripted` 脚本表达式 ·
+`Charset` 字符集 · `DateLogic` 日期逻辑 · `Composite` 组合约束
+
+数据类型：`string` / `integer` / `float` / `decimal` / `boolean` / `date`。
+大文件（>500MB）自动分块加载。
+
+## 与 AI Agent 集成
+
+`--format json` 输出为机器可读契约（含行级错误定位与约束来源文件回溯），
+可直接被 AI 编程助手消费：
+
+- **MCP server**：`pip install "precis-cli[mcp]"` 后运行 `precis-mcp`（stdio），
+  提供 `validate_data` / `infer_schema` / `check_config` / `describe_constraints` 四个工具
+- **Kimi Code 插件**：`/plugins install https://github.com/AirSaiga/Precis`
+- **CLI 自带 AI 命令**（自然语言生成/修改校验配置，独立于宿主 agent）：
+  `pip install "precis-cli[ai]"`，然后 `precis ai chat` 或 `precis ai ask "..."`
+
+## 链接
+
+- 仓库与文档：<https://github.com/AirSaiga/Precis>
+- 问题反馈：<https://github.com/AirSaiga/Precis/issues>
+- 桌面 GUI 版本（画布式可视化编辑）见仓库 releases
+
+License: Apache-2.0

{precis_cli-0.1.4 → precis_cli-0.1.5}/app/cli/shell/commands/ai/__init__.py

@@ -23,7 +23,8 @@
 - 支持直接通过自然语言执行 AI 指令
 
 架构设计:
-- AICommand 作为聚合命令，管理 chat、status、switch、delete、setup 等子命令
+- AICommand 作为聚合命令，管理 chat、status、switch、delete、provider 等子命令
+- 裸装（无 [ai] extra）时入口门控：help 标注缺依赖，execute 直接给安装指引
 - 无参数时显示交互式菜单（支持方向键导航）
 - 第一个参数如果不是子命令，则将其视为直接询问的消息
 - 使用 execute_ai_chat 统一执行 AI 对话
@@ -52,6 +53,31 @@ from app.cli.shell.config_storage import get_cli_config
 from app.cli.shell.formatter import Formatter
 from app.cli.shell.interactive_menu import InteractiveMenu
 
+# [ai] 扩展依赖探测结果缓存（失败导入不会被 import 机制负缓存，help 每次渲染
+# 都会读 description，缓存避免重复文件系统扫描；测试可经 monkeypatch 覆盖）
+_AI_DEPS_AVAILABLE: bool | None = None
+
+
+def ai_dependencies_available() -> bool:
+    """探测 AI 功能的可选依赖是否已安装（裸装 precis-cli 不含 [ai] extra）。
+
+    openai 是核心门控导入（OpenAI 兼容 provider 全系走它）；aiohttp/psutil
+    随同一 extra 安装，openai 可导入即视为 extra 已装。
+    """
+    global _AI_DEPS_AVAILABLE  # noqa: PLW0603
+    if _AI_DEPS_AVAILABLE is None:
+        try:
+            import openai  # noqa: F401
+        except ImportError:
+            _AI_DEPS_AVAILABLE = False
+        else:
+            _AI_DEPS_AVAILABLE = True
+    return _AI_DEPS_AVAILABLE
+
+
+# 依赖缺失时 ai 入口的统一提示（help 标注与 execute 门控共用同一安装指引）
+_AI_INSTALL_HINT = 'pip install "precis-cli[ai]"（源码安装用 pip install -e ".[ai]"）'
+
 
 class AICommand(Command):
     """AI 助手命令。
@@ -82,6 +108,10 @@ class AICommand(Command):
 
     @property
     def description(self) -> str:
+        # help 列表动态标注：裸装（无 [ai] extra）不伪装成可用功能，
+        # 让用户在进菜单之前就知道差什么、怎么补
+        if not ai_dependencies_available():
+            return f"AI 助手 - 未安装依赖（{_AI_INSTALL_HINT}）"
         return "AI 助手 - 使用自然语言修改项目配置"
 
     @property
@@ -139,6 +169,14 @@ class AICommand(Command):
         Returns:
             子命令执行结果或 AI 对话结果
         """
+        if not ai_dependencies_available():
+            # 门控在菜单/子命令分发之前：缺依赖时不进交互菜单（菜单里每个
+            # 选项最终都会失败），直接给安装指引；provider 预配置不受影响
+            # （顶层 provider 命令不依赖 LLM 库）
+            return CommandResult.error(
+                f"AI 功能需要可选依赖，当前未安装。安装命令: {_AI_INSTALL_HINT}\n"
+                "如仅需预配置 AI Provider，可先运行 'provider add'（无需依赖）。"
+            )
         if not args:
             # 无参数时显示交互式菜单
             return self._show_interactive_menu(context)

{precis_cli-0.1.4 → precis_cli-0.1.5}/app/cli/shell/commands/ai/chat.py

@@ -100,7 +100,7 @@ class AIChatCommand(Command):
         # 检查 AI 配置（使用 CLI 配置）
         provider = self._cli_config.get_active_provider()
         if not provider:
-            return CommandResult.error("没有可用的 LLM Provider 配置\n请先运行 'setup' 命令配置 API Key")
+            return CommandResult.error("没有可用的 LLM Provider 配置\n请先运行 'provider add' 命令配置 API Key")
 
         # 解析命令行参数（--stream/--no-stream 已随 execute_ai_chat 的死参数一并移除）
         agent_mode = True  # 默认启用 Agent 深度模式

{precis_cli-0.1.4 → precis_cli-0.1.5}/app/cli/shell/commands/ai/executor.py

@@ -80,7 +80,7 @@ def execute_ai_chat(
     # 获取用于显示的 Provider 配置（脱敏，用于日志或展示）
     provider_config_display = _get_provider_display()
     if not provider_config_display:
-        return CommandResult.error("没有可用的 LLM Provider 配置，请先运行 'setup' 命令配置 AI Provider")
+        return CommandResult.error("没有可用的 LLM Provider 配置，请先运行 'provider add' 命令配置 AI Provider")
 
     # 获取包含完整 API Key 的 Provider 配置（用于实际调用 API）
     provider_config = _get_provider_with_key()

{precis_cli-0.1.4 → precis_cli-0.1.5}/app/cli/shell/commands/ai/switch.py

@@ -87,7 +87,7 @@ class AISwitchCommand(Command):
         providers = self._cli_config.list_providers()
 
         if not providers:
-            return CommandResult.error("没有已配置的 Provider\n请先使用 'setup' 命令进行配置")
+            return CommandResult.error("没有已配置的 Provider\n请先使用 'provider add' 命令进行配置")
 
         if not args:
             # 无参数时进入交互式选择（支持方向键）

{precis_cli-0.1.4 → precis_cli-0.1.5}/app/cli/shell/commands/help.py

@@ -36,6 +36,7 @@
 """
 
 from rich.console import Console
+from rich.markup import escape as markup_escape
 from rich.table import Table
 
 from app.cli.shell.commands.base import Command, CommandResult, ProjectContext
@@ -82,11 +83,14 @@ class HelpCommand(Command):
         for cmd in commands:
             # 聚合命令（如 config/project/ai）在描述后追加子命令提示，
             # 让用户无需先输入命令即可发现 inspect 等子命令的存在。
+            # description 是动态文案，须 markup 转义——Table 单元格会解析
+            # markup，方括号（如安装指引 precis-cli[ai]）不转义会被当标签吞掉；
+            # [dim] 包裹是我们自己的有意标记，不参与转义
             subs = cmd.list_subcommands()
             if subs:
-                desc = f"{cmd.description}  [dim](子命令: {', '.join(subs)})[/dim]"
+                desc = f"{markup_escape(cmd.description)}  [dim](子命令: {', '.join(subs)})[/dim]"
             else:
-                desc = cmd.description
+                desc = markup_escape(cmd.description)
             table.add_row(cmd.name, desc)
 
         _console.print(table)

{precis_cli-0.1.4 → precis_cli-0.1.5}/app/cli/shell/formatter.py

@@ -33,6 +33,7 @@ import sys
 from typing import Any
 
 from rich.console import Console
+from rich.markup import escape as markup_escape
 from rich.panel import Panel
 from rich.progress import Progress, SpinnerColumn, TaskID, TextColumn
 from rich.table import Table
@@ -190,19 +191,21 @@ class Formatter:
 
     @staticmethod
     def print_error(message: str) -> None:
-        _stderr_console.print(f"[bold red]错误:[/bold red] {message}")
+        # 动态消息必须 markup 转义：消息里的方括号（如安装指引
+        # precis-cli[ai]、允许值集合 ['a','b']）否则会被 rich 当样式标签吞掉
+        _stderr_console.print(f"[bold red]错误:[/bold red] {markup_escape(message)}")
 
     @staticmethod
     def print_warning(message: str) -> None:
-        _console.print(f"[yellow]警告:[/yellow] {message}")
+        _console.print(f"[yellow]警告:[/yellow] {markup_escape(message)}")
 
     @staticmethod
     def print_success(message: str) -> None:
-        _console.print(f"[green]{message}[/green]")
+        _console.print(f"[green]{markup_escape(message)}[/green]")
 
     @staticmethod
     def print_info(message: str) -> None:
-        _console.print(f"[cyan]{message}[/cyan]")
+        _console.print(f"[cyan]{markup_escape(message)}[/cyan]")
 
     @staticmethod
     def print_table(headers: list[str], rows: list[list[Any]]) -> None:

{precis_cli-0.1.4 → precis_cli-0.1.5}/app/shared/services/llm/providers/openai.py

@@ -89,7 +89,7 @@ class OpenAIProvider(BaseProvider):
     def __init__(self, config: AIProvider) -> None:
         super().__init__(config)
         if AsyncOpenAI is None:
-            raise ImportError("openai 未安装，请运行 pip install openai")
+            raise ImportError('openai 未安装，请运行 pip install "precis-cli[ai]"')
         self.client = AsyncOpenAI(
             base_url=config.base_url,
             api_key=config.api_key or "",

precis_cli-0.1.5/precis_cli.egg-info/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: precis-cli
+Version: 0.1.5
+Summary: Precis - 可配置数据校验工具 CLI（校验 CSV/Excel/JSON 数据质量）
+Author: Precis Team
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/AirSaiga/Precis
+Project-URL: Repository, https://github.com/AirSaiga/Precis
+Project-URL: Bug Tracker, https://github.com/AirSaiga/Precis/issues
+Project-URL: Discussions, https://github.com/AirSaiga/Precis/discussions
+Keywords: data-quality,data-validation,csv,excel,json,yaml,cli,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: <3.14,>=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: pandas<3.0,>=2.2.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: xlrd>=2.0.1
+Requires-Dist: SQLAlchemy>=2.0.48
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: ruamel.yaml>=0.19.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: readchar>=4.2.0
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: simpleeval>=1.0.0
+Requires-Dist: filelock>=3.12.0
+Provides-Extra: api
+Requires-Dist: fastapi!=0.136.3,>=0.135.0; extra == "api"
+Requires-Dist: uvicorn>=0.42.0; extra == "api"
+Requires-Dist: email-validator>=2.3.0; extra == "api"
+Requires-Dist: uritemplate>=4.2.0; extra == "api"
+Requires-Dist: python-multipart>=0.0.26; extra == "api"
+Requires-Dist: cryptography>=44.0.0; extra == "api"
+Provides-Extra: ai
+Requires-Dist: openai>=1.6.0; extra == "ai"
+Requires-Dist: aiohttp>=3.9.0; extra == "ai"
+Requires-Dist: psutil>=5.9.6; extra == "ai"
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.30.0; extra == "mcp"
+Provides-Extra: completion
+Requires-Dist: pyreadline3>=0.1.8; sys_platform == "win32" and extra == "completion"
+Provides-Extra: full
+Requires-Dist: precis-cli[ai,api,completion,mcp]; extra == "full"
+Provides-Extra: dev
+Requires-Dist: precis-cli[ai,api,mcp]; extra == "dev"
+Requires-Dist: debugpy>=1.8.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Requires-Dist: pytest>=9.0.3; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: httpx>=0.27.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+
+# Precis CLI
+
+> Local-first data validation engine — define schemas and constraints in YAML, validate CSV / Excel / JSON with a single command.
+> 本地优先的数据校验引擎：用 YAML 定义表结构与约束规则，一条命令校验 CSV / Excel / JSON。
+
+**Alpha** — 核心功能稳定，配置格式有版本保障（V2）。
+
+## 安装
+
+```bash
+pip install precis-cli          # 需要 Python >= 3.12
+
+# 或免安装直接运行（需要 uv）
+uvx --from precis-cli precis --version
+```
+
+## 快速上手
+
+```bash
+# 1. 从数据文件推断 schema 草稿
+precis infer-schema orders.csv > schemas/orders.schema.yaml
+
+# 2. 在项目清单 project.precis.yaml 中登记 schema 与约束文件
+#    （格式见下方示例）
+
+# 3. 执行校验
+precis validate --manifest project.precis.yaml --format json
+```
+
+退出码契约（CI / AI agent 友好）：
+
+| 退出码 | 含义 |
+|--------|------|
+| `0` | 校验通过 |
+| `1` | 校验完成，发现数据违规（详情见 JSON 输出的 `errors`） |
+| `2` | 工具自身错误（参数错误、文件不存在、异常崩溃） |
+
+## 配置示例（V2 YAML）
+
+`project.precis.yaml`：
+
+```yaml
+version: 2
+project:
+  id: my-project
+  name: 订单数据校验
+schemas:
+  - id: orders
+    path: schemas/orders.schema.yaml
+constraints:
+  - id: orders_amount_range
+    path: constraints/orders_amount_range.constraint.yaml
+```
+
+`constraints/orders_amount_range.constraint.yaml`：
+
+```yaml
+version: 2
+id: orders_amount_range
+type: Range
+enabled: true
+refs:
+  table_id: orders
+  column_id: amount
+params:
+  min: 0
+  max: 1000000
+  boundary_mode: inclusive
+```
+
+## 10 种约束类型
+
+`NotNull` 非空 · `Unique` 唯一 · `AllowedValues` 枚举 · `Range` 数值区间 ·
+`ForeignKey` 跨表引用 · `Conditional` 条件约束 · `Scripted` 脚本表达式 ·
+`Charset` 字符集 · `DateLogic` 日期逻辑 · `Composite` 组合约束
+
+数据类型：`string` / `integer` / `float` / `decimal` / `boolean` / `date`。
+大文件（>500MB）自动分块加载。
+
+## 与 AI Agent 集成
+
+`--format json` 输出为机器可读契约（含行级错误定位与约束来源文件回溯），
+可直接被 AI 编程助手消费：
+
+- **MCP server**：`pip install "precis-cli[mcp]"` 后运行 `precis-mcp`（stdio），
+  提供 `validate_data` / `infer_schema` / `check_config` / `describe_constraints` 四个工具
+- **Kimi Code 插件**：`/plugins install https://github.com/AirSaiga/Precis`
+- **CLI 自带 AI 命令**（自然语言生成/修改校验配置，独立于宿主 agent）：
+  `pip install "precis-cli[ai]"`，然后 `precis ai chat` 或 `precis ai ask "..."`
+
+## 链接
+
+- 仓库与文档：<https://github.com/AirSaiga/Precis>
+- 问题反馈：<https://github.com/AirSaiga/Precis/issues>
+- 桌面 GUI 版本（画布式可视化编辑）见仓库 releases
+
+License: Apache-2.0

{precis_cli-0.1.4 → precis_cli-0.1.5}/precis_cli.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 MANIFEST.in
+PYPI_README.md
 README.md
 pyproject.toml
 app/__init__.py

{precis_cli-0.1.4 → precis_cli-0.1.5}/pyproject.toml

@@ -6,9 +6,12 @@ build-backend = "setuptools.build_meta"
 # 分发名 precis-cli：PyPI 上 "precis" 已被 2014 年的第三方包占用；
 # 命令名保持 `precis`（见 [project.scripts]），仅分发名带 -cli 后缀
 name = "precis-cli"
-version = "0.1.4"
+version = "0.1.5"
 description = "Precis - 可配置数据校验工具 CLI（校验 CSV/Excel/JSON 数据质量）"
-readme = "README.md"
+# PyPI 页面描述使用面向用户的专用 README（安装 + 快速上手）；
+# backend/README.md 保持开发者向（架构与开发命令），两者分开维护
+readme = "PYPI_README.md"
+keywords = ["data-quality", "data-validation", "csv", "excel", "json", "yaml", "cli", "mcp"]
 license = {text = "Apache-2.0"}
 requires-python = ">=3.12,<3.14"
 authors = [