# octopus-recognition-network

**Repository Path**: github-9819409/octopus-recognition-network

## Basic Information

- **Project Name**: octopus-recognition-network
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 章鱼识网（Octopus Recognition Network）

快速查询网站 Whois 域名信息，溯源网址背景，上网查址更省心。

基于 WXT + React 开发的浏览器扩展（支持 Chromium / Firefox 构建），主要面向“当前标签页 URL/域名”的快速查询与辅助分析。

## 功能

- 参数解析 & URL 生成器：对当前网址进行协议/主机/端口/路径/Hash/Query 参数解析，支持直接编辑并同步生成新链接（Query 参数支持添加/删除）。
- Whois 域名查询：域名注册商、注册/到期时间、DNS 服务器、状态等信息展示（并提供原始 WHOIS 内容）。
- ICP 备案查询：查询域名备案信息（如备案号、主办单位、审核时间等）。
- SSL 证书检测：查询站点证书有效期、签发者、指纹、链路等信息。
- 域名价格：查询域名注册/续费参考价格（支持选择币种）。
- 网页详情：读取当前网页的 TDK（Title/Description/Keywords）、OG/Twitter meta、canonical、favicon、样式表/alternate 链接等。
- DNS 解析查询：支持 A/AAAA/CNAME/MX/NS/TXT 等记录展示。
- Ping 检测：展示目标信息、节点汇总与各节点详情。
- 收录详情：展示搜索引擎收录/索引等信息（以接口返回为准）。
- 视频详情：对常见短视频/视频链接进行解析（按域名自动显示入口，结果以接口返回为准）。

## 权限与数据来源

本扩展需要以下能力：

- `tabs` / `activeTab`：读取当前标签页信息（URL 等）。
- `scripting`：在“网页详情”功能中注入脚本以采集页面 TDK 等信息。
- `storage`：用于本地缓存（降低重复查询次数）。
- `permissions` + `optional_host_permissions: ['<all_urls>']`：在用户操作触发时请求站点授权，用于读取“网页详情”。

网络请求与数据来源（以代码配置为准）：

- Whois：`api.whoiscx.com`
- ICP / SSL / DNS / Ping / 收录 / 域名价格 / 视频解析：`openapi.dwo.cc`
- VS Code 插件详情：`marketplace.visualstudio.com`、`*.gallery.vsassets.io`

说明：

- 本插件部分数据来源于互联网上的免费公开 API 服务，结果仅供参考，可能存在延迟、缺失或不准确。
- 免费接口不保证长期稳定，能用且用，请珍惜。

## 缓存策略

为减少重复请求，部分查询结果会写入浏览器本地存储做缓存（TTL：24 小时）。缓存仅存储在本机浏览器中，不会由本扩展主动上传。

## 开发与构建

### 环境要求

- Node.js（建议使用 LTS）
- pnpm（本项目包含 `pnpm-lock.yaml`）

### 常用命令

```bash
pnpm install

# 开发调试（Chromium）
pnpm dev

# 开发调试（Firefox）
pnpm dev:firefox

# 构建
pnpm build
pnpm build:firefox

# 生成 zip 包（用于分发/提交商店前的打包）
pnpm zip
pnpm zip:firefox

# 仅类型检查
pnpm compile
```

构建产物默认输出到 WXT 的 `.output/` 目录中（不同浏览器目标会生成不同子目录）。

## 安装与使用

### 手动加载（Chromium / Edge）

1. 执行构建：`pnpm build`
2. 打开扩展管理页：`chrome://extensions/`（或 Edge 的 `edge://extensions/`）
3. 打开“开发者模式”
4. 点击“加载已解压的扩展程序”
5. 选择构建输出目录（通常位于 `.output/` 下对应浏览器目标的子目录，目录内包含 `manifest.json`）

### 临时加载（Firefox）

1. 执行构建：`pnpm build:firefox`
2. 打开 `about:debugging#/runtime/this-firefox`
3. 点击“临时载入附加组件…”
4. 选择构建输出目录中的 `manifest.json`

### 使用方式

- 打开扩展弹窗后，会自动读取“当前标签页 URL”并填入“当前网址”
- 展开“参数解析 & URL 生成器”，可直接编辑协议/主机/端口/路径/Hash/Query 参数来生成新链接
- 点击各功能按钮，对当前域名/网址进行查询；部分功能首次使用可能会弹出站点授权请求

## 使用提示（常见问题）

### “网页详情”提示无权限/无法读取

“网页详情”需要读取当前页面的 meta 信息，浏览器会要求对当前站点授权。按弹窗提示点击“刷新”，并在浏览器弹窗中允许权限请求即可。

### 查询失败/网络请求失败

请检查：

- 网络是否可访问对应接口域名；
- 扩展是否包含了接口域名的 `host_permissions`，更新后是否已重新加载扩展；
- 免费接口可能存在不稳定或限流，稍后重试。

## 配置与扩展

### 接口域名与权限

本项目通过 WXT 生成 Manifest，接口域名权限配置在 `wxt.config.ts` 的 `host_permissions` 中（不同构建模式可能略有差异）。如需替换 API 或新增域名，需要同步更新：

- `entrypoints/popup/App.tsx` 中的接口地址常量
- `wxt.config.ts` 中的 `host_permissions`

### 本地缓存

- Whois / ICP / SSL / TDK / DNS / 收录 / 域名价格等查询会写入本地存储缓存（默认 TTL：24 小时）
- 缓存仅保存在本机浏览器中，不会由扩展主动上传

## 项目结构

- `entrypoints/popup/`：扩展弹窗 UI（主要业务逻辑在 `App.tsx`）。
- `entrypoints/background.ts`：后台脚本入口（可扩展用于事件监听、消息通信等）。
- `entrypoints/content.ts`：内容脚本入口（如需页面内功能可在此扩展）。
- `public/`：图标等静态资源。

## 隐私说明

- 扩展不会主动收集或上传你的浏览历史
- 你触发查询时，会向 README 中列出的第三方接口域名发起网络请求，传递你输入/当前页的域名或网址（用于查询）

## 贡献

欢迎提交 Issue / PR。建议在提交前先执行：

```bash
pnpm install
pnpm compile
```