trustbase-seller-backend 0.1.5

package/core/distributed.js

@@ -0,0 +1,422 @@
+"use strict";
+/**
+ * TrustChain Distributed Indexer
+ *
+ * 分布式索引架构
+ * 目标：并发能力从100/s → 1000/s
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DistributedIndexer = exports.ShardStrategy = exports.DEFAULT_DISTRIBUTED_CONFIG = void 0;
+const events_1 = require("events");
+exports.DEFAULT_DISTRIBUTED_CONFIG = {
+    shards: [],
+    replicationFactor: 2,
+    queryTimeout: 5000,
+};
+/**
+ * 分片策略
+ */
+class ShardStrategy {
+    /**
+     * 根据SKU ID计算分片
+     */
+    static getShardForProduct(skuId, totalShards) {
+        // 使用SKU ID的哈希值进行分片
+        const hash = this.hashString(skuId);
+        return hash % totalShards;
+    }
+    /**
+     * 根据卖家地址计算分片
+     */
+    static getShardForSeller(address, totalShards) {
+        const hash = this.hashString(address);
+        return hash % totalShards;
+    }
+    /**
+     * 字符串哈希
+     */
+    static hashString(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32bit integer
+        }
+        return Math.abs(hash);
+    }
+}
+exports.ShardStrategy = ShardStrategy;
+/**
+ * 分布式索引器
+ */
+class DistributedIndexer extends events_1.EventEmitter {
+    name = 'distributed-indexer';
+    displayName = 'Distributed Indexer';
+    tier = 3;
+    maxCapacity = 1000000;
+    config;
+    shards = new Map();
+    localIndexer;
+    constructor(config = exports.DEFAULT_DISTRIBUTED_CONFIG) {
+        super();
+        this.config = config;
+        // 初始化分片
+        for (const shard of config.shards) {
+            this.shards.set(shard.id, shard);
+        }
+    }
+    /**
+     * 设置本地索引器
+     */
+    setLocalIndexer(indexer) {
+        this.localIndexer = indexer;
+    }
+    /**
+     * 启动分布式索引器
+     */
+    async start() {
+        console.log('[Distributed] Starting distributed indexer');
+        console.log(`[Distributed] Shards: ${this.shards.size}`);
+        // 检查所有分片状态
+        await this.checkShardsHealth();
+        console.log('[Distributed] Started successfully');
+    }
+    /**
+     * 停止分布式索引器
+     */
+    async stop() {
+        console.log('[Distributed] Stopped');
+    }
+    /**
+     * 检查分片健康状态
+     */
+    async checkShardsHealth() {
+        for (const [id, shard] of this.shards) {
+            try {
+                const response = await fetch(`${shard.node}/health`, {
+                    method: 'GET',
+                });
+                shard.status = response.ok ? 'active' : 'inactive';
+                console.log(`[Distributed] Shard ${id}: ${shard.status}`);
+            }
+            catch (error) {
+                shard.status = 'inactive';
+                console.error(`[Distributed] Shard ${id} health check failed: ${error.message}`);
+            }
+        }
+    }
+    /**
+     * 分布式搜索
+     */
+    async search(query) {
+        const startTime = Date.now();
+        // 获取活跃的分片
+        const activeShards = Array.from(this.shards.values())
+            .filter(s => s.status === 'active');
+        if (activeShards.length === 0) {
+            console.warn('[Distributed] No active shards available, using local indexer');
+            if (this.localIndexer) {
+                return this.localIndexer.search(query);
+            }
+            return { total: 0, results: [], meta: { queryTimeMs: 0, indexerName: 'distributed-indexer', coverage: 'none' } };
+        }
+        // 并行查询所有分片
+        const queryPromises = activeShards.map(shard => this.queryShard(shard, query));
+        try {
+            // 等待所有查询完成（带超时）
+            const results = await Promise.allSettled(queryPromises.map(p => this.withTimeout(p, this.config.queryTimeout)));
+            // 合并结果
+            return this.mergeResults(results, startTime);
+        }
+        catch (error) {
+            console.error(`[Distributed] Search failed: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * 查询单个分片
+     */
+    async queryShard(shard, query) {
+        const response = await fetch(`${shard.node}/api/search`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(query),
+        });
+        if (!response.ok) {
+            throw new Error(`Shard ${shard.id} query failed: ${response.status}`);
+        }
+        return await response.json();
+    }
+    /**
+     * 合并搜索结果
+     */
+    mergeResults(results, startTime) {
+        const mergedResults = [];
+        let totalCount = 0;
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                mergedResults.push(...result.value.results);
+                totalCount += result.value.total;
+            }
+        }
+        // 按TrustScore排序
+        mergedResults.sort((a, b) => (b.trustScore || 0) - (a.trustScore || 0));
+        const latency = Date.now() - startTime;
+        return {
+            total: totalCount,
+            results: mergedResults,
+            meta: {
+                queryTimeMs: latency,
+                indexerName: 'distributed-indexer',
+                coverage: 'distributed',
+            },
+        };
+    }
+    /**
+     * 带超时的Promise
+     */
+    withTimeout(promise, timeoutMs) {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error('Query timeout')), timeoutMs)),
+        ]);
+    }
+    /**
+     * 索引商品（路由到对应分片）
+     */
+    async indexProduct(product) {
+        const shardId = this.getShardIdForProduct(product.skuId);
+        const shard = this.shards.get(shardId);
+        if (!shard || shard.status === 'inactive') {
+            // 使用本地索引器
+            if (this.localIndexer) {
+                return this.localIndexer.indexProduct(product);
+            }
+            throw new Error(`No active shard for product ${product.skuId}`);
+        }
+        // 发送到对应分片
+        const response = await fetch(`${shard.node}/api/products`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(product),
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to index product on shard ${shardId}`);
+        }
+    }
+    /**
+     * 获取商品对应的分片ID
+     */
+    getShardIdForProduct(skuId) {
+        const shardIndex = ShardStrategy.getShardForProduct(skuId, this.shards.size);
+        const shardArray = Array.from(this.shards.keys());
+        return shardArray[shardIndex] || shardArray[0];
+    }
+    /**
+     * 更新商品
+     */
+    async updateProduct(product) {
+        return this.indexProduct(product);
+    }
+    /**
+     * 删除商品
+     */
+    async removeProduct(skuId) {
+        const shardId = this.getShardIdForProduct(skuId);
+        const shard = this.shards.get(shardId);
+        if (!shard || shard.status === 'inactive') {
+            if (this.localIndexer) {
+                return this.localIndexer.removeProduct(skuId);
+            }
+            throw new Error(`No active shard for product ${skuId}`);
+        }
+        const response = await fetch(`${shard.node}/api/products/${skuId}`, {
+            method: 'DELETE',
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to remove product on shard ${shardId}`);
+        }
+    }
+    /**
+     * 索引卖家
+     */
+    async indexSeller(seller) {
+        if (this.localIndexer) {
+            return this.localIndexer.indexSeller(seller);
+        }
+    }
+    /**
+     * 更新卖家
+     */
+    async updateSeller(seller) {
+        return this.indexSeller(seller);
+    }
+    /**
+     * 索引评价
+     */
+    async indexReview(review) {
+        if (this.localIndexer) {
+            return this.localIndexer.indexReview(review);
+        }
+    }
+    /**
+     * 获取评价列表
+     */
+    async getReviews(address, limit, offset) {
+        if (this.localIndexer) {
+            return this.localIndexer.getReviews(address, limit, offset);
+        }
+        return [];
+    }
+    /**
+     * 提交评价（写入本地）
+     */
+    async addReview(review) {
+        if (this.localIndexer) {
+            return this.localIndexer.addReview(review);
+        }
+    }
+    /**
+     * 索引订单
+     */
+    async indexOrder(order) {
+        if (this.localIndexer) {
+            return this.localIndexer.indexOrder(order);
+        }
+    }
+    /**
+     * 获取卖家信息
+     */
+    async getSeller(address) {
+        if (this.localIndexer) {
+            return this.localIndexer.getSeller(address);
+        }
+        return null;
+    }
+    /**
+     * 获取商品信息
+     */
+    async getProduct(skuId) {
+        const shardId = this.getShardIdForProduct(skuId);
+        const shard = this.shards.get(shardId);
+        if (!shard || shard.status === 'inactive') {
+            if (this.localIndexer) {
+                return this.localIndexer.getProduct(skuId);
+            }
+            return null;
+        }
+        const response = await fetch(`${shard.node}/api/products/${skuId}`);
+        if (!response.ok) {
+            return null;
+        }
+        return await response.json();
+    }
+    /**
+     * 获取统计信息
+     */
+    async getStats() {
+        // 聚合所有分片的统计信息
+        const shardStats = await Promise.all(Array.from(this.shards.values())
+            .filter(s => s.status === 'active')
+            .map(shard => this.getShardStats(shard)));
+        // 合并统计信息
+        return this.aggregateStats(shardStats);
+    }
+    /**
+     * 获取分片统计信息
+     */
+    async getShardStats(shard) {
+        try {
+            const response = await fetch(`${shard.node}/api/stats`);
+            return await response.json();
+        }
+        catch (error) {
+            return {
+                totalProducts: 0,
+                totalSellers: 0,
+                totalReviews: 0,
+                totalOrders: 0,
+                syncedHeight: 0,
+                indexerTier: 3,
+                dbSizeBytes: 0,
+                uptimeSeconds: 0,
+                queriesPerSecond: 0,
+            };
+        }
+    }
+    /**
+     * 聚合统计信息
+     */
+    aggregateStats(stats) {
+        return {
+            totalProducts: stats.reduce((sum, s) => sum + s.totalProducts, 0),
+            totalSellers: stats.reduce((sum, s) => sum + s.totalSellers, 0),
+            totalReviews: stats.reduce((sum, s) => sum + s.totalReviews, 0),
+            totalOrders: stats.reduce((sum, s) => sum + s.totalOrders, 0),
+            syncedHeight: Math.max(...stats.map(s => s.syncedHeight)),
+            indexerTier: 3,
+            dbSizeBytes: stats.reduce((sum, s) => sum + s.dbSizeBytes, 0),
+            uptimeSeconds: Math.max(...stats.map(s => s.uptimeSeconds)),
+            queriesPerSecond: stats.reduce((sum, s) => sum + s.queriesPerSecond, 0),
+        };
+    }
+    /**
+     * 获取同步高度
+     */
+    getSyncHeight() {
+        if (this.localIndexer) {
+            return this.localIndexer.getSyncHeight();
+        }
+        return 0;
+    }
+    /**
+     * 同步区块事件
+     */
+    async syncFromBlock(height, events) {
+        if (this.localIndexer) {
+            return this.localIndexer.syncFromBlock(height, events);
+        }
+    }
+    /**
+     * 初始化
+     */
+    async init() {
+        console.log('[Distributed] Initialized');
+    }
+    /**
+     * 销毁
+     */
+    async destroy() {
+        console.log('[Distributed] Destroyed');
+    }
+    async clearAll() {
+        if (this.localIndexer && typeof this.localIndexer.clearAll === 'function') {
+            await this.localIndexer.clearAll();
+        }
+    }
+    /**
+     * 获取分布式状态
+     */
+    getDistributedStatus() {
+        return {
+            shards: Array.from(this.shards.values()),
+            activeShards: Array.from(this.shards.values()).filter(s => s.status === 'active').length,
+            totalShards: this.shards.size,
+            replicationFactor: this.config.replicationFactor,
+        };
+    }
+    /**
+     * 处理查询（IndexerPlugin接口）
+     */
+    async handleQuery(query) {
+        return this.search(query);
+    }
+    /**
+     * 获取状态（IndexerPlugin接口）
+     */
+    getStatus() {
+        return this.getDistributedStatus();
+    }
+}
+exports.DistributedIndexer = DistributedIndexer;
+//# sourceMappingURL=distributed.js.map

package/core/distributed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed.js","sourceRoot":"","sources":["../../src/core/distributed.ts"],"names":[],"mappings":"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"}

package/core/doctor.js

@@ -0,0 +1,249 @@
+"use strict";
+/**
+ * doctor.js — 卖家后端启动自检 (人可读报告)
+ *
+ * 覆盖: base/keyring 解析结果 → 目录与身份文件 → JS 派生地址 vs CLI keyring 地址 (身份分裂)
+ *       → 签名通道现状 (js/trustchaind) → LCD 可达性 → 卖家地址链上账户 (account_number/sequence)
+ *
+ * 入口: `tb-seller-doctor` / `tb-seller-backend doctor` / `node bin/tb-doctor.js`
+ * 只读: 不写密钥, 不广播交易, 不打印助记词 (只报"存在/词数")。
+ */
+const fs = require("fs");
+const path = require("path");
+const paths = require("./paths");
+const runtimeData = require("./runtime-data");
+const chainWrites = require("../routes/chain-writes");
+const { mnemonicToAddress } = require("./seller-identity");
+const { isTctAddress } = require("./address");
+
+const PASS = "PASS";
+const WARN = "WARN";
+const FAIL = "FAIL";
+
+function fmtTime(d = new Date()) {
+    const p = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+
+async function timed(fn) {
+    const t0 = Date.now();
+    try {
+        const value = await fn();
+        return { ok: true, value, ms: Date.now() - t0 };
+    }
+    catch (e) {
+        return { ok: false, error: e, ms: Date.now() - t0 };
+    }
+}
+
+async function lcdGet(url, timeoutMs = 6000) {
+    const resp = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!resp.ok)
+        throw new Error(`HTTP ${resp.status}`);
+    return await resp.json();
+}
+
+/**
+ * 跑一遍自检。返回 { ok, checks, text, json }
+ * ok=false 表示有 FAIL 项 (WARN 不算失败)。
+ */
+async function runDoctor() {
+    const checks = [];
+    const add = (level, name, detail) => checks.push({ level, name, detail });
+
+    const b = paths.base();
+    const keyring = paths.keyringDir();
+    const mnemonicFile = paths.mnemonicFile();
+    const addressFile = paths.addressFile();
+
+    // ---------- 路径 ----------
+    add(fs.existsSync(b.baseDir) ? PASS : FAIL, "base 目录", `${b.baseDir} (来源: ${b.source})`);
+    if (b.cwd !== b.baseDir) {
+        add(PASS, "进程 cwd", `${b.cwd} (与 base 不同 — 所有路径已按绝对路径解析, 不受 cwd 影响)`);
+    }
+    else {
+        add(PASS, "进程 cwd", `${b.cwd} (与 base 一致)`);
+    }
+    if (fs.existsSync(keyring)) {
+        let writable = true;
+        try {
+            fs.accessSync(keyring, fs.constants.W_OK);
+        }
+        catch (_) {
+            writable = false;
+        }
+        add(writable ? PASS : WARN, "keyring 目录", `${keyring}${writable ? "" : " (当前用户不可写: 入驻生成身份会失败)"}`);
+    }
+    else {
+        add(FAIL, "keyring 目录", `${keyring} 不存在 — 先完成入驻 (生成卖家身份) 或检查 TB_BASE_DIR/CHAIN_HOME`);
+    }
+
+    // ---------- 运行时数据目录 (api-keys.json / .encryption-key 等落盘处) ----------
+    const rd = runtimeData.runtimeDataInfo();
+    let rdWritable = true;
+    try {
+        fs.accessSync(rd.dir, fs.constants.W_OK);
+    }
+    catch (_) {
+        rdWritable = false;
+    }
+    const rdLevel = rd.source === "legacy-fallback" ? WARN : PASS;
+    const rdNote = rd.source === "legacy-fallback"
+        ? "⚠️ 仍在旧路径 (node_modules 下, npm 升级会被清掉) — 检查目录权限或显式设 TRUSTBASE_DATA_DIR"
+        : "npm 升级不影响 (node_modules 之外); 可用 TRUSTBASE_DATA_DIR 覆盖";
+    add(rdLevel, "运行时数据目录", `${rd.dir} (来源: ${rd.source}; ${rdNote})` +
+        (rdWritable ? "" : " — 当前用户不可写!") +
+        (rd.migration.moved.length ? `; 本次已从旧 node_modules/data 自动搬迁: ${rd.migration.moved.join(", ")}` : ""));
+    const legacyKeysLeft = path.join(runtimeData.legacyDataDir(), "api-keys.json");
+    if (fs.existsSync(legacyKeysLeft)) {
+        add(WARN, "旧数据残留", `${legacyKeysLeft} 仍存在 — 搬迁未完成 (见上行/启动日志), 确认新目录数据完好后可手动删除`);
+    }
+
+    // ---------- 身份文件 ----------
+    let mnemonic = null;
+    if (fs.existsSync(mnemonicFile)) {
+        mnemonic = fs.readFileSync(mnemonicFile, "utf8").trim();
+        const words = mnemonic ? mnemonic.split(/\s+/).length : 0;
+        let mode = "";
+        try {
+            mode = "0" + (fs.statSync(mnemonicFile).mode & 0o777).toString(8);
+        }
+        catch (_) { /* ignore */ }
+        add(words >= 12 ? PASS : FAIL, "mnemonic.txt", `存在 (${words} 词${mode ? ", 权限 " + mode : ""}; 内容不打印)`);
+    }
+    else {
+        add(FAIL, "mnemonic.txt", `${mnemonicFile} 不存在 — JS 直签不可用, SIGN_MODE=auto 会降级 CLI`);
+    }
+
+    let fileAddress = null;
+    if (fs.existsSync(addressFile)) {
+        const a = fs.readFileSync(addressFile, "utf8").trim();
+        if (isTctAddress(a)) {
+            fileAddress = a;
+            add(PASS, "address.txt", a);
+        }
+        else {
+            add(FAIL, "address.txt", `${addressFile} 内容不是合法 tct1 地址: ${a.slice(0, 40)}`);
+        }
+    }
+    else {
+        add(mnemonic ? WARN : FAIL, "address.txt", `${addressFile} 不存在${mnemonic ? " (有助记词, 入驻流程会现算补写)" : ""}`);
+    }
+
+    // 身份派生 (纯计算, 不写盘)
+    const jsAddress = mnemonic ? await mnemonicToAddress(mnemonic).catch((e) => {
+        add(FAIL, "身份派生", `助记词派生地址失败: ${e && e.message}`);
+        return null;
+    }) : null;
+    if (jsAddress) {
+        if (fileAddress && fileAddress !== jsAddress) {
+            add(FAIL, "身份一致性", `address.txt=${fileAddress} 与助记词派生=${jsAddress} 不一致 — address.txt 被改过或被别的助记词覆盖`);
+        }
+        else {
+            add(PASS, "身份一致性", `address.txt 与助记词派生一致 (${jsAddress})`);
+        }
+    }
+
+    // ---------- 签名通道 ----------
+    const c = chainWrites.cfg();
+    const mode = chainWrites.signModeInfo(c);
+    if (mode.effective === "unavailable") {
+        add(FAIL, "签名通道", `SIGN_MODE=${mode.configured} 但 mnemonic.txt 不存在 (JS 直签不可用)`);
+    }
+    else {
+        add(PASS, "签名通道", `SIGN_MODE=${mode.configured} → 生效 ${mode.effective} (卖家身份 ${jsAddress || "?"})`);
+    }
+    add(PASS, "trustchaind --home", c.home + (c.home === keyring ? " (与 tb-keyring 一致)" : " (注意: 与 tb-keyring 不同)"));
+
+    // CLI keyring 地址 (JS 通道不需要它, 但两者不一致时必须暴露)
+    let cliAddress = null;
+    let cliError = null;
+    const cliProbe = await timed(() => chainWrites.cliKeyAddress(c));
+    if (cliProbe.ok) {
+        cliAddress = cliProbe.value;
+    }
+    else {
+        cliError = cliProbe.error;
+    }
+    if (cliAddress && jsAddress && cliAddress !== jsAddress) {
+        add(WARN, "⚠️ 身份分裂", `JS 通道 ${jsAddress} / CLI 通道 ${cliAddress} — 链上交易身份以 JS 通道 ${jsAddress} 为准; ` +
+            `CLI keyring 里的 "${c.keyName}" (${cliAddress}) 与店铺身份无关, 不要用它的助记词恢复店铺`);
+    }
+    else if (cliAddress) {
+        add(PASS, "CLI keyring", `${c.keyName} → ${cliAddress} (与 JS 通道一致)`);
+    }
+    else if (mode.effective === "js") {
+        add(PASS, "CLI keyring", `未读到 CLI key "${c.keyName}" (JS 直签不需要; 原始错误: ${String((cliError && cliError.message) || cliError).slice(0, 80)})`);
+    }
+    else {
+        add(FAIL, "CLI keyring", `CLI 签名通道不可用: keys show "${c.keyName}" --home ${c.home} 失败 (${String((cliError && cliError.message) || cliError).slice(0, 120)})`);
+    }
+
+    // ---------- 链 ----------
+    const net = await timed(() => lcdGet(`${c.lcdUrl}/cosmos/base/tendermint/v1beta1/blocks/latest`));
+    if (net.ok) {
+        const h = net.value && net.value.block && net.value.block.header && net.value.block.header.height;
+        add(PASS, "LCD 可达", `${c.lcdUrl} (${net.ms}ms, 最新高度 ${h || "?"})`);
+    }
+    else {
+        add(FAIL, "LCD 可达", `${c.lcdUrl} 不可达: ${String((net.error && net.error.message) || net.error).slice(0, 120)}`);
+    }
+    const info = await timed(() => lcdGet(`${c.lcdUrl}/cosmos/base/tendermint/v1beta1/node_info`));
+    if (info.ok) {
+        const network = info.value && info.value.default_node_info && info.value.default_node_info.network;
+        if (network && network !== c.chainId) {
+            add(WARN, "chain-id", `LCD 报告 network=${network}, 配置 CHAIN_ID=${c.chainId} — 不一致会让交易签名被拒`);
+        }
+        else {
+            add(PASS, "chain-id", `${c.chainId}`);
+        }
+    }
+
+    if (jsAddress) {
+        const acct = await timed(() => chainWrites.queryAccount(c, jsAddress));
+        if (acct.ok) {
+            add(PASS, "链上账户", `${jsAddress} account_number=${acct.value.accountNumber} sequence=${acct.value.sequence} (可发起链上交易)`);
+        }
+        else if (acct.error && acct.error.code === "account_not_found") {
+            add(FAIL, "链上账户", `${jsAddress} 尚未在链上创建 (没有手续费/未收到过任何资金) — 发起链上交易会失败, 需先充值少量 TCT 手续费`);
+        }
+        else {
+            add(FAIL, "链上账户", `LCD 查账户失败: ${String((acct.error && acct.error.message) || acct.error).slice(0, 120)}`);
+        }
+    }
+
+    const failed = checks.filter((x) => x.level === FAIL);
+    const warned = checks.filter((x) => x.level === WARN);
+    const lines = [];
+    lines.push("TrustBase 卖家后端自检 (doctor)");
+    lines.push(`时间: ${fmtTime()}`);
+    lines.push("");
+    for (const ck of checks) {
+        const tag = ck.level === PASS ? "[PASS]" : ck.level === WARN ? "[WARN]" : "[FAIL]";
+        lines.push(`${tag} ${ck.name}: ${ck.detail}`);
+    }
+    lines.push("");
+    lines.push(`汇总: ${checks.length - failed.length - warned.length} 项通过, ${warned.length} 项警告, ${failed.length} 项失败`);
+    if (failed.length) {
+        lines.push("");
+        lines.push("需要处理:");
+        for (const ck of failed)
+            lines.push(`  - ${ck.name}: ${ck.detail}`);
+    }
+    const text = lines.join("\n") + "\n";
+    return { ok: failed.length === 0, checks, text };
+}
+
+/** 启动日志一行摘要 (run-unified.js 调用; 不查网络, 不抛异常) */
+function bootLine() {
+    try {
+        const b = paths.base();
+        const mode = chainWrites.signModeInfo();
+        return `[boot] base=${b.baseDir} (source=${b.source}, cwd=${b.cwd}) keyring=${mode.keyringDir} mnemonic=${mode.mnemonic ? "yes" : "no"} signMode=${mode.effective}`;
+    }
+    catch (e) {
+        return `[boot] 路径解析失败: ${(e && e.message) || e}`;
+    }
+}
+
+module.exports = { runDoctor, bootLine, PASS, WARN, FAIL };