From 317397154ef71b5a4c35b11a080eb2fa7bb614b1 Mon Sep 17 00:00:00 2001 From: kicer Date: Wed, 11 Nov 2026 17:31:04 +0800 Subject: [PATCH] =?UTF-8?q?feat(office):=20=E6=9C=AC=E5=9C=B0=E5=8F=AF?= =?UTF-8?q?=E7=94=A8=E2=80=94=E2=80=94install.sh=20=E8=B7=A8=E5=B9=B3?= =?UTF-8?q?=E5=8F=B0=E5=8F=96=E8=B5=84=E4=BA=A7=EF=BC=8CPATH=20=E7=9B=B4?= =?UTF-8?q?=E5=A1=9E=20scripts=20=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit office 技能本体(SKILL.md + Node 封装层 + officecli 二进制)本来就是跨平台的, 坏在两处容器假设:install.sh 只认 linux-x64、PATH 入口只写 /usr/local/bin。 - install.sh: 按 uname -s/-m 选资产(linux x64/arm64、mac x64/arm64),校验和 pin 到 上游 release 的 SHA256SUMS(八平台齐全,linux-x64 那行与原有 pin 完全一致); mac 没有 sha256sum,补 shasum -a 256 兜底;构建阶段判定提前到平台探测之前, 避免构建机架构未被识别时中断镜像构建 - 已在且能跑就沿用:officecli 会自更新到上游 latest(实测 1.0.157 跑一次变 1.0.160, 文件大小与 latest 资产一字节不差),用 pin 去比对只会反复重拉 34MB。服务器卷 :ro、 二进制不会漂,正常仍走 sha 比对,行为不变 - local/start.sh: 起 core 时把 skills/office/scripts 塞进 PATH(服务器靠镜像里的 /usr/local/bin 软链;本地没 root 写不了系统目录)。无需复制、无需改 app/ - 封装层 ENOENT 报错带上 install.sh 绝对路径,模型看到即可自行补装 本地实测(macOS x86_64):office create / view outline 正常;启动器不预下载,首次用到时 按报错跑一次 install.sh(GitHub 慢时自动换 gh-proxy,实测 27s)。 预览仍不可用(缺 executor 的 :3100 网关),已记入文档。 --- docs/local-mode.md | 21 +++++++++++ local/README.md | 3 ++ local/start.sh | 4 ++ skills/office/install.sh | 72 ++++++++++++++++++++++++++++-------- skills/office/scripts/office | 3 +- 5 files changed, 86 insertions(+), 17 deletions(-) diff --git a/docs/local-mode.md b/docs/local-mode.md index 1bfccf5..083080f 100644 --- a/docs/local-mode.md +++ b/docs/local-mode.md @@ -277,6 +277,25 @@ health 只作为「端口上有服务但不是本启动器拉起的」兜底提 需要系统库的包(`weasyprint` → pango/cairo)pip 装不了,仍需用户 `brew install`;这类不在 自动修复范围内,模型只报结论。 +### 4.14 `office` 本地化:平台矩阵 + PATH 直塞,不碰 `app/` + +`office` 技能是 `SKILL.md` + `scripts/office`(Node 封装层)+ `bin/officecli`(.NET 单文件二进制)。 +本地化只做两件小事: + +- **PATH**:服务器上靠镜像里的 `/usr/local/bin/office` 软链;本地没 root 写不了系统目录, + `start.sh` 起 core 时把 `skills/office/scripts` 直接塞进 `PATH`(脚本自身可执行,不复制、不装软链)。 + `terminal` 继承 core 的 env,模型调 `office ` 即命中。 +- **二进制**:`install.sh` 改成按 `uname -s/-m` 选资产(linux x64/arm64、mac x64/arm64), + 校验和 pin 到上游 release 的 `SHA256SUMS`(八个平台都有,不用猜);mac 没有 `sha256sum`, + 用 `shasum -a 256` 兜底。但已经存在的二进制只要能跑就沿用:officecli 会把自己更新到上游 + latest(实测 1.0.157 跑一次变 1.0.160,大小与 latest 资产完全一致),拿 pin 去比对只会反复 + 重拉 34MB。pin 因此只约束「本次下载的东西」;服务器上卷是 `:ro`,二进制不会漂,仍走 sha 比对。 + **启动器不预下载**:首次用到时,封装层报错里带 `install.sh` 的绝对路径, + 模型跑一次即可(~34MB,GitHub 慢时自动换 gh-proxy)。 + +没做的是预览:预览卡片要 executor 的 `:3100` 网关,本地没有。要补就相当于把 +`executor/preview.js` 的槽位管理搬进 core,不值得。 + ## 5. 验证结果(macOS 12.7.6 / x86_64 / Node 22.21 / python3 3.10 / 本机无 ffmpeg) 静态检查:`sh -n local/start.sh`、`sh -n local/stop.sh`、`node --check` 均通过。 @@ -348,6 +367,8 @@ tail -f local/.runtime/core.log # 以及 npm-install.log / mcp-*.log | Windows 不支持 | `spawn('/bin/sh')`、`process.kill(-pid)`、模型写的 bash 语法都是 POSIX 语义 | | `mint_public_link` 不可用 | 本地 `public_link.base_url` 为空,工具会回明确的「未配置」错误 | | 技能依赖 | 本地不预装:缺包时模型会把包装进 `skills/deps`(`$AGENT_SKILLS_DEPS`,已在该进程 `PYTHONPATH` 里,装完下次运行即生效);连 `python3` 都没有时也由它自己装。怎么装由模型自己决定。需要系统库的包(`weasyprint`→pango/cairo)pip 装不了,仍需手工 `brew install`。服务器上由 `agent-executor-init` 处理 | +| `office` 二进制 | 不入库、镜像阶段不下载:首次用到时由模型按报错提示跑一次 `skills/office/install.sh`(按 `uname` 选 linux/mac 资产,下载时校验和 pin 到上游 `SHA256SUMS`,约 34MB;GitHub 慢时自动换 gh-proxy)。不需要 root,装完不需重启。officecli 会自更新到上游 latest,版本比 pin 新属正常 | +| `office` 预览 | 预览卡片走 core → executor 的 `:3100` 网关,本地没有这个网关 → 点开打不开。文档创建/编辑/读取不受影响 | | 首个 `npm install` 要联网 | 支持 `NPM_REGISTRY` 覆盖源;`app/package-lock.json` 的 `resolved` 已改指向公共 registry(原来钉在内网镜像,外部机器必失败) | ## 8. 回滚 diff --git a/local/README.md b/local/README.md index f4cf282..fc9dec3 100644 --- a/local/README.md +++ b/local/README.md @@ -66,6 +66,7 @@ cd agent |---|---|---| | 语音输入 | `ffmpeg` + 设置页给 `asr` 填上游(`X-ASR-Base-Url` / `X-ASR-Model`) | 麦克风入口自动隐藏(`/api/asr/status` 返回 `enabled:false`),`mcp_asr` 子进程也不启动 | | 技能 | `python3`(仅 Python 类技能需要) | 技能清单照常显示;调 `run.py` 类技能报「入口启动失败」,`office` 这类非 Python 技能不受影响 | +| Office 文档(docx/xlsx/pptx) | 首次用到时下载一次 officecli 二进制(约 34MB) | `office` 命令报「binary missing」并给出 `skills/office/install.sh` 绝对路径,按提示跑一次即可(不需要 root、不需重启) | | 网页搜索 | 无 | 装了 Node 就有(内置免费后端) | | 图片 / 视频生成 | 设置页给对应 MCP 填上游 key | 调用时报明确的缺参错误 | @@ -139,6 +140,8 @@ git pull - **Windows 暂不支持**:本机执行走 `spawn('/bin/sh')` 与 `process.kill(-pid)`,都是 POSIX 语义。 - **`mint_public_link` 不可用**:`public_link.base_url` 未配置(本地生成的链接只有本机能打开), 模型调用该工具会得到明确的「未配置」错误。 +- **`office` 文档没有预览**:预览卡片走 core → executor 的 `:3100` 网关,本地没有这个网关, + 点开得不到可用页面;文档本身的创建/编辑/读取完全正常。 - **技能依赖不预装**:本地没有 `agent-executor-init`,`skills/*/requirements.txt` 不会在启动时 自动安装。技能缺包时会报 `ModuleNotFoundError`,模型会把缺的包装进 `skills/deps` (`AGENT_SKILLS_DEPS` 指向它,且已在该进程的 `PYTHONPATH` 里,装完下次运行即生效)。 diff --git a/local/start.sh b/local/start.sh index 44966bd..0120f18 100755 --- a/local/start.sh +++ b/local/start.sh @@ -822,6 +822,9 @@ start_core() { # 的 PYTHONPATH 对齐,那边由 compose 注入)。本地没有 agent-executor-init 替我们装包, # 所以另外把目录路径作为 AGENT_SKILLS_DEPS 传下去:模型在 terminal 里发现技能缺包时, # 按提示词里的写法 pip install --target "$AGENT_SKILLS_DEPS" 即可,技能下次运行就能 import。 + # PATH 前面加 skills/office/scripts:office 技能的唯一入口就是那个 Node 封装层。 + # 服务器上靠镜像里的 /usr/local/bin/office 软链进 PATH,本地没 root 写不了系统目录, + # 所以直接把目录塞进 PATH(脚本自身可执行,不复制、不装软链)。二进制缺时封装层会报 install.sh 路径。 ( cd "$ROOT/app" && exec env \ PORT="$PORT" \ HOST="$HOST_ADDR" \ @@ -831,6 +834,7 @@ start_core() { ASR_URL="$ASR_URL" \ PYTHONPATH="$ROOT/skills/deps" \ AGENT_SKILLS_DEPS="$ROOT/skills/deps" \ + PATH="$ROOT/skills/office/scripts:$PATH" \ node server/server.js >>"$LOG" 2>&1 ) & CORE_PID=$! } diff --git a/skills/office/install.sh b/skills/office/install.sh index e9e341a..c630872 100755 --- a/skills/office/install.sh +++ b/skills/office/install.sh @@ -1,39 +1,82 @@ #!/bin/bash # office 技能资产与入口(skills/README 5.2 约定:本脚本在「镜像构建(skills 阶段)」与「启动 init」两处都跑,必须幂等): # -# 1) 资产 bin/officecli —— officecli 官方 .NET 单文件二进制(v1.0.157 linux-x64)。 +# 1) 资产 bin/officecli —— officecli 官方 .NET 单文件二进制,按平台取对应 release 资产: +# Linux(x64/arm64) / macOS(x64/arm64)。Windows 暂不支持(要用时手工放置二进制并设 OFFICECLI_BIN)。 +# 校验和 pin 死,取自上游 release 的 SHA256SUMS(与下面 VER 对应)。注意 officecli 会自更新, +# 所以 sha 只约束「本次下载的资产」;已在且能跑的直接沿用(详见下方 usable() 的注释)。 # 不进 git(.gitignore 已排除 skills/office/bin/)、不进镜像:init 阶段写进宿主 ./skills 卷, # executor 容器以 :ro 挂到 /workspace/skills —— 运行期只读执行,改动版本=改本文件 pin 重启。 # 构建阶段($HERE 在 /tmp 下,产物即弃)跳过下载,只烘 PATH 入口。 -# 主源 GitHub,备源 gh-proxy(国内网络);sha256 必须等于 pin,宁缺毋错。 +# 主源 GitHub,备源 gh-proxy(国内网络)。 # 2) PATH 入口 /usr/local/bin/office -> <运行期技能根>/scripts/office —— 构建阶段写进镜像层持久; -# init 阶段根只读,|| true 静默(镜像里已就位)。officecli 二进制刻意不进 PATH:模型只见封装层。 +# init 阶段根只读,|| true 静默(镜像里已就位)。 +# 本地端(macOS)没有写 /usr/local/bin 的权限,这里会静默失败——不影响使用: +# local/start.sh 直接把 scripts 目录放进 PATH,本地同样能直接调 `office`。 # # 两个源都拉不到:exit 1(init 不写 marker,下次启动自动重试);救急可手动放置同名二进制到 # skills/office/bin/officecli(sha 对上即认),再 docker compose up -d 重跑 init。 +# +# 本地首次使用(macOS/Linux):bash skills/office/install.sh,装完即可 `office help`, +# 无需重启 agent(封装层每次执行时才解析二进制路径)。 set -u HERE="$(cd "$(dirname "$0")" && pwd)" VER=v1.0.157 -SHA=f8eefe88dbfa7464bee421e5421efe57fc26bc3180b30e56eef58594c8245c94 ASSET="$HERE/bin/officecli" ln -sfn "${EXECUTOR_SKILLS_DIR:-/workspace/skills}/office/scripts/office" /usr/local/bin/office 2>/dev/null || true -# 构建阶段:PATH 入口已烘,资产交给 init(避免每次 skills 层重建白拉 35MB) +# 构建阶段:PATH 入口已烘,资产交给 init(避免每次 skills 层重建白拉 35MB)。 +# 放在平台探测之前:构建阶段不下载,也就不该因为构建机架构不被识别而中断镜像构建。 case "$HERE" in /tmp/*) echo "[office] build stage: PATH 入口就位;bin/officecli 资产由 init 阶段落到技能卷"; exit 0 ;; esac -verify() { [ -f "$ASSET" ] && echo "$SHA $ASSET" | sha256sum -c - >/dev/null 2>&1; } +# 平台 → 资产名 + 官方校验和(SHA256SUMS@$VER) +case "$(uname -s)" in + Linux) + case "$(uname -m)" in + x86_64|amd64) NAME=officecli-linux-x64; SHA=f8eefe88dbfa7464bee421e5421efe57fc26bc3180b30e56eef58594c8245c94 ;; + aarch64|arm64) NAME=officecli-linux-arm64; SHA=60db926c8a1371984b9e99622a834777befb02b6f73d0f3fff914ffcc2760d2f ;; + *) echo "[office] 不支持的 Linux 架构:$(uname -m)" >&2; exit 1 ;; + esac ;; + Darwin) + case "$(uname -m)" in + x86_64) NAME=officecli-mac-x64; SHA=178c1e9ebaf44c24d2b4b359064a5dea6eb7b2f539809871a3de1c09599dff9f ;; + arm64) NAME=officecli-mac-arm64; SHA=0dae0990a9cc29688a5d54469f984c34e5b15ab6bbd194a0ffdc571bb9040124 ;; + *) echo "[office] 不支持的 macOS 架构:$(uname -m)" >&2; exit 1 ;; + esac ;; + *) + echo "[office] 本平台没有预置资产($(uname -s) $(uname -m)):手工放置二进制到 $ASSET 并设 OFFICECLI_BIN 即可" >&2 + exit 1 ;; +esac + +# macOS 默认没有 sha256sum,只有 shasum +sha_of() { + if command -v sha256sum >/dev/null 2>&1; then sha256sum "$1" | cut -d' ' -f1 + else shasum -a 256 "$1" | cut -d' ' -f1; fi +} + +verify() { [ -f "$ASSET" ] && [ "$(sha_of "$ASSET")" = "$SHA" ]; } + +# 已存在且能跑就算就位:officecli 会自更新到上游 latest(实测 1.0.157 跑一次就变成 1.0.160, +# 文件大小与 latest 资产完全一致),拿 sha pin 去比对已跑过的二进制只会反复重拉 34MB。 +# 校验和的意义因此收窄为「管本次下载的东西」;服务器上卷是 :ro,二进制不会漂,正常仍走 verify。 +usable() { [ -f "$ASSET" ] && "$ASSET" --version >/dev/null 2>&1; } if verify; then echo "[office] 资产已就位(sha 匹配):$ASSET" exit 0 fi +if usable; then + echo "[office] 资产已就位(版本 $("$ASSET" --version 2>/dev/null | head -1),与 pin 的 $VER 不同:officecli 自更新所致)" + exit 0 +fi + mkdir -p "$HERE/bin" -for u in "https://github.com/iOfficeAI/OfficeCLI/releases/download/$VER/officecli-linux-x64" \ - "https://gh-proxy.com/https://github.com/iOfficeAI/OfficeCLI/releases/download/$VER/officecli-linux-x64"; do +for u in "https://github.com/iOfficeAI/OfficeCLI/releases/download/$VER/$NAME" \ + "https://gh-proxy.com/https://github.com/iOfficeAI/OfficeCLI/releases/download/$VER/$NAME"; do echo "[office] 拉取 $u (connect<=10s, speed>=100KB/s, max 300s)" t0=$(date +%s) if curl -fL \ @@ -44,24 +87,21 @@ for u in "https://github.com/iOfficeAI/OfficeCLI/releases/download/$VER/officecl --retry 1 \ --progress-bar \ -o "$ASSET.tmp" "$u"; then - got="$(sha256sum "$ASSET.tmp" | cut -d' ' -f1)" + got="$(sha_of "$ASSET.tmp")" if [ "$got" = "$SHA" ]; then mv -f "$ASSET.tmp" "$ASSET" chmod 755 "$ASSET" - echo "[office] officecli $VER installed -> $ASSET ($(( $(date +%s) - t0 ))s)" + echo "[office] officecli $VER ($NAME) -> $ASSET ($(( $(date +%s) - t0 ))s)" break fi - echo "[office] sha256 mismatch (got $got), trying next source" + echo "[office] sha256 mismatch (got $got, want $SHA), trying next source" else echo "[office] $(( $(date +%s) - t0 ))s 后失败: $u" fi rm -f "$ASSET.tmp" done -if verify; then - echo "[office] 就绪:$ASSET" - exit 0 -else - echo "[office] 两个源都拉不到 bin/officecli —— 手动放置 $ASSET(sha 对上即认)后 docker compose up -d 重试" >&2 +if ! verify; then + echo "[office] 资产获取失败:两个源都没拿到匹配的二进制。稍后重跑本脚本,或手工放置到 $ASSET" >&2 exit 1 fi diff --git a/skills/office/scripts/office b/skills/office/scripts/office index f80dd76..4ebfba2 100755 --- a/skills/office/scripts/office +++ b/skills/office/scripts/office @@ -92,7 +92,8 @@ try { } if (r.error) { if (r.error.code === 'ENOENT') { - err('office.core binary missing: ' + BIN + ' (skill asset not fetched: docker compose up -d agent-executor-init to retry, or place it per skills/office/install.sh)'); + err('office.core binary missing: ' + BIN + '\nInstall it: bash ' + path.resolve(__dirname, '..', 'install.sh') + + ' (server: docker compose up -d agent-executor-init)'); } err(String(r.error.message || r.error)); }