open-index/open-npm huggingface dataset:
npm package: @miaz/poisun
Description: Typescript REST API wrapper for SpaceTradersAPI game
Author: Ryan
Latest version: 0.1.0

# <p align="center"> PoisuN

<p align="center">
An all-purpose API wrapper for the SpaceTraders REST API written in Typescript.

---

<p align="center">
<img src="./.gitfiles/poisunsplash.png">

---

## <p align="center"> [Documentation can be found here](https://mia-z.github.io/poisuN/modules.html)

---
npm package: @mibatt/dietu
Description: Dietu CLI - 独立 npm 分发的云端 API 客户端
Latest version: 0.1.0

# Dietu CLI

独立 npm 分发的 Dietu 命令行客户端。

它只通过 HTTP 与云端 Dietu Web/API 交互，不依赖本地 Python 运行时或数据库。

## 安装

已发布版本可通过 npm registry 安装：

```bash
npm i -g @mibatt/dietu@latest
```

如果你正在这个仓库里本地联调，先不要执行 `bun install -g @dietu/cli`。当前 CLI 的 npm 包名是 `@mibatt/dietu`，且只有真正发布到 npm registry 后，全局安装命令才会成功。

本地试用建议这样做：

```bash
cd cli
npm install
npm link
dietu --help
```

## 示例

```bash
dietu auth login
dietu auth status
dietu market overview
dietu market stock 600519.SH
dietu research strategy list
dietu research strategy screen white_horse_undervalued --top 10
dietu decision plan --account 1
dietu review executions --limit 20
dietu schema
dietu doctor
```

## 认证

默认的人类交互式登录入口：

```bash
dietu auth login
```

CLI 会显示 GitHub device flow 的验证地址和一次性 code，并尽量自动打开浏览器。你在浏览器里完成授权后，CLI 会自动把 token 写入本地 profile。

自动化、Agent 或 CI 场景建议直接提供 token：

```bash
dietu market overview --token "$DIETU_ACCESS_TOKEN"
DIETU_ACCESS_TOKEN=xxx dietu auth status
```

推荐做法是把后台 `Settings / Access Tokens` 页面创建的 PAT 放进 `DIETU_ACCESS_TOKEN`。不要把浏览器登录态或本地 profile 里的短期 JWT 当成长期环境变量分发。

兼容模式仍保留账号密码登录：

```bash
dietu auth login --email you@example.com --password '***'
```

但这条路径主要用于过渡和受控环境，不再是推荐主入口。

## 配置优先级

1. 命令行参数
2. 环境变量
3. profile 配置文件
4. 默认值

支持的关键环境变量：

- `DIETU_BASE_URL`
- `DIETU_PROFILE`
- `DIETU_OUTPUT`
- `DIETU_ACCESS_TOKEN`
- `DIETU_CONFIG_DIR`

## 维护发布

发布 `@mibatt/dietu` 时，建议按下面流程执行：

```bash
cd cli
npm version patch --no-git-tag-version
npm run release:check
```

然后在 GitHub Actions 手动触发 `CLI Publish` workflow。

发布前提：

- 仓库 Actions Secrets 已配置 `NPM_TOKEN`
- `cli/package.json` 中的版本号尚未发布到 npm
- 当前分支已经包含待发布提交

workflow 会在 `cli/` 子目录内执行 `npm ci`、`npm run release:check`，通过后再发布到 npm registry。