@bingran/sbti-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bingran You
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,13 @@
+This repository includes original code and documentation authored for `sbti-cli`,
+which are released under the MIT License in `LICENSE`.
+
+This repository may also contain third-party content derived from the upstream
+SBTI website at https://sbti.fancc.de5.net/, including but not limited to:
+
+- survey prompts
+- result descriptions
+- extracted character artwork / poster images
+
+Those upstream materials remain subject to their original ownership and are not
+relicensed by this repository unless the original rights holder states
+otherwise.

package/README.md

@@ -0,0 +1,322 @@
+<h1 align="center">SBTI CLI - Test SBTI for your agents.</h1>
+
+<p align="center">
+  <em>SBTI CLI - Test SBTI for your agents.</em><br>
+  A Node.js CLI with <strong>offline-only execution</strong>, <strong>bundled survey data</strong>, and <strong>result-image export</strong>.
+</p>
+
+<p align="center">
+  <a href="https://sbti.fancc.de5.net"><img alt="Original test" src="https://img.shields.io/badge/original-sbti.fancc.de5.net-4CAF50?style=flat-square"></a>
+  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-18%2B-339933?style=flat-square">
+  <img alt="Runtime mode" src="https://img.shields.io/badge/runtime-offline--only-blue?style=flat-square">
+  <img alt="Result images" src="https://img.shields.io/badge/result%20images-27-orange?style=flat-square">
+  <img alt="Questions" src="https://img.shields.io/badge/questions-30%20%2B%201%20hidden-purple?style=flat-square">
+  <img alt="License" src="https://img.shields.io/badge/license-MIT-red?style=flat-square">
+</p>
+
+<p align="center">
+  <a href="./README.md"><img alt="English" src="https://img.shields.io/badge/English-current-111827?style=for-the-badge"></a>
+  <a href="./README.zh-CN.md"><img alt="简体中文" src="https://img.shields.io/badge/简体中文-click_to_switch-EF4444?style=for-the-badge"></a>
+</p>
+
+<p align="center">
+  <img src="assets/type-images/CTRL.png" width="130" alt="CTRL">
+  <img src="assets/type-images/BOSS.png" width="130" alt="BOSS">
+  <img src="assets/type-images/SEXY.png" width="130" alt="SEXY">
+  <img src="assets/type-images/MALO.png" width="130" alt="MALO">
+  <img src="assets/type-images/DRUNK.png" width="130" alt="DRUNK">
+  <img src="assets/type-images/HHHH.png" width="130" alt="HHHH">
+</p>
+
+---
+
+## 📖 Table of Contents
+
+- [📖 Table of Contents](#-table-of-contents)
+- [🎯 What Is This](#-what-is-this)
+- [🧭 Installation \& Setup](#-installation--setup)
+- [🧪 Using the CLI](#-using-the-cli)
+  - [Common Commands](#common-commands)
+  - [Interactive Controls](#interactive-controls)
+  - [Typical Run](#typical-run)
+- [🧬 Core Capabilities](#-core-capabilities)
+- [🎭 Result Images \& Offline Resources](#-result-images--offline-resources)
+  - [Export All Result Images](#export-all-result-images)
+- [🔬 Data Sources \& How It Works](#-data-sources--how-it-works)
+  - [Why It Can Match the Website So Closely](#why-it-can-match-the-website-so-closely)
+  - [Where the Poster Art Comes From](#where-the-poster-art-comes-from)
+  - [Most Important Files in This Repo](#most-important-files-in-this-repo)
+- [🙏 Acknowledgements](#-acknowledgements)
+- [📄 License](#-license)
+
+---
+
+## 🎯 What Is This
+
+This repository turns **SBTI** into a local command-line runner.
+
+Key traits:
+
+- 🎲 **Website-equivalent question flow**
+- 📊 **Website-equivalent scoring**
+- 📴 **Offline-safe execution**
+- 🖼️ **Exportable result posters**
+- ✅ **Regression coverage**
+
+---
+
+## 🧭 Installation & Setup
+
+### Install From npm
+
+For agent runs or normal CLI use, install the published package and run the binary directly:
+
+```bash
+npm install -g @bingran/sbti-cli
+sbti-cli
+```
+
+or:
+
+```bash
+npx @bingran/sbti-cli
+```
+
+The npm install surface is intentionally small: the root `@bingran/sbti-cli` package only ships a tiny launcher, and npm pulls the matching platform-native binary package for your machine. The published package does **not** ship the repository source tree, tests, build scripts, or image assets.
+
+Current native package targets:
+
+- macOS `arm64`
+- macOS `x64`
+- Linux `arm64`
+- Linux `x64`
+- Windows `x64`
+
+### Clone The Repo For Development
+
+If you want the test suite, image-export tooling, or source code itself, use the repository checkout:
+
+```bash
+git clone https://github.com/bingran-you/sbti-cli.git
+cd sbti-cli
+npm install
+npm test
+```
+
+Then start the development CLI with:
+
+```bash
+npm run sbti
+```
+
+or:
+
+```bash
+node src/cli.mjs
+```
+
+> 💡 There is no database, browser driver, or `.env` setup required. If Node.js is installed, you can run either the published CLI or the repo-local development entry point.
+
+---
+
+## 🧪 Using the CLI
+
+### Common Commands
+
+| Command | Purpose |
+|---|---|
+| `sbti-cli` | Start a normal interactive run from the published npm package |
+| `sbti-cli --seed 42` | Use a deterministic shuffle seed |
+| `sbti-cli --json` | Print the final result as JSON |
+| `npm run sbti` | Start the repo-local development entry point |
+| `npm run export-images` | Rebuild the local poster manifest and gallery from bundled assets in a repo checkout |
+
+### Interactive Controls
+
+Once the CLI starts, you answer one question at a time:
+Each answer is locked in for that run as soon as you submit it.
+
+| Input | Action |
+|---|---|
+| `A / B / C / D` | Select the current option |
+| `q` | Quit without submitting |
+
+### Typical Run
+
+```bash
+sbti-cli
+```
+
+```text
+SBTI CLI
+Question source: bundled:sbti-main.js
+
+Question 1 / 31 · dimension hidden
+...
+
+Enter A/B/C/D, or q to quit.
+> C
+```
+
+---
+
+## 🧬 Core Capabilities
+
+<table>
+<tr>
+  <th>Area</th>
+  <th>Capability</th>
+  <th>Details</th>
+</tr>
+<tr>
+  <td><strong>🛟 Offline runtime</strong></td>
+  <td>Always runs from the bundled snapshot</td>
+  <td>The CLI never fetches the live website at runtime, so every questionnaire run stays fully local</td>
+</tr>
+<tr>
+  <td><strong>🖼️ Result-image export</strong></td>
+  <td>27 bundled posters can be indexed locally</td>
+  <td>The repo can rebuild a JSON manifest and an HTML gallery from the checked-in image files</td>
+</tr>
+<tr>
+  <td><strong>🧪 Regression tests</strong></td>
+  <td>Bundled-runtime verification</td>
+  <td>Includes runtime parity, 50 deterministic result cases, and offline asset coverage</td>
+</tr>
+<tr>
+  <td><strong>📦 Native npm release</strong></td>
+  <td>Small launcher plus platform-native binary packages</td>
+  <td>Installing from npm no longer ships the repo source tree, tests, or build scripts with the runnable CLI</td>
+</tr>
+</table>
+
+---
+
+## 🎭 Result Images & Offline Resources
+
+This section is repository-only. The published npm CLI does not ship the poster assets or the export script.
+
+<table>
+  <tr>
+    <td align="center" width="33%">
+      <a href="assets/type-images/index.html"><img src="assets/type-images/CTRL.png" width="180"><br><strong>Local result gallery</strong></a><br>
+      <sub>An HTML gallery generated from the extracted poster files</sub>
+    </td>
+    <td align="center" width="33%">
+      <a href="assets/type-images/manifest.json"><img src="assets/type-images/BOSS.png" width="180"><br><strong>Image manifest</strong></a><br>
+      <sub>File names, MIME types, and sizes for all exported posters</sub>
+    </td>
+    <td align="center" width="33%">
+      <a href="src/bundled-data.mjs"><img src="assets/type-images/SEXY.png" width="180"><br><strong>Offline snapshot</strong></a><br>
+      <sub>The built-in survey data used for every CLI run</sub>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="scripts/export-type-images.mjs"><img src="assets/type-images/MALO.png" width="180"><br><strong>Image export script</strong></a><br>
+      <sub>Rebuilds the local poster manifest and gallery from the checked-in image files</sub>
+    </td>
+    <td align="center">
+      <a href="test/runtime.test.mjs"><img src="assets/type-images/HHHH.png" width="180"><br><strong>Parity tests</strong></a><br>
+      <sub>Checks that CLI results stay aligned with the bundled scoring logic</sub>
+    </td>
+  </tr>
+</table>
+
+### Export All Result Images
+
+```bash
+npm run export-images
+```
+
+This generates:
+
+- [`assets/type-images/index.html`](assets/type-images/index.html) — local gallery
+- [`assets/type-images/manifest.json`](assets/type-images/manifest.json) — poster manifest
+- [`assets/type-images/`](assets/type-images/) — all decoded `.png` / `.jpg` files
+
+## 🔬 Data Sources & How It Works
+
+### Why It Can Match the Website So Closely
+
+This repository stores a bundled snapshot of the survey data and scoring logic in [`src/bundled-data.mjs`](src/bundled-data.mjs). [`src/runtime.mjs`](src/runtime.mjs) turns that snapshot into a sandboxed runtime so the CLI can stay local while preserving the original question flow and result math.
+
+The CLI therefore uses the same runtime objects throughout every run:
+
+| Runtime object | Content |
+|---|---|
+| `dimensionMeta` | Chinese labels and model groups for the 15 dimensions |
+| `questions` | The 30 regular questions |
+| `specialQuestions` | The drink-gate question set |
+| `TYPE_LIBRARY` | Codes, names, intros, and full descriptions for all 27 result types |
+| `NORMAL_TYPES` | The 25 normal H / M / L templates |
+| `DIM_EXPLANATIONS` | Dimension explanations for each L / M / H tier |
+| `computeResult()` | The website's own result-selection branch logic |
+
+That is why the CLI can stay aligned with:
+
+- question shuffle
+- drink-gate insertion and hidden question reveal
+- 15-dimension scoring and bucketing
+- normal-type ranking
+- `DRUNK` override
+- `HHHH` low-similarity fallback
+
+### Where the Poster Art Comes From
+
+All 27 result posters are checked into [`assets/type-images/`](assets/type-images/). [`scripts/export-type-images.mjs`](scripts/export-type-images.mjs) rebuilds the manifest and gallery pages from those local files.
+
+### Most Important Files in This Repo
+
+- [`src/cli.mjs`](src/cli.mjs) — CLI entry point and interactive questionnaire flow
+- [`src/runtime.mjs`](src/runtime.mjs) — bundled runtime loading, sandbox evaluation, and result summarization
+- [`src/bundled-data.mjs`](src/bundled-data.mjs) — bundled offline snapshot
+- [`src/type-images.mjs`](src/type-images.mjs) — image helpers and local gallery generation
+- [`bin/sbti-cli.cjs`](bin/sbti-cli.cjs) — npm launcher that resolves the installed native binary package
+- [`lib/platform-package.cjs`](lib/platform-package.cjs) — supported-platform map and native-package resolution helpers
+- [`dist/sbti-cli.cjs`](dist/sbti-cli.cjs) — CommonJS single-file bundle used as the native-binary build input
+- [`scripts/build-dist.mjs`](scripts/build-dist.mjs) — generates the single-file ESM/CJS CLI bundles
+- [`scripts/build-platform-packages.mjs`](scripts/build-platform-packages.mjs) — builds precompiled native npm subpackages for each platform target
+- [`scripts/publish-packages.mjs`](scripts/publish-packages.mjs) — publishes the native platform packages and then the root `@bingran/sbti-cli` package
+- [`scripts/export-type-images.mjs`](scripts/export-type-images.mjs) — local poster metadata rebuild
+- [`test/runtime.test.mjs`](test/runtime.test.mjs) — bundled runtime parity tests
+- [`test/launcher.test.mjs`](test/launcher.test.mjs) — native-launcher package resolution coverage
+- [`test/package.test.mjs`](test/package.test.mjs) — publish-tarball surface checks
+- [`test/type-images.test.mjs`](test/type-images.test.mjs) — offline asset coverage
+
+---
+
+## 🙏 Acknowledgements
+
+<table>
+  <tr>
+    <th>Project</th>
+    <th>Author</th>
+    <th>Contribution</th>
+  </tr>
+  <tr>
+    <td><a href="https://sbti.fancc.de5.net"><strong>SBTI Personality Test</strong></a></td>
+    <td>Bilibili <a href="https://space.bilibili.com/417038183">@蛆肉儿串儿</a></td>
+    <td>Original survey author and source of the question text, result copy, and character artwork</td>
+  </tr>
+  <tr>
+    <td><a href="https://github.com/serenakeyitan/sbti-wiki"><strong>sbti-wiki</strong></a></td>
+    <td><a href="https://github.com/serenakeyitan">@serenakeyitan</a></td>
+    <td>The visual README format here was inspired by that project's centered hero, badges, image strip, and information-card layout</td>
+  </tr>
+  <tr>
+    <td><strong>sbti-cli</strong></td>
+    <td><a href="https://github.com/bingran-you">Bingran You (@bingran-you)</a></td>
+    <td>Built the sandboxed runtime loader, offline snapshot, image exporter, and regression test suite for a practical terminal workflow</td>
+  </tr>
+</table>
+
+> ⚠️ **For entertainment only**: the upstream site already warns against treating this as diagnosis, hiring criteria, relationship truth, fortune telling, or any serious judgment. This repo is a tooling and reference project, not a psychological assessment.
+
+---
+
+## 📄 License
+
+The original code and documentation in this repository are released under the [MIT License](LICENSE).
+
+Third-party survey prompts, result text, and extracted character artwork originate from the upstream SBTI website and remain subject to their original ownership. See [NOTICE](NOTICE) for attribution and scope.

package/README.zh-CN.md

@@ -0,0 +1,319 @@
+<h1 align="center">SBTI CLI · 官网逻辑等效的命令行版</h1>
+
+<p align="center">
+  <em>把 SBTI 人格测试搬进终端，同时尽量保留官网同一套运行时与结果资源。</em><br>
+  一个支持 <strong>纯离线运行</strong>、<strong>内置题库快照</strong>、<strong>结果图导出</strong> 的 Node.js CLI。
+</p>
+
+<p align="center">
+  <a href="https://sbti.fancc.de5.net"><img alt="原测试" src="https://img.shields.io/badge/原测试-sbti.fancc.de5.net-4CAF50?style=flat-square"></a>
+  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-18%2B-339933?style=flat-square">
+  <img alt="运行模式" src="https://img.shields.io/badge/运行模式-纯离线-blue?style=flat-square">
+  <img alt="结果图" src="https://img.shields.io/badge/结果图-27%20张-orange?style=flat-square">
+  <img alt="题目" src="https://img.shields.io/badge/题目-30%20%2B%201%20隐藏-purple?style=flat-square">
+  <img alt="许可证" src="https://img.shields.io/badge/许可证-MIT-red?style=flat-square">
+</p>
+
+<p align="center">
+  <a href="./README.md"><img alt="English" src="https://img.shields.io/badge/English-click_to_switch-2563EB?style=for-the-badge"></a>
+  <a href="./README.zh-CN.md"><img alt="简体中文" src="https://img.shields.io/badge/简体中文-当前-F0522D?style=for-the-badge"></a>
+</p>
+
+<p align="center">
+  <img src="assets/type-images/CTRL.png" width="130" alt="CTRL">
+  <img src="assets/type-images/BOSS.png" width="130" alt="BOSS">
+  <img src="assets/type-images/SEXY.png" width="130" alt="SEXY">
+  <img src="assets/type-images/MALO.png" width="130" alt="MALO">
+  <img src="assets/type-images/DRUNK.png" width="130" alt="DRUNK">
+  <img src="assets/type-images/HHHH.png" width="130" alt="HHHH">
+</p>
+
+---
+
+## 📖 目录
+
+- [这是什么](#-这是什么)
+- [如何安装与设置](#-如何安装与设置)
+- [如何使用 CLI](#-如何使用-cli)
+- [核心能力一览](#-核心能力一览)
+- [结果图与离线资源](#-结果图与离线资源)
+- [数据来源与原理](#-数据来源与原理)
+- [鸣谢](#-鸣谢)
+- [License](#-license)
+
+---
+
+## 🎯 这是什么
+
+本仓库把 [**sbti.fancc.de5.net**](https://sbti.fancc.de5.net) 的 SBTI 人格测试做成了一个可在本地终端运行的 CLI。它不是手写一套“像官网”的逻辑，而是把题库和结果逻辑打包成内置快照，在本地 sandbox 中运行，因此保留了这些关键特性：
+
+- 🎲 **和官网一致的题目行为**：30 道常规题随机顺序、饮酒分支插入位置、隐藏题触发规则都保持一致
+- 📊 **和官网一致的结果计算**：15 维打分、H / M / L 分档、25 个标准人格匹配、`DRUNK` 覆盖、`HHHH` 兜底都保持一致
+- 📴 **每次都纯离线运行**：CLI 每次都直接使用仓库内置快照，不依赖 live website
+- 🖼️ **结果图可本地整理**：27 张结果海报已随仓库提供，可重建本地 manifest 与画廊
+- ✅ **有对齐测试兜底**：除了基础单测，还包含 50 组结果回归测试与离线资源完整性验证
+
+如果你想：
+
+- 在终端里完整做一次 SBTI
+- 用脚本研究结果逻辑
+- 在完全离线的环境里继续跑测试
+- 重建 27 张结果图的本地资源清单
+
+这个仓库就是干这个的。
+
+---
+
+## 🧭 如何安装与设置
+
+### 直接从 npm 安装
+
+如果只是想让 agent 或普通用户直接跑 CLI，用 npm 安装发布包即可：
+
+```bash
+npm install -g @bingran/sbti-cli
+sbti-cli
+```
+
+或者：
+
+```bash
+npx @bingran/sbti-cli
+```
+
+npm 安装面现在被刻意收紧了：根包 `@bingran/sbti-cli` 只带一个很小的 launcher，安装时会自动拉取当前平台对应的 native binary 子包。发布到 npm 的内容 **不会** 再带上仓库源码、测试、构建脚本或结果图资源。
+
+当前原生包目标平台：
+
+- macOS `arm64`
+- macOS `x64`
+- Linux `arm64`
+- Linux `x64`
+- Windows `x64`
+
+### 克隆仓库用于开发
+
+如果你需要测试集、结果图导出工具或源码本身，再使用仓库 checkout：
+
+```bash
+git clone https://github.com/bingran-you/sbti-cli.git
+cd sbti-cli
+npm install
+npm test
+```
+
+然后可以用开发入口启动：
+
+```bash
+npm run sbti
+```
+
+或者：
+
+```bash
+node src/cli.mjs
+```
+
+> 💡 这个项目不需要数据库、浏览器驱动或 `.env` 配置；只要有 Node.js，就能运行发布版 CLI 或仓库内开发入口。
+
+---
+
+## 🧪 如何使用 CLI
+
+### 常用命令
+
+| 命令 | 作用 |
+|---|---|
+| `sbti-cli` | 从 npm 发布包直接开始一次测试 |
+| `sbti-cli --seed 42` | 固定随机种子，方便复现题目顺序 |
+| `sbti-cli --json` | 直接输出 JSON 结果 |
+| `npm run sbti` | 运行仓库内的开发入口 |
+| `npm run export-images` | 在仓库 checkout 里重建 manifest 和本地画廊 |
+
+### 交互方式
+
+运行测试后，CLI 会逐题提问。输入方式和导航规则如下：
+每个答案一旦提交，就会在本轮测试中锁定。
+
+| 输入 | 作用 |
+|---|---|
+| `A / B / C / D` | 选择当前题的选项 |
+| `q` | 中途退出，不提交结果 |
+
+### 一个最常见的流程
+
+```bash
+sbti-cli
+```
+
+```text
+SBTI 人格测试 CLI
+题库来源: bundled:sbti-main.js
+
+第 1 题 / 31 · 维度已隐藏
+...
+
+输入 A/B/C/D 选择，或输入 q 退出。
+> C
+```
+
+## 🧬 核心能力一览
+
+<table>
+<tr>
+  <th>模块</th>
+  <th>能力</th>
+  <th>说明</th>
+</tr>
+<tr>
+  <td><strong>🛟 离线运行时</strong></td>
+  <td>始终直接加载内置快照</td>
+  <td>题目顺序、饮酒隐藏题、打分、匹配、特殊分支都走本地内置的同一套逻辑</td>
+</tr>
+<tr>
+  <td><strong>🖼️ 结果图资源</strong></td>
+  <td>27 张已收录海报可本地整理</td>
+  <td>支持生成 <code>manifest.json</code> 与本地 <code>index.html</code> 画廊</td>
+</tr>
+<tr>
+  <td><strong>🧪 回归测试</strong></td>
+  <td>内置运行时验证</td>
+  <td>包含 50 组结果回归、图片完整性测试与离线运行路径验证</td>
+</tr>
+<tr>
+  <td><strong>📦 原生 npm 发布</strong></td>
+  <td>小型 launcher + 平台 native binary 子包</td>
+  <td>通过 npm 安装时，不再把仓库源码、测试或构建脚本连同可运行 CLI 一起发出去</td>
+</tr>
+</table>
+
+---
+
+## 🎭 结果图与离线资源
+
+这一节是仓库开发资源，不属于发布到 npm 的 CLI 安装面。
+
+<table>
+  <tr>
+    <td align="center" width="33%">
+      <a href="assets/type-images/index.html"><img src="assets/type-images/CTRL.png" width="180"><br><strong>本地结果图画廊</strong></a><br>
+      <sub>27 张海报导出后的可浏览 HTML 页面</sub>
+    </td>
+    <td align="center" width="33%">
+      <a href="assets/type-images/manifest.json"><img src="assets/type-images/BOSS.png" width="180"><br><strong>结果图清单</strong></a><br>
+      <sub>文件名、类型、字节数都收录在 manifest 里</sub>
+    </td>
+    <td align="center" width="33%">
+      <a href="src/bundled-data.mjs"><img src="assets/type-images/SEXY.png" width="180"><br><strong>离线快照</strong></a><br>
+      <sub>每次 CLI 运行都会直接使用的内置题库与结果数据</sub>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="scripts/export-type-images.mjs"><img src="assets/type-images/MALO.png" width="180"><br><strong>图片导出脚本</strong></a><br>
+      <sub>基于仓库内已有图片重建 manifest 和本地画廊</sub>
+    </td>
+    <td align="center">
+      <a href="test/runtime.test.mjs"><img src="assets/type-images/HHHH.png" width="180"><br><strong>对齐测试</strong></a><br>
+      <sub>确保 CLI 的结果分支和内置逻辑保持一致</sub>
+    </td>
+  </tr>
+</table>
+
+### 导出结果图
+
+```bash
+npm run export-images
+```
+
+执行后会生成：
+
+- [`assets/type-images/index.html`](assets/type-images/index.html) — 本地画廊
+- [`assets/type-images/manifest.json`](assets/type-images/manifest.json) — 27 张图片的清单
+- [`assets/type-images/`](assets/type-images/) — 全部解码后的 `.png` / `.jpg` 文件
+
+## 🔬 数据来源与原理
+
+### 为什么能做到和官网行为一致
+
+本仓库把题库和结果逻辑存成 [`src/bundled-data.mjs`](src/bundled-data.mjs) 里的内置快照，再通过 [`src/runtime.mjs`](src/runtime.mjs) 用 Node.js 的 `vm` 模块放进一个很小的 sandbox 里运行。
+
+CLI 不是手写“差不多”的逻辑，而是每次都直接跑这份内置快照里的同一套对象：
+
+| 运行时对象 | 内容 |
+|---|---|
+| `dimensionMeta` | 15 个维度的中文名与模型分组 |
+| `questions` | 30 道常规题 |
+| `specialQuestions` | 饮酒隐藏题与其前置分支 |
+| `TYPE_LIBRARY` | 27 个人格的代号、中文名、开场白、完整描述 |
+| `NORMAL_TYPES` | 25 个标准人格的 H / M / L 模板 |
+| `DIM_EXPLANATIONS` | 15 维 × 3 档的维度文案 |
+| `computeResult()` | 官网自己的结果分支逻辑 |
+
+因此，CLI 可以和官网保持同一套：
+
+- 题目 shuffle
+- 饮酒题插入与隐藏题显示
+- 15 维打分与分档
+- 25 个标准人格匹配排序
+- `DRUNK` 特殊覆盖
+- `HHHH` 低匹配度兜底
+
+### 结果图从哪里来
+
+27 张人物海报已经随仓库一起存放在 [`assets/type-images/`](assets/type-images/) 中。[`scripts/export-type-images.mjs`](scripts/export-type-images.mjs) 负责根据这些本地文件重建 manifest 和本地画廊。
+
+### 本仓库里最关键的文件
+
+- [`src/cli.mjs`](src/cli.mjs) — 命令行交互入口
+- [`src/runtime.mjs`](src/runtime.mjs) — 内置运行时加载、sandbox 运行、结果汇总
+- [`src/bundled-data.mjs`](src/bundled-data.mjs) — CLI 使用的内置快照
+- [`src/type-images.mjs`](src/type-images.mjs) — 图片工具与本地画廊生成
+- [`bin/sbti-cli.cjs`](bin/sbti-cli.cjs) — npm launcher，会解析当前平台对应的 native binary 子包
+- [`lib/platform-package.cjs`](lib/platform-package.cjs) — 支持的平台映射与 native package 解析逻辑
+- [`dist/sbti-cli.cjs`](dist/sbti-cli.cjs) — 用来生成 native binary 的 CommonJS 单文件入口
+- [`scripts/build-dist.mjs`](scripts/build-dist.mjs) — 生成 ESM/CJS 两份单文件 CLI 构建产物
+- [`scripts/build-platform-packages.mjs`](scripts/build-platform-packages.mjs) — 生成各平台预编译 native npm 子包
+- [`scripts/publish-packages.mjs`](scripts/publish-packages.mjs) — 先发布平台子包，再发布根包 `@bingran/sbti-cli`
+- [`scripts/export-type-images.mjs`](scripts/export-type-images.mjs) — 重建结果图 manifest 与画廊
+- [`test/runtime.test.mjs`](test/runtime.test.mjs) — 内置运行时对齐测试
+- [`test/launcher.test.mjs`](test/launcher.test.mjs) — launcher 与 native package 解析测试
+- [`test/package.test.mjs`](test/package.test.mjs) — npm tarball 发布面检查
+- [`test/type-images.test.mjs`](test/type-images.test.mjs) — 图片资源完整性测试
+
+---
+
+## 🙏 鸣谢
+
+<table>
+  <tr>
+    <th>项目</th>
+    <th>作者</th>
+    <th>贡献</th>
+  </tr>
+  <tr>
+    <td><a href="https://sbti.fancc.de5.net"><strong>SBTI 人格测试</strong></a></td>
+    <td>B 站 <a href="https://space.bilibili.com/417038183">@蛆肉儿串儿</a></td>
+    <td>原测试作者，提供题目、27 个人格文案与角色插画</td>
+  </tr>
+  <tr>
+    <td><a href="https://github.com/serenakeyitan/sbti-wiki"><strong>sbti-wiki</strong></a></td>
+    <td><a href="https://github.com/serenakeyitan">@serenakeyitan</a></td>
+    <td>这次 README 改版的版式参考来源：中心 Hero、徽章、图卡与信息分段方式</td>
+  </tr>
+  <tr>
+    <td><strong>sbti-cli</strong></td>
+    <td><a href="https://github.com/bingran-you">Bingran You (@bingran-you)</a></td>
+    <td>把题库快照 sandbox 化，补上离线运行、结果图整理与测试体系，提供一个可直接使用的 CLI</td>
+  </tr>
+</table>
+
+> ⚠️ **仅供娱乐**：原测试首页已经写得很明确了，不要把它当成诊断、面试、相亲、分手、招魂、算命或人生判决书。本仓库也只是一个便于运行、研究和导出资源的工具。
+
+---
+
+## 📄 License
+
+本仓库中由本项目原创的代码与文档采用 [MIT License](LICENSE) 发布。
+
+与此同时，来自上游 SBTI 网站的题目文案、结果文案以及角色插画仍然归原作者所有，并不因为放进这个仓库就自动转成 MIT。具体归属说明见 [NOTICE](NOTICE)。

package/bin/sbti-cli.cjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+const { spawn } = require('node:child_process');
+const process = require('node:process');
+
+const { resolveInstalledBinaryPath } = require('../lib/platform-package.cjs');
+
+let resolvedBinary;
+
+try {
+  resolvedBinary = resolveInstalledBinaryPath((request) => require.resolve(request));
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}
+
+const child = spawn(resolvedBinary.binaryPath, process.argv.slice(2), {
+  stdio: 'inherit'
+});
+
+child.on('error', (error) => {
+  console.error(error.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    console.error(`sbti-cli terminated with signal ${signal}.`);
+    process.exit(1);
+  }
+
+  process.exit(code ?? 0);
+});

package/lib/platform-package.cjs

@@ -0,0 +1,117 @@
+const path = require('node:path');
+
+const SUPPORTED_PLATFORMS = [
+  {
+    id: 'darwin-arm64',
+    platform: 'darwin',
+    arch: 'arm64',
+    packageName: '@bingran/sbti-cli-darwin-arm64',
+    pkgTarget: 'node18-macos-arm64',
+    binaryName: 'sbti-cli'
+  },
+  {
+    id: 'darwin-x64',
+    platform: 'darwin',
+    arch: 'x64',
+    packageName: '@bingran/sbti-cli-darwin-x64',
+    pkgTarget: 'node18-macos-x64',
+    binaryName: 'sbti-cli'
+  },
+  {
+    id: 'linux-arm64',
+    platform: 'linux',
+    arch: 'arm64',
+    packageName: '@bingran/sbti-cli-linux-arm64',
+    pkgTarget: 'node18-linux-arm64',
+    binaryName: 'sbti-cli'
+  },
+  {
+    id: 'linux-x64',
+    platform: 'linux',
+    arch: 'x64',
+    packageName: '@bingran/sbti-cli-linux-x64',
+    pkgTarget: 'node18-linux-x64',
+    binaryName: 'sbti-cli'
+  },
+  {
+    id: 'win32-x64',
+    platform: 'win32',
+    arch: 'x64',
+    packageName: '@bingran/sbti-cli-win32-x64',
+    pkgTarget: 'node18-win-x64',
+    binaryName: 'sbti-cli.exe'
+  }
+];
+
+function formatSupportedPlatforms() {
+  return SUPPORTED_PLATFORMS.map(
+    ({ platform, arch, packageName }) => `- ${platform}/${arch}: ${packageName}`
+  ).join('\n');
+}
+
+function getPlatformPackageInfo(platform, arch) {
+  return (
+    SUPPORTED_PLATFORMS.find(
+      (entry) => entry.platform === platform && entry.arch === arch
+    ) ?? null
+  );
+}
+
+function getCurrentPlatformPackageInfo() {
+  return getPlatformPackageInfo(process.platform, process.arch);
+}
+
+function getBinaryPath(packageRoot, platformInfo) {
+  if (!platformInfo) {
+    throw new Error('A supported platform package definition is required.');
+  }
+
+  return path.join(packageRoot, 'bin', platformInfo.binaryName);
+}
+
+function resolveInstalledBinaryPath(
+  resolveRequest,
+  platform = process.platform,
+  arch = process.arch
+) {
+  if (typeof resolveRequest !== 'function') {
+    throw new TypeError('resolveRequest must be a function.');
+  }
+
+  const platformInfo = getPlatformPackageInfo(platform, arch);
+
+  if (!platformInfo) {
+    throw new Error(
+      `Unsupported platform ${platform}/${arch}.\nSupported native packages:\n${formatSupportedPlatforms()}`
+    );
+  }
+
+  let packageJsonPath;
+
+  try {
+    packageJsonPath = resolveRequest(`${platformInfo.packageName}/package.json`);
+  } catch (error) {
+    if (error?.code === 'MODULE_NOT_FOUND') {
+      throw new Error(
+        `Missing native binary package ${platformInfo.packageName} for ${platform}/${arch}. ` +
+          'Reinstall @bingran/sbti-cli without omitting optional dependencies.'
+      );
+    }
+
+    throw error;
+  }
+
+  return {
+    platformInfo,
+    binaryPath: getBinaryPath(path.dirname(packageJsonPath), platformInfo)
+  };
+}
+
+module.exports = {
+  SUPPORTED_PLATFORMS,
+  formatSupportedPlatforms,
+  getBinaryPath,
+  getCurrentPlatformPackageInfo,
+  getPlatformPackageInfo,
+  resolveInstalledBinaryPath
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@bingran/sbti-cli",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Native-binary CLI runner for the public SBTI survey.",
+  "license": "MIT",
+  "homepage": "https://github.com/bingran-you/sbti-cli",
+  "bugs": {
+    "url": "https://github.com/bingran-you/sbti-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bingran-you/sbti-cli.git"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "bin": {
+    "sbti-cli": "./bin/sbti-cli.cjs"
+  },
+  "optionalDependencies": {
+    "@bingran/sbti-cli-darwin-arm64": "0.1.0",
+    "@bingran/sbti-cli-darwin-x64": "0.1.0",
+    "@bingran/sbti-cli-linux-arm64": "0.1.0",
+    "@bingran/sbti-cli-linux-x64": "0.1.0",
+    "@bingran/sbti-cli-win32-x64": "0.1.0"
+  },
+  "scripts": {
+    "build:dist": "node scripts/build-dist.mjs",
+    "build:platform-packages": "node scripts/build-platform-packages.mjs",
+    "publish:packages": "node scripts/publish-packages.mjs",
+    "start": "node src/cli.mjs",
+    "sbti": "node src/cli.mjs",
+    "export-images": "node scripts/export-type-images.mjs",
+    "test": "node --test test/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}