dsh-archify-projects 0.0.0-stage → 0.1.0

package/lib/host/config.js

@@ -0,0 +1,95 @@
+/**
+ * 插件配置：默认值、解析与校验。
+ *
+ * 不用 schemastery 是因为本插件只有 5 个标量字段，而 schemastery 会引入一个
+ * 宿主内部包的硬依赖；对第三方插件来说，手写解析 + 明确报错更稳。
+ */
+import os from 'node:os';
+import path from 'node:path';
+/** DSH 配置根。 */
+export function dshHome() {
+    const env = process.env.DSH_HOME;
+    if (typeof env === 'string' && env.trim().length > 0)
+        return path.resolve(env.trim());
+    return path.join(os.homedir(), '.dsh');
+}
+/**
+ * 解析配置。
+ *
+ * 非法值一律回落到默认值并**记录**（由调用方打印），不抛异常 ——
+ * 一个配置项写错不应该让整个插件在宿主启动期炸掉。
+ */
+export function resolveConfig(raw, warnings) {
+    const dataDirDefault = path.join(dshHome(), 'dsh-archify-projects');
+    const dataDir = readString(raw?.dataDir, dataDirDefault, 'dataDir', warnings);
+    const presetId = readString(raw?.presetId, 'archify-projects', 'presetId', warnings);
+    const askPresetId = readString(raw?.askPresetId, 'archify-projects-ask', 'askPresetId', warnings);
+    const skillRaw = raw?.archifySkillDir;
+    const archifySkillDir = typeof skillRaw === 'string' && skillRaw.trim().length > 0
+        ? path.resolve(skillRaw.trim())
+        : null;
+    return {
+        dataDir: path.resolve(dataDir),
+        presetId,
+        askPresetId,
+        archifySkillDir,
+        runTimeoutMs: readPositiveInt(raw?.runTimeoutMs, 20 * 60 * 1000, 'runTimeoutMs', warnings),
+        askTimeoutMs: readPositiveInt(raw?.askTimeoutMs, 6 * 60 * 1000, 'askTimeoutMs', warnings),
+        keepRuns: readPositiveInt(raw?.keepRuns, 20, 'keepRuns', warnings),
+        pricing: readPricing(raw?.pricing, warnings),
+    };
+}
+function readString(value, fallback, field, warnings) {
+    if (value === undefined || value === null)
+        return fallback;
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        warnings.push(`配置项 ${field} 不是非空字符串，已回落到默认值`);
+        return fallback;
+    }
+    return value.trim();
+}
+function readPositiveInt(value, fallback, field, warnings) {
+    if (value === undefined || value === null)
+        return fallback;
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n) || n <= 0 || !Number.isInteger(n)) {
+        warnings.push(`配置项 ${field} 不是正整数，已回落到默认值`);
+        return fallback;
+    }
+    return n;
+}
+/** 读单价配置；三个字段都必须是非负数，否则整块作废。 */
+function readPricing(value, warnings) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== 'object') {
+        warnings.push('配置项 pricing 不是对象，已忽略（页面只显示 token）');
+        return null;
+    }
+    const raw = value;
+    const read = (key) => {
+        const n = Number(raw[key]);
+        return Number.isFinite(n) && n >= 0 ? n : null;
+    };
+    const inputPerMTok = read('inputPerMTok');
+    const outputPerMTok = read('outputPerMTok');
+    const cacheReadPerMTok = read('cacheReadPerMTok');
+    if (inputPerMTok === null || outputPerMTok === null || cacheReadPerMTok === null) {
+        warnings.push('配置项 pricing 缺字段或不是非负数，已忽略（页面只显示 token）');
+        return null;
+    }
+    return { inputPerMTok, outputPerMTok, cacheReadPerMTok };
+}
+/** 台账文件的绝对路径。 */
+export function ledgerPath(config) {
+    return path.join(config.dataDir, 'projects.json');
+}
+/** 插件工作区目录（所有运行产物都在这里）。 */
+export function workspaceRoot(config) {
+    return path.join(config.dataDir, 'workspace');
+}
+/** 单个项目的工作目录。 */
+export function projectDir(config, projectId) {
+    return path.join(workspaceRoot(config), projectId);
+}
+//# sourceMappingURL=config.js.map

package/lib/host/config.js.map

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

package/lib/host/context.js

@@ -0,0 +1,28 @@
+/**
+ * 宿主 ctx 的窄化类型。
+ *
+ * cordis 的 `ctx` 在运行期是一个动态服务容器，没有可用的静态类型。与其到处 `any`，
+ * 不如在这里把「本插件实际用到的那几个面」逐项写出来：改宿主 API 时，
+ * 编译错误会集中出现在这一个文件，而不是散落几十处。
+ */
+/** 取一个服务，取不到时返回 undefined（而不是抛）。 */
+export function serviceOf(ctx, name) {
+    try {
+        const viaGet = ctx.get(name);
+        if (viaGet !== undefined && viaGet !== null)
+            return viaGet;
+    }
+    catch {
+        // ctx.get 在服务不存在时会抛，这里当作「没有」
+    }
+    // cordis 的 ctx 是 proxy：访问未 inject 的服务，取属性这一步本身就会抛
+    // 「cannot get property "x" without inject」，所以 `direct` 也必须在 try 里。
+    try {
+        const direct = ctx[name];
+        return direct ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=context.js.map

package/lib/host/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/host/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0MH,oCAAoC;AACpC,MAAM,UAAU,SAAS,CAAI,GAAgB,EAAE,IAAY;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAW,CAAA;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,kDAAkD;IAClD,mEAAmE;IACnE,IAAI,CAAC;QACH,MAAM,MAAM,GAAI,GAA0C,CAAC,IAAI,CAAC,CAAA;QAChE,OAAQ,MAAwB,IAAI,SAAS,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/lib/host/git.js

@@ -0,0 +1,185 @@
+/**
+ * Git 探测与同步。
+ *
+ * 所有命令都走 `execFile('git', argv, {cwd})` —— 不拼 shell 字符串，分支名作为独立
+ * argv 传入，用户仓库里再奇怪的分支名也不会变成注入点。
+ *
+ * 只做**只读探测**与**安全同步**：
+ *   - 探测：rev-parse / log / rev-list / status / remote
+ *   - 同步：fetch、checkout <记录的分支>、merge --ff-only
+ * 永远不 reset --hard、不 clean、不 stash、不强推。工作区脏就停下来说清楚。
+ */
+import { execFile } from 'node:child_process';
+import { emptyGitSnapshot } from '../shared/types.js';
+/** 单条 git 命令的超时。fetch 在慢网络上要久一点，所以给 60s。 */
+const GIT_TIMEOUT_MS = 60_000;
+/** 默认执行器。 */
+export const gitExec = (args, cwd) => new Promise((resolve) => {
+    execFile('git', [...args], {
+        cwd,
+        timeout: GIT_TIMEOUT_MS,
+        windowsHide: true,
+        maxBuffer: 8 * 1024 * 1024,
+        // 输出按 UTF-8 解，中文提交信息才不会乱码
+        encoding: 'utf8',
+    }, (error, stdout, stderr) => {
+        if (error === null) {
+            resolve({ code: 0, stdout: String(stdout), stderr: String(stderr) });
+            return;
+        }
+        const code = typeof error.code === 'number' ? error.code : 1;
+        // 进程根本没起来（cwd 不存在、git 不在 PATH）时 stderr 是空串，
+        // 真正的原因只存在于 error.message 里 —— 不能因为「stderr 有值」就丢掉它
+        const detail = String(stderr ?? '').trim();
+        resolve({
+            code,
+            stdout: String(stdout ?? ''),
+            stderr: detail.length > 0 ? detail : error.message,
+        });
+    });
+});
+/**
+ * 探测一个目录的 Git 状态。
+ *
+ * 任何子命令失败都只让对应字段为 null，不让整个探测失败 ——
+ * 老 git 版本、浅克隆、没有 upstream 都是正常情况。
+ */
+export async function probeGit(repoPath, now, exec = gitExec) {
+    const top = await exec(['rev-parse', '--show-toplevel'], repoPath);
+    if (top.code !== 0)
+        return emptyGitSnapshot(now);
+    const root = top.stdout.trim();
+    if (root.length === 0)
+        return emptyGitSnapshot(now);
+    const [branchRes, commitRes, logRes, upstreamRes, statusRes, remoteRes] = await Promise.all([
+        exec(['rev-parse', '--abbrev-ref', 'HEAD'], root),
+        exec(['rev-parse', 'HEAD'], root),
+        exec(['log', '-1', '--format=%cI%n%s'], root),
+        exec(['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}'], root),
+        exec(['status', '--porcelain'], root),
+        exec(['remote', 'get-url', 'origin'], root),
+    ]);
+    const branchRaw = branchRes.code === 0 ? branchRes.stdout.trim() : '';
+    const detached = branchRaw === 'HEAD' || branchRaw.length === 0;
+    const branch = detached ? null : branchRaw;
+    const commitFull = commitRes.code === 0 ? commitRes.stdout.trim() : null;
+    const commit = commitFull === null || commitFull.length === 0 ? null : commitFull.slice(0, 40);
+    const { commitTime, commitSubject } = parseLog(logRes.code === 0 ? logRes.stdout : '');
+    const upstream = upstreamRes.code === 0 ? emptyToNull(upstreamRes.stdout) : null;
+    let ahead = null;
+    let behind = null;
+    if (upstream !== null) {
+        const counts = await exec(['rev-list', '--left-right', '--count', 'HEAD...@{u}'], root);
+        if (counts.code === 0) {
+            const parsed = parseAheadBehind(counts.stdout);
+            ahead = parsed.ahead;
+            behind = parsed.behind;
+        }
+    }
+    const tree = statusRes.code === 0 ? parseTree(statusRes.stdout) : null;
+    const dirty = statusRes.code === 0 ? statusRes.stdout.trim().length > 0 : null;
+    return {
+        isRepo: true,
+        root,
+        branch,
+        detached,
+        commit,
+        commitFull: commitFull === null || commitFull.length === 0 ? null : commitFull,
+        commitTime,
+        commitSubject,
+        upstream,
+        ahead,
+        behind,
+        dirty,
+        tree,
+        remoteUrl: remoteRes.code === 0 ? emptyToNull(remoteRes.stdout) : null,
+        checkedAt: now,
+    };
+}
+/**
+ * 解析 `git status --porcelain` 的 XY 两列：
+ *   - X = 暂存区状态，Y = 工作区状态；`??` 是未跟踪；
+ *   - 只看计数，不看文件名（页面只需要「有改动 / 几处」）。
+ */
+export function parseTree(stdout) {
+    let staged = 0;
+    let unstaged = 0;
+    let untracked = 0;
+    for (const line of stdout.split(/\r?\n/)) {
+        if (line.trim().length === 0)
+            continue;
+        const x = line[0] ?? ' ';
+        const y = line[1] ?? ' ';
+        if (x === '?' && y === '?') {
+            untracked += 1;
+            continue;
+        }
+        if (x !== ' ' && x !== '?')
+            staged += 1;
+        if (y !== ' ' && y !== '?')
+            unstaged += 1;
+    }
+    return { staged, unstaged, untracked };
+}
+/** `log -1 --format=%cI%n%s` 的两行结果。 */
+export function parseLog(stdout) {
+    const lines = stdout.split(/\r?\n/);
+    const time = lines[0]?.trim() ?? '';
+    const subject = lines.slice(1).join(' ').trim();
+    return {
+        commitTime: time.length > 0 ? time : null,
+        commitSubject: subject.length > 0 ? subject : null,
+    };
+}
+/**
+ * `rev-list --left-right --count HEAD...@{u}` 的输出是 `<HEAD 独有>\t<上游独有>`，
+ * 也就是 `<ahead>\t<behind>`。方向搞反会让页面把「落后 3 个提交」显示成「领先 3 个」，
+ * 所以这里单独抽出来测。
+ */
+export function parseAheadBehind(stdout) {
+    const m = /^\s*(\d+)\s+(\d+)\s*$/.exec(stdout);
+    if (m === null)
+        return { ahead: null, behind: null };
+    return { ahead: Number(m[1]), behind: Number(m[2]) };
+}
+/**
+ * 把仓库切回记录的分支并快进到最新提交。
+ *
+ * 顺序：脏工作区先停 → fetch（有 origin 才做，失败只记录）→ checkout → merge --ff-only → 重新探测。
+ */
+export async function syncToLatest(repoPath, recordedBranch, exec = gitExec) {
+    const before = await probeGit(repoPath, new Date().toISOString(), exec);
+    if (!before.isRepo || before.root === null) {
+        return { skipped: true, reason: 'no-git', from: null, to: null };
+    }
+    const root = before.root;
+    const from = before.commit;
+    if (before.dirty === true) {
+        return { skipped: true, reason: 'dirty', from, to: from };
+    }
+    if (before.remoteUrl !== null) {
+        // fetch 失败（离线、无权限）不该阻断后续 checkout/ff：本地可能已经是最新的
+        await exec(['fetch', '--all', '--prune'], root);
+    }
+    const target = recordedBranch ?? before.branch;
+    if (target !== null && target !== before.branch) {
+        const checkout = await exec(['checkout', target], root);
+        if (checkout.code !== 0) {
+            return { skipped: true, reason: 'checkout-failed', from, to: from };
+        }
+    }
+    const afterCheckout = await probeGit(repoPath, new Date().toISOString(), exec);
+    if (afterCheckout.upstream !== null) {
+        const merge = await exec(['merge', '--ff-only', '@{u}'], root);
+        if (merge.code !== 0) {
+            return { skipped: true, reason: 'ff-failed', from, to: afterCheckout.commit };
+        }
+    }
+    const after = await probeGit(repoPath, new Date().toISOString(), exec);
+    return { skipped: false, reason: null, from, to: after.commit };
+}
+function emptyToNull(value) {
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? null : trimmed;
+}
+//# sourceMappingURL=git.js.map

package/lib/host/git.js.map

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

package/lib/host/http.js

@@ -0,0 +1,184 @@
+/**
+ * 路由层公共设施：请求体解析、统一响应、信任栅栏。
+ *
+ * 三条硬约束（都是这一层唯一的正确写法）：
+ *   1. 响应只从 `sendJson` / `sendError` 出，且不重复写头；
+ *   2. 对外错误只回稳定 code + 一句人话，原始 message（常含绝对路径）只进日志；
+ *   3. 请求体必须是 JSON 对象；空 body / 数组 / 标量在 `readJsonObject` 就抛。
+ */
+import { serviceOf } from './context.js';
+/** 请求体上限：本插件只收短 JSON。 */
+const MAX_BODY_BYTES = 256 * 1024;
+/** 解析失败的类型，路由层据此回 400。 */
+export class BadRequest extends Error {
+    code;
+    constructor(message, code = 'bad-request') {
+        super(message);
+        this.name = 'BadRequest';
+        this.code = code;
+    }
+}
+/** 读完整请求体并解析成 JSON 对象。 */
+export async function readJsonObject(req) {
+    const raw = await readBody(req);
+    if (raw.trim().length === 0)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new BadRequest('请求体不是合法 JSON');
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new BadRequest('请求体必须是 JSON 对象');
+    }
+    return parsed;
+}
+async function readBody(req) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of req) {
+        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        total += buf.length;
+        if (total > MAX_BODY_BYTES)
+            throw new BadRequest('请求体过大');
+        chunks.push(buf);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+/** 唯一响应出口：已发过就什么都不做。 */
+export function sendJson(res, status, payload) {
+    if (res.headersSent || res.writableEnded)
+        return false;
+    try {
+        res.writeHead(status, {
+            'Content-Type': 'application/json; charset=utf-8',
+            'Cache-Control': 'no-store',
+        });
+        res.end(JSON.stringify(payload));
+        return true;
+    }
+    catch {
+        try {
+            res.destroy();
+        }
+        catch {
+            // 连接已经没了，无事可做
+        }
+        return false;
+    }
+}
+/** 成功响应。 */
+export function sendOk(res, value) {
+    return sendJson(res, 200, { ok: true, value });
+}
+/** 错误响应。`err` 只进日志，不回给浏览器。 */
+export function sendError(res, status, code, message, err) {
+    const detail = err === undefined ? '' : ` | ${describe(err)}`;
+    console.warn(`[dsh-archify-projects] ${code}: ${message}${detail}`);
+    return sendJson(res, status, { ok: false, error: { code, message } });
+}
+function describe(err) {
+    if (err instanceof Error)
+        return err.message;
+    try {
+        return typeof err === 'string' ? err : JSON.stringify(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+/** 请求方法（大写）。 */
+export function methodOf(req) {
+    return (req.method ?? 'GET').toUpperCase();
+}
+/** 请求路径（去掉 query）。 */
+export function pathOf(req) {
+    const url = req.url ?? '/';
+    const index = url.indexOf('?');
+    return index === -1 ? url : url.slice(0, index);
+}
+/**
+ * 信任栅栏。
+ *
+ * 三道，任意一道不过即 403：
+ *   1. `sec-fetch-site` 存在且不是同源/同站/直接输入；
+ *   2. `Origin` 存在且 host 与请求 host 不一致；
+ *   3. 宿主自己的 `connection.requestRejection`（若该服务存在）。
+ *
+ * 浏览器直连（无 Origin / 无 sec-fetch-site，如 curl）交给第 3 道与路由自身鉴权判断，
+ * 本插件没有敏感凭据可泄露，默认放行。
+ */
+export function makeFence(ctx) {
+    return (req) => {
+        const site = firstHeader(req.headers['sec-fetch-site']);
+        if (site !== null && !['same-origin', 'same-site', 'none'].includes(site)) {
+            return '跨站请求被拒绝';
+        }
+        const hostHeader = firstHeader(req.headers.host);
+        if (hostHeader === null)
+            return '请求缺少 Host 头';
+        const origin = firstHeader(req.headers.origin);
+        if (origin !== null) {
+            let originHost = null;
+            try {
+                originHost = new URL(origin).host.toLowerCase();
+            }
+            catch {
+                return 'Origin 无法解析';
+            }
+            if (originHost !== hostHeader.toLowerCase())
+                return 'Origin 与请求 host 不一致';
+        }
+        const connection = serviceOf(ctx, 'connection');
+        if (connection !== undefined && typeof connection.requestRejection === 'function') {
+            const rejected = connection.requestRejection(req);
+            if (rejected !== undefined && rejected !== null && rejected !== false) {
+                // 诊断信息：宿主连接的准入会同时做「可信 authority」和「浏览器会话认证」两件事，
+                // 401 与 403 的处理方式完全不同，光看一条文案分不出来。
+                try {
+                    ctx.logger.warn(`[dsh-archify-projects] fence 拒绝 code=${String(rejected)} host=${hostHeader} origin=${origin ?? '-'} site=${site ?? '-'} method=${req.method ?? '-'} url=${req.url ?? '-'}`);
+                }
+                catch {
+                    // 忽略日志失败
+                }
+                return '宿主拒绝该请求';
+            }
+        }
+        return null;
+    };
+}
+function firstHeader(value) {
+    if (value === undefined)
+        return null;
+    const raw = Array.isArray(value) ? value[0] : value;
+    if (raw === undefined)
+        return null;
+    const trimmed = raw.trim();
+    return trimmed.length === 0 ? null : trimmed;
+}
+/**
+ * 匹配 `/projects/:id/check` 这类路径。
+ *
+ * 只支持 `:name` 段——本插件的路由表就这么浅，上正则引擎是过度设计。
+ */
+export function matchPath(pattern, pathname) {
+    const patternParts = pattern.split('/').filter((p) => p.length > 0);
+    const pathParts = pathname.split('/').filter((p) => p.length > 0);
+    if (patternParts.length !== pathParts.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < patternParts.length; i += 1) {
+        const patternPart = patternParts[i];
+        const pathPart = pathParts[i];
+        if (patternPart.startsWith(':')) {
+            params[patternPart.slice(1)] = decodeURIComponent(pathPart);
+            continue;
+        }
+        if (patternPart !== pathPart)
+            return null;
+    }
+    return params;
+}
+//# sourceMappingURL=http.js.map

package/lib/host/http.js.map

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

package/lib/host/index.js

@@ -0,0 +1,90 @@
+/**
+ * 宿主插件入口：`dsh-archify-projects`。
+ *
+ * 这里只做装配，不含业务逻辑：
+ *   ① 解析配置、准备台账与工作区；
+ *   ② 注册一条 prefix HTTP 路由，把所有请求交给 routes.ts 的分发器；
+ *   ③ 把 archify skill 目录做一次懒解析并缓存（preset 侧与提示词侧共用同一份答案）。
+ *
+ * 页面由 `dist/client.js` 提供（package.json 的 `exports["./client"]`），
+ * 受限于 preset 的那个受限 agent 组合由 `lib/host/preset.js` 提供。
+ */
+import path from 'node:path';
+import { ROUTE_PREFIX } from '../shared/protocol.js';
+import { resolveArchifySkillDir } from './archify-skill.js';
+import { ledgerPath, resolveConfig, workspaceRoot } from './config.js';
+import { serviceOf } from './context.js';
+import { makeFence } from './http.js';
+import { createDispatcher } from './routes.js';
+import { reconcileArtifacts, Runner } from './runner.js';
+import { ProjectStore } from './store.js';
+import { ensureWorkspace } from './workspace.js';
+/** 与 package.json 的 version 保持一致（有单测守着）。 */
+export const VERSION = '0.1.0';
+/** 插件入口。 */
+export function apply(ctx, rawConfig) {
+    const warnings = [];
+    const config = resolveConfig(rawConfig, warnings);
+    for (const warning of warnings)
+        log(ctx, 'warn', warning);
+    const store = new ProjectStore(ledgerPath(config));
+    let cachedSkill;
+    const skillDir = () => {
+        cachedSkill ??= resolveArchifySkillDir(config.archifySkillDir);
+        return cachedSkill;
+    };
+    const runner = new Runner({ ctx, store, config, skillDir });
+    const hasSessionService = serviceOf(ctx, 'sessionController') !== undefined || serviceOf(ctx, 'agents') !== undefined;
+    if (!hasSessionService) {
+        log(ctx, 'warn', '宿主没有 sessionController / agents 服务：更新会失败，只能浏览台账');
+    }
+    const dispatcher = createDispatcher({
+        ctx,
+        store,
+        config,
+        runner,
+        fence: makeFence(ctx),
+        skillDir,
+        version: VERSION,
+        hasSessionService,
+    });
+    // 路由必须挂在 inject 出来的子 ctx 上：cordis 的 proxy 在没 inject 时读
+    // `ctx.webServer` 会直接抛，注册就会被静默跳过（页面表现为「HTTP 404」）。
+    ctx.inject(['webServer'], (scoped) => {
+        scoped.effect(() => scoped.webServer.register({
+            kind: 'prefix',
+            path: ROUTE_PREFIX,
+            handler: (req, res) => {
+                void dispatcher(req, res);
+            },
+        }), 'dsh-archify-projects: http routes');
+        log(ctx, 'info', `HTTP 路由已注册：${ROUTE_PREFIX}`);
+    });
+    // 开库对账：把上次没记完的产物认回来（宿主重启/断连后最常见的「明明有图却显示失败」）
+    void reconcileArtifacts(store, config).then((adopted) => {
+        for (const line of adopted)
+            log(ctx, 'info', `已认领磁盘上的产物：${line}`);
+    }, (err) => log(ctx, 'warn', `产物对账失败：${describe(err)}`));
+    // 工作区准备是异步的，不阻塞宿主启动；失败也不致命
+    void ensureWorkspace(ctx, config, {
+        warn: (message) => log(ctx, 'warn', message),
+    }).then((info) => {
+        log(ctx, 'info', `工作区就绪：${path.basename(info.root)}（${ROUTE_PREFIX}）`);
+        const drained = store.drainWarnings();
+        for (const warning of drained)
+            log(ctx, 'warn', warning);
+    }, (err) => log(ctx, 'warn', `准备插件工作区失败：${describe(err)}`));
+    log(ctx, 'info', `已挂载 v${VERSION}，台账 ${ledgerPath(config)}，工作区 ${workspaceRoot(config)}`);
+}
+function log(ctx, level, message) {
+    try {
+        ctx.logger[level](`[dsh-archify-projects] ${message}`);
+    }
+    catch {
+        // 日志器不可用不影响功能
+    }
+}
+function describe(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=index.js.map

package/lib/host/index.js.map

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