@delilegal/deli-cli
得理开放平台命令行客户端，用于向 skill 提供法规检索、案例检索和 OCR 文件解析等开放平台工具能力。
本地开发与构建
cd deli-cli
pnpm install
pnpm run build
pnpm run build 会通过打包器生成 dist 产物。
构建后可直接运行：
node dist/cli.js --help
如需把 deli-cli 注册为本机全局命令：
pnpm link --global
deli-cli --help
本地发布前校验：
pnpm run verify
pnpm run verify 会同时验证普通构建和发布构建，并对发布包做 dry-run 检查。
生成发布构建产物：
pnpm run build:release
build:release 会重建 dist，确认不包含 source map 或类型声明文件，并检查 CLI 可启动；它只生成发布用 dist，不生成 tarball。
本地生成 tarball：
pnpm run pack:local
pack:local 会执行发布构建并生成最终 tarball，输出到 pack/ 目录；同时检查包内不包含源码、测试文件或 .map 文件。
发布与 npx 使用
pack/ 目录中的 .tgz 是最终发布包。例如：
pnpm run pack:local
pnpm publish pack/delilegal-deli-cli-1.0.0.tgz --access public
发布到 npm registry 后，用户可以通过 npx 临时下载并执行包内的 bin 入口：
npx -y @delilegal/deli-cli@latest --help
也可以用更显式的 npm exec 写法：
npm exec --package @delilegal/deli-cli@latest -- deli-cli --help
npx/npm exec 读取 package.json 中的 bin.deli-cli，实际执行的是发布包里的 dist/cli.js。
配置
API Key 获取地址：https://open.delilegal.com/personal/keys
写入本机配置：
deli-cli init --apikey "<你的 API Key>"
API Key 会以加密形式保存到本机配置文件。若只想在当前 shell 环境注入加密后的 API Key，并跳过本机配置写入：
eval "$(deli-cli init --apikey "<你的 API Key>" --print-env --no-write)"
也可以把输出的 DELI_CLI_ENCRYPTED_APIKEY 写入特定 bash 环境；该环境变量优先于本机配置。
如需指向自定义测试环境域名，可同时指定 Open Platform API baseUrl：
deli-cli init --apikey "<你的测试环境 API Key>" --base-url "https://platform.ailawyers.cn/api/v1"
也可以仅在当前 shell 中设置 API Key 和 Base URL，不写入配置文件：
eval "$(deli-cli init --apikey "<你的测试环境 API Key>" --base-url "https://platform.ailawyers.cn/api/v1" --print-env --no-write)"
此时会输出并设置 DELI_CLI_ENCRYPTED_APIKEY 和 DELI_CLI_BASE_URL。两者都优先于配置文件；Base URL 的完整优先级为：环境变量、配置文件、内置默认值。
配置会保存到：
~/.deli/cli/config.json
检查本机环境和 API Key 是否可用：
deli-cli check
使用方式
业务命令由远端 skill 实时提供。先用 cmds 发现某个 skill 当前可用的命令，并创建一个 run_... 调用入口：
deli-cli cmds [email protected]
输出会包含本次可复制的 run id、用法和命令参数。
usage: deli-cli run_a1b2c3d4e5f6 COMMAND [options]
commands:
The following skill commands are available.
COMMAND
case-list 案例检索
usage: deli-cli run_a1b2c3d4e5f6 case-list --arg <value>
required options:
--query <string> 检索关键词
optional options:
--page-no <integer> 页码
实际命令名、参数名和说明以 cmds 当前输出为准。随后按 usage 行的命令形态，结合 options 传参：
deli-cli run_a1b2c3d4e5f6 case-list --query "劳动合同"
如果远端 skill 暴露 skill-version 工具，cmds 会自动检查当前版本和最新版本。只有最新版本高于当前版本时，输出开头才会出现 notice 提示；远端返回技能包 URL 时会显示 download 行，否则只显示得理法律 AI 开放平台下载入口。
查询类参数也可以用位置参数传入：
deli-cli run_a1b2c3d4e5f6 law-list "员工连续旷工三天 公司能否解除劳动合同"
cmds 只支持下列可选参数：
--refresh：跳过本地缓存，重新从远端获取最新命令说明；不加时会优先使用本地已发现过的命令说明，但仍会生成新的run_...入口。--json：输出结构化 JSON，适合脚本或上层 agent 继续处理。
run_... <command> 的输出和缓存可选参数：
- 默认输出：普通 skill 命令默认以 Markdown 输出。远端返回 Markdown 或文本时会直接输出；检索类响应包含
data数组时，会按“结果元信息 → 单条元信息 → highlights → 正文”的顺序展示。 --json：输出远端原始 JSON 响应，适合脚本或上层 agent 继续处理。--md/-m：显式使用默认 Markdown 输出；这是run_...的输出选项，不是cmds的参数。--refresh：跳过本地工具缓存，重新获取该命令的远端 schema 后再调用。--verbose/-v：把诊断信息写到 stderr，不污染 stdout。
OCR 文件解析
当某个 skill 同时提供文件上传和文件解析能力时，cmds 会聚合出一个 ocr-parse 命令，不需要手工串联底层上传接口：
deli-cli cmds [email protected]
deli-cli run_a1b2c3d4e5f6 ocr-parse --file ./scan.pdf
默认会把解析后的 Markdown 输出到 stdout。如需落盘、保留原始响应或指定解析参数，按需追加下列可选参数。
OCR 支持常见 PDF、Word、Excel、OFD、图片和文本类文件。ocr-parse 的可选参数：
--output-dir <dir>：把 Markdown 写入指定目录；不加时默认输出到 stdout。--save-response：在落盘时同时保留远端原始响应。--json：输出远端原始响应。--lang <lang>、--task-type <type>：只会在远端 schema 暴露时传入。
输出格式
普通 skill 命令默认输出 Markdown：
deli-cli run_a1b2c3d4e5f6 law-list "劳动合同"
如需结构化 JSON，请显式追加 --json：
deli-cli run_a1b2c3d4e5f6 law-list "劳动合同" --json
开发结构
src/
├── cli.ts # 根路由和命令分发
├── config/ # manifest、用户配置、文件路径
├── commands/ # init/check/docs/skill 等命令入口
├── mcp/ # MCP client、协议解析、缓存、run 和动态参数构建
├── services/ # HTTP 工具和 OCR 本地封装
└── utils/ # 参数解析、校验、格式化、错误处理