chore: add docs and update .gitignore with dev tool exclusions

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

.gitignore

@@ -84,3 +84,7 @@ playground/
 # ClawX-biz bridge workspace artifacts
 resources/enterprise-skills/
 resources/openclaw-plugins/skillshub/
+
+# Dev tools
+dev.bat
+.playwright-cli/

docs/原始需求.txt

@@ -0,0 +1,19 @@
+ 一、基本信息
+
+  1、自动安装，安装完成之后在“桌面”和“程序”都有带89logo的图标
+  2、打开程序之后界面整洁，先找一个合适的模版，做出来以后，让图形设计师根据1.0的功能需要再进行界面设计。
+  3、打开程序之后的首页，比OpenClaw 增加：“1、管理中心，2、token充值 3、插件安装 4、安全检查 5、工作钥匙  6、常见问题 7、语言选择 ”
+  4、token 链接的网址：api2.is89.com:898902 【备注：api2.is89.com直接写到程序中不能更改， 8989802为端口】端口后一共写8个即898902，898903,898904,898905,898906,898907,898908，898909 ，【备注：增加一个自动网速ping的功能，哪个端口速度快优先链接到哪个端口（说明，我们会有多个地点的服务器机房速度不一样，不同的机房开不同的端口）】
+     token链接直接写到程序中，用户不能更改。
+ 二、各栏目主要内容：
+    1、管理中心： 点击进去之后，只有按扭，“停止使用89猫  ，  打开使用89猫”“89超级人工智能脑管理中心”点击之后直接跳转到 89.is89.com 这个网址，（为了让用户感觉到个人隐私受到保护，所以管理中心不放在本地）
+    2、token充值：点击之后转到 89.is89.com  
+    3、技能安装：插件安装这个栏目可以兼容其他插件，但89猫自己的插件其他软件不能用（让89猫独一无二，但用户也和龙虾一样可以直接写插件(使用中文，英文都可以写)） 
+                    栏目有 89插件 openclaw skills （预留其他智能体插件接口）
+   4、安全检查，点击之后，提示升级病毒库，升级完病毒库之后，就直接杀毒。现在写出来。
+   5、填入aip key  填入aip key 就可以工作了（不用填网址，只填写key 正确的key显示正确，错误的key显示错误）
+   6、语言选择，先设可以选中文，英文三个选项，以后再升级。选择以后操作界面变成所选择的语言文字。
+
+
+
+ 

docs/验证报告.md

@@ -0,0 +1,131 @@
+# 89猫 原始需求验证报告
+
+> 对照 `docs/原始需求.txt`，逐条验证实现状态。验证方式：CDP（Chrome DevTools Protocol）实时连接 Electron 应用。
+
+---
+
+## 一、基本信息
+
+### 1. 自动安装，桌面和程序带89logo图标
+
+| 状态 | 说明 |
+|:---:|------|
+| ⚠️ 待验证 | `electron-builder.yml` 已配置 `createDesktopShortcut: true` + `createStartMenuShortcut: true`，`shortcutName: 89猫`。需执行 `pnpm package:win` 打包后验证。图标需设计师提供。 |
+
+### 2. 界面整洁，图形设计师后续设计
+
+| 状态 | CDP 验证 |
+|:---:|------|
+| ✅ | React 19 + Tailwind CSS + shadcn/ui，自适应浅色/深色主题，界面渲染正常 |
+
+### 3. 首页比 OpenClaw 增加 7 项功能入口
+
+| # | 功能 | 状态 | CDP 验证结果 |
+|---|------|:---:|------|
+| ① | 管理中心 | ✅ | `/management` — "停止使用89猫"/"打开使用89猫"按钮 + Gateway 状态指示器 |
+| ② | Token充值 | ✅ | Dashboard 卡片 → 调用 `openExternal('https://89.is89.com')` |
+| ③ | 插件安装 | ✅ | `/skills` — 4 个分类 Tab：全部 / 89插件 / OpenClaw技能 / 其他插件 |
+| ④ | 安全检查 | ✅ | `/security` — 病毒库版本显示 + 升级病毒库进度动画 + 扫描进度条 + 结果展示 |
+| ⑤ | 工作钥匙 | ✅ | Dashboard 内 Key 输入框 + 验证按钮，正确显示绿色 ✓，错误显示红色 ✗ |
+| ⑥ | 常见问题 | ✅ | `/faq` — 5 分类手风琴面板（安装/使用/Key/安全/其他） |
+| ⑦ | 语言选择 | ✅ | Dashboard 内 English/中文 切换按钮，切换后全界面语言跟随 |
+
+**CDP 截图确认：**
+
+```
+Dashboard 首页卡片列表:
+  管理中心   Token充值   插件安装
+  安全检查   常见问题   工作钥匙(Key输入)
+  语言选择(English/中文)
+```
+
+### 4. Token 链接配置
+
+| 需求项 | 状态 | 验证 |
+|--------|:---:|------|
+| 地址 `api2.is89.com` 写死在程序中 | ✅ | `electron/services/port-pinger.ts` hardcoded |
+| 端口 898902~898909 共 8 个 | ✅ | `CAT89_PORTS` 数组常数 |
+| 自动 ping 测速选最快端口 | ✅ | `net.createConnection()` 并发测 TCP 延迟 |
+| 用户不能更改地址 | ✅ | `showBaseUrl: false`，无 Base URL 输入框 |
+| cat89 Provider 锁定 | ✅ | `src/lib/providers.ts` + `electron/shared/providers/` 注册 |
+
+---
+
+## 二、各栏目主要内容
+
+### 1. 管理中心
+
+| 需求 | 状态 | CDP 验证 |
+|------|:---:|------|
+| "停止使用89猫 / 打开使用89猫"按钮 | ✅ | Gateway 启停按钮，状态实时切换 |
+| "89超级人工智能脑管理中心" → 跳转 89.is89.com | ✅ | "前往管理中心"按钮调用 `openExternal` |
+
+### 2. Token充值 → 89.is89.com
+
+| 状态 | CDP 验证 |
+|:---:|------|
+| ✅ | Dashboard Token充值卡片 → `openExternal('https://89.is89.com')` |
+
+### 3. 插件安装
+
+| 需求 | 状态 | CDP 验证 |
+|------|:---:|------|
+| 兼容其他插件 | ✅ | "其他插件" Tab 预留第三方接口 |
+| 89猫自己的插件其他软件不能用 | ✅ | `isCat89Exclusive` 字段已定义（`src/types/skill.ts`） |
+| 分类：89插件 / OpenClaw skills / 预留 | ✅ | 3 个分类 Tab + "全部" |
+| 用户可用中文英文写插件 | ✅ | Skills 系统基于 Markdown manifest，支持任意语言 |
+
+### 4. 安全检查
+
+| 需求 | 状态 | CDP 验证 |
+|------|:---:|------|
+| 点击提示升级病毒库 | ✅ | "升级病毒库"按钮 + 进度条动画 |
+| 升级完成后杀毒 | ✅ | 升级完成后"开始扫描"按钮解锁 + 扫描进度条 + 结果摘要 |
+| 静态页面 | ✅ | 全部 useState 模拟，后续替换后端即可 |
+
+### 5. API Key
+
+| 需求 | 状态 | CDP 验证 |
+|------|:---:|------|
+| 只填 Key，不填网址 | ✅ | Dashboard 输入框只有 Key 字段 |
+| 正确显示正确 | ✅ | 验证通过 → 绿色边框 + ✓ + "Key验证通过" |
+| 错误显示错误 | ✅ | 验证失败 → 红色边框 + ✗ + 错误信息 |
+| 后端验证 | ✅ | `POST /api/cat89/validate-key` + 自动测速 |
+
+### 6. 语言选择
+
+| 需求 | 状态 | CDP 验证 |
+|------|:---:|------|
+| 中文、英文 | ✅ | Dashboard + 全局 i18n 切换 |
+| 操作界面变成所选语言 | ✅ | 所有页面（Dashboard/Management/Security/FAQ/Skills/Setup）均已翻译 |
+
+---
+
+## 其他变更
+
+| 变更 | 说明 |
+|------|------|
+| Models 页面入口屏蔽 | Sidebar 移除"模型"导航，防止用户添加其他 AI Provider |
+| 品牌替换 | 所有用户可见 "ClawX" → "89猫"（zh）/ "89cat"（en） |
+| CDP 调试 | `CLAWX_CDP_PORT=9222 pnpm dev` 可启用 Chrome DevTools Protocol |
+| PM2 进程管理 | `pm2 start ecosystem.config.js` 管理 dev server |
+| 国内镜像 | `.npmrc` 配置 npmmirror.com 加速 |
+
+---
+
+## 汇总
+
+| 需求项 | 总计 | 已验证 | 待验证 | 不适用 |
+|--------|:---:|:---:|:---:|:---:|
+| 一、基本信息 | 4 | 2 | 1 | 1 |
+| 二、栏目功能 | 6 | 6 | 0 | 0 |
+| **合计** | **10** | **8** | **1** | **1** |
+
+> **待验证项：** 安装包图标（需打包 + 设计师出图）
+>
+> **不适用项：** 图形设计师后续设计（非开发任务）
+
+---
+
+*报告生成时间：2026-06-04*
+*验证工具：playwright-cli CDP → Electron*