内容
# GlossWise
<p align="center">
<strong>English</strong> ·
<a href="README.ar.md">العربية</a> ·
<a href="README.zh.md">中文</a> ·
<a href="README.fr.md">Français</a> ·
<a href="README.ru.md">Русский</a> ·
<a href="README.es.md">Español</a> ·
<a href="README.de.md">Deutsch</a> ·
<a href="README.ja.md">日本語</a>
</p>
<p align="center">
<img src="docs/assets/glosswise-banner.png" alt="GlossWise — terminology-safe translation for AI agents" width="100%">
</p>
<p align="center">
<a href="https://github.com/Magolor/GlossWise/actions/workflows/ci.yml"><img src="https://github.com/Magolor/GlossWise/actions/workflows/ci.yml/badge.svg?branch=master" alt="Continuous integration"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10–3.13-3776AB" alt="Python 3.10 through 3.13"></a>
<a href="https://ahvn.top"><img src="https://img.shields.io/badge/HeavenBase-0.1.2.1-6957E5" alt="HeavenBase 0.1.2.1"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="MIT License"></a>
</p>
<p align="center">
<a href="#安装">安装</a> ·
<a href="#连接代理">连接代理</a> ·
<a href="#试用：教一次，持续翻译">试用</a> ·
<a href="#日常提示">日常提示</a> ·
<a href="#MCP 服务器">MCP 工具</a> ·
<a href="#Python SDK">Python SDK</a>
</p>
GlossWise 存储已批准的术语、翻译规则和示例，然后为调用的代理或应用程序准备一份简洁的简介。主机代理使用自己的模型进行翻译；直接 CLI 使用一个可见的 HeavenBase LLM 预设。
GlossWise 可作为 CLI、MCP 服务器和 Python SDK 使用。版本 `0.1.0.5` 支持 `heavenbase>=0.1.2.1`。
## 安装
GlossWise 需要 Python 3.10–3.13。从 GitHub 直接安装当前源代码。在安装之前，您可以查看确切的代理技能：
```console
python -m pip install "git+https://github.com/Magolor/GlossWise.git"
glosswise setup -l en -l zh
```
要检查或贡献源代码：
```console
git clone https://github.com/Magolor/GlossWise.git
cd GlossWise
python -m pip install .
glosswise setup -l en -l zh
```
`setup` 需要您通常翻译的语言，将它们保存为全局默认值，创建并激活具有这些语言的 `default` 工作区，然后在以下位置安装 GlossWise 代理技能：
- `~/.agents/skills/glosswise`
- `~/.claude/skills/glosswise`
公共根技能和 `setup` 安装的打包副本保持字节对字节的相同。
工作区数据在 `~/.glosswise/` 下自动管理。您不需要选择或公开数据库。新工作区继承全局语言默认值；使用 `glosswise config lang -l en -l <language>` 更改它们。
检查安装：
```console
glosswise ws ls
glosswise ws get
```
## 连接代理
`glosswise setup` 已经安装了通用和 Claude GlossWise 技能。从任何支持的主机连接同一个全局 MCP 服务器：
| 主机 | 一次性设置 |
| --- | --- |
| [Claude Code](https://code.claude.com/docs/en/mcp) | `claude mcp add --scope user glosswise -- glosswise mcp` |
| [Codex](https://developers.openai.com/codex/mcp/) | `codex mcp add glosswise -- glosswise mcp` |
| [Cursor](https://docs.cursor.com/context/model-context-protocol) | 保存 `glosswise mcp --json` 为 `~/.cursor/mcp.json`。 |
| [VS Code / Copilot](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) | 添加 `.vscode/mcp.json` 并使用命令 `glosswise` 和参数 `["mcp"]` 的 `servers.glosswise` stdio 条目。 |
| [OpenCode](https://opencode.ai/docs/mcp-servers/) | 将以下本地 MCP 条目添加到 `~/.config/opencode/opencode.json`。 |
| [OpenClaw](https://ahvn.top/quickstart/heavenbase-mcp#3-connect-your-agent) | 运行 `glosswise mcp --transport http`，然后将 `mcp.servers.glosswise` 设置为 `http://127.0.0.1:61055/mcp`，传输方式为 `streamable-http`。 |
| [Hermes](https://ahvn.top/quickstart/heavenbase-mcp#3-connect-your-agent) | 运行 `glosswise mcp --transport http`，然后在 `~/.hermes/config.yaml` 的 `mcp_servers.glosswise` 下添加其 URL。 |
| [LM Studio](https://lmstudio.ai/docs/app/mcp) | 打开 **Program/Developer → Install → Edit mcp.json**，然后粘贴 `glosswise mcp --json` 的输出。 |
| [Qwen Code](https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/) | `qwen mcp add --scope user glosswise glosswise mcp` |
| [HeavenBase](https://ahvn.top/quickstart/heavenbase-mcp#3-connect-your-agent) | 运行 `glosswise mcp --transport http`，然后 `hb llm session --mcp http://127.0.0.1:61055/mcp`。 |
对于 [OpenCode](https://opencode.ai/docs/mcp-servers/)，将以下内容添加到全局 `~/.config/opencode/opencode.json`：
```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"glosswise": {
"type": "local",
"command": ["glosswise", "mcp"],
"enabled": true
}
}
}
```
使用主机的 MCP 列表命令验证连接，然后在文档要求时重启代理。
启动新的聊天并说：
```text
/glosswise 列出我的工作区并告诉我哪个是活动的。
```
代理现在可以创建工作区、策划术语、搜索它并代表您准备翻译简介。您不需要编写 JSON 或管理数据库。一个技能和一个 MCP 连接适用于所有 GlossWise 工作区。
对于另一个支持 stdio 的 MCP 客户端，打印便携式配置文件：
```console
glosswise mcp --json
```
## 试用：教一次，持续翻译
此演示从普通的模型翻译开始，教会 GlossWise 两个术语决策，然后在干净的代理会话中重复原始请求。摘自
[玛丽·雪莱的 *弗兰肯斯坦*](https://www.gutenberg.org/cache/epub/42324/pg42324-images.html)，这是一部早期科幻作品，属于公共领域。
### 1. 创建工作区
询问您的代理：
```text
/glosswise 创建并选择一个名为 `frankenstein-lab` 的 GlossWise 工作区。
将其默认语言设置为英语、中文、法语、德语、俄语和日语。
```
或使用两个简短的 CLI 命令：
```console
glosswise ws create frankenstein-lab
glosswise ws lang -l en -l zh -l fr -l de -l ru -l ja
```
`ws create` 自动选择新的工作区。重复 `-l/--lang` 以设置每个有序语言。该集合是一个策划提示，提醒代理收集所有六种首选表单，而不将语言变成硬性限制。
### 2. 在教导 GlossWise 之前进行翻译
发送以下段落给代理：
```text
/glosswise 使用 `frankenstein-lab` 工作区。将以下段落翻译成中文、法语、德语、俄语和日语。
首先检查 GlossWise 的相关指导，然后识别执行翻译的模型或主机。
“It was on a dreary night of November, that I beheld the accomplishment of my toils. With an anxiety that almost amounted to agony, I collected the instruments of life around me, that I might infuse a spark of being into the lifeless thing that lay at my feet.”
```
第一个措辞取决于代理的翻译模型。它可能会选择字面短语，例如“spark of being” → `存在的火花`、`étincelle de vie`、`Lebensfunken`、`искра жизни` 或 `命の火花`。
### 3. 通过对话教授两个决策
发送另一条消息：
```text
/glosswise 将以下内容保存为 `frankenstein-lab` 工作区中的主动首选术语。
目标形式是我项目的术语决策，而不是关于小说官方翻译的声明。
1. “instruments of life” 表示实验中使用的仪器：
中文：生命仪器；法语：instruments de vie；
德语：Instrumente des Lebens；俄语：орудия жизни；
日语：生命の器具。
2. “spark of being” 表示赋予无生命物质的生命本质：
中文：生命之火；法语：étincelle d'existence；
德语：Funke des Seins；俄语：искра бытия；
日语：存在の火花。
保留英文源形式。在目标语言语法允许的情况下，精确使用首选术语；否则，在不改变批准概念的情况下进行变形。
告诉我何时存储了两个记录。
```
代理处理结构化的 CRUD 调用。如果请求的 工作区语言缺失，安装的技能会告诉它询问、提出表单进行确认或清楚地披露代理生成的表单。
### 4. 启动新会话并重复相同请求
结束当前聊天并启动新的代理会话。发送与步骤 2 相同的提示 - 不要添加您刚刚存储的术语的提醒：
```text
/glosswise 使用 `frankenstein-lab` 工作区。将以下段落翻译成中文、法语、德语、俄语和日语。
首先检查 GlossWise 的相关指导，然后识别执行翻译的模型或主机。
“It was on a dreary night of November, that I beheld the accomplishment of my toils. With an anxiety that almost amounted to agony, I collected the instruments of life around me, that I might infuse a spark of being into the lifeless thing that lay at my feet.”
```
提示相同；只有持久的 GlossWise 工作区已更改。新会话必须检索该状态，而不是依赖聊天内存。重要的更改现在可见：
| 语言 | 基线可能使用 | GlossWise 指导的措辞 |
| --- | --- | --- |
| 中文 | `生命工具` · `存在的火花` | `生命仪器` · `生命之火` |
| 法语 | `instruments de la vie` · `étincelle de vie` | `instruments de vie` · `étincelle d'existence` |
| 德语 | `Werkzeuge des Lebens` · `Lebensfunken` | `Instrumente des Lebens` · `Funken des Seins`¹ |
| 俄语 | `инструменты жизни` · `искра жизни` | `орудия жизни` · `искру бытия`¹ |
| 日语 | `生命の道具` · `命の火花` | `生命の器具` · `存在の火花` |
¹ 代理将规范的首选形式变形以适应该句子。
<details>
<summary>一个成功的 GlossWise 指导结果</summary>
**中文**
> 那是十一月一个阴沉的夜晚，我目睹了自己辛劳的成果。怀着近乎痛苦的焦虑，我把生命仪器聚集在身边，想把生命之火注入躺在我脚边的无生命之物中。
**法语**
> Ce fut par une lugubre nuit de novembre que je contemplai l’accomplissement de mes travaux. Avec une anxiété qui confinait presque à l’agonie, je rassemblai autour de moi les instruments de vie afin d’insuffler une étincelle d'existence à la chose inanimée étendue à mes pieds.
**德语**
> Es war in einer trüben Novembernacht, als ich die Vollendung meiner Mühen erblickte. Mit einer Angst, die beinahe an Qual grenzte, versammelte ich die Instrumente des Lebens um mich, um dem leblosen Ding zu meinen Füßen einen Funken des Seins einzuhauchen.
**俄语**
> В мрачную ноябрьскую ночь я увидел завершение своих трудов. С тревогой, почти переходившей в агонию, я собрал вокруг себя орудия жизни, чтобы вдохнуть искру бытия в безжизненное создание, лежавшее у моих ног.
**日语**
> 十一月の陰鬱な夜、私は自らの労苦の成就を目の当たりにした。苦悶に近い不安を抱えながら、私は生命の器具を周囲に集め、足元に横たわる生命なきものへ存在の火花を吹き込もうとした。
</details>
GlossWise 没有生成这些句子。连接的代理生成了它们；GlossWise 使批准的术语在生成前可检索和可检查。
### 5. 稍后查找和编辑
不需要记录标识符：
```text
/glosswise 在 `frankenstein-lab` 中查找关于火花的术语。显示其首选形式的紧凑表格。
```
然后自然地编辑它：
```text
/glosswise 仅更改 `frankenstein-lab` 中“spark of being”的日语首选形式为
`生命の火花`。保留其他语言的每个其他字段和表单，然后显示保存的记录。
```
此完整设置 → 创建 → 策略 → 重启 → 简介 → 搜索 → 编辑路径在
[`tests/test_quickstart.py`](https://github.com/Magolor/GlossWise/blob/master/tests/test_quickstart.py) 中针对已安装的轮子和两个独立的_stdio MCP 会话进行练习。
## 日常提示
连接后，正常工作可以留在聊天中。下面管理提示会进行有意更改；查询和翻译提示是只读的，除非它们明确要求保存某些内容。
### 管理工作区和术语
- `/glosswise 创建并选择一个名为 <name> 的工作区。`
- `/glosswise 在工作区 <name> 中，将默认语言设置为英语、中文和日语。`
- `/glosswise 在工作区 <name> 中，将“rate limit”保存为一个主动首选术语，英文为“rate limit”，中文为“速率限制”，日语为“レート制限”。显示保存的记录。`
- `/glosswise 在工作区 <name> 中查找“rate limit”。仅更改其日语首选形式为“速度制限”，保留其他字段和表单不变，然后显示更新后的记录。`
- `/glosswise 在工作区 <name> 中归档术语“rate limit”，使其排除在正常主动术语查找之外。在进行更改之前请先询问我。`
### 查找指导并翻译
- `/glosswise 在工作区 <name> 中查找与身份验证相关的活动术语。显示其在英语、中文和日语中的首选和禁止形式。不要修改任何内容。`
- `/glosswise 在工作区 <name> 中查找与法语错误消息翻译相关的规则和示例。显示优先级、样式和冲突。不要修改任何内容。`
- `/glosswise 检查工作区 <name> 中的“请求超出此限制，将拒绝请求。”与工作区 <name> 进行匹配。列出匹配的术语和规则，而不翻译或保存任何内容。`
- `/glosswise 使用工作区 <name>。将英文文本“The client retries the request after the rate limit resets.”翻译成中文和日语。为每个目标语言准备一个新的 GlossWise 简介，应用主动首选术语和规则，标记冲突，并标识执行翻译的模型或主机。`
- `/glosswise 使用工作区 <name>。将以下英文段落翻译成法语。首先准备一个 GlossWise 简介，然后显示翻译结果，并附上应用的每个存储术语、规则或示例的紧凑表格：<粘贴源段落>。`
- `/glosswise 审查法语翻译结果与工作区 <name>。报告缺少的首选术语、禁止形式和冲突规则；如果我要求，请不要重写或保存任何内容：<粘贴翻译>。`
在终端检查更快捷时，使用 `glosswise ws ls`、`glosswise ws use <name>` 和 `glosswise ws get`。
## 直接翻译、文件范围和 PDF OCR
直接翻译使用命名的 HeavenBase `LLMSession` 预设。每个结果都会报告解析的预设、网关、提供商、模型和模型 ID。独立选择预设和不确定性行为：
```console
glosswise config llm chat
glosswise config mode auto
glosswise translate "Run this query." -sl en -tl ja
glosswise translate "Run this query." -sl en -tl ja --preset chat
```
模式为 `yolo`（立即翻译）、`elicit`（带有选项的聚焦术语问题）、`auto`（适应可用证据）、`explain`（翻译和解释每个材料选择）和 `custom` 带有 `--prompt`。HeavenBase 通过 `hb.Prompt` 渲染系统提示，并解析命名预设。使用 `chat` 获取 HeavenBase 当前的快速聊天选择，或固定专用预设，而在 GlossWise 中不重复提供者凭据：
```console
hb cfg set heavenbase.llm.presets.glosswise-translate.model deepseek-v4-flash
glosswise config llm glosswise-translate
```
`scan`、`brief` 和 `translate` 接受包含的基于 1 的 `--start-line` 和 `--end-line` 范围，用于内联文本、标准输入和 `@file` 输入。授权的本地 MCP 配置文件添加了等效的文件工具。
对于 PDF，授权其目录，仅使用配置的 HeavenBase LLM 预设对所需页面进行 OCR，并通过其简短的 `gw-...` 处理器浏览保留的每页文本：
```console
glosswise ws files '["/absolute/path/to/documents"]'
glosswise pdf ocr /absolute/path/to/documents/manual.pdf --start-page 4 --end-page 8
glosswise doc read gw-0123456789ab 4 --start-line 1 --end-line 80
glosswise doc rm gw-0123456789ab
```
GlossWise 逐页渲染和 OCR，并立即删除每个页面图像。配置默认的 `ocr-local` 使用 `hb cfg set heavenbase.llm.presets.ocr-local.<field-or-path> <value>`；设置包括 `desc`、`gateway`、`provider`、`model` 和 `default_args`；使用 `glosswise config ocr <preset>` 选择另一个预设。
## MCP 服务器
### 本地 stdio
大多数桌面和编码代理客户端应使用：
```console
glosswise mcp --json
```
生成的子进程启动具有读取、CRUD、技能和工作区管理工具的完整服务器。`glosswise` 可执行文件必须位于 MCP 客户端的 `PATH` 上。
### 本地 HTTP
要运行一个长生存期的流式 HTTP 服务器：
```console
glosswise mcp --transport http
```
它默认绑定到 `127.0.0.1:61055`，并在 `http://127.0.0.1:61055/mcp` 提供 MCP 服务。使用以下命令打印匹配的客户端配置文件：
```console
glosswise mcp --json --transport http
```
根据需要选择另一个本地端点：
```console
glosswise mcp --transport http --host 127.0.0.1 --port 61056
```
GlossWise 不添加网络身份验证。除非另一个受信任层提供身份验证和传输安全，否则请将服务器保留在环回主机上。
### MCP 工具
数据和上下文工具接受可选的 `workspace_id` 参数。当省略时，GlossWise 使用活动工作区，然后是托管默认工作区。
| 工具 | 用途 | `read` | `full` | `local` |
| --- | --- | :---: | :---: | :---: |
| `glosswise_workspace_info` | 显示工作区功能和语言提示。 | ✓ | ✓ | ✓ |
| `glosswise_prepare_translation` | 为源文本构建翻译简报。 | ✓ | ✓ | ✓ |
| `glosswise_search_terms` | 搜索术语。 | ✓ | ✓ | ✓ |
| `glosswise_search_rules` | 搜索规则。 | ✓ | ✓ | ✓ |
| `glosswise_search_examples` | 搜索示例。 | ✓ | ✓ | ✓ |
| `glosswise_scan_text` | 扫描文本以匹配术语和规则。 | ✓ | ✓ | ✓ |
| `glosswise_list_records` | 列出术语、规则或示例。 | ✓ | ✓ | ✓ |
| `glosswise_get_record` | 通过对象 ID 获取一个记录。 | ✓ | ✓ | ✓ |
| `glosswise_put_term` | 创建或更新术语及其形式。 | — | ✓ | ✓ |
| `glosswise_put_rule` | 创建或更新规则。 | — | ✓ | ✓ |
| `glosswise_put_example` | 创建或更新示例。 | — | ✓ | ✓ |
| `glosswise_archive` | 存档一个记录。 | — | ✓ | ✓ |
| `glosswise_list_workspaces` | 列出工作区。 | ✓ | ✓ | ✓ |
| `glosswise_get_workspace` | 获取一个已编辑的工作区记录。 | ✓ | ✓ | ✓ |
| `glosswise_create_workspace` | 创建一个托管工作区。 | — | ✓ | ✓ |
| `glosswise_set_workspace_languages` | 设置工作区语言提示。 | — | ✓ | ✓ |
| `glosswise_activate_workspace` | 选择活动工作区。 | — | ✓ | ✓ |
| `glosswise_deactivate_workspace` | 清除活动选择。 | — | ✓ | ✓ |
| `glosswise_remove_workspace` | 注销工作区。 | — | ✓ | ✓ |
| `glosswise_open_workspace` | 打开工作区并显示其功能。 | ✓ | ✓ | ✓ |
| `glosswise_health_workspace` | 检查注册表和运行时健康状况。 | ✓ | ✓ | ✓ |
| `glosswise_read_skill` | 读取打包的代理说明。 | ✓ | ✓ | ✓ |
| `glosswise_scan_file` | 扫描授权的服务器本地文本文件。 | — | — | ✓ |
| `glosswise_prepare_file` | 从授权的文本文件范围构建简报。 | — | — | ✓ |
| `glosswise_ocr_pdf` | 将授权的 PDF 页面 OCR 成短句柄。 | — | — | ✓ |
| `glosswise_list_documents` | 列出临时 OCR 文档句柄。 | — | — | ✓ |
| `glosswise_get_document` | 检查一个 OCR 文档清单。 | — | — | ✓ |
| `glosswise_read_document` | 从一个 OCR 页面读取有界行范围。 | — | — | ✓ |
| `glosswise_remove_document` | 删除一个临时 OCR 文档。 | — | — | ✓ |
### MCP 配置文件
配置文件控制工具的暴露，不控制工作区内容或安装的 Skill 文件：
| 配置文件 | 确切界面 | 用途 |
| --- | --- | --- |
| `full` | `full` 列中勾选的 22 个工具。 | 默认。它支持查找、翻译简报、CRUD、Skill 检查和工作区管理。裸 `glosswise mcp` 和 `glosswise mcp --json` 选择此配置文件。 |
| `read` | `read` 列中勾选的 13 个工具。 | 仅限只读术语/上下文使用和工作区检查。它不能策划记录、更改选择或管理工作区。 |
| `local` | 所有 22 个 `full` 工具加上 7 个授权的本地文档工具。 | 一个具有有限文本范围和 PDF OCR 的高级全访问服务器。选择此配置文件本身并不授予文件访问权限；请先授权根目录。 |
`glosswise setup` 安装一个与配置文件无关的 Skill。该 Skill 不选择配置文件：连接的 MCP 服务器决定代理可以调用哪些工具。正常的设置使用 `full`，这是 Skill 教授的每个管理和翻译工作流中唯一的非本地配置文件。
要更改现有的安装程序，请保留已安装的 Skill 并仅更改代理配置中的 MCP 服务器命令，然后重新启动或重新连接代理：
```console
glosswise mcp # full（默认）
glosswise mcp --profile read # 只读
glosswise mcp --profile local # 完整且授权的文本/PDF 工具
```
使用 `glosswise mcp --json --profile <profile>` 生成替换客户端 JSON。当切换配置文件时，不需要重新运行 `glosswise setup`。更改回裸 `glosswise mcp` 会恢复默认的 `full` 界面。
每个工具都返回一个版本化的 JSON 信封。代理应该在使用 `items` 之前检查 `error`、`warnings`、`conflicts` 和 `truncated`。
## CLI 参考
| 任务 | 命令 | 也可以接受 |
| --- | --- | --- |
| 列出工作区 | `glosswise ws ls` | `ws list` |
| 检查工作区 | `glosswise ws get [<name>]` | — |
| 创建工作区 | `glosswise ws create [<name>]` | — |
| 选择工作区 | `glosswise ws use <name>` | `ws activate`、`ws act` |
| 清除选择 | `glosswise ws deact` | `ws deactivate` |
| 注销工作区 | `glosswise ws rm <name>` | `ws unset`、`ws remove` |
| 显示全局配置 | `glosswise config get` | — |
| 设置全局语言默认值 | `glosswise config lang -l en -l <language>` | `config languages` |
| 设置翻译行为 | `glosswise config mode <mode>` | — |
| 设置翻译 LLM 预设 | `glosswise config llm <preset>` | — |
| 设置语言提示 | `glosswise ws lang -l en -l <language>` | `ws languages` |
| 授权本地根目录 | `glosswise ws files '[...]'` | — |
| 创建或更新数据 | `glosswise term set @term.json` | `term put` |
| 获取一个记录 | `glosswise term get <object-id>` | — |
| 列出数据 | `glosswise term ls` | `term list` |
| 搜索数据 | `glosswise term search "query"` | — |
| 存档数据 | `glosswise term archive <object-id>` | — |
| 扫描段落 | `glosswise scan "text"` | — |
| 准备上下文 | `glosswise brief "text"` | — |
| 通过 LLMSession 翻译 | `glosswise translate "text"` | — |
| OCR PDF 页面 | `glosswise pdf ocr <path>` | — |
| 浏览 OCR 文本 | `glosswise doc read <handle> <page>` | — |
将 `term` 替换为 `rule` 或 `example` 以获取相同的设置/获取/列出/搜索/存档工作流程。运行 `glosswise --help` 或 `glosswise <group> --help` 以获取完整的命令界面。
## Python SDK
```python
import glosswise
with glosswise.GlossWiseApp.open() as app:
app.configure_default_languages(["en", "zh", "ru"])
terms = app.list_terms(status="active")
brief = app.prepare_translation(
"使用公共 API。",
source_lang="en",
target_lang="zh",
)
translation = app.translate(
"使用公共 API。",
source_lang="en",
target_langs=["zh"],
preset="chat",
)
```
`GlossWiseApp.open()` 使用活动工作区或创建托管默认工作区后配置全局语言。
使用 `GlossWiseApp.create("<name>")` 获取显式命名的托管工作区，当不存在时应使用 `GlossWiseApp.load()`。已经拥有 HeavenBase 工作区的应用程序可以直接使用 `workspace.glosswise`。
## 工作原理
1. 代理通过 MCP、CLI 或 Python SDK 连接。
2. GlossWise 解析请求的工作区，或使用活动/默认工作区。
3. 它检索相关的术语、规则和示例。
4. `brief` 排名并将证据与警告和冲突一起打包。
5. 主机代理翻译，或 `translate` 调用 HeavenBase `LLMSession`，并使用 `hb.Prompt` 管理的合约和可见的预设。
6. 调用者可以扫描提议的翻译，或将授权的 PDF 页面 OCR 成有界的临时每页文本。
GlossWise 将存储和术语策略保留在任务聚焦的操作后面；代理不需要通用的数据库访问权限。
## 开发者
GlossWise 是一个演示项目，展示了干净的独立应用程序如何使用 HeavenBase。它演示了以下实际优势：
- 安装在 `workspace.glosswise` 处的模块化扩展；
- 托管工作区和应用程序拥有的默认值；
- 上下文级别的用户默认值和可见的 HeavenBase LLM 预设；
- 类型化的实体、查询和计算检索；
- 基于页面的 HeavenBase LLM OCR，具有有界的文档句柄；
- 通过多个 CLI 后端公开的一个命令注册表；
- 从 HeavenBase 工具包生成的 MCP 工具；以及
- 一个教授代理应用程序工作流的打包 Skill。
直接 CLI 和 Python 翻译使用通过 `LLMSession` 配置的 HeavenBase 预设；MCP 主机使用它们自己的配置模型。
开发检查：
```console
git clone https://github.com/Magolor/GlossWise.git
cd GlossWise
bash scripts/sync-env.bash
bash scripts/flake.bash --ci
bash scripts/test.bash
bash scripts/test.bash -m full
uv build
```
参见 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取贡献工作流程和 [SECURITY.md](SECURITY.md) 以获取私有漏洞报告。
当前边界：HeavenBase 扩展被显式安装，启用的扩展不会被禁用，模式迁移不是自动的，GlossWise 不选择或隐藏翻译模型。
## 引用
如果 GlossWise 支持您的研究或项目，请使用 [CITATION.cff](CITATION.cff) 或以下方式引用该软件：
```bibtex
@software{glosswise_2026,
author = {Magolor},
title = {GlossWise: 面向 AI 代理的术语安全翻译},
year = {2026},
version = {0.1.0.5},
url = {https://github.com/Magolor/GlossWise}
}
```
GlossWise 建立在 [HeavenBase](https://ahvn.top) 之上。
## 许可证
GlossWise 在 [MIT License](LICENSE) 下可用。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器