feat(office): 本地可用——install.sh 跨平台取资产,PATH 直塞 scripts 目录
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 网关),已记入文档。
This commit is contained in:
@@ -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 <cmd>` 即命中。
|
||||
- **二进制**:`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. 回滚
|
||||
|
||||
@@ -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` 里,装完下次运行即生效)。
|
||||
|
||||
@@ -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=$!
|
||||
}
|
||||
|
||||
+56
-16
@@ -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
|
||||
|
||||
@@ -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));
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user