@langlink/memoq-mcp 0.0.0-stage → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +45 -3
- package/THIRD_PARTY_NOTICES.txt +194 -0
- package/bin/MemoQ.Bridge.Helper.exe +0 -0
- package/dist/index.js +32163 -0
- package/dist/index.js.map +7 -0
- package/package.json +35 -4
- package/skills/memoq-live-qa/SKILL.md +20 -0
- package/skills/memoq-setup-troubleshoot/SKILL.md +24 -0
- package/skills/memoq-stage-translate/SKILL.md +31 -0
package/package.json
CHANGED
|
@@ -1,6 +1,37 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@langlink/memoq-mcp",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.2.2",
|
|
4
|
+
"private": false,
|
|
5
|
+
"type": "module",
|
|
6
|
+
"description": "LangLink memoQ connector over stdio MCP for WorkBuddy, Codex, ZCode, and Trae: live Preview read/jump, staged translations, confirmed feedback, and local setup wizard.",
|
|
7
|
+
"license": "MIT",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/langlink-tech/langlink-harness-toolsets.git",
|
|
11
|
+
"directory": "packages/memoq-mcp"
|
|
12
|
+
},
|
|
13
|
+
"publishConfig": {
|
|
14
|
+
"access": "public",
|
|
15
|
+
"registry": "https://registry.npmjs.org/"
|
|
16
|
+
},
|
|
17
|
+
"engines": {
|
|
18
|
+
"node": ">=22"
|
|
19
|
+
},
|
|
20
|
+
"main": "dist/index.js",
|
|
21
|
+
"bin": {
|
|
22
|
+
"langlink-memoq-mcp": "dist/index.js"
|
|
23
|
+
},
|
|
24
|
+
"files": [
|
|
25
|
+
"dist",
|
|
26
|
+
"bin",
|
|
27
|
+
"skills",
|
|
28
|
+
"README.md",
|
|
29
|
+
"LICENSE",
|
|
30
|
+
"THIRD_PARTY_NOTICES.txt"
|
|
31
|
+
],
|
|
32
|
+
"dependencies": {
|
|
33
|
+
"fflate": "^0.8.3",
|
|
34
|
+
"htmlparser2": "^12.0.0",
|
|
35
|
+
"saxes": "^6.0.0"
|
|
36
|
+
}
|
|
37
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: memoq-live-qa
|
|
3
|
+
description: Read live source/target segments and document context from memoQ Desktop via Preview pipe, run evidence-based QA, and jump memoQ focus to flagged segments.
|
|
4
|
+
whenToUse: The user asks to check, review, QA, or inspect the active segment or document currently open in memoQ Desktop.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# memoQ 实时质量检查(memoq-live-qa)
|
|
8
|
+
|
|
9
|
+
使用本地 Preview 通道读取当前 memoQ 编辑器内容——**无需安装 MT DLL、无需提权**。
|
|
10
|
+
|
|
11
|
+
## 执行流程
|
|
12
|
+
|
|
13
|
+
1. 先调用 `memoq_status` 检查 Preview 连接状态与当前打开的文档。
|
|
14
|
+
- 若 `preview.connected === false`,提示用户先打开 memoQ 并打开文档;如 memoQ 弹出外部预览工具授权框,点击允许。
|
|
15
|
+
2. 检查当前句段时,调用 `memoq_get_active_segment`。
|
|
16
|
+
- **严格检查 `mappingCertain`**:若 `mappingCertain === false`(例如选中了多段或过滤器未推送活动段),必须向用户明确说明原因,不要凭猜测下质量结论。
|
|
17
|
+
- 若用户要求检查整篇已缓存句段,分批调用 `memoq_get_document_segments`(`limit <= 50`),不要一次性拉取过多破坏上下文。
|
|
18
|
+
3. 结合项目术语/TM(如工作区有 `.langlink/manifest.json`,优先参考其中启用的资产)与 LangLink V1.1 质量标准逐条给出问题、原文/译文证据及修改建议。
|
|
19
|
+
- **注意**:Preview 通道默认传递 `Minimal` 纯文本,不包含 memoQ 专有内联标签(inline tags)。若需要精确检查或批量修复内联标签,建议用户从 memoQ 导出 `.mqxliff` 后交给 `l10n_*` 工具处理。
|
|
20
|
+
4. 若某句需要用户在 memoQ 中定位复核,调用 `memoq_focus_segment` 传入该句的 `previewPartId`,让 memoQ 编辑器直接跳转高亮到对应句段。
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: memoq-setup-troubleshoot
|
|
3
|
+
description: Guide the user through safe memoQ MT DLL setup, port 5271 coexistence with memoQ AI Hub, and Preview pipe troubleshooting without scary scripts.
|
|
4
|
+
whenToUse: The user asks how to connect memoQ, install the memoQ plugin DLL, or reports memoQ connection, port 5271, or Preview errors.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# memoQ 连接器安装与排错(memoq-setup-troubleshoot)
|
|
8
|
+
|
|
9
|
+
**禁止给用户粘贴 `powershell -ExecutionPolicy Bypass` 等提权脚本。**
|
|
10
|
+
|
|
11
|
+
## 标准处理步骤
|
|
12
|
+
|
|
13
|
+
1. 先调用 `memoq_status` 获取完整诊断信息:
|
|
14
|
+
- Preview 状态(`preview.state` / `preview.connected` / `preview.lastError`)
|
|
15
|
+
- 端口 5271 归属(`port5271Owner`)
|
|
16
|
+
- DLL 与 `ClientDevConfig.xml` 状态(`integration.status`)
|
|
17
|
+
2. **未安装或需要修复 DLL**:
|
|
18
|
+
- 若 `integration.canReuseExisting === true`:告知用户本机已有兼容的 `MemoQ.AI.Hub.Plugin.dll`,无需重复安装。
|
|
19
|
+
- 否则调用 `memoq_setup`,把返回的可点击链接发给用户。引导用户在本地向导页确认将写入的两个具体路径和 SHA-256 后,点击「一键安装 / 修复到 memoQ」(使用纯 .NET 原生拷贝与标准系统 UAC)。安装后需**重启 memoQ**并在 `Options → Default resources → MT settings` 勾选启用 `memoQ AI Hub`。
|
|
20
|
+
3. **端口 5271 被 `memoQ AI Hub` 占用**:
|
|
21
|
+
- 若 `port5271Owner === "memoq-ai-hub"`:说明用户同时开着 `memoQ AI Hub` 桌面端。Preview 读写和跳转完全不受影响;如需使用本连接器的暂存池/Agent 翻译,请用户在两个方案中二选一:① 暂时关闭 `memoQ AI Hub`;② 在 memoQ 插件 Options 中把网关端口改为 `5272` 并配置环境变量 `MEMOQ_BRIDGE_PORT=5272`。
|
|
22
|
+
4. **Preview 连接不到或无文本**:
|
|
23
|
+
- 确认 memoQ 已打开项目和具体文档(仅停留在项目仪表盘不会推送 Preview)。
|
|
24
|
+
- 某些特殊过滤器不提供目标预览;如仅需读源文可正常工作,如需无损编辑复杂标签建议导出 `.mqxliff`。
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: memoq-stage-translate
|
|
3
|
+
description: Translate or polish segments from memoQ Desktop using the current agent session and stage them into the local memoQ bridge for one-click Pre-translate pull inside memoQ (Direction A).
|
|
4
|
+
whenToUse: The user asks to translate, pre-translate, or polish segments from memoQ Desktop using this agent (Codex, WorkBuddy, etc.).
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# memoQ 会话翻译暂存闭环(Direction A:memoq-stage-translate)
|
|
8
|
+
|
|
9
|
+
采用**「Agent 翻译并暂存 → 译员在 memoQ 点选或 Pre-translate 拉取 → 人工确认回流」**闭环,直接使用当前对话模型和上下文,不额外消耗外部 MT API Key。
|
|
10
|
+
|
|
11
|
+
## 执行流程
|
|
12
|
+
|
|
13
|
+
1. **检查状态与参考定稿**:
|
|
14
|
+
- 调用 `memoq_status` 查看 Preview 状态与 `integration.status`。
|
|
15
|
+
- 调用 `memoq_get_confirmed_translations` 读取译员近期在 memoQ 中确认的译文,保持前后用词和风格一致。
|
|
16
|
+
2. **读取待翻内容**:
|
|
17
|
+
- 检查多文档与整项目视图:调用 `memoq_list_documents` 查看会话期间打开过的所有文档与拼接视图(`Create View -> Simply glue documents together` 可一次翻译整个项目全部文档)。
|
|
18
|
+
- 单句润色/翻译:调用 `memoq_get_active_segment`(带前后上下文 `contextBefore=2, contextAfter=2`)。
|
|
19
|
+
- 批量段落:使用 `memoq_get_document_segments({ onlyUntranslated: true, offset: 0, limit: 200 })` 分页读取(单页最高支持 `500`),按 `total` 遍历完所有 `offset` 批次,避免漏翻长列表末尾句段。
|
|
20
|
+
3. **翻译与暂存**:
|
|
21
|
+
- 结合术语表、上下文和已确认译文完成高质量翻译;**在 `targetText` 中原样保留占位符(如 `{value}`、`%s`)、游戏伪标签(如 `<CN-Medium>...</>`)及换行 `\n`**,使桥接器在 Pre-translate 时可 0ms 确定性回填 `<span data-mqitag="...">`。
|
|
22
|
+
- 调用 `memoq_stage_translations` 写入本地暂存池(注明 `documentId`、`previewPartId`、`sourceLanguage`、`targetLanguage`、`stagedBy`)。**默认以 `status: "draft"` 草稿状态暂存**,方便译员在审校工作台多轮检查与修订;若用户明确要求跳过审校直接可用,可传顶层参数 `status: "approved"`。
|
|
23
|
+
4. **审校、QA 体检与多轮修改闭环**:
|
|
24
|
+
- 返回结果里的 `reviewLink`(或调用 `memoq_open_review`)可直接在浏览器打开「双语审校与 QA 工作台」。
|
|
25
|
+
- 用户要对当前 memoQ 文档、跨多份打开文档(`allDocuments: true`)或暂存草稿做 QA 检查时,调用 `memoq_qa_document`(`scope` 可选 `memoq` / `staged` / `merged`),可结合 `.csv/.tbx` 术语表输出 23 条确定性规则问题与 MQM 评分,并在工作台中一键跳回 memoQ 对应句段。
|
|
26
|
+
- 用户在工作台标出修改意见后,调用 `memoq_list_staged({ status: "needs_revision", onlyWithComment: true })` 读取 `reviewComment` 逐条改好后重新调用 `memoq_stage_translations`(自动记录修订版本 `v1→v2...`)。
|
|
27
|
+
5. **处理复杂格式或特殊内联标签句段**:
|
|
28
|
+
- 若某句在 memoQ 中包含无法通过占位符对齐的格式标签(如 `<b>/<i>/<u>`)并被标签守卫记入 `memoq_get_recent_mt_requests`,调用 `memoq_get_recent_mt_requests({ onlyWithTags: true })` 获取 memoQ 发来的完整带标签 `text`(以及 `tmSource`/`tmTarget`),保留全部 `<span data-mqitag="...">` 和格式标签后通过 `sourceHtml` + `targetHtml` 重新暂存。
|
|
29
|
+
6. **放行定稿并写入 memoQ**:
|
|
30
|
+
- 若返回 `integrationReady: false`,调用 `memoq_setup` 给出本地安装引导页链接(切勿给用户发 PowerShell 脚本)。
|
|
31
|
+
- 用户确认最终版后,可在工作台点击「一键放行全部定稿到 memoQ」或由 Agent 调用 `memoq_approve_staged` 将状态切为 `approved`,再回 memoQ 点击目标句段或运行 **Pre-translate** 即可毫秒级写入,人工确认后的译文会自动回流供下一批参考。
|