# certagent-website

**Repository Path**: kxunyun/certagent-website

## Basic Information

- **Project Name**: certagent-website
- **Description**: CertAgent certificate expiry management system - official website and documentation center (install / API / user guide)
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-10
- **Last Updated**: 2026-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CertAgent 官网

面向中介服务机构的证照到期管理系统 **CertAgent** 的官方网站与文档中心。纯静态站点，无构建依赖，可直接部署到腾讯云 **EdgeOne Pages**。

## 页面

| 页面 | 说明 |
| --- | --- |
| `index.html` | 首页：产品价值、九大能力、核心亮点、界面预览、移动端、安全、文档入口、FAQ |
| `features.html` | 功能全景：九大业务域、50+ 功能模块、适用团队 |
| `docs/index.html` | 文档中心：三份手册入口、角色导航、常用章节、全文搜索 |
| `docs/install.html` | 安装部署手册：宝塔 / Docker / Linux、安装向导、定时任务、备份升级、故障排查 |
| `docs/api.html` | 接口文档：通用约定、29 个业务域路由、Agent 开放接口、附录 |
| `docs/guide.html` | 使用手册：按角色讲解业务操作、常见问题与状态速查 |
| `404.html` | 404 页面 |

## 技术栈

- 原生 HTML5 + CSS3 + JavaScript（ES5 兼容写法）
- 无 npm、无构建步骤、无第三方 CDN 依赖
- 响应式布局，支持移动端、`prefers-reduced-motion`、键盘导航
- 图片全部来自业务系统真实界面截图
- 文档由 Markdown 预生成静态 HTML，运行时不需要 Markdown 解析器

## 本地预览

任选一种方式，在仓库根目录启动静态服务器：

```bash
# Python 3
python -m http.server 8080

# Node.js（无需安装依赖）
npx serve .
```

打开 <http://localhost:8080>，文档中心位于 <http://localhost:8080/docs/>。

> 不要直接双击 `index.html`：部分浏览器会限制本地文件读取与 `fetch`，使用静态服务器体验更完整。

## 文档

文档源文件位于 `docs-src/`：

```text
docs-src/
├── 01-install.md   # 安装部署手册
├── 02-api.md       # 接口文档
└── 03-guide.md     # 使用手册
```

修改 Markdown 后，重新生成文档页与搜索索引：

```bash
python -m pip install markdown
python tools/build_docs.py
```

脚本会生成：

- `docs/install.html`、`docs/api.html`、`docs/guide.html`
- `docs/index.html`
- `docs/search-index.json`（全文搜索索引）

生成结果已提交到仓库，EdgeOne Pages 发布时无需执行构建命令。

## 目录结构

```text
certagent-website/
├── index.html
├── features.html
├── 404.html
├── edgeone.json          # EdgeOne Pages 项目配置
├── robots.txt
├── sitemap.xml
├── assets/
│   ├── css/main.css
│   ├── css/docs.css
│   ├── js/main.js
│   ├── js/docs.js
│   └── img/              # 截图、Logo、OG 封面、EdgeOne 步骤图
├── docs/                 # 预生成的文档页与搜索索引
├── docs-src/             # Markdown 文档源文件
├── tools/build_docs.py   # 文档生成脚本
└── README.md
```

## 部署到 EdgeOne Pages（图文步骤）

> 下面的图为操作示意图，按钮位置、字段名称以腾讯云控制台实际界面为准。

### 部署前确认

- 代码已推送到 Gitee 的 `master` 分支：<https://gitee.com/kxunyun/certagent-website>
- 本仓库是纯静态站点：**不需要服务器、不需要安装依赖、不需要构建命令**
- `edgeone.json` 已声明输出目录为仓库根目录，控制台通常会自动识别
- `docs/` 里已经是生成好的 HTML 与搜索索引，平台不需要运行 Python

### 步骤 1 · 进入 Pages 控制台

登录腾讯云控制台，在左侧菜单选择 **Pages**，点击右上角 **创建项目**。

![步骤 1：进入 Pages 控制台，点击创建项目](assets/img/edgeone/step-1-pages.png)

### 步骤 2 · 选择导入方式

推荐 **导入 Git 仓库**：以后每次 `git push` 都会自动重新发布。  
没有仓库权限时，也可以选 **直接上传**，上传仓库 ZIP。

![步骤 2：选择导入 Git 仓库或直接上传](assets/img/edgeone/step-2-import.png)

> 直接上传 ZIP 时，请确保 `index.html` 位于压缩包根目录，而不是多套一层 `certagent-website/` 目录。

### 步骤 3 · 授权并选择仓库

首次使用需要完成 Gitee 授权（只读取代码，不会修改仓库）。授权后选择：

- 仓库：`kxunyun/certagent-website`
- 分支：`master`

![步骤 3：授权 Gitee 并选择仓库与分支](assets/img/edgeone/step-3-repo.png)

### 步骤 4 · 填写构建配置

| 配置项 | 填写内容 |
| --- | --- |
| 项目名称 | `certagent-website` |
| 框架预设 | 静态站点 / 无框架 |
| 安装命令 | **留空** |
| 构建命令 | **留空** |
| 输出目录 | `/` |

![步骤 4：框架预设选静态站点，安装与构建命令留空，输出目录填 /](assets/img/edgeone/step-4-build.png)

这一步是最容易填错的地方：只要填了 `npm install` 或 `npm run build`，平台就会因为没有 `package.json` 而失败。本仓库的文件已经是可以直接发布的最终产物。

### 步骤 5 · 等待部署完成

点击部署后通常 1 分钟内完成。成功后平台会分配一个默认域名，可直接访问：

- `/` → 官网首页
- `/docs/` → 文档中心
- `/docs/install.html`、`/docs/api.html`、`/docs/guide.html` → 三份手册

![步骤 5：部署成功并获取默认访问域名](assets/img/edgeone/step-5-deploy.png)

### 步骤 6 · 绑定自定义域名（可选）

在项目的域名管理里添加域名，按控制台提示配置一条 CNAME 记录。DNS 生效后平台会自动签发并续期 HTTPS 证书。

![步骤 6：添加自定义域名并配置 CNAME 记录](assets/img/edgeone/step-6-domain.png)

> 国内节点绑定自定义域名通常要求域名已完成 ICP 备案；没有备案时先用平台分配的默认域名。

### 部署后检查

- [ ] 首页 `/` 打开正常，导航、截图、页脚没有 404
- [ ] 文档中心 `/docs/` 正常，`Ctrl / Cmd + K` 搜索能返回章节
- [ ] 三份手册均可访问，代码块「复制」按钮可用
- [ ] 手机宽度下文档目录抽屉能打开，正文无横向滚动
- [ ] 访问一个不存在的路径，确认展示 `404.html`
- [ ] 把 `sitemap.xml`、`robots.txt` 里的 `https://your-domain.com/` 换成实际域名后重新推送

### 常见问题

| 现象 | 处理 |
| --- | --- |
| 部署成功但首页 404 | 输出目录没填 `/`，或 ZIP 多套了一层目录 |
| 页面没有样式 | `assets/` 未完整上传，检查 `assets/css/main.css` 是否存在 |
| 搜索一直加载 | `docs/search-index.json` 缺失，或站点部署在子路径导致请求地址错误 |
| 推送后页面没更新 | 确认推送的是 `master` 分支，或在控制台手动触发一次重新部署 |
| 自定义域名一直待验证 | CNAME 记录未生效或填错，等待 DNS 生效后再点验证 |


## 上线前替换

- `sitemap.xml`、`robots.txt` 中的 `https://your-domain.com/` 替换为实际域名。
- `assets/img/og-cover.svg` 为社交分享封面，可按品牌调整；部分平台对 SVG 分享图支持有限，建议导出为 1200×630 PNG 后替换各页面 `og:image`。
- 页面中的 Gitee 仓库链接按实际账号调整。
- 截图中的企业与人员均为演示数据。

## 相关仓库

- 官网（本仓库）：<https://gitee.com/kxunyun/certagent-website>
- 问题反馈：<https://gitee.com/kxunyun/certagent-website/issues>
- 业务系统：<https://gitee.com/kxunyun/cert-expiry-manager>（私有仓库，需授权访问）

## License

[MIT](LICENSE)