# jianzhi

**Repository Path**: liupima/jianzhi

## Basic Information

- **Project Name**: jianzhi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-02
- **Last Updated**: 2026-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 剪韵流光

当前持续开发的 React + TypeScript + Vite 项目位于 **[`jianyun-liuguang/`](jianyun-liuguang/)**，当前版本为 v0.2.0。

## 启动最新版

```bash
cd jianyun-liuguang
npm ci
npm run dev
```

打开 http://127.0.0.1:5173/ 。

```bash
npm run test:content
npm run content:report
npm run build
```

- [项目说明与开发进度](jianyun-liuguang/README.md)
- [设计体系](jianyun-liuguang/docs/design-system.md)
- [共用内容模型与接入方式](jianyun-liuguang/docs/content-model.md)
- [资源映射](jianyun-liuguang/docs/resource-manifest.json)
- [缺失资源与待核实清单](jianyun-liuguang/docs/missing-resources.md)

新版已建立十个路由的基础外壳、共用内容数据和资源映射。正式页面交互、画板、账户与社区服务仍按模块继续开发。未配置的登录、发布和 AI 服务不会模拟成功。

`node_modules/`、新项目的 `dist/`、本地截图和环境配置不会提交；`.env.example` 仅保存空白公开地址示例。

## 历史静态导出版本（原说明保留）

仓库根目录的 `build.py`、`reference/`、`dist/` 及已有托管配置来自先前静态导出版本，继续保留。新模块开发请使用上方的 `jianyun-liuguang/` 项目。以下为此前版本说明：

按参考站 https://app-fbspr2zt8wld.miaoda.online/ 的公开页面还原的静态多页网站。

### 本地运行

```sh
python3 build.py
python3 -m http.server 4173 --directory dist
```

打开 http://localhost:4173 。无 npm 依赖，图片、字体、视频均本地托管。

### 页面与实现

- 首页：3D 旋转画廊、七大流派切换、视频、典范作品弹窗。
- 历史 / 工艺：时间轴与四步工序切换。
- 纹样：十九式作品分类筛选与图文详情。
- 现代创新：本地模板检索，照片红白阈值转换、调整与 PNG 导出。
- 互动创作：Canvas 镜像剪刻、补纸、贴纹，2/4/8 折、撤销重做、保存和导出。
- VR 展馆：CSS 3D 漫游、拖拽、键盘与触屏控制、自动巡馆、音乐及全屏。
- 社区 / 账户：当前浏览器的昵称与作品收藏演示，不提供远程账户验证或公共发布。
- 文化助手：本地关键词知识库，不连接大语言模型。

`build.py` 根据 `reference/pages/` 中的公开页面快照构建 HTML；`dist/reference.css` 保留参考视觉；独立交互由 `app.js`、`studio.js`、`modern.js`、`vr.js` 实现。未使用参考站业务 JavaScript、账号配置或后端凭据。

接入生产级 AI、注册登录、云端作品和跨用户社区，需要另行配置模型接口、认证服务及数据库。当前站点默认以 Sites 私有访问部署。

图片和字体来源映射见 `reference/asset-map.json` 与 `reference/url-rewrite-map.json`。