# TermCore

**Repository Path**: ccw333/term-core

## Basic Information

- **Project Name**: TermCore
- **Description**: 这是一个大学生的opc实践项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-18
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TermCore 译核 - 使用说明

> 零基础也能快速上手的企业合同术语翻译系统

---

## 一、功能介绍

### 1.1 产品定位

**TermCore 译核**是一款企业合同术语守护系统，解决：
- 合同翻译中术语不准确的问题
- 通用AI翻译无法识别专业术语的问题
- 翻译结果缺乏校验机制的问题

### 1.2 四大核心功能

| 功能 | 说明 |
|------|------|
| **📜 术语守护翻译** | AI精准翻译 + 三层术语校验，确保术语100%准确 |
| **🔍 合同风险审查** | 自动识别10类核心条款，评估高/中/低风险 |
| **💬 合同智能问答** | 基于合同内容的信息查询、义务梳理、条款对比 |
| **📚 术语库管理** | 查看、搜索、添加专业术语，置信度动态更新 |

### 1.3 核心技术

| 技术 | 说明 |
|------|------|
| **三层校验引擎** | 正向匹配 + 语义匹配 + 反向校验 |
| **法系智能识别** | 自动识别普通法/大陆法语境，选择正确译法 |
| **翻译缓存** | 重复翻译不消耗API额度，节省成本 |
| **中英双语** | 一键切换中/英文界面 |

---

## 二、环境准备（零基础教程）

### 2.1 需要安装的软件

#### Step 1：安装 Python

1. 打开浏览器，访问 https://www.python.org/downloads/
2. 点击 **Download Python 3.12**（或最新版本）
3. 下载完成后，双击安装包
4. **重要**：安装时勾选 **"Add Python to PATH"**
5. 点击 **Install Now**

**验证安装成功：**
- 按 `Win + R`，输入 `cmd`，回车
- 在命令行输入：
```bash
python --version
```
看到类似 `Python 3.12.0` 表示安装成功

---

#### Step 2：下载代码

**方式一：从Gitee下载（推荐）**
1. 打开 https://gitee.com/ccw333/term-core
2. 点击绿色的 **"克隆/下载"** 按钮
3. 选择 **下载ZIP**
4. 解压到一个好找的目录，如 `C:\TermCore`

**方式二：用Git克隆**
1. 安装 Git：https://git-scm.com/download/win
2. 打开命令行，进入你想放代码的目录
3. 运行：
```bash
git clone https://gitee.com/ccw333/term-core.git
```

---

### 2.2 安装依赖

1. 打开命令行，进入项目目录：
```bash
cd C:\TermCore\TermCore
```

2. 安装所有依赖（一次性安装）：
```bash
pip install -r requirements.txt
```

如果提示 `pip` 找不到，试试：
```bash
python -m pip install -r requirements.txt
```

**等待安装完成，没有报错就是成功！**

---

### 2.3 初始化数据库

项目需要数据库存储术语库，首次使用需要初始化：

```bash
cd scripts
python init_db.py
python import_terms.py
cd ..
```

看到 `数据库初始化完成` 和 `成功导入XX条术语` 表示成功

---

## 三、启动使用

### 3.1 启动应用

在项目目录下运行：

```bash
cd C:\TermCore\TermCore
streamlit run src\app.py
```

或双击运行启动脚本 `start.bat`（如果项目里有的话）

---

### 3.2 打开网页

启动后，在浏览器中打开：

```
http://localhost:8501
```

---

### 3.3 界面介绍

#### 顶部导航
- **右上角**：点击切换中文/English

#### 左侧功能栏
| 功能 | 说明 |
|------|------|
| 📜 术语守护翻译 | 翻译合同文本，校验术语准确性 |
| 🔍 合同风险审查 | 分析合同条款，识别风险 |
| 💬 合同智能问答 | 基于合同内容提问 |
| 📚 术语库管理 | 查看和添加术语 |

---

## 四、详细使用教程

### 4.1 术语守护翻译

1. 选择 **📜 术语守护翻译**
2. 在左侧文本框粘贴中文合同
3. 点击 **开始翻译**
4. 右侧显示：
   - 英文译文
   - 综合置信度（越高越好）
   - 术语校验结果（✅正确 / ❌错误）

**术语校验说明：**
- **第一层**：检查是否用了标准译法
- **第二层**：检查是否有疑似误译
- **第三层**：回译检查语义一致性

---

### 4.2 合同风险审查

1. 选择 **🔍 合同风险审查**
2. 粘贴合同文本（或点击"加载示例"）
3. 点击 **开始审查**
4. 查看风险概览：
   - 🔴 高风险：需要重点关注
   - 🟡 中风险：建议优化
   - 🔵 低风险：基本没问题

---

### 4.3 合同智能问答

1. 选择 **💬 合同智能问答**
2. 在左侧粘贴合同文本
3. 在右侧输入问题，如：
   - "这份合同什么时候到期？"
   - "我们需要承担哪些保密义务？"
   - "付款条件是什么？"
4. 点击 **提问**

---

### 4.4 术语库管理

1. 选择 **📚 术语库管理**
2. **术语查询**：搜索原文或译文
3. **添加术语**：填写表单添加新术语
4. **统计信息**：查看术语库概况

---

## 五、常见问题

### Q1：启动报错 "Module not found"

需要安装依赖：
```bash
pip install -r requirements.txt
```

### Q2：翻译报错 "API Key无效"

检查 `src/config.py` 中的 API Key 是否正确，或联系项目负责人。

### Q3：网页打不开

确认命令行显示 "Running on http://localhost:8501"，然后在浏览器中访问这个地址。

### Q4：翻译没反应

- 检查网络连接
- 等待几秒后重试（可能API响应慢）

### Q5：缓存有什么用？

缓存可以节省API调用次数。重复翻译同一内容会直接读缓存，不消耗API额度。

---

## 六、项目结构

```
TermCore/
├── src/                    # 源代码
│   ├── app.py              # 主入口
│   ├── config.py           # 配置
│   ├── core/               # 核心模块
│   │   ├── translator.py   # 翻译引擎
│   │   └── embedder.py     # 语义匹配
│   ├── modules/            # 功能模块
│   │   └── translation/
│   │       └── checker.py  # 三层校验
│   └── pages/              # 页面
│       ├── translation_page.py
│       ├── risk_review_page.py
│       ├── qa_page.py
│       └── terminology_page.py
├── scripts/                # 工具脚本
│   ├── init_db.py         # 数据库初始化
│   └── import_terms.py    # 术语导入
├── data/                   # 数据
│   ├── termcore.db        # SQLite数据库
│   └── cache/             # 翻译缓存
├── requirements.txt       # Python依赖
└── README.md              # 本文档
```

---

## 七、联系方式

- **项目负责人**：阿辰
- **邮箱**：2712273892@qq.com
- **仓库地址**：https://gitee.com/ccw333/term-core

---

## 八、致谢

本项目基于：
- DeepSeek-V3 翻译模型
- SiliconFlow API 服务
- Streamlit Web 框架

---

*最后更新：2026-04-18*