# Ai征服者 · 使用说明

> 兼容 DeepSeek Harness 插件体系的智能工作台
> 模型接入 · 屏幕识别与控制 · 远程工作台 · aizfz.xyz 账号 · 插件商场

---

## 一、Windows 版运行方式

1. 解压 `Ai征服者-Windows-x64.zip` 到任意目录（建议非 C 盘，如 `D:\Ai征服者`）。
2. 双击 **`Ai征服者.exe`** 即可启动，工作台窗口会自动打开。
3. 启动后窗口顶部即显示本机工作台地址（形如 `http://192.168.x.x:8765`），手机连同一 WiFi 即可远程访问。

> 首次启动 Windows 可能弹出防火墙提示，请选择「允许访问」，否则手机无法远程连接。
> 无需安装 Node.js 或 Python，所有依赖已内置。

## 二、安卓 App 安装与使用

1. 将 `Ai征服者-安卓版.apk` 传到手机安装（需允许「安装未知来源应用」）。
2. 打开 App，两种连接方式任选：
   - **👤 账号远程（公网，推荐）**：电脑端「远程工作台」页开启「☁ 账号云端接入」后，会显示 **6 位访问 PIN**；在 App 输入 aizfz **用户名 + PIN** → 「查找我的电脑」→ 一键远程连接。**无需同一 WiFi、无需输 IP，可跨互联网远程。**
   - **🔗 直接地址**：输入电脑端显示的局域网地址（如 `http://192.168.1.100:8765`）。
3. 连接后即进入**远程工作台**：可看到电脑实时画面，点击画面 = 移动/点击鼠标，支持右键、双击、滚轮、发送文字与按键（回车 / Esc / Win）。二次启动自动记住账号与地址。

## 二·一、账号云端远程（公网）原理与安全

- 电脑端开启云端接入后，软件自动启动 **Cloudflare 快速隧道**（免注册）获得公网 https 地址；
- 同时把「公网地址 + PIN」以你的 **aizfz 用户名** 发布到公共 MQTT 信令频道（主题 `aic/remote/v1/<用户名>`）；
- 手机端凭「用户名 + PIN」从信令频道取得地址后直连；**不知道 PIN 的人即使知道用户名也无法连接**；
- 云端模式开启期间，工作台全部 API 与 WebSocket 均要求 PIN 校验（局域网直连不受影响）；
- 首次开启会自动下载 cloudflared（约 17MB，仅一次）。隧道地址每次重启会变化，PIN 也会重新生成——App 里重新「查找我的电脑」即可。

## 三、核心功能

| 功能 | 说明 |
|---|---|
| **模型接入** | 默认预置 aizfz.xyz 网关（`https://aizfz.xyz/v1`，OpenAI 协议全兼容）。在「模型接入」页粘贴 sk- 开头的 Key 即可，支持流式对话与函数调用 |
| **aizfz 账号** | 「aizfz 账号」页直接登录，查看余额（¥）、累计消费、调用次数、令牌列表，并可购买套餐（不破甲日卡 ¥5 / 周卡 ¥40 / 月卡 ¥110 / 按量计费充值） |
| **屏幕智能体** | 「屏幕智能体」页输入目标（如“打开记事本输入你好”），视觉模型自动识别屏幕内容并循环执行鼠标/键盘操作，实时输出思考与动作日志 |
| **联网搜索** | 对话中内置联网搜索工具，问实时问题时模型自动检索并引用结果 |
| **插件商场** | 每次打开自动采集全网插件（npm·cordis/dsh 关键字 + GitHub topic + 精选索引），兼容 **DeepSeek Harness（cordis/dsh）插件**；点击「⬇ 安装」自动下载并启用 |
| **皮肤背景插件** | 内置 3 款皮肤（霓虹之夜 / 落日余晖 / 星穹桌面），在商场一键安装立即换肤；任何带 `ui.css` 的插件都会被自动加载 |
| **远程工作台** | 局域网直连（`http://电脑IP:8765`）或 **账号云端远程**（跨公网，用户名+PIN 查找电脑），手机 App 或浏览器均可远程查看并操控电脑 |

## 四、快速上手三步

1. **登录**：左侧「aizfz 账号」→ 登录（没有账号可点「注册账号」，注册后在网页控制台「令牌」新建一个 sk- Key）。
2. **配 Key**：「模型接入」页粘贴 sk- Key → 保存 → 测试连接。
3. **开用**：「对话」直接问（支持联网）；「屏幕智能体」让它操控电脑；「插件商场」装皮肤和插件。

## 五、插件开发/兼容说明

- **本格式**：插件文件夹含 `manifest.json`：
  ```json
  {
    "name": "my-plugin",
    "version": "1.0.0",
    "capabilities": ["ui", "tool"],
    "ui": { "css": "theme.css", "js": "client.js" },
    "tools": [{ "name": "my_tool", "description": "...", "handler": "myTool" }]
  }
  ```
- **DeepSeek Harness / cordis 兼容**：直接兼容含 `package.json`（main 入口 + `apply(ctx)` 导出）的 cordis/dsh 插件包；内核提供 `ctx.on / ctx.emit / ctx.registerTool / ctx.registerService / ctx.logger` 等 Cordis 风格 API。商场采集到的 npm/GitHub dsh 插件可一键安装。
- 插件安装位置：`resources/app/plugins/<插件名>/`（Windows 版在解压目录内）。

## 六、常见问题

- **手机连不上电脑**：检查防火墙放行 8765 端口、两设备同一 WiFi、电脑端已运行。
- **屏幕智能体无动作**：需在「模型接入」配置**视觉模型**（默认 `gemini-2.5-pro`，aizfz 在售）。
- **套餐购买接口未开放直连**：软件会自动弹出网页购买页，购买后余额即时同步。
- **修改端口**：编辑 `resources/app/data/config.json` → `server.port`，重启软件。

## 七、源码

`源码.zip` 为完整源码（Node.js，核心依赖仅 ws 一个包）：
- `server/` 服务器、插件内核、aizfz 客户端、屏幕驱动、屏幕智能体、插件商场
- `public/` 工作台前端（PC 与手机远程共用）
- `builtin-plugins/` 内置皮肤插件
- `main.js` Electron 桌面壳

源码可直接 `node server/index.js` 运行（跨平台）。