specific-ai-cli 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,175 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="assets/hero.svg" width="100%" alt="Specific AI — 一个命令，连接每个平台">
+
+<br>
+
+**一个命令，连接 10 个平台。**<br>
+小红书 · 抖音 · TikTok · B 站 · 快手 · 微博 · 闲鱼 · 淘宝 · 京东 · X
+<br>
+<sub>即将支持：Instagram · YouTube · Facebook · 知乎 · 微信公众号 · 今日头条 · 得物 · 拼多多 · 美团 · 大众点评</sub>
+
+<br>
+
+[![npm](https://img.shields.io/npm/v/specific-ai-cli?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/specific-ai-cli)
+[![License: MIT](https://img.shields.io/badge/license-MIT-A6E3A1?style=for-the-badge)](LICENSE)
+[![Node](https://img.shields.io/badge/node-22%20%7C%2024%20%7C%2026-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](tsconfig.json)
+[![Platforms](https://img.shields.io/badge/platforms-10-F38BA8?style=for-the-badge)](docs/platforms/README.md)
+[![Agent Ready](https://img.shields.io/badge/AI%20Agent-ready-CBA6F7?style=for-the-badge)](.claude/skills/specific-ai/SKILL.md)
+
+**简体中文** · [English](README.en.md) · [繁體中文](README.zh-TW.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
+
+[快速上手](docs/guide/quick-start.md) · [能力矩阵](docs/capabilities.md) · [各平台](docs/platforms/README.md) · [示例](docs/examples/README.md) · [给 Agent 用](.claude/skills/specific-ai/SKILL.md)
+
+</div>
+
+<br>
+
+> 每个平台都有自己的一套接口、签名、登录方式和数据格式。**Specific AI 把它们汇聚到同一个入口**：同一套命令、同一种 JSON、同一个登录态目录。换平台，只需要换一个词。
+
+
+## ✨ Specific AI 是什么
+
+Specific AI 是一个命令行工具，用**统一的语法**调用 10 个中外主流平台的 web 端能力：搜索、详情、评论、用户、推荐流、下载、发布、私信、直播弹幕……
+
+```bash
+specific-ai xhs      item search 露营 --sort latest
+specific-ai douyin   item search 露营 --sort latest
+specific-ai bilibili item search 露营 --sort latest
+specific-ai x        item search camping --sort latest
+```
+
+四个平台，四条几乎一样的命令，输出**同一种结构**的 JSON。笔记、作品、稿件、推文一律叫 `item`，搜索一律叫 `search`，点赞一律叫 `like`。学一次，十个平台都会用。
+
+<p align="center">
+  <img src="assets/platforms.svg" width="100%" alt="已支持的 10 个平台与正在开发的 10 个平台">
+</p>
+
+## 🚀 为什么是 Specific AI
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🧭 同义同名
+含义相同的能力，在所有平台上用**同一个命令、同一组参数、同一种输出**。用了平台原生叫法（`note`、`aweme`、`tweet`……）也没关系，specific-ai 会告诉你该用哪个词。
+
+</td>
+<td width="50%" valign="top">
+
+### 📦 只需要 Node
+不需要 Python、编译器或任何系统依赖。原生依赖全部带预编译包，覆盖 Windows、macOS、Linux 的 x64 / arm64（含 musl），**8 个目标系统**在 CI 上逐一冒烟。
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🤖 为 AI Agent 而生
+stdout 只有 JSON，退出码稳定，错误里带着下一步该执行的命令；`specific-ai platforms` 输出完整的能力清单。自带 [Agent 技能](.claude/skills/specific-ai/SKILL.md) 与 [llms.txt](llms.txt)。
+
+</td>
+<td valign="top">
+
+### 🔐 登录态只在你的电脑上
+扫码、短信、cookie 导入都支持，凭证按 **平台 × 端 × 账号** 隔离在 `~/.specific-ai/`（0700 / 0600），多账号随时切换。不收集、不上传任何数据，没有遥测。
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🧪 与上游逐字节一致
+每个请求的 URL、header 顺序、cookie、body 和签名，都在固定的随机数与时钟下和上游实现**逐字节对拍**。560+ 份对拍数据、940+ 个离线测试守住每一次改动。
+
+</td>
+<td valign="top">
+
+### 🛡️ 浏览器级的网络栈
+与真 Chrome 一致的 TLS / HTTP2 指纹，上游签名 JS 原样在沙箱里运行，滑块、点选验证码用本地的 ONNX 与 OpenCV 自动识别。
+
+</td>
+</tr>
+</table>
+
+## 📊 一些数字
+
+<div align="center">
+
+| 🚌 平台 | ⌨️ 已实现命令 | 🧪 对拍数据 | ✅ 离线测试 | 💻 目标系统 |
+|:---:|:---:|:---:|:---:|:---:|
+| **10** | **300+** | **560+** | **940+** | **8** |
+
+</div>
+
+## 🏗️ 架构
+
+<p align="center">
+  <img src="assets/architecture.svg" width="100%" alt="specific-ai 架构">
+</p>
+
+- **一个注册表驱动一切**：命令解析、四层 `--help`、`specific-ai platforms`、[能力矩阵](docs/capabilities.md) 都由同一份注册表生成，永远不会互相矛盾。
+- **一个平台，一组文件**：`client` 管会话与签名，`api` 一一对应上游方法，`normalize` 把原始数据变成统一的类型，`resolve` 让 ID、链接、分享短链、`me` 都能当参数。
+- **可扩展**：规范为 app / pc 端预留了位置；非 JS 的上游将通过 provider 协议接入。
+
+## 🤖 为 AI Agent 而生
+
+Specific AI 从第一天起就按「被程序调用」来设计：
+
+```bash
+specific-ai platforms douyin | jq '.data.commands[] | select(.status=="implemented") | .resource + " " + .action'
+```
+
+- **自描述**：每个平台、每条命令的登录要求、实现状态、上游支持程度，一条命令就能查到。
+- **可预期**：成功和失败都是同一种信封 `{ ok, data, page, error }`；`error.hint` 直接给出下一步命令。
+- **能接力**：所有输出对象都带 `id` 和 `url`，上一条命令的结果可以直接喂给下一条。
+- **有分寸**：危险操作必须显式 `-y`，发布可以设为仅自己可见，遇到风控明确报 `RISK_CONTROL`，不会悄悄重试。
+
+一条命令把 Specific AI 技能装进 Claude Code、Cursor、Codex 等 Agent：
+
+```bash
+npx skills add Dearli666/specific-ai
+```
+
+技能按需加载：总纲只有一页，涉及哪个平台、做哪类事（采集、发布、直播私信、排错）才读对应的[子文件](.claude/skills/specific-ai/SKILL.md)，并且内置了安全红线——登录交给你、写操作先确认、发布默认仅自己可见、遇到风控就停。
+
+## ⚡ 30 秒开始
+
+```bash
+npm i -g specific-ai-cli
+
+specific-ai doctor                 # 检查环境
+specific-ai bilibili auth login    # 扫码登录
+specific-ai bilibili item search 猫 --limit 20
+```
+
+也可以用 [Docker](docs/guide/docker.md) 或从源码安装，完整步骤见 [快速上手](docs/guide/quick-start.md)。
+
+## 📚 文档
+
+| | |
+|---|---|
+| 🚀 [快速上手](docs/guide/quick-start.md) | 从安装到导出第一批数据 |
+| 🔑 [登录](docs/guide/login.md) · ⚙️ [配置](docs/guide/configuration.md) · 🐳 [Docker](docs/guide/docker.md) | 扫码 / cookie、多账号、代理、容器 |
+| 📤 [输出与错误处理](docs/guide/output.md) | 信封、归一化类型、分页、退出码 |
+| 🧭 [各平台说明](docs/platforms/README.md) · 🗂️ [能力矩阵](docs/capabilities.md) | 每个平台支持什么、怎么传参 |
+| 🧪 [示例脚本](docs/examples/README.md) | 跨平台搜索、导出评论、备份作品、录直播弹幕 |
+| 📐 [AGENTS.md](AGENTS.md) | specific-ai 的规范本身 |
+| ❓ [常见问题](docs/guide/faq.md) | 为什么要登录、遇到风控怎么办…… |
+
+## 🤝 参与
+
+欢迎 issue 和 PR：新平台、新命令、平台接口变了、文档改进都可以。开始之前读一下 [CONTRIBUTING.md](.github/CONTRIBUTING.md) 和 [AGENTS.md](AGENTS.md)（规范先行，请求必须有对拍）。安全问题请按 [SECURITY.md](.github/SECURITY.md) 私下报告。
+
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 [cv-cat](https://github.com/cv-cat). Specific AI 基于原项目重命名并保持其 CLI 能力。
+
+<div align="center">
+<br>
+<img src="assets/logo.svg" width="64" alt="specific-ai">
+<br>
+<sub>一个命令，连接每个平台 · One command. Every platform.</sub>
+</div>

package/README.zh-TW.md

@@ -0,0 +1,177 @@
+<div align="center">
+
+<img src="assets/hero.svg" width="100%" alt="Specific AI — 一個指令，連接每個平台">
+
+<br>
+
+**一個指令，連接 10 個平台。**<br>
+小紅書 · 抖音 · TikTok · 嗶哩嗶哩 · 快手 · 微博 · 閒魚 · 淘寶 · 京東 · X
+<br>
+<sub>即將支援：Instagram · YouTube · Facebook · 知乎 · 微信公眾號 · 今日頭條 · 得物 · 拼多多 · 美團 · 大眾點評</sub>
+
+<br>
+
+[![npm](https://img.shields.io/npm/v/specific-ai-cli?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/specific-ai-cli)
+[![License: MIT](https://img.shields.io/badge/license-MIT-A6E3A1?style=for-the-badge)](LICENSE)
+[![Node](https://img.shields.io/badge/node-22%20%7C%2024%20%7C%2026-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](tsconfig.json)
+[![Platforms](https://img.shields.io/badge/platforms-10-F38BA8?style=for-the-badge)](docs/platforms/README.md)
+[![Agent Ready](https://img.shields.io/badge/AI%20Agent-ready-CBA6F7?style=for-the-badge)](.claude/skills/specific-ai/SKILL.md)
+
+[简体中文](README.md) · [English](README.en.md) · **繁體中文** · [日本語](README.ja.md) · [한국어](README.ko.md)
+
+[快速上手](docs/guide/quick-start.md) · [能力矩陣](docs/capabilities.md) · [各平台](docs/platforms/README.md) · [範例](docs/examples/README.md) · [給 Agent 用](.claude/skills/specific-ai/SKILL.md)
+
+</div>
+
+<br>
+
+> 每個平台都有自己的一套 API、簽章、登入方式和資料格式。**Specific AI 把它們整合到同一個入口**：同一套指令、同一種 JSON、同一個登入狀態目錄。換平台，只需要換一個詞。
+
+
+## ✨ Specific AI 是什麼
+
+Specific AI 是一個命令列工具，用**統一的語法**呼叫 10 個中國大陸及國際主流平台的 web 端功能：搜尋、詳細資料、留言、使用者、推薦動態、下載、發佈、私訊、直播彈幕……
+
+```bash
+specific-ai xhs      item search 露营 --sort latest
+specific-ai douyin   item search 露营 --sort latest
+specific-ai bilibili item search 露营 --sort latest
+specific-ai x        item search camping --sort latest
+```
+
+四個平台，四條幾乎一樣的指令，輸出**同一種結構**的 JSON。筆記、作品、影片、推文一律叫 `item`，搜尋一律叫 `search`，按讚一律叫 `like`。學一次，十個平台都會用。
+
+<p align="center">
+  <img src="assets/platforms.svg" width="100%" alt="已支援的 10 個平台與開發中的 10 個平台">
+</p>
+
+## 🚀 為什麼選 Specific AI
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🧭 同義同名
+意義相同的功能，在所有平台上都用**同一個指令、同一組參數、同一種輸出**。就算用了平台原生的叫法（`note`、`aweme`、`tweet`……）也沒關係，specific-ai 會告訴你該用哪個詞。
+
+</td>
+<td width="50%" valign="top">
+
+### 📦 只需要 Node
+不需要 Python、編譯器或任何系統相依套件。原生相依套件全部附有預先編譯的版本，涵蓋 Windows、macOS、Linux 的 x64 / arm64（含 musl），**8 個目標系統**都在 CI 上逐一進行冒煙測試。
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🤖 為 AI Agent 而生
+stdout 只有 JSON，結束代碼穩定，錯誤訊息裡直接附上下一步該執行的指令；`specific-ai platforms` 會輸出完整的功能清單。內建 [Agent 技能](.claude/skills/specific-ai/SKILL.md) 與 [llms.txt](llms.txt)。
+
+</td>
+<td valign="top">
+
+### 🔐 登入狀態只留在你的電腦上
+QR Code 掃描、簡訊、cookie 匯入都支援，憑證依 **平台 × 端 × 帳號** 隔離存放在 `~/.specific-ai/`（0700 / 0600），多帳號隨時切換。不蒐集、不上傳任何資料，也沒有遙測。
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🧪 與上游逐位元組一致
+每個請求的 URL、header 順序、cookie、body 和簽章，都在固定的亂數與時鐘下和上游實作**逐位元組比對**。560+ 份比對資料、940+ 個離線測試，守住每一次修改。
+
+</td>
+<td valign="top">
+
+### 🛡️ 瀏覽器等級的網路堆疊
+與真正的 Chrome 一致的 TLS / HTTP2 指紋，上游簽章 JS 原封不動地在沙盒中執行，滑塊、點選驗證碼則用本機的 ONNX 與 OpenCV 自動辨識。
+
+</td>
+</tr>
+</table>
+
+## 📊 一些數字
+
+<div align="center">
+
+| 🚌 平台 | ⌨️ 已實作指令 | 🧪 比對資料 | ✅ 離線測試 | 💻 目標系統 |
+|:---:|:---:|:---:|:---:|:---:|
+| **10** | **300+** | **560+** | **940+** | **8** |
+
+</div>
+
+## 🏗️ 架構
+
+<p align="center">
+  <img src="assets/architecture.svg" width="100%" alt="specific-ai 架構">
+</p>
+
+- **一個註冊表驅動一切**：指令解析、四層 `--help`、`specific-ai platforms`、[能力矩陣](docs/capabilities.md) 都由同一份註冊表產生，永遠不會互相矛盾。
+- **一個平台，一組檔案**：`client` 負責工作階段與簽章，`api` 與上游方法一一對應，`normalize` 把原始資料轉成統一的型別，`resolve` 讓 ID、連結、分享短網址、`me` 都能當作參數。
+- **可擴充**：規範為 app / pc 端預留了位置；非 JS 的上游將透過 provider 協定接入。
+
+## 🤖 為 AI Agent 而生
+
+specific-ai 從第一天起，就是依照「被程式呼叫」來設計的：
+
+```bash
+specific-ai platforms douyin | jq '.data.commands[] | select(.status=="implemented") | .resource + " " + .action'
+```
+
+- **自我描述**：每個平台、每條指令的登入需求、實作狀態、上游支援程度，一條指令就能查到。
+- **可預期**：成功和失敗都是同一種信封 `{ ok, data, page, error }`；`error.hint` 直接給出下一步的指令。
+- **能接力**：所有輸出物件都帶有 `id` 和 `url`，上一條指令的結果可以直接餵給下一條。
+- **有分寸**：危險操作必須明確加上 `-y`，發佈時可以設為僅自己可見，遇到風控會明確回報 `RISK_CONTROL`，不會偷偷重試。
+
+一行指令把 specific-ai 技能裝進 Claude Code、Cursor、Codex 等 Agent：
+
+```bash
+npx skills add Dearli666/specific-ai
+```
+
+技能按需載入：總綱只有一頁，碰到哪個平台、做哪類事（採集、發布、直播私訊、排錯）才讀對應的[子檔案](.claude/skills/specific-ai/SKILL.md)，並且內建安全紅線——登入交給你、寫入操作先確認、發布預設僅自己可見、遇到風控就停。
+
+## ⚡ 30 秒上車
+
+```bash
+npm i -g specific-ai-cli
+
+specific-ai doctor                 # 檢查環境
+specific-ai bilibili auth login    # 掃描 QR Code 登入
+specific-ai bilibili item search 猫 --limit 20
+```
+
+也可以用 [Docker](docs/guide/docker.md) 或從原始碼安裝，完整步驟請見 [快速上手](docs/guide/quick-start.md)。
+
+## 📚 文件
+
+以下文件目前僅提供簡體中文版。
+
+| | |
+|---|---|
+| 🚀 [快速上手](docs/guide/quick-start.md) | 從安裝到匯出第一批資料 |
+| 🔑 [登入](docs/guide/login.md) · ⚙️ [設定](docs/guide/configuration.md) · 🐳 [Docker](docs/guide/docker.md) | 掃碼 / cookie、多帳號、代理伺服器、容器 |
+| 📤 [輸出與錯誤處理](docs/guide/output.md) | 信封、正規化型別、分頁、結束代碼 |
+| 🧭 [各平台說明](docs/platforms/README.md) · 🗂️ [能力矩陣](docs/capabilities.md) | 每個平台支援什麼、參數怎麼傳 |
+| 🧪 [範例腳本](docs/examples/README.md) | 跨平台搜尋、匯出留言、備份作品、錄製直播彈幕 |
+| 📐 [AGENTS.md](AGENTS.md) | specific-ai 的規範本身 |
+| ❓ [常見問題](docs/guide/faq.md) | 為什麼要登入、遇到風控怎麼辦…… |
+
+## 🤝 參與貢獻
+
+歡迎 issue 和 PR：新平台、新指令、平台 API 變動、文件改進都可以。開始之前請先讀一下 [CONTRIBUTING.md](.github/CONTRIBUTING.md) 和 [AGENTS.md](AGENTS.md)（規範先行，請求必須有比對測試）。安全性問題請依照 [SECURITY.md](.github/SECURITY.md) 私下回報。
+
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 [cv-cat](https://github.com/cv-cat)
+
+<div align="center">
+<br>
+<img src="assets/logo.svg" width="64" alt="specific-ai">
+<br>
+<sub>一個指令，連接每個平台 · One command. Every platform.</sub>
+</div>

package/assets/banner.txt

@@ -0,0 +1,3 @@
+  ╭─●──●─╮  Specific AI · 一个命令，连接每个平台
+  ●  ❯_  ●  specific-ai <platform> <resource> <action>
+  ╰─●──●─╯  One command. Every platform.

package/dist/cli/argv.js

@@ -0,0 +1,98 @@
+import { parseArgs } from 'node:util';
+import { SpecificAIError } from '../core/errors.js';
+import { describeOption, flagName, STANDARD_OPTIONS } from '../core/options.js';
+import { VOCAB } from '../core/vocab.js';
+export const GLOBAL_FLAGS = {
+    account: { type: 'string', short: 'a' },
+    endpoint: { type: 'string', short: 'e' },
+    output: { type: 'string', short: 'o' },
+    raw: { type: 'boolean' },
+    proxy: { type: 'string' },
+    verbose: { type: 'boolean', short: 'v' },
+    quiet: { type: 'boolean', short: 'q' },
+    yes: { type: 'boolean', short: 'y' },
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean' },
+};
+/**
+ * 汇总标准选项、词表和所有平台声明的选项。同名选项在不同命令里的类型必须一致，
+ * 也不能与全局选项重名，否则启动时就报错。
+ */
+export function collectOptionKinds(platforms) {
+    const kinds = new Map();
+    const add = (key, schema, where) => {
+        if (key in GLOBAL_FLAGS)
+            throw new Error(`选项 --${flagName(key)}（${where}）与全局选项重名`);
+        const kind = describeOption(schema).kind;
+        const prev = kinds.get(key);
+        if (prev && prev !== kind)
+            throw new Error(`选项 --${flagName(key)}（${where}）的类型 ${kind} 与别处的 ${prev} 不一致`);
+        kinds.set(key, kind);
+    };
+    for (const [k, s] of Object.entries(STANDARD_OPTIONS))
+        add(k, s, '标准选项');
+    for (const [key, spec] of Object.entries(VOCAB))
+        for (const [k, s] of Object.entries(spec.options))
+            add(k, s, key);
+    for (const p of platforms) {
+        for (const e of Object.values(p.endpoints)) {
+            if (e === 'planned')
+                continue;
+            for (const c of e.commands.values())
+                for (const [k, s] of Object.entries(c.options))
+                    add(k, s, `${p.id} ${c.key}`);
+        }
+    }
+    return kinds;
+}
+export function parseArgv(argv, kinds) {
+    const config = { ...GLOBAL_FLAGS };
+    const keyOf = new Map();
+    for (const [key, kind] of kinds) {
+        const flag = flagName(key);
+        keyOf.set(flag, key);
+        config[flag] = { type: kind === 'boolean' ? 'boolean' : 'string', multiple: kind === 'array' };
+    }
+    let parsed;
+    try {
+        parsed = parseArgs({ args: argv, options: config, strict: true, allowPositionals: true });
+    }
+    catch (err) {
+        throw translate(err);
+    }
+    const global = {};
+    const options = {};
+    for (const [flag, value] of Object.entries(parsed.values)) {
+        if (flag in GLOBAL_FLAGS) {
+            global[flag] = value;
+            continue;
+        }
+        const key = keyOf.get(flag);
+        if (kinds.get(key) === 'number') {
+            const n = Number(value);
+            if (typeof value !== 'string' || value.trim() === '' || !Number.isFinite(n)) {
+                throw new SpecificAIError('USAGE', `选项 --${flag} 需要一个数字，收到的是 ${String(value)}`);
+            }
+            options[key] = n;
+        }
+        else
+            options[key] = value;
+    }
+    return { positionals: parsed.positionals, global, options };
+}
+function translate(err) {
+    const quoted = /'([^']+)'/.exec(err.message)?.[1] ?? '';
+    const flag = /--[\w-]+/.exec(quoted)?.[0] ?? /-\w/.exec(quoted)?.[0] ?? quoted;
+    switch (err.code) {
+        case 'ERR_PARSE_ARGS_UNKNOWN_OPTION':
+            return new SpecificAIError('USAGE', `未知选项 ${flag}`, {
+                hint: `以 - 开头的参数请放在 -- 之后，例如：-- "${flag}"`,
+            });
+        case 'ERR_PARSE_ARGS_INVALID_OPTION_VALUE':
+            return /does not take an argument/.test(err.message)
+                ? new SpecificAIError('USAGE', `选项 ${flag} 不接受值`)
+                : new SpecificAIError('USAGE', `选项 ${flag} 缺少值`, { hint: `值以 - 开头时写成 ${flag}=<值>` });
+        default:
+            return new SpecificAIError('USAGE', err.message);
+    }
+}

package/dist/cli/commands/auth.js

@@ -0,0 +1,11 @@
+import { listAccounts } from '../../core/auth-store.js';
+import { ENDPOINTS } from '../../core/registry.js';
+import { PLATFORMS } from '../../platforms/index.js';
+/** 全局 `specific-ai auth list`：所有平台、所有端的账号。 */
+export async function allAccounts() {
+    const accounts = [];
+    for (const p of PLATFORMS)
+        for (const e of ENDPOINTS)
+            accounts.push(...(await listAccounts(p.id, e)));
+    return accounts;
+}

package/dist/cli/commands/config.js

@@ -0,0 +1,23 @@
+import { getConfig, listConfig, parseKey, setConfig, unsetConfig } from '../../core/config.js';
+import { SpecificAIError } from '../../core/errors.js';
+import { findPlatform } from '../../platforms/index.js';
+const resolvePlatform = (name) => findPlatform(name)?.id;
+const USAGE = { get: 1, set: 2, unset: 1, list: 0 };
+export async function config(action, words) {
+    const arity = USAGE[action];
+    if (arity === undefined) {
+        throw new SpecificAIError('USAGE', `未知的 config 子命令：${action}`, { hint: 'specific-ai config --help' });
+    }
+    if (words.length !== arity) {
+        const usage = { get: 'get <key>', set: 'set <key> <value>', unset: 'unset <key>', list: 'list' }[action];
+        throw new SpecificAIError('USAGE', `参数个数不对，用法：specific-ai config ${usage}`, { hint: 'specific-ai config --help' });
+    }
+    if (action === 'list')
+        return listConfig();
+    const path = parseKey(words[0], resolvePlatform);
+    if (action === 'get')
+        return getConfig(path);
+    if (action === 'set')
+        return setConfig(path, words[1]);
+    return unsetConfig(path);
+}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,134 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { rm, stat } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import vm from 'node:vm';
+import { ensureDir, writeFileAtomic } from '../../core/fsutil.js';
+import { specificAiHome, packageJson } from '../../core/paths.js';
+import { createContext } from '../../core/vm.js';
+const require = createRequire(import.meta.url);
+/** onnx 冒烟用的最小模型：c = a + b，float32[2]。 */
+const ADD_MODEL = 'CAg6SAoOCgFhCgFiEgFjIgNBZGQSA2FkZFoPCgFhEgoKCAgBEgQKAggCWg8KAWISCgoICAESBAoCCAJiDwoBYxIKCggIARIECgIIAkIECgAQDQ==';
+async function check(name, run) {
+    try {
+        return { name, ok: true, message: await run() };
+    }
+    catch (err) {
+        return { name, ok: false, message: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** 已安装依赖的版本：从入口文件向上找它的 package.json（有的包不导出 ./package.json）。 */
+function installedVersion(name) {
+    let dir = dirname(require.resolve(name));
+    for (;;) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+            if (pkg.name === name)
+                return pkg.version;
+        }
+        catch { }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return '?';
+        dir = parent;
+    }
+}
+/** 只支持 engines 里用到的写法：`^x.y.z`、`>=x.y.z`，用 `||` 连接。 */
+export function satisfies(version, range) {
+    const v = version.split('.').map(Number);
+    return range.split('||').some((part) => {
+        const m = /^\s*(\^|>=)(\d+)\.(\d+)\.(\d+)\s*$/.exec(part);
+        if (!m)
+            return false;
+        const min = [Number(m[2]), Number(m[3]), Number(m[4])];
+        const i = v.findIndex((n, j) => n !== min[j]);
+        const atLeast = i === -1 || v[i] > min[i];
+        return atLeast && (m[1] === '>=' || v[0] === min[0]);
+    });
+}
+export async function doctor() {
+    const engines = packageJson().engines.node;
+    return [
+        await check('node', () => {
+            const v = process.versions.node;
+            if (!satisfies(v, engines))
+                throw new Error(`Node ${v} 不满足要求 ${engines}`);
+            return `Node ${v}（要求 ${engines}）`;
+        }),
+        await check('home', async () => {
+            const home = specificAiHome();
+            await ensureDir(home);
+            const probe = join(home, '.doctor');
+            await writeFileAtomic(probe, 'ok');
+            await rm(probe, { force: true });
+            if (process.platform !== 'win32') {
+                const mode = (await stat(home)).mode & 0o777;
+                if (mode & 0o077) {
+                    throw new Error(`${home} 的权限是 ${mode.toString(8).padStart(4, '0')}，其他用户可以访问；执行 chmod 700 ${home}`);
+                }
+            }
+            return `${home} 可写`;
+        }),
+        await check('vm', () => {
+            const expected = createHash('md5').update('specific-ai').digest('hex');
+            const got = vm.runInContext(`require('node:crypto').createHash('md5').update('specific-ai').digest('hex')`, createContext());
+            if (got !== expected)
+                throw new Error(`签名 vm 的结果不对：${got}`);
+            return 'node:vm + require 正常';
+        }),
+        await check('http', async () => {
+            const { createSession } = await import('wreq-js');
+            const session = await createSession();
+            await session.close();
+            return `wreq-js ${installedVersion('wreq-js')}`;
+        }),
+        await check('canvas', async () => {
+            const { createCanvas } = await import('@napi-rs/canvas');
+            const canvas = createCanvas(4, 4);
+            const ctx = canvas.getContext('2d');
+            ctx.fillStyle = '#f5c2e7';
+            ctx.fillRect(0, 0, 4, 4);
+            const png = canvas.toBuffer('image/png');
+            if (png.subarray(1, 4).toString() !== 'PNG')
+                throw new Error('PNG 编码结果不对');
+            return `@napi-rs/canvas ${installedVersion('@napi-rs/canvas')}`;
+        }),
+        await check('onnx', async () => {
+            const ort = await import('onnxruntime-web');
+            ort.env.wasm.numThreads = 1;
+            const session = await ort.InferenceSession.create(Buffer.from(ADD_MODEL, 'base64'));
+            const input = (v) => new ort.Tensor('float32', Float32Array.from(v), [2]);
+            const { c } = await session.run({ a: input([1, 2]), b: input([3, 4]) });
+            await session.release();
+            const got = Array.from(c.data).join();
+            if (got !== '4,6')
+                throw new Error(`推理结果不对：${got}`);
+            return `onnxruntime-web ${installedVersion('onnxruntime-web')}（wasm）`;
+        }),
+        await check('assets-jd', async () => {
+            const name = 'specific-ai-assets-jd';
+            const { models } = await import('specific-ai-assets-jd').catch(() => {
+                throw new Error(`没有安装 ${name}，请重新安装 specific-ai-cli`);
+            });
+            for (const file of Object.values(models)) {
+                const s = await stat(file).catch(() => null);
+                if (!s?.size)
+                    throw new Error(`模型文件缺失：${file}`);
+            }
+            return `${name} ${installedVersion(name)}`;
+        }),
+        await check('assets-ocr', async () => {
+            const name = 'specific-ai-assets-ocr';
+            const { models } = await import('specific-ai-assets-ocr').catch(() => {
+                throw new Error(`没有安装 ${name}，请重新安装 specific-ai-cli`);
+            });
+            for (const file of Object.values(models)) {
+                const s = await stat(file).catch(() => null);
+                if (!s?.size)
+                    throw new Error(`模型文件缺失：${file}`);
+            }
+            return `${name} ${installedVersion(name)}`;
+        }),
+    ];
+}

package/dist/cli/commands/platforms.js

@@ -0,0 +1,24 @@
+import { ENDPOINTS, sortCommands } from '../../core/registry.js';
+/** `specific-ai platforms` 的一项：平台 × 端 × 命令的状态，数据来自注册表。 */
+export function platformInfo(platform) {
+    return {
+        id: platform.id,
+        name: platform.name,
+        aliases: platform.aliases,
+        endpoints: Object.fromEntries(ENDPOINTS.map((e) => [e, platform.endpoints[e] === 'planned' ? 'planned' : 'available'])),
+        commands: ENDPOINTS.flatMap((endpoint) => {
+            const ep = platform.endpoints[endpoint];
+            if (ep === 'planned')
+                return [];
+            return sortCommands(ep.commands.values()).map((c) => ({
+                endpoint,
+                resource: c.resource,
+                action: c.action,
+                auth: c.auth,
+                status: c.status,
+                upstream: c.upstream,
+                note: c.note,
+            }));
+        }),
+    };
+}

package/dist/cli/commands/version.js

@@ -0,0 +1,4 @@
+import { packageJson } from '../../core/paths.js';
+export function version() {
+    return { version: packageJson().version, node: process.versions.node, platform: process.platform, arch: process.arch };
+}