@mafdet/cli 0.4.12 → 1.4.18

package/CHANGELOG.md

@@ -6,6 +6,14 @@ The version is the contract for the JSON output shapes and the exit codes.
 Being 0.x, semver still permits a break in a minor bump; the intent is not to
 use that latitude, and the promise becomes binding at 1.0.0.
 
+## 0.4.13 - 2026-08-17
+
+- Documentation only; no code change. Both READMEs now open by saying what
+  Mafdet AI is — an OpenAI-compatible gateway, its base URL, its endpoints and
+  its providers — because the npm page was addressed to readers who already
+  knew, and most do not. The model count is dated and points at
+  `models.json` rather than standing alone, so it cannot quietly go stale.
+
 ## 0.4.12 - 2026-08-12
 
 - Validate usage-event pages, model identities, non-stream Chat responses and

package/README.md

@@ -3,12 +3,25 @@
 The official Mafdet AI command line: model calls, account queries, and a
 permissioned local agent.
 
-> **0.4.12.** 中文版见 [README.zh-CN.md](./README.zh-CN.md). The CLI never
+> **0.4.13.** 中文版见 [README.zh-CN.md](./README.zh-CN.md). The CLI never
 > advertises a command it cannot serve, so `mafdet help` always lists exactly
 > what works.
 >
 > macOS and Windows are not yet verified. On Windows the command timeout uses `taskkill /T`, which is written but has never been run on a real Windows machine - so whether every grandchild process is reached there is unverified rather than fixed.
 
+## What Mafdet AI is
+
+Mafdet AI is an OpenAI-compatible AI gateway: one API key and one base URL reach
+models from several providers, billed by usage. Any tool or SDK that speaks the
+OpenAI API works by pointing its base URL and key at Mafdet AI.
+
+- Base URL: `https://api.mafdet.ai/v1`
+- Endpoints: `/chat/completions`, `/embeddings`, `/audio/speech`
+- Providers: Google (Gemini), Kimi (Moonshot), Qwen, DeepSeek
+- 30 models as of August 2026. The catalogue changes, so the authoritative list
+  with current prices is [`models.json`](https://docs.mafdet.ai/models.json)
+- Docs: <https://docs.mafdet.ai>
+
 ## Requirements
 
 Node.js 20 or newer, and a Mafdet API key.
@@ -23,8 +36,8 @@ Or build it from this repository:
 
 ```bash
 pnpm --filter @mafdet/cli build
-cd packages/cli && npm pack          # -> mafdet-cli-0.4.12.tgz
-npm install -g ./mafdet-cli-0.4.12.tgz
+cd packages/cli && npm pack          # -> mafdet-cli-0.4.13.tgz
+npm install -g ./mafdet-cli-0.4.13.tgz
 ```
 
 ## The interactive session

package/README.zh-CN.md

@@ -2,7 +2,20 @@
 
 Mafdet AI 官方命令行：模型调用、账户查询，以及一个受权限约束的本地 Agent。
 
-> **0.4.12。** 英文版见 [README.md](./README.md)。
+> **0.4.13。** 英文版见 [README.md](./README.md)。
+
+## Mafdet AI 是什么
+
+Mafdet AI 是一个 OpenAI 兼容的 AI 网关：一把 API Key、一个 base URL，即可调用多家
+提供方的模型，按量计费。任何支持 OpenAI API 格式的工具或 SDK，只要把 base URL 和
+Key 换成 Mafdet AI 的就能用。
+
+- Base URL：`https://api.mafdet.ai/v1`
+- 端点：`/chat/completions`、`/embeddings`、`/audio/speech`
+- 提供方：Google（Gemini）、Kimi（月之暗面）、Qwen、DeepSeek
+- 截至 2026 年 8 月共 30 个模型。目录会变动，**以带实时价格的
+  [`models.json`](https://docs.mafdet.ai/models.json) 为准**
+- 文档：<https://docs.mafdet.ai>
 
 ## 环境要求
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mafdet/cli",
-  "version": "0.4.12",
+  "version": "1.4.18",
   "description": "Mafdet AI command line — model calls, account queries, and a permissioned local agent.",
   "type": "module",
   "license": "MIT",