@jingyi0605/codingns 0.3.0 → 0.3.6

package/dist/server/modules/butler/butler-workspace-context.d.ts

@@ -0,0 +1,13 @@
+import type { ButlerProfile } from "../../types/domain.js";
+import type { ButlerPromptContext } from "./context-aggregator.js";
+import type { ButlerAuthService } from "./butler-auth-service.js";
+import type { SkillManagerService } from "../skills/skill-manager-service.js";
+export declare function syncButlerWorkspaceContext(input: {
+    profile: ButlerProfile;
+    promptContext: ButlerPromptContext;
+    userId: string;
+    butlerAuthService: Pick<ButlerAuthService, "ensureWorkspaceCredential" | "getCredentialFilePath">;
+    skillManagerService: Pick<SkillManagerService, "getOverview" | "importUnmanagedSkill">;
+    codexHomeDir: string | null;
+    sourceCodexHomeDir: string | null;
+}): void;

package/dist/server/modules/butler/butler-workspace-context.js

@@ -0,0 +1,234 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { ensureButlerWorkspaceIsolation } from "./butler-profile-service.js";
+export function syncButlerWorkspaceContext(input) {
+    fs.mkdirSync(input.profile.workspacePath, { recursive: true });
+    ensureButlerWorkspaceIsolation(input.profile.workspacePath);
+    const auth = input.butlerAuthService.ensureWorkspaceCredential(input.profile.workspacePath, input.userId);
+    const authFilePath = input.butlerAuthService.getCredentialFilePath(input.profile.workspacePath);
+    writeInstructionFiles(input.profile, input.promptContext, auth, authFilePath);
+    syncCodexInstructionConfig(input.profile, input.skillManagerService, input.codexHomeDir, input.sourceCodexHomeDir);
+}
+function writeInstructionFiles(profile, promptContext, auth, authFilePath) {
+    const rootAgentsPath = path.join(profile.workspacePath, "AGENTS.md");
+    writeFileIfChanged(rootAgentsPath, composeInstructionContent(profile, promptContext));
+    if (profile.agentsMode === "file" && profile.agentsFilePath) {
+        writeFileIfChanged(profile.agentsFilePath, composeInstructionContent(profile, promptContext));
+    }
+    if (profile.providerId === "claude-code") {
+        const claudeFilePath = path.join(profile.workspacePath, "CLAUDE.md");
+        writeFileIfChanged(claudeFilePath, composeInstructionContent(profile, promptContext));
+    }
+    writeFileIfChanged(path.join(profile.workspacePath, "BUTLER_CONTEXT.md"), `${promptContext.prompt.trim()}\n`);
+    writeFileIfChanged(path.join(profile.workspacePath, "BUTLER_API.md"), buildApiGuideContent(auth, authFilePath));
+}
+function syncCodexInstructionConfig(profile, skillManagerService, codexHomeDir, sourceCodexHomeDir) {
+    if (profile.providerId !== "codex" || !codexHomeDir?.trim()) {
+        return;
+    }
+    const targetHomeDir = path.resolve(codexHomeDir);
+    const sourceHomeDir = resolveSourceCodexHomeDir(sourceCodexHomeDir, targetHomeDir);
+    const sourceConfigPath = path.join(sourceHomeDir, "config.toml");
+    const instructionFilePath = profile.agentsMode === "file" && profile.agentsFilePath
+        ? path.resolve(profile.agentsFilePath)
+        : path.join(profile.workspacePath, "AGENTS.md");
+    const sourceConfigContent = sourceHomeDir !== targetHomeDir && fs.existsSync(sourceConfigPath) && fs.statSync(sourceConfigPath).isFile()
+        ? fs.readFileSync(sourceConfigPath, "utf8")
+        : "";
+    const configContent = composeCodexConfigContent(sourceConfigContent, instructionFilePath);
+    fs.mkdirSync(targetHomeDir, { recursive: true });
+    removeFileIfExists(path.join(targetHomeDir, "AGENTS.md"));
+    removeFileIfExists(path.join(targetHomeDir, "AGENTS.override.md"));
+    // Butler 运行在独立 home，下游会话仍然需要沿用当前 Codex 登录态。
+    syncOptionalFile(path.join(sourceHomeDir, "auth.json"), path.join(targetHomeDir, "auth.json"));
+    syncButlerCodexSkill(skillManagerService, path.join(targetHomeDir, "skills", "codingns-assistant"));
+    writeFileIfChanged(path.join(targetHomeDir, "config.toml"), `${configContent}\n`);
+}
+function syncButlerCodexSkill(skillManagerService, targetSkillPath) {
+    const skillDirectoryName = "codingns-assistant";
+    const overview = skillManagerService.getOverview({
+        targetCli: ["codex"]
+    });
+    const managedSkill = overview.managedSkills.find((item) => item.skill.directoryName === skillDirectoryName);
+    if (managedSkill) {
+        syncOptionalDirectory(managedSkill.ssotPath, targetSkillPath);
+        return;
+    }
+    const unmanagedEntry = overview.unmanagedEntries.find((entry) => entry.targetCli === "codex" && entry.directoryName === skillDirectoryName);
+    if (unmanagedEntry) {
+        const imported = skillManagerService.importUnmanagedSkill({
+            targetCli: "codex",
+            directoryPath: unmanagedEntry.directoryPath,
+            expectedContentHash: unmanagedEntry.contentHash
+        });
+        syncOptionalDirectory(imported.ssotPath, targetSkillPath);
+        return;
+    }
+    fs.rmSync(targetSkillPath, { recursive: true, force: true });
+}
+function composeInstructionContent(profile, promptContext) {
+    return `${profile.agentsContent.trim()}
+
+## 代码助手运行附加说明（系统自动生成）
+
+- 当前工作目录是代码助手专用目录，只使用这里的助手规则，不回退到普通项目会话规则。
+- 你是代码助手控制面，不是项目实现者。默认职责只有：查看、分析、归纳、补查信息、安排下一步、把指令发送给真实项目会话或终端。
+- 禁止直接改业务项目代码、禁止直接生成补丁并落盘、禁止自己在项目目录里写实现。用户要推进开发时，只能通过内部 API 续接/新建项目会话、发送消息、查询结果，或者操作受控终端。
+- 如果用户要求“修改代码”“继续实现”“修 bug”，先定位目标项目和目标会话；没有会话就先新建/续接项目会话，再把任务发给那个会话继续做，不要自己在 Butler 工作目录里动手。
+- 当前聚合后的平台摘要写在 \`BUTLER_CONTEXT.md\`，先看这里，不要把所有项目原始记录一股脑塞进回答。
+- 当前摘要作用域以 \`BUTLER_CONTEXT.md\` 的最新内容为准；这次生成时记录的是：${promptContext.scope === "project" ? `项目 ${promptContext.projectId}` : "全局总览"}。如果后续上下文文件已刷新，以文件里的当前作用域为准，不要被旧缓存绑死。
+- 你自己的主工具入口不是一堆 HTTP 路由，而是 \`codingns assistant ...\`。真正执行前，先用 \`codingns assistant --help\`、\`codingns assistant help <group>\`、\`codingns assistant <group> <action> --help\` 按需查命令。
+- 如果当前 Codex 环境能发现 \`codingns-assistant\` skill，优先按这个 skill 的流程工作：先确认 CLI 的默认认证入口可用，再查能力，再查项目/会话/终端，再决定是否发送消息、fork 或发终端输入。
+- 默认查询顺序固定为：先看 \`BUTLER_CONTEXT.md\`，再确认 CLI 认证入口可用，然后用 \`codingns assistant capabilities list\` 确认能力，再按 \`projects / sessions / terminals\` 分组查具体对象；不要先翻一大堆旧 REST 文档。
+- 如果你在跟进开发会话，且目标或上下文里提到了 spec，只能围绕 spec 明确写出的必做项推进，不能顺着建议项无限扩展开发范围。
+- 如果当前没有 spec，就先从用户要求和会话现状里归纳一句核心任务，后续只围绕这个核心任务推进；不要把建议项、最佳实践、顺手优化当成必做项。
+- 如果用户的问题里已经带了项目名、会话名、错误词或任务关键词，先通过 \`codingns assistant projects --help\`、\`codingns assistant sessions --help\` 选对命令，再查目标对象；如果用户明确点名历史会话或归档会话，按 help 提示补充筛选参数。
+- 如果 \`BUTLER_CONTEXT.md\` 里的项目数或会话数是 0，不能直接下结论，必须先确认 CLI 认证入口可用，再跑 \`codingns assistant capabilities list\` 和 \`codingns assistant projects list\` 确认真实状态。
+- 如果用户追问的细节超出当前摘要，先明确缺口，再按 \`BUTLER_API.md\` 里记录的 CLI 顺序补查项目、会话、消息窗口或终端历史。
+- 如果用户追问会话内容，先定位 \`sessionId\`，再优先用 \`codingns assistant sessions messages <sessionId>\` 查看最近消息，不要只复述摘要。
+- 需要推进开发时，优先用 \`codingns assistant sessions send <sessionId> --message ...\`；只有明确需要 shell 链路时，才用 \`codingns assistant terminals send <terminalId> --input ...\`。
+- 不要编造不存在的项目状态；信息不足时直接说缺什么。
+`;
+}
+function buildApiGuideContent(auth, authFilePath) {
+    return `# 代码助手 CLI 与按需补查指南
+
+默认不要直接背 HTTP 路由。先用 \`codingns assistant ...\` 和分层 help 按需查询。
+
+## 固定认证方式
+
+- Butler 专用凭证文件：\`${path.basename(authFilePath)}\`
+- 凭证文件路径：\`${authFilePath}\`
+- 当前 API 基地址：\`${auth.apiBaseUrl}\`
+- 默认直接执行 \`codingns assistant ...\`；CLI 会优先按固定顺序读取认证。
+
+## CLI 默认认证顺序
+
+1. 显式传入的 \`--token\` / \`--base-url\`
+2. 环境变量 \`CODINGNS_ACCESS_TOKEN\` / \`CODINGNS_BASE_URL\`
+3. 环境变量 \`CODINGNS_AUTH_FILE\` 或 \`BUTLER_AUTH_FILE\` 指向的认证文件
+4. 当前目录及上级目录里的 \`BUTLER_AUTH.json\`
+
+## 什么时候手工导出环境变量
+
+- 只有当你不在 Butler 工作区、CLI 自动发现失败，或者要临时切到别的 Host / 凭证文件时，才手工导出环境变量。
+- 默认不要把“先 export 再执行”当成每轮固定动作。
+
+\`\`\`bash
+export CODINGNS_BASE_URL="$(jq -r '.apiBaseUrl' "${authFilePath}")"
+export CODINGNS_ACCESS_TOKEN="$(jq -r '.accessToken' "${authFilePath}")"
+\`\`\`
+
+## 默认读取顺序
+
+1. 先读 \`BUTLER_CONTEXT.md\` 的当前摘要。
+2. 先确认 CLI 认证入口可用；在 Butler 工作区里默认直接执行即可，必要时再核对上面的凭证文件路径。
+3. 认证入口可用后，再跑 \`codingns assistant capabilities list\`，确认当前开放能力。
+4. 不知道怎么查时，先跑 \`codingns assistant --help\`、\`codingns assistant help projects\`、\`codingns assistant help sessions\`、\`codingns assistant help terminals\`。
+5. 要找项目时，先 \`codingns assistant projects list\`，需要详情时再 \`projects get <projectId>\`。
+6. 要找会话时，先 \`codingns assistant sessions list --project <projectId>\`，再按需要用 \`sessions get\`、\`sessions runtime\`、\`sessions messages\`。
+7. 要推进开发时，优先 \`codingns assistant sessions send <sessionId> --message "..."\`。
+8. 只有明确需要 shell 链路时，先 \`terminals list\`、\`terminals history\`，再决定是否 \`terminals send\`。
+9. 要开新分支时，再用 \`codingns assistant sessions fork <sessionId>\`。
+
+## 执行边界
+
+- 你不能直接修改项目代码，也不能把自己当成项目执行会话。
+- 需要推进开发时，只能通过下面这些 CLI 命令驱动真实项目会话或受控终端。
+- 需要命令结果时，优先查终端历史；确实要执行命令，再向受控终端发送输入。
+- 需要分叉会话时，统一走 \`codingns assistant sessions fork\`，不要自己伪造一条“新上下文”继续编。
+
+## help 入口
+
+\`\`\`bash
+codingns assistant --help
+codingns assistant help projects
+codingns assistant help sessions
+codingns assistant sessions send --help
+codingns assistant terminals send --help
+\`\`\`
+
+## 常用命令
+
+- \`codingns assistant capabilities list\`：查看当前 Butler 可用能力。
+- \`codingns assistant projects list\`：列出托管项目。
+- \`codingns assistant projects get <projectId>\`：读取项目详情和项目下可操作会话。
+- \`codingns assistant sessions list --project <projectId>\`：列出项目会话。
+- \`codingns assistant sessions get <sessionId>\`：读取真实会话详情。
+- \`codingns assistant sessions messages <sessionId> --limit 40\`：读取最近消息窗口。
+- \`codingns assistant sessions runtime <sessionId>\`：查看会话是否还在运行。
+- \`codingns assistant sessions send <sessionId> --message "..."\`：向真实项目会话发消息。
+- \`codingns assistant sessions fork <sessionId> --message-id <messageId>\`：从消息点 fork 新会话。
+- \`codingns assistant terminals list --project-id <projectId>\`：列出项目下终端。
+- \`codingns assistant terminals history <terminalId> --limit 50\`：读取终端最近输出。
+- \`codingns assistant terminals send <terminalId> --input "npm test\\n"\`：向终端发送输入。
+
+## 底层说明
+
+- 上面这些命令最终还是调用宿主系统的 \`/api/assistant/*\`。
+- 只有当 CLI 还没覆盖某个极少数细节时，才回退到底层 HTTP。
+`;
+}
+function resolveSourceCodexHomeDir(sourceCodexHomeDir, targetHomeDir) {
+    const configuredSource = sourceCodexHomeDir?.trim();
+    if (configuredSource) {
+        const resolvedConfiguredSource = path.resolve(configuredSource);
+        if (resolvedConfiguredSource !== targetHomeDir) {
+            return resolvedConfiguredSource;
+        }
+    }
+    const fallbackHomeDir = path.resolve(path.join(os.homedir(), ".codex"));
+    if (fallbackHomeDir !== targetHomeDir) {
+        return fallbackHomeDir;
+    }
+    return targetHomeDir;
+}
+function composeCodexConfigContent(sourceConfigContent, instructionFilePath) {
+    const normalizedSource = sourceConfigContent
+        .split(/\r?\n/)
+        .filter((line) => {
+        const trimmed = line.trim();
+        return trimmed.length > 0 && !trimmed.startsWith("model_instructions_file");
+    })
+        .join("\n")
+        .trim();
+    return [
+        "# 代码助手专用 Codex 配置（系统自动生成）",
+        normalizedSource,
+        `model_instructions_file = ${toTomlString(instructionFilePath)}`
+    ]
+        .filter((part) => part.trim().length > 0)
+        .join("\n\n");
+}
+function writeFileIfChanged(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    if (fs.existsSync(filePath) && fs.readFileSync(filePath, "utf8") === content) {
+        return;
+    }
+    fs.writeFileSync(filePath, content, "utf8");
+}
+function syncOptionalFile(sourcePath, targetPath) {
+    if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isFile()) {
+        return;
+    }
+    writeFileIfChanged(targetPath, fs.readFileSync(sourcePath, "utf8"));
+}
+function syncOptionalDirectory(sourcePath, targetPath) {
+    if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isDirectory()) {
+        return;
+    }
+    fs.rmSync(targetPath, { recursive: true, force: true });
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.cpSync(sourcePath, targetPath, { recursive: true });
+}
+function removeFileIfExists(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return;
+    }
+    fs.rmSync(filePath, { force: true });
+}
+function toTomlString(value) {
+    return `"${value.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"")}"`;
+}
+//# sourceMappingURL=butler-workspace-context.js.map

package/dist/server/modules/butler/butler-workspace-context.js.map

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

package/dist/server/modules/client/client-controller.d.ts

@@ -6,4 +6,10 @@ export declare class ClientController {
     readonly getRuntimeConfig: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
     readonly getReleaseManifest: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
     readonly getServiceUpdate: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly installServiceUpdate: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly getServiceUpdateTask: (request: FastifyRequest<{
+        Params: {
+            taskId: string;
+        };
+    }>, reply: FastifyReply) => Promise<void>;
 }

package/dist/server/modules/client/client-controller.js

@@ -31,7 +31,7 @@ export class ClientController {
             throw new AppError({
                 statusCode: 400,
                 errorCode: "INVALID_PLATFORM",
-                detail: "缺少桌面平台标识",
+                detail: "缺少发布平台标识",
                 field: "platform"
             });
         }
@@ -39,17 +39,29 @@ export class ClientController {
         reply.send(this.clientService.getReleaseManifest(channel, query.platform));
     };
     getServiceUpdate = async (request, reply) => {
-        if (!request.auth?.user.userId) {
-            throw new AppError({
-                statusCode: 401,
-                errorCode: "UNAUTHORIZED",
-                detail: "当前请求缺少有效登录态"
-            });
-        }
+        ensureAuthenticated(request);
         const query = request.query;
         const channel = query.channel === "beta" ? "beta" : "stable";
         reply.send(await this.clientService.getServiceUpdate(channel));
     };
+    installServiceUpdate = async (request, reply) => {
+        ensureAuthenticated(request);
+        const body = request.body;
+        if (!body?.packageName) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "SERVICE_UPDATE_PACKAGE_REQUIRED",
+                detail: "缺少需要升级的 npm 包名",
+                field: "packageName"
+            });
+        }
+        const channel = body.channel === "beta" ? "beta" : "stable";
+        reply.send(await this.clientService.installServiceUpdate(channel, body.packageName));
+    };
+    getServiceUpdateTask = async (request, reply) => {
+        ensureAuthenticated(request);
+        reply.send(this.clientService.getServiceUpdateTask(request.params.taskId));
+    };
 }
 function readRequestProtocol(request) {
     const forwarded = request.headers["x-forwarded-proto"];
@@ -62,4 +74,14 @@ function normalizePlatform(query) {
     const platform = query?.platform;
     return platform === "desktop" ? "desktop" : "web";
 }
+function ensureAuthenticated(request) {
+    if (request.auth?.user.userId) {
+        return;
+    }
+    throw new AppError({
+        statusCode: 401,
+        errorCode: "UNAUTHORIZED",
+        detail: "当前请求缺少有效登录态"
+    });
+}
 //# sourceMappingURL=client-controller.js.map

package/dist/server/modules/client/client-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-controller.js","sourceRoot":"","sources":["../../../../src/modules/client/client-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAG5D,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,gBAAgB,GAAG,KAAK,EAC/B,OAAuB,EACvB,KAAmB,EACJ,EAAE;QACjB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,cAAc;gBACzB,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,QAAQ,EAAE;YACvD,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC;YACtC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI;SACnC,CAAC,CAAC,CAAC;IACN,CAAC,CAAC;IAEO,kBAAkB,GAAG,KAAK,EACjC,OAAuB,EACvB,KAAmB,EACJ,EAAE;QACjB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,cAAc;gBACzB,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAGrB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,kBAAkB;gBAC7B,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC;IAEO,gBAAgB,GAAG,KAAK,EAC/B,OAAuB,EACvB,KAAmB,EACJ,EAAE;QACjB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,cAAc;gBACzB,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAErB,CAAC;QAEF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC;CACH;AAED,SAAS,mBAAmB,CAAC,OAAuB;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEvD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IACnD,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,MAAM,QAAQ,GAAI,KAA2C,EAAE,QAAQ,CAAC;IACxE,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC"}
+{"version":3,"file":"client-controller.js","sourceRoot":"","sources":["../../../../src/modules/client/client-controller.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/client/client-service.d.ts

@@ -1,4 +1,7 @@
 import type { HostConfig } from "../../config/env.js";
+import type { NpmGlobalPackageService } from "./npm-global-package-service.js";
+import type { ServiceUpdateTaskService } from "./service-update-task-service.js";
+import type { ServiceUpdateListDto, ServiceUpdateTaskDto } from "./service-update-types.js";
 export interface ClientRuntimeConfigDto {
     platform: "desktop" | "web";
     hostBaseUrl: string;
@@ -6,7 +9,7 @@ export interface ClientRuntimeConfigDto {
     autoReconnect: boolean;
     autoCheckUpdate: boolean;
 }
-export interface ReleaseManifestDto {
+export interface DesktopReleaseManifestDto {
     channel: "stable" | "beta";
     platform: string;
     version: string;
@@ -15,23 +18,32 @@ export interface ReleaseManifestDto {
     signature: string;
     publishedAt: string;
 }
-export interface ServiceUpdateDto {
+export interface AndroidReleaseManifestDto {
     channel: "stable" | "beta";
+    version: string;
+    versionCode: number;
     packageName: string;
-    registryUrl: string;
-    packagePageUrl: string;
-    currentVersion: string;
-    latestVersion: string | null;
-    hasUpdate: boolean;
-    updateCommand: string;
+    fileName: string;
+    downloadUrl: string;
+    sha256: string;
+    publishedAt: string;
+    notes: string;
+    minSupportedVersionCode: number | null;
+    htmlUrl: string | null;
 }
+export type ReleaseManifestDto = DesktopReleaseManifestDto | AndroidReleaseManifestDto;
 export declare class ClientService {
     private readonly config;
-    constructor(config: HostConfig);
+    private readonly npmGlobalPackageService;
+    private readonly serviceUpdateTaskService;
+    constructor(config: HostConfig, npmGlobalPackageService: NpmGlobalPackageService, serviceUpdateTaskService: ServiceUpdateTaskService);
     getRuntimeConfig(platform: "desktop" | "web", requestContext?: {
         readonly protocol?: string | null;
         readonly host?: string | null;
     }): ClientRuntimeConfigDto;
     getReleaseManifest(channel: "stable" | "beta", platform: string): ReleaseManifestDto;
-    getServiceUpdate(channel: "stable" | "beta"): Promise<ServiceUpdateDto>;
+    getServiceUpdate(channel: "stable" | "beta"): Promise<ServiceUpdateListDto>;
+    installServiceUpdate(channel: "stable" | "beta", packageName: string): Promise<ServiceUpdateTaskDto>;
+    getServiceUpdateTask(taskId: string): ServiceUpdateTaskDto;
 }
+export declare function readHostPackageVersion(): string;

package/dist/server/modules/client/client-service.js

@@ -4,8 +4,12 @@ import { fileURLToPath } from "node:url";
 import { AppError } from "../../shared/errors/app-error.js";
 export class ClientService {
     config;
-    constructor(config) {
+    npmGlobalPackageService;
+    serviceUpdateTaskService;
+    constructor(config, npmGlobalPackageService, serviceUpdateTaskService) {
         this.config = config;
+        this.npmGlobalPackageService = npmGlobalPackageService;
+        this.serviceUpdateTaskService = serviceUpdateTaskService;
     }
     getRuntimeConfig(platform, requestContext) {
         return {
@@ -28,72 +32,89 @@ export class ClientService {
         const raw = fs.readFileSync(manifestPath, "utf8");
         try {
             const parsed = JSON.parse(raw);
-            if (!parsed.channel ||
-                !parsed.platform ||
-                !parsed.version ||
-                !parsed.packageUrl ||
-                !parsed.signature ||
-                !parsed.publishedAt) {
-                throw new Error("manifest incomplete");
+            if (platform === "android-apk") {
+                return parseAndroidReleaseManifest(parsed);
             }
-            return {
-                channel: parsed.channel,
-                platform: parsed.platform,
-                version: parsed.version,
-                notes: parsed.notes ?? "",
-                packageUrl: parsed.packageUrl,
-                signature: parsed.signature,
-                publishedAt: parsed.publishedAt
-            };
+            return parseDesktopReleaseManifest(parsed);
         }
         catch {
             throw new AppError({
                 statusCode: 500,
                 errorCode: "MANIFEST_INVALID",
-                detail: `桌面发布清单 ${manifestPath} 格式无效`
+                detail: `发布清单 ${manifestPath} 格式无效`
             });
         }
     }
     async getServiceUpdate(channel) {
-        const packageName = this.config.serverUpdatePackageName;
         const currentVersion = readHostPackageVersion();
-        const packagePageUrl = `https://www.npmjs.com/package/${packageName}`;
-        const registryUrl = buildRegistryPackageUrl(this.config.npmRegistryBaseUrl, packageName);
-        try {
-            const response = await fetch(registryUrl, {
-                headers: {
-                    Accept: "application/json"
-                }
-            });
-            if (!response.ok) {
-                throw new Error(`HTTP ${response.status}`);
-            }
-            const raw = (await response.json());
-            const latestVersion = pickServiceTargetVersion(raw, channel);
-            return {
-                channel,
-                packageName,
-                registryUrl,
-                packagePageUrl,
-                currentVersion,
-                latestVersion,
-                hasUpdate: latestVersion !== null && compareSemver(latestVersion, currentVersion) > 0,
-                updateCommand: `npm install ${packageName}@${channel === "beta" ? "beta" : "latest"}`
-            };
-        }
-        catch {
-            return {
-                channel,
-                packageName,
-                registryUrl,
-                packagePageUrl,
-                currentVersion,
-                latestVersion: null,
-                hasUpdate: false,
-                updateCommand: `npm install ${packageName}@${channel === "beta" ? "beta" : "latest"}`
-            };
-        }
+        const packages = await this.npmGlobalPackageService.listManagedPackages(channel, currentVersion, (packageName) => this.serviceUpdateTaskService.getLatestTaskByPackageName(packageName));
+        return {
+            channel,
+            checkedAt: new Date().toISOString(),
+            packages
+        };
+    }
+    async installServiceUpdate(channel, packageName) {
+        return await this.serviceUpdateTaskService.installPackage(channel, packageName);
     }
+    getServiceUpdateTask(taskId) {
+        return this.serviceUpdateTaskService.getTask(taskId);
+    }
+}
+function parseDesktopReleaseManifest(parsed) {
+    if (!isReleaseChannel(parsed.channel) ||
+        !isNonEmptyString(parsed.platform) ||
+        !isNonEmptyString(parsed.version) ||
+        !isNonEmptyString(parsed.packageUrl) ||
+        !isNonEmptyString(parsed.signature) ||
+        !isNonEmptyString(parsed.publishedAt)) {
+        throw new Error("desktop manifest incomplete");
+    }
+    return {
+        channel: parsed.channel,
+        platform: parsed.platform,
+        version: parsed.version,
+        notes: isNonEmptyString(parsed.notes) ? parsed.notes : "",
+        packageUrl: parsed.packageUrl,
+        signature: parsed.signature,
+        publishedAt: parsed.publishedAt
+    };
+}
+function parseAndroidReleaseManifest(parsed) {
+    if (!isReleaseChannel(parsed.channel) ||
+        !isNonEmptyString(parsed.version) ||
+        !isPositiveInteger(parsed.versionCode) ||
+        !isNonEmptyString(parsed.packageName) ||
+        !isNonEmptyString(parsed.fileName) ||
+        !isNonEmptyString(parsed.downloadUrl) ||
+        !isNonEmptyString(parsed.sha256) ||
+        !isNonEmptyString(parsed.publishedAt)) {
+        throw new Error("android manifest incomplete");
+    }
+    return {
+        channel: parsed.channel,
+        version: parsed.version,
+        versionCode: parsed.versionCode,
+        packageName: parsed.packageName,
+        fileName: parsed.fileName,
+        downloadUrl: parsed.downloadUrl,
+        sha256: parsed.sha256,
+        publishedAt: parsed.publishedAt,
+        notes: isNonEmptyString(parsed.notes) ? parsed.notes : "",
+        minSupportedVersionCode: isPositiveInteger(parsed.minSupportedVersionCode)
+            ? parsed.minSupportedVersionCode
+            : null,
+        htmlUrl: isNonEmptyString(parsed.htmlUrl) ? parsed.htmlUrl : null
+    };
+}
+function isReleaseChannel(value) {
+    return value === "stable" || value === "beta";
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isPositiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0;
 }
 function resolveClientHostBaseUrl(config, platform, requestContext) {
     if (platform === "web") {
@@ -114,7 +135,7 @@ function resolveAccessibleHost(host) {
     }
     return host;
 }
-function readHostPackageVersion() {
+export function readHostPackageVersion() {
     const packageJsonPath = findNearestPackageJson(fileURLToPath(import.meta.url));
     if (!packageJsonPath) {
         return "0.0.0";
@@ -125,50 +146,6 @@ function readHostPackageVersion() {
         ? parsed.version
         : "0.0.0";
 }
-function buildRegistryPackageUrl(baseUrl, packageName) {
-    const normalizedBaseUrl = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
-    return new URL(encodeURIComponent(packageName), normalizedBaseUrl).toString();
-}
-function pickServiceTargetVersion(payload, channel) {
-    const distTags = payload["dist-tags"] ?? {};
-    if (channel === "beta") {
-        return distTags.beta ?? distTags.latest ?? null;
-    }
-    return distTags.latest ?? null;
-}
-function compareSemver(left, right) {
-    const leftMeta = parseSemver(left);
-    const rightMeta = parseSemver(right);
-    for (let index = 0; index < 3; index += 1) {
-        const diff = (leftMeta.numbers[index] ?? 0) - (rightMeta.numbers[index] ?? 0);
-        if (diff !== 0) {
-            return diff;
-        }
-    }
-    if (leftMeta.prerelease === rightMeta.prerelease) {
-        return 0;
-    }
-    if (!leftMeta.prerelease) {
-        return 1;
-    }
-    if (!rightMeta.prerelease) {
-        return -1;
-    }
-    return leftMeta.prerelease.localeCompare(rightMeta.prerelease);
-}
-function parseSemver(input) {
-    const normalized = input.trim().replace(/^v/i, "");
-    const [versionPart, prerelease = ""] = normalized.split("-", 2);
-    const rawNumbers = versionPart.split(".");
-    return {
-        numbers: [
-            Number.parseInt(rawNumbers[0] ?? "0", 10) || 0,
-            Number.parseInt(rawNumbers[1] ?? "0", 10) || 0,
-            Number.parseInt(rawNumbers[2] ?? "0", 10) || 0
-        ],
-        prerelease
-    };
-}
 function findNearestPackageJson(fromFilePath) {
     let currentDir = path.dirname(fromFilePath);
     while (true) {