根因：启动器的运行时解析第三顺位是开发检出 ~/Dev/ant/ant-copilot，同事机器没有该目录 → 插件装上、MCP 起不来；而私有 registry 匿名读返回 401，走 npm 安装等于要求每台机器都配 Gitea token。 改法：① 打包产物随插件分发（plugins/<产品>/runtime/，3.96MB 自包含单文件 + manifest 记录来源版本/提交/大小/sha256）；② 启动器每次拉起比对 sha256，缺失或被改动即从插件包安装到 ~/.deta/runtime（首次启动零操作、升级自动同步）；③ 新增 deta install-runtime（显式安装 + 补装可选依赖 @resvg/resvg-js + 装完立刻做一次真实 MCP 握手自证），status/doctor 显示运行时来源与预览图依赖状态；④ 契约校验加 E6：运行时包必须自洽（sha256/字节数/manifest.pluginVersion 与插件版本一致），拦住“升版本忘重跑 sync-runtime”。 实测：全新 HOME（模拟同事机器、无开发检出、无凭据）下供给探针 10/10 通过 —— 首次启动自动安装、启动行指向沙箱运行时、install-runtime 握手 39 个工具、重复安装幂等、运行时被改动自动修复、插件包缺运行时两处都给打包缺陷指引；已装副本 0.3.14 独立验证（含 npm 自动补装 @resvg 2 包）。studio 0.3.14 / writer 0.1.5。
This commit is contained in:
ringo
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "writer",
|
||||
"version": "0.1.4",
|
||||
"version": "0.1.5",
|
||||
"description": "DETA Writer 插件：读取建筑模型与模拟结果，产出报告 / 文档内容。",
|
||||
"author": {
|
||||
"name": "DETA",
|
||||
|
||||
@@ -14,8 +14,9 @@
|
||||
* 纪律：本文件**永不打印令牌**，只报告来源与长度；密码/验证码一律由 deta-login.mjs
|
||||
* 在用户自己的终端里交互读取（不回显）。
|
||||
*/
|
||||
import { spawn } from 'node:child_process';
|
||||
import { existsSync, readFileSync } from 'node:fs';
|
||||
import { spawn, spawnSync } from 'node:child_process';
|
||||
import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync } from 'node:fs';
|
||||
import { createHash } from 'node:crypto';
|
||||
import { homedir } from 'node:os';
|
||||
import { dirname, join, resolve, basename } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
@@ -64,13 +65,135 @@ function cmdLogin(argv) {
|
||||
child.on('exit', (code) => process.exit(code ?? 1));
|
||||
}
|
||||
|
||||
/**
|
||||
* 运行时供给：插件包自带打包产物 → 安装到 `~/.deta/runtime`。
|
||||
*
|
||||
* 为什么随插件分发而不是 npm 安装：`@ringoarch/ant-copilot` 在私有 registry 上，匿名读 401，
|
||||
* 走 npm 等于要求每台同事机器都配 token。打包产物是自包含单文件，插件包带上即可「装插件就能用」。
|
||||
* 启动器每次拉起都会做同样的幂等检查（缺失/不一致就补）——本命令是它的**显式版 + 自证版**，
|
||||
* 用于首次核对、补装可选依赖、以及排障（装完立刻做一次真实 MCP 握手）。
|
||||
*/
|
||||
|
||||
/** 插件包内的运行时位置 */
|
||||
function bundledRuntime() {
|
||||
const dir = join(HERE, '..', 'runtime');
|
||||
return { dir, entry: join(dir, 'dist', 'deta-mcp.mjs'), manifestPath: join(dir, 'manifest.json') };
|
||||
}
|
||||
|
||||
function sha256File(p) {
|
||||
try {
|
||||
return createHash('sha256').update(readFileSync(p)).digest('hex');
|
||||
} catch {
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
function readJson(p) {
|
||||
try {
|
||||
return JSON.parse(readFileSync(p, 'utf8'));
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/** 运行时溯源描述（给 status / doctor 用；永不打印凭据） */
|
||||
function runtimeProvenance(root) {
|
||||
const m = readJson(join(root, 'manifest.json'));
|
||||
if (!m) return '';
|
||||
const sha = sha256File(join(root, 'dist', 'deta-mcp.mjs'));
|
||||
const verdict = sha && sha === m.sha256 ? 'sha 一致' : 'sha 不一致（运行时被改动或拷贝不完整，跑 deta install-runtime --force 重装）';
|
||||
const size = typeof m.bytes === 'number' ? ` · ${(m.bytes / 1048576).toFixed(2)}MB` : '';
|
||||
return `${m.source ?? '?'}@${m.version ?? '?'} (${m.gitSha ?? '?'})${size} · ${verdict}`;
|
||||
}
|
||||
|
||||
/** 候选预览图的栅格化依赖（可选）：缺失只影响候选预览图 */
|
||||
function resvgReady(root) {
|
||||
return existsSync(join(root, 'node_modules', '@resvg', 'resvg-js', 'package.json'));
|
||||
}
|
||||
|
||||
async function cmdInstallRuntime(argv) {
|
||||
const force = argv.includes('--force');
|
||||
const noResvg = argv.includes('--no-resvg');
|
||||
const b = bundledRuntime();
|
||||
|
||||
if (!existsSync(b.entry)) {
|
||||
console.error(`✗ 插件包内没有运行时：${b.entry}`);
|
||||
console.error(' 这是打包缺陷（插件应由 scripts/sync-runtime.mjs 带上运行时）。');
|
||||
console.error(' 处置：重装插件（codex plugin remove <插件>@deta && codex plugin add <插件>@deta）；');
|
||||
console.error(' 开发态则在插件仓执行 node scripts/sync-runtime.mjs。');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const manifest = readJson(b.manifestPath) ?? {};
|
||||
const srcSha = sha256File(b.entry);
|
||||
if (manifest.sha256 && srcSha !== manifest.sha256) {
|
||||
console.error(`✗ 插件包内运行时与 manifest 不一致（包内 sha ${String(srcSha).slice(0, 12)}… ≠ manifest ${String(manifest.sha256).slice(0, 12)}…）`);
|
||||
console.error(' 处置：在插件仓重跑 node scripts/sync-runtime.mjs 并重装插件。');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const target = join(DETA_DIR, 'runtime');
|
||||
const targetEntry = join(target, 'dist', 'deta-mcp.mjs');
|
||||
const installedSha = sha256File(targetEntry);
|
||||
const same = installedSha && installedSha === srcSha;
|
||||
const sizeMb = (statSync(b.entry).size / 1048576).toFixed(2);
|
||||
|
||||
if (same && !force) {
|
||||
console.log(`✓ 运行时已是最新：${target}（${sizeMb}MB · ${b.manifestPath ? `来自 ${manifest.source ?? '?'}@${manifest.version ?? '?'} (${manifest.gitSha ?? '?'})` : ''}）`);
|
||||
} else {
|
||||
mkdirSync(join(target, 'dist'), { recursive: true });
|
||||
copyFileSync(b.entry, targetEntry);
|
||||
if (existsSync(b.manifestPath)) copyFileSync(b.manifestPath, join(target, 'manifest.json'));
|
||||
const verify = sha256File(targetEntry);
|
||||
if (verify !== srcSha) {
|
||||
console.error(`✗ 安装后校验失败：${targetEntry} 与源不一致`);
|
||||
process.exit(1);
|
||||
}
|
||||
console.log(`✓ 已安装运行时到 ${target}（${sizeMb}MB · sha ${srcSha.slice(0, 12)}… · 来自 ${manifest.source ?? '?'}@${manifest.version ?? '?'} (${manifest.gitSha ?? '?'})）`);
|
||||
}
|
||||
|
||||
// 可选依赖：候选预览图的 SVG 栅格化（缺了只是没有预览图，不影响其他能力）
|
||||
if (noResvg) {
|
||||
console.log('· 已按 --no-resvg 跳过 @resvg/resvg-js（候选预览图不可用）');
|
||||
} else if (resvgReady(target) && !force) {
|
||||
console.log('✓ 候选预览图依赖 @resvg/resvg-js 已就绪');
|
||||
} else {
|
||||
console.log('· 正在安装候选预览图依赖 @resvg/resvg-js（可选，需要联网访问公共 npm）…');
|
||||
const r = spawnSync('npm', ['i', '--prefix', target, '--no-save', '--no-audit', '--no-fund', '--loglevel=error', '@resvg/resvg-js@^2'], { stdio: 'inherit' });
|
||||
if (r.error || r.status !== 0) {
|
||||
console.log('! @resvg/resvg-js 未装上（自动安装失败）——其余能力不受影响，仅候选预览图不可用。');
|
||||
console.log(` 手动补装：npm i --prefix "${target}" @resvg/resvg-js@^2`);
|
||||
if (r.error) console.log(` 原因：${r.error.message}`);
|
||||
} else {
|
||||
console.log('✓ 候选预览图依赖 @resvg/resvg-js 已就绪');
|
||||
}
|
||||
}
|
||||
|
||||
// 装完立刻做一次真实 MCP 握手——「装上了」不等于「起得来」
|
||||
const launcher = join(HERE, 'deta-mcp.sh');
|
||||
const r = await smokeMcp(launcher, PROFILE);
|
||||
if (r.ok) {
|
||||
console.log(`✓ MCP 握手通过（--profile ${PROFILE}）：${r.tools} 个工具${r.tokenLine ? ` · ${r.tokenLine.trim()}` : ''}`);
|
||||
console.log('\n宿主里的下一步：退出并重启宿主应用（或开新会话）即可看到工具。');
|
||||
} else {
|
||||
console.error(`✗ MCP 握手失败：${r.detail}`);
|
||||
console.error(' 排障：~/.deta/bin/deta doctor；仍不行时看启动器输出的运行时路径是否正确。');
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
function cmdStatus() {
|
||||
const { source, token, meta } = readToken();
|
||||
console.log(`凭据：${token ? `已存在（来源 ${source}，长度 ${token.length}）` : '未登录'}`);
|
||||
if (meta?.username) console.log(`账号：${meta.username}（登录于 ${meta.loginAt ?? '未知'}）`);
|
||||
console.log(`工作区：${process.env.DETA_WORKSPACE || join(DETA_DIR, PROFILE, 'workspace')}`);
|
||||
const runtime = resolveRuntime();
|
||||
console.log(`运行时：${runtime || '未找到（需要本机引擎包或 DETA_SERVER_ROOT）'}`);
|
||||
console.log(`运行时：${runtime || '未找到（插件包自带运行时，正常应由启动器自动安装到 ~/.deta/runtime）'}`);
|
||||
if (runtime) {
|
||||
const prov = runtimeProvenance(runtime);
|
||||
console.log(` · 来源：${prov || '开发检出（非打包运行时，仅开发机可见）'}`);
|
||||
console.log(` · 候选预览图依赖 @resvg/resvg-js：${resvgReady(runtime) ? '已就绪' : '缺失（跑 deta install-runtime 补装；不影响其他能力）'}`);
|
||||
}
|
||||
if (!token) console.log('\n未登录时云类工具（项目列表 / 同步 / 打开 Studio）会返回 auth_required；跑 `deta login` 即可。');
|
||||
}
|
||||
|
||||
@@ -118,7 +241,12 @@ async function cmdDoctor() {
|
||||
const say = (ok, label, detail) => { console.log(`${ok ? '✓' : '✗'} ${label}${detail ? ` —— ${detail}` : ''}`); if (!ok) failed += 1; };
|
||||
|
||||
const runtime = resolveRuntime();
|
||||
say(Boolean(runtime), '领域服务运行时', runtime || '未找到：装本机引擎包到 ~/.deta/runtime，或设 DETA_SERVER_ROOT');
|
||||
say(Boolean(runtime), '领域服务运行时', runtime || '未找到：插件包自带时应由启动器自动装到 ~/.deta/runtime；否则设 DETA_SERVER_ROOT');
|
||||
if (runtime) {
|
||||
console.log(` · 来源：${runtimeProvenance(runtime) || '开发检出（非打包运行时）'}`);
|
||||
const hasResvg = resvgReady(runtime);
|
||||
console.log(` · 候选预览图依赖 @resvg/resvg-js：${hasResvg ? '已就绪' : '缺失 —— 跑 deta install-runtime 补装（只影响候选预览图）'}`);
|
||||
}
|
||||
|
||||
const { source, token } = readToken();
|
||||
say(Boolean(token), '云凭据', token ? `已存在（来源 ${source}，长度 ${token.length}）` : '未登录：跑 `~/.deta/bin/deta login`');
|
||||
@@ -147,18 +275,21 @@ switch (cmd) {
|
||||
case 'login': cmdLogin(rest); break;
|
||||
case 'status': cmdStatus(); break;
|
||||
case 'doctor': await cmdDoctor(); break;
|
||||
case 'install-runtime': await cmdInstallRuntime(rest); break;
|
||||
case 'help':
|
||||
case '--help':
|
||||
case '-h':
|
||||
console.log(`DETA 命令行（插件自动注册为 ~/.deta/bin/deta）
|
||||
|
||||
deta login [--identifier <账号>] [--email-code <邮箱>] 登录 deta.city（凭据写入 ~/.deta/）
|
||||
deta install-runtime [--force] [--no-resvg] 安装/更新领域服务运行时 + 可选预览图依赖
|
||||
deta status 查看凭据来源 / 运行时 / 工作区
|
||||
deta doctor 端到端自检（运行时、凭据、GSA、MCP 握手）
|
||||
|
||||
运行时通常无需手动安装：启动器会在插件升级后自动同步到 ~/.deta/runtime。
|
||||
登录后开新会话即可让宿主读到凭据（无需 source / launchctl / 重启应用）。`);
|
||||
break;
|
||||
default:
|
||||
console.error(`未知命令：${cmd}（可用：login / status / doctor）`);
|
||||
console.error(`未知命令：${cmd}（可用：login / install-runtime / status / doctor）`);
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
@@ -26,6 +26,30 @@ while [ $# -gt 0 ]; do
|
||||
esac
|
||||
done
|
||||
|
||||
PLUGIN_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
|
||||
# ── 运行时自备：插件包内自带打包产物（同事机器没有开发检出，也拿不到私有 registry）──
|
||||
# 缺失或与插件包不一致时自动安装到 $HOME/.deta/runtime；只比 sha256，命中即跳过（4MB 哈希约 20ms）。
|
||||
# 为什么随插件分发：私有 registry 匿名读 401，走 npm 会让每个同事机器都要配 token。
|
||||
RUNTIME_DIR="$HOME/.deta/runtime"
|
||||
BUNDLED="$PLUGIN_ROOT/runtime/dist/deta-mcp.mjs"
|
||||
if [ -f "$BUNDLED" ]; then
|
||||
WANT_SHA="$(shasum -a 256 "$BUNDLED" 2>/dev/null | cut -d' ' -f1)"
|
||||
HAVE_SHA=""
|
||||
if [ -f "$RUNTIME_DIR/dist/deta-mcp.mjs" ]; then
|
||||
HAVE_SHA="$(shasum -a 256 "$RUNTIME_DIR/dist/deta-mcp.mjs" 2>/dev/null | cut -d' ' -f1)"
|
||||
fi
|
||||
if [ -n "$WANT_SHA" ] && [ "$WANT_SHA" != "$HAVE_SHA" ]; then
|
||||
mkdir -p "$RUNTIME_DIR/dist" 2>/dev/null || true
|
||||
if cp "$BUNDLED" "$RUNTIME_DIR/dist/deta-mcp.mjs" 2>/dev/null; then
|
||||
if [ -f "$PLUGIN_ROOT/runtime/manifest.json" ]; then
|
||||
cp "$PLUGIN_ROOT/runtime/manifest.json" "$RUNTIME_DIR/manifest.json" 2>/dev/null || true
|
||||
fi
|
||||
echo "[deta] 已从插件包安装运行时到 ${RUNTIME_DIR}" >&2
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
# ── 运行时解析：显式 DETA_SERVER_ROOT → 本机引擎包安装位置 → 本机开发检出（打印提示）──
|
||||
ROOT="${DETA_SERVER_ROOT:-}"
|
||||
if [ -z "$ROOT" ]; then
|
||||
@@ -70,7 +94,6 @@ export DETA_TOOL_SURFACE="${DETA_SURFACE:-full}"
|
||||
|
||||
# ── 稳定入口：把命令行门面注册为 ~/.deta/bin/deta（幂等，路径随插件更新自动刷新）──
|
||||
# 插件装在宿主缓存目录，用户看不见这个路径；而用户与工具回执都需要一条可复制的命令。
|
||||
PLUGIN_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
BIN_DIR="$HOME/.deta/bin"
|
||||
SHIM="$BIN_DIR/deta"
|
||||
SHIM_BODY="#!/bin/sh
|
||||
@@ -123,4 +146,9 @@ fi
|
||||
|
||||
echo "[deta] 档位=${PROFILE} 运行时=${ROOT} 工作区=${WS} 工具面=${DETA_TOOL_SURFACE} 云令牌=${CLOUD_STATE} 网关桥=${BRIDGE_STATE}" >&2
|
||||
|
||||
# ── 可选依赖提示：缺 @resvg/resvg-js 只影响候选预览图，其余能力不受影响 ──
|
||||
if [ ! -f "$ROOT/node_modules/@resvg/resvg-js/package.json" ]; then
|
||||
echo "[deta] 提示：候选预览图需要 @resvg/resvg-js；运行 ~/.deta/bin/deta install-runtime 补装（其余能力不受影响）" >&2
|
||||
fi
|
||||
|
||||
exec node "$ENTRY" "$@"
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "deta-writer-plugin",
|
||||
"version": "0.1.4",
|
||||
"version": "0.1.5",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "deta-writer-plugin",
|
||||
"version": "0.1.4",
|
||||
"version": "0.1.5",
|
||||
"license": "Proprietary"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "deta-writer-plugin",
|
||||
"version": "0.1.4",
|
||||
"version": "0.1.5",
|
||||
"description": "DETA Writer：建筑性能报告与文档产出（Codex 插件 / dsh 组合包 双壳）",
|
||||
"type": "module",
|
||||
"license": "Proprietary",
|
||||
|
||||
+96086
File diff suppressed because one or more lines are too long
@@ -0,0 +1,12 @@
|
||||
{
|
||||
"source": "@ringoarch/ant-copilot",
|
||||
"version": "0.2.2",
|
||||
"gitSha": "984a816",
|
||||
"builtAt": "2026-09-20T08:38:38.048Z",
|
||||
"entry": "dist/deta-mcp.mjs",
|
||||
"sha256": "db05fa93049977fe69846b296e51ee6b9245552e8d96928589911c0051e8ee59",
|
||||
"bytes": 4153494,
|
||||
"note": "由 scripts/sync-runtime.mjs 生成；勿手工编辑。安装到 ~/.deta/runtime 由启动器/install-runtime 完成。",
|
||||
"plugin": "writer",
|
||||
"pluginVersion": "0.1.5"
|
||||
}
|
||||
Reference in New Issue
Block a user