open-index/open-npm huggingface dataset:
npm package: @kepler.io/sample-tool-1
Description: This is a sample project for 3rd party clients to the Kepler.
Latest version: 0.0.3


# Kepler sample client  

This is a sample project for 3rd party clients to the Kepler.

## Run

`yarn start` and open http://localhost:8080 

## Build

`yarn build`

## Dependencies

`yarn`

- @kepler-io/core-react
- @fluentui
npm package: @keploreai/physmind
Description: PhysMind AI coding assistant CLI — powered by Claude
Latest version: 1.0.6



### 环境要求

一定要最新版本的 bun 啊, 不然一堆奇奇怪怪的 BUG!!! bun upgrade!!!

- [Bun](https://bun.sh/) >= 1.3.11
- Node.js >= 18（部分依赖需要）
- 有效的 Anthropic API Key（或 Bedrock / Vertex 凭据）

### 安装

```bash
bun install
```

### 运行

```bash
# 开发模式, 看到版本号 888 说明就是对了
bun run dev

# 直接运行
bun run src/entrypoints/cli.tsx

# 管道模式（-p）
echo "say hello" | bun run src/entrypoints/cli.tsx -p

# 构建
bun run build
```

构建产物输出到 `dist/cli.js`（~25.75 MB，5326 模块）。

---

## PhysMind / KeploreAI 模式

启动后选择模型后端：

```
Select model backend:
  1  Claude  (Anthropic)     — 使用用户自己的 Anthropic API key / 账号
  2  PhysMind  (KeploreAI)   — 通过 KeploreAI 代理访问 Claude，需要 kplr- token
```

选择 `2` 后输入 `kplr-xxx` token，首次输入后自动保存至 `~/.claude/.physmind_key`，下次启动无需重复输入。

### Cloudflare 代理管理后台

访问 `https://physmind-proxy.marvin-gao-cs.workers.dev/admin`，功能：

- 创建 / 吊销 kplr- token
- 查看每个 token 的调用次数、输入/输出 token 数、最近调用时间
- 复制任意 token
- 为每个 token 指定 Claude 模型版本

部署代理：

```bash
cd cloudflare-worker
npx wrangler secret put ANTHROPIC_API_KEY   # 首次设置
npx wrangler secret put ADMIN_PASSWORD       # 首次设置
npx wrangler deploy
```

---

## TODO

- [ ] **token 管理后台的模型选择目前功能是无效的，需要补充好** — 下拉框已展示，但代理层 model 覆盖逻辑需进一步验证和完善
- [ ] 支持用量限额：每个 token 设置每日/每月最大调用次数或 token 上限
- [ ] 管理后台支持查看每个 token 的详细调用日志
- [ ] 支持多用户，token 与用户身份绑定