@langlink/memoq-mcp 0.2.2 → 0.2.4

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@langlink/memoq-mcp",
3
- "version": "0.2.2",
3
+ "version": "0.2.4",
4
4
  "private": false,
5
5
  "type": "module",
6
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.",
@@ -1,12 +1,12 @@
1
1
  ---
2
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.
3
+ description: Guide the user through safe Agent-assisted memoQ MT DLL discovery and confirm-before-copy setup, port 5271 coexistence with memoQ AI Hub, and Preview pipe troubleshooting without scary scripts.
4
4
  whenToUse: The user asks how to connect memoQ, install the memoQ plugin DLL, or reports memoQ connection, port 5271, or Preview errors.
5
5
  ---
6
6
 
7
7
  # memoQ 连接器安装与排错(memoq-setup-troubleshoot)
8
8
 
9
- **禁止给用户粘贴 `powershell -ExecutionPolicy Bypass` 等提权脚本。**
9
+ **禁止给用户粘贴 `powershell -ExecutionPolicy Bypass` 等提权脚本,禁止跳过用户确认直接写入 `Addins` 或 `ClientDevConfig.xml`。**
10
10
 
11
11
  ## 标准处理步骤
12
12
 
@@ -14,9 +14,17 @@ whenToUse: The user asks how to connect memoQ, install the memoQ plugin DLL, or
14
14
  - Preview 状态(`preview.state` / `preview.connected` / `preview.lastError`)
15
15
  - 端口 5271 归属(`port5271Owner`)
16
16
  - DLL 与 `ClientDevConfig.xml` 状态(`integration.status`)
17
- 2. **未安装或需要修复 DLL**:
17
+ 2. **未安装或需要修复 DLL(Agent 找路径 → 确认 → 复制安装)**:
18
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`。
19
+ - 否则先调用只读预检:`memoq_setup({ action: "plan" })`(若用户提供了本地 `.dll` / `.zip` 路径或自定义 memoQ 目录,一并传入 `dllPath` / `customInstallDir`)。
20
+ - 工具会自动探测运行中 `MemoQ.exe` 进程路径、Windows 注册表与本机盘符中的 memoQ 安装目录,以及常用目录中的 `MemoQ.AI.Hub.Plugin.dll` / 发布 `.zip` 包。
21
+ - **在对话中把 `plan.plannedChanges` 的精确内容列给用户确认**:
22
+ 1. 源文件路径与种类(复制安装,**保留原文件不删除**)及 SHA-256 校验值;
23
+ 2. 目标路径(`<memoqRoot>\Addins\MemoQ.AI.Hub.Plugin.dll`,自动清除 MOTW);
24
+ 3. 配置变更(`C:\ProgramData\MemoQ\ClientDevConfig.xml`,如存在先备份 `.bak` 再启用 `LoadUnsignedPlugins`);
25
+ 4. 若 `requiresElevation: true`,提前说明将触发一次系统原生 UAC 提权弹窗。
26
+ - **等待用户明确回复确认后**,再调用 `memoq_setup({ action: "install", confirmed: true, memoqRoot, dllPath })` 执行受控 Helper 安装;也可同时附上返回的本地可视化向导链接作为备选兜底。
27
+ - 安装完成后提示用户**完全重启 memoQ**并在 `Options → Default resources → MT settings` 勾选启用 `memoQ AI Hub`。
20
28
  3. **端口 5271 被 `memoQ AI Hub` 占用**:
21
29
  - 若 `port5271Owner === "memoq-ai-hub"`:说明用户同时开着 `memoQ AI Hub` 桌面端。Preview 读写和跳转完全不受影响;如需使用本连接器的暂存池/Agent 翻译,请用户在两个方案中二选一:① 暂时关闭 `memoQ AI Hub`;② 在 memoQ 插件 Options 中把网关端口改为 `5272` 并配置环境变量 `MEMOQ_BRIDGE_PORT=5272`。
22
30
  4. **Preview 连接不到或无文本**: