xshat-lite 1.0.0

package/README.md

@@ -0,0 +1,211 @@
+# XShat
+
+一个基于浏览器自动化的命令行 AI 聊天工具。
+
+它的核心抽象只有四步：
+
+1. 输入
+2. 发送
+3. 读取
+4. 完成
+
+也就是说，想适配新网站时，重点不是改主流程，而是给这个网站补一份四步配置。
+
+## 当前内置站点
+
+- Duck.ai
+- HuggingChat
+- DeepAI Chat
+- Qwen
+- You.com
+- Microsoft Copilot
+- ChatGPT
+- Gemini
+
+其中前四个更偏向免登录或可直接访问；后两个是否能直接使用，取决于地区、配额和站点当时策略。
+
+## 安装
+
+```bash
+npm install
+```
+
+全局安装：
+
+```bash
+npm install -g xshat-lite
+```
+
+本地调试全局命令：
+
+```bash
+npm link
+```
+
+如果你是在当前项目目录里本地试装，也可以：
+
+```bash
+npm install -g .
+```
+
+## 运行
+
+```bash
+xshat
+```
+
+开发模式：
+
+```bash
+npm run dev
+```
+
+调试模式：
+
+```bash
+XSHAT_DEBUG=true npm start
+```
+
+如果你还没有全局安装，也可以继续用：
+
+```bash
+npm start
+```
+
+## 配置
+
+创建 `.env`：
+
+```env
+DEFAULT_PROVIDER=gemini
+BROWSER_HEADLESS=true
+USER_DATA_DIR=./runtime/profiles/my-profile
+SESSION_DIR=./runtime/sessions
+LOG_DIR=./runtime/logs
+```
+
+全局命令模式下，运行时数据默认写入：
+
+- Windows: `%LOCALAPPDATA%\\xshat`
+- macOS / Linux: `~/.xshat`
+
+其中会包含：
+
+- `runtime/profiles`
+- `runtime/sessions`
+- `runtime/logs`
+
+也可以自己指定：
+
+```bash
+XSHAT_HOME=D:\\my-xshat xshat
+```
+
+## 如何扩展新网站
+
+在 [src/config/default.mjs](/d:/node/example/xshat/src/config/default.mjs) 里新增一个 provider。
+
+结构大致是：
+
+```js
+{
+  id: 'mychat',
+  name: 'My Chat',
+  url: 'https://example.com/chat',
+  steps: {
+    input: {
+      selectors: ['textarea', '[contenteditable="true"]']
+    },
+    send: {
+      selectors: ['button[type="submit"]', 'button[aria-label*="Send"]']
+    },
+    read: {
+      selectors: ['.assistant-message', '.message.bot']
+    },
+    complete: {
+      mode: 'script',
+      script: '...',
+      selectors: {
+        response: ['.assistant-message', '.message.bot'],
+        pending: ['.streaming', '.loading'],
+        done: ['.copy-button', '.finished']
+      }
+    }
+  }
+}
+```
+
+## 四步说明
+
+`input`
+
+- 找输入框
+- 点击并聚焦
+- 清空旧内容
+- 粘贴消息
+
+`send`
+
+- 找发送按钮点击
+- 如果没配到按钮，退回 `Enter`
+
+`read`
+
+- 定义“助手回复节点”的候选选择器
+
+`complete`
+
+- 判断是否还在生成
+- 判断是否已经完成
+- 返回当前累计文本
+
+## 调试命令
+
+聊天时可输入：
+
+- `/inspect`：打印当前网站命中的输入框、发送按钮、读取节点和完成状态
+- `/config`：打开系统设置并调整默认提供方
+- `/model`：打开系统设置中的提供方配置
+- `/menu`：返回主菜单
+
+逐 provider smoke：
+
+```bash
+SMOKE_PROVIDER=gemini node --env-file=.env scripts/provider-smoke.mjs
+```
+
+多轮 smoke：
+
+```bash
+SMOKE_PROVIDER=gemini SMOKE_PROMPTS="你好，请只回复1|继续，只回复2" node --env-file=.env scripts/provider-smoke.mjs
+```
+
+导出调试产物（HTML、截图、结果 JSON）：
+
+```bash
+SMOKE_PROVIDER=gemini SMOKE_SAVE_ARTIFACTS=true node --env-file=.env scripts/provider-smoke.mjs
+```
+
+## 项目结构
+
+```text
+src/
+  config/
+    default.mjs
+  modules/
+    browser.mjs
+    chat.mjs
+    logger.mjs
+    session.mjs
+    ui.mjs
+  utils/
+    config.mjs
+  index.mjs
+```
+
+## 备注
+
+- 不同网站 DOM 变动很频繁，所以选择器最好准备多个候选。
+- 某些网站首页可打开，但真正发送消息时仍可能弹登录、限流或地区限制。
+- 当前这套架构已经支持继续扩站，后续新增网站通常只需要补配置，不需要改主循环。
+- 发布 npm 包时，运行时数据目录不会被一起打包。

package/bin/xshat.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import process from 'node:process';
+import dotenv from 'dotenv';
+
+function getDefaultAppHome() {
+  if (process.platform === 'win32') {
+    const base = process.env.LOCALAPPDATA || process.env.APPDATA || homedir();
+    return resolve(base, 'xshat');
+  }
+
+  return resolve(homedir(), '.xshat');
+}
+
+function loadEnvFile(path, override = false) {
+  if (!existsSync(path)) {
+    return;
+  }
+
+  dotenv.config({
+    path,
+    override
+  });
+}
+
+if (!process.env.XSHAT_HOME) {
+  process.env.XSHAT_HOME = getDefaultAppHome();
+}
+
+loadEnvFile(resolve(process.env.XSHAT_HOME, '.env'));
+loadEnvFile(resolve(process.cwd(), '.env'), true);
+
+await import('../src/index.mjs');

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "xshat-lite",
+  "version": "1.0.0",
+  "description": "CLI chat and agent tool powered by free AI web providers",
+  "type": "module",
+  "main": "src/index.mjs",
+  "bin": {
+    "xshat": "./bin/xshat.mjs"
+  },
+  "files": [
+    "bin",
+    "src/config",
+    "src/modules",
+    "src/utils",
+    "src/index.mjs",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node ./bin/xshat.mjs",
+    "dev": "node --watch ./bin/xshat.mjs",
+    "lint": "eslint \"src/**/*.mjs\" \"test/**/*.mjs\"",
+    "test": "node --test",
+    "check": "node --check ./bin/xshat.mjs && node --check ./src/index.mjs && node --check ./src/utils/config.mjs",
+    "prepublishOnly": "npm run check && npm test && npm pack --dry-run",
+    "format": "prettier --write \"src/**/*.mjs\" \"test/**/*.mjs\"",
+    "format:check": "prettier --check \"src/**/*.mjs\" \"test/**/*.mjs\""
+  },
+  "keywords": [
+    "chat",
+    "ai",
+    "cli",
+    "agent",
+    "browser-automation",
+    "gemini",
+    "chatgpt",
+    "duckai",
+    "web-ai"
+  ],
+  "author": "",
+  "license": "ISC",
+  "preferGlobal": true,
+  "dependencies": {
+    "@inquirer/prompts": "^8.5.2",
+    "cli-table3": "^0.6.5",
+    "cloakbrowser": "^0.4.10",
+    "dotenv": "^16.4.5",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "ora": "^9.4.1",
+    "string-width": "^8.2.1",
+    "yoctocolors": "^2.1.2"
+  },
+  "devDependencies": {
+    "eslint": "^9.0.0",
+    "prettier": "^3.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}