u1s1-cli 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# u1s1 — 有一说一,最省心的 AI 编程搭子
+
+在终端里用中文说需求,AI 帮你读文件、改代码、跑命令。不用买模型、不用配 API、不用懂那些名词,注册就送**每月 $2 免费额度**(普通人根本用不完)。
+
+## 三步开始
+
+```bash
+# 1. 安装(需要 Node.js 20+)
+npm i -g u1s1-cli
+
+# 2. 第一次运行会引导你去 u1s1.io 注册领 Key(30 秒,不用绑卡)
+u1s1
+
+# 3. 进到你的项目文件夹,像发微信一样说需求
+cd 我的项目
+u1s1
+```
+
+## 常用命令
+
+| 命令 | 作用 |
+|---|---|
+| `u1s1` | 进入交互模式,直接开聊 |
+| `u1s1 -p "把 README 里的错别字修一下"` | 一句话模式,干完就退出 |
+| `u1s1 usage` | 看本月额度用了多少 |
+| `u1s1 login` / `u1s1 logout` | 登录 / 退出 |
+
+## 有一说一
+
+- **背后模型**:DeepSeek V4 Flash,1M 超长上下文,写代码很能打,成本只有大牌模型的约 1/50。
+- **怎么收费**:额度按 API 实际成本扣,不加价;每月 1 号自动重置。
+- **额度不够**:邀请朋友,你俩各得 $1 加量,永不过期 → [u1s1.io/dashboard](https://u1s1.io/dashboard)
+- **内核**:基于开源的 [pi](https://pi.dev) coding agent,会话管理、斜杠命令、皮肤等能力全都有。
+
+官网:[u1s1.io](https://u1s1.io)

package/dist/api.js

@@ -0,0 +1,18 @@
+export async function fetchMe(cfg) {
+    if (!cfg.apiKey)
+        throw new Error("没有配置 API Key");
+    let resp;
+    try {
+        resp = await fetch(`${cfg.baseUrl}/me`, {
+            headers: { authorization: `Bearer ${cfg.apiKey}` },
+        });
+    }
+    catch {
+        throw new Error(`连不上 ${cfg.baseUrl},检查一下网络?`);
+    }
+    if (resp.status === 401)
+        throw new Error("这把 Key 不对或已失效,去 https://u1s1.io/dashboard 看看");
+    if (!resp.ok)
+        throw new Error(`服务端返回 ${resp.status},稍后再试`);
+    return (await resp.json());
+}

package/dist/config.js

@@ -0,0 +1,30 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const DEFAULT_BASE_URL = "https://api.u1s1.io/v1";
+export const MODEL_ID = "deepseek/deepseek-v4-flash";
+export const PROVIDER_ID = "u1s1";
+export const u1s1Dir = join(homedir(), ".u1s1");
+const configFile = join(u1s1Dir, "config.json");
+/** pi keeps auth/models/settings/sessions under this dir — isolated from any real pi install. */
+export const agentDir = join(u1s1Dir, "agent");
+export function loadConfig() {
+    let file = {};
+    if (existsSync(configFile)) {
+        try {
+            file = JSON.parse(readFileSync(configFile, "utf8"));
+        }
+        catch {
+            // corrupted config falls back to defaults; login rewrites it
+        }
+    }
+    return {
+        apiKey: process.env["U1S1_API_KEY"] || file.apiKey,
+        baseUrl: process.env["U1S1_BASE_URL"] || file.baseUrl || DEFAULT_BASE_URL,
+    };
+}
+export function saveConfig(cfg) {
+    mkdirSync(u1s1Dir, { recursive: true, mode: 0o700 });
+    writeFileSync(configFile, JSON.stringify(cfg, null, 2) + "\n");
+    chmodSync(configFile, 0o600);
+}

package/dist/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createRequire } from "node:module";
+import { agentDir, loadConfig, MODEL_ID, PROVIDER_ID } from "./config.js";
+const require = createRequire(import.meta.url);
+const VERSION = require("../package.json").version;
+const BRAND_APPEND = `## u1s1
+
+你运行在 u1s1(有一说一)里 —— 一个面向编程新手的中文 AI 编程助手。用户很可能不熟悉编程术语:
+- 默认用中文回复;代码、命令、报错原文保持英文。
+- 解释问题时说人话,别堆术语;必要时用一句话打比方。
+- 改动前先说明打算做什么,改完用一两句话总结改了哪里。
+- 用户描述模糊时,先猜最可能的意图并确认,不要长篇追问。
+`;
+/** pi auto-appends <agentDir>/APPEND_SYSTEM.md to its system prompt — our branding hook. */
+function ensureBrandPrompt() {
+    mkdirSync(agentDir, { recursive: true });
+    const p = join(agentDir, "APPEND_SYSTEM.md");
+    if (!existsSync(p) || readFileSync(p, "utf8") !== BRAND_APPEND) {
+        writeFileSync(p, BRAND_APPEND);
+    }
+}
+async function runAgent(cfg, args) {
+    ensureBrandPrompt();
+    // must be set before pi reads them (getAgentDir() reads at call time, env at import is fine too)
+    process.env["PI_CODING_AGENT_DIR"] = agentDir;
+    process.env["U1S1_API_KEY"] = cfg.apiKey;
+    const { main } = await import("@earendil-works/pi-coding-agent");
+    const extension = [
+        {
+            name: "u1s1",
+            factory: (pi) => {
+                pi.registerProvider(PROVIDER_ID, {
+                    name: "u1s1",
+                    baseUrl: cfg.baseUrl,
+                    api: "openai-completions",
+                    apiKey: "$U1S1_API_KEY",
+                    models: [
+                        {
+                            id: MODEL_ID,
+                            name: "DeepSeek V4 Flash (u1s1)",
+                            reasoning: false,
+                            input: ["text"],
+                            cost: { input: 0.14, output: 0.28, cacheRead: 0, cacheWrite: 0 },
+                            contextWindow: 1_048_576,
+                            maxTokens: 65_536,
+                        },
+                    ],
+                });
+            },
+        },
+    ];
+    const hasModelArg = args.some((a) => a === "--model" || a.startsWith("--model=") || a === "--provider");
+    const finalArgs = hasModelArg ? args : ["--model", `${PROVIDER_ID}/${MODEL_ID}`, ...args];
+    await main(finalArgs, { extensionFactories: extension });
+}
+async function run() {
+    const args = process.argv.slice(2);
+    const cmd = args[0];
+    if (cmd === "--version" || cmd === "-v") {
+        console.log(`u1s1 v${VERSION}`);
+        return;
+    }
+    if (cmd === "login") {
+        const { login } = await import("./login.js");
+        await login(args[1]);
+        return;
+    }
+    if (cmd === "usage") {
+        const { usage } = await import("./usage.js");
+        await usage();
+        return;
+    }
+    if (cmd === "logout") {
+        const { saveConfig } = await import("./config.js");
+        saveConfig({ ...loadConfig(), apiKey: undefined });
+        console.log("已退出登录。");
+        return;
+    }
+    const { ensureAuth } = await import("./login.js");
+    const cfg = await ensureAuth();
+    await runAgent(cfg, args);
+}
+run().catch((e) => {
+    console.error(e instanceof Error ? e.message : e);
+    process.exit(1);
+});

package/dist/login.js

@@ -0,0 +1,46 @@
+import { createInterface } from "node:readline/promises";
+import { fetchMe } from "./api.js";
+import { loadConfig, saveConfig } from "./config.js";
+const DASHBOARD_URL = "https://u1s1.io/dashboard";
+function tryOpenBrowser(url) {
+    import("node:child_process")
+        .then(({ spawn }) => {
+        const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+        spawn(cmd, [url], { detached: true, stdio: "ignore" }).on("error", () => { }).unref();
+    })
+        .catch(() => { });
+}
+export async function login(keyArg) {
+    const cfg = loadConfig();
+    let key = keyArg?.trim();
+    if (!key) {
+        console.log("");
+        console.log("  u1s1 需要一把 API Key(免费):");
+        console.log(`  1. 打开 ${DASHBOARD_URL} 注册/登录(30 秒,送每月 $2 额度)`);
+        console.log("  2. 复制你的 API Key,粘贴到下面");
+        console.log("");
+        tryOpenBrowser(DASHBOARD_URL);
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        key = (await rl.question("  粘贴 API Key: ")).trim();
+        rl.close();
+    }
+    if (!key.startsWith("u1s1-")) {
+        console.error("  这不像一把 u1s1 的 Key(应该以 u1s1- 开头),再看看?");
+        process.exit(1);
+    }
+    const next = { ...cfg, apiKey: key };
+    const me = await fetchMe(next).catch((e) => {
+        console.error(`  验证失败:${e.message}`);
+        process.exit(1);
+    });
+    saveConfig(next);
+    console.log(`  ✓ 登录成功${me.email ? `(${me.email})` : ""},本月还剩 $${me.remaining_usd} 额度。`);
+    return next;
+}
+/** Returns a config that definitely has an apiKey, prompting the user if needed. */
+export async function ensureAuth() {
+    const cfg = loadConfig();
+    if (cfg.apiKey)
+        return cfg;
+    return login();
+}

package/dist/usage.js

@@ -0,0 +1,28 @@
+import { fetchMe } from "./api.js";
+import { loadConfig } from "./config.js";
+function bar(ratio, width = 24) {
+    const filled = Math.round(Math.max(0, Math.min(1, ratio)) * width);
+    return "█".repeat(filled) + "░".repeat(width - filled);
+}
+export async function usage() {
+    const cfg = loadConfig();
+    if (!cfg.apiKey) {
+        console.error("还没登录,先跑 u1s1 login");
+        process.exit(1);
+    }
+    const me = await fetchMe(cfg).catch((e) => {
+        console.error(e.message);
+        process.exit(1);
+    });
+    const total = me.monthly_free_usd + me.bonus_balance_usd;
+    const remainRatio = total > 0 ? me.remaining_usd / total : 0;
+    console.log("");
+    console.log(`  账号     ${me.email ?? "(未绑定邮箱)"}`);
+    console.log(`  本月已用 $${me.mtd_usd}`);
+    console.log(`  剩余额度 $${me.remaining_usd}  ${bar(remainRatio)}`);
+    if (me.bonus_balance_usd > 0)
+        console.log(`  其中加量 $${me.bonus_balance_usd}(邀请所得,不过期)`);
+    console.log("");
+    console.log("  邀请朋友双方各得加量 → https://u1s1.io/dashboard");
+    console.log("");
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "u1s1-cli",
+  "version": "0.1.0",
+  "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
+  "type": "module",
+  "bin": {
+    "u1s1": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "coding-agent",
+    "deepseek",
+    "u1s1"
+  ],
+  "license": "MIT",
+  "homepage": "https://u1s1.io",
+  "dependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2",
+    "tsx": "^4.20.0",
+    "@types/node": "^22.15.0"
+  }
+}