diff --git a/.gitignore b/.gitignore index 64e1b39..6aacb25 100644 --- a/.gitignore +++ b/.gitignore @@ -84,3 +84,7 @@ playground/ # ClawX-biz bridge workspace artifacts resources/enterprise-skills/ resources/openclaw-plugins/skillshub/ + +# Dev tools +dev.bat +.playwright-cli/ diff --git a/docs/原始需求.txt b/docs/原始需求.txt new file mode 100644 index 0000000..720b2e4 --- /dev/null +++ b/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、语言选择,先设可以选中文,英文三个选项,以后再升级。选择以后操作界面变成所选择的语言文字。 + + + + \ No newline at end of file diff --git a/docs/验证报告.md b/docs/验证报告.md new file mode 100644 index 0000000..e1ece84 --- /dev/null +++ b/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*