# 智引未来企业官网

西安智引未来人工智能科技有限公司官网。项目基于 Astro 5 + Node standalone adapter 的 SSR 模式，包含品牌官网、GEO/SMO 服务页、响应式适配、搜索增长洞察 CMS、SEO/GEO 基础、原子构建与 GitLab/Nginx 部署配置。

## 本地运行

```bash
npm install
npm run dev
```

- 官网开发地址：`http://localhost:4321/`
- 内容后台：`http://localhost:4321/admin/`
- 文章列表、分类页、详情页和首页文章区均在请求时从 CMS 数据目录读取并渲染。

生产构建与本地服务：

```bash
npm run build
npm start
```

生产模式默认监听 `http://127.0.0.1:8792/`。

## 常用命令

```bash
npm run check   # Astro / TypeScript 检查
npm test        # CMS 认证与导入测试
npm run build   # 带共享锁的原子生产构建
npm start       # 启动 standalone 服务
```

## 内容管理

洞察文章使用 Markdown 存储，并由同端口 `/admin/` 后台管理。仓库中的 `src/data/content/` 仅用于本地初始化种子；生产环境通过 `CMS_DATA_DIR` 将内容持久化到仓库外。文章页面采用 SSR，发布、下架、删除后无需重新编译静态页面即可生效。

后台支持：

- 草稿、发布、下架、删除与未发布修改回退
- 分类新增、重命名、删除与文章迁移
- Markdown 和 Word `.docx` 导入
- 文章图片上传、Markdown 预览和修改密码
- Bearer API 调用与发布构建状态查询

完整说明见 [CMS_README.md](./CMS_README.md)。

## SEO 与 AI 可发现性

- 页面级标题、描述、关键词、canonical、Open Graph 和 Twitter Card
- Organization、WebSite、WebPage、Service、FAQ、Article 和 Breadcrumb 结构化数据
- sitemap、robots.txt、语义化页面、SSR 文章与分类分页
- `/llms.txt` 和 `/llms-full.txt` 提供结构化站点摘要与完整内容入口
- Astro 图片优化、移动端适配、减少动态效果偏好与原生懒加载

## 部署

- Astro standalone 输出：`dist/server/` 与 `dist/client/`
- GitLab CI：`.gitlab-ci.yml`
- Nginx 配置：`deploy/nginx/zhiyinweilai.conf`
- 生产端口：`8792`
- 站点域名：`www.zhiyintec.com`
- 服务器目录：`/root/zhiyinweilai/current` 与 `/root/zhiyinweilai/shared`

生产部署前需在 `/root/zhiyinweilai/shared/.env` 配置独立的 `CMS_PASSWORD`、`CMS_SECRET`、`CMS_API_KEY`、`CMS_DATA_DIR` 和 `CMS_BUILD_LOCK`。上传文件、CMS 数据与构建锁必须位于 `shared/`，不能放入部署时会覆盖的 `current/`。
