@jingyi0605/codingns 0.8.1 → 0.8.5

package/dist/server/modules/channels/wechat-claw-client.js

@@ -0,0 +1,245 @@
+import { randomInt } from "node:crypto";
+import { AppError } from "../../shared/errors/app-error.js";
+const WECHAT_CLAW_FIXED_BASE_URL = "https://ilinkai.weixin.qq.com";
+const WECHAT_CLAW_BOT_TYPE = "3";
+const WECHAT_CLAW_APP_ID = "bot";
+const WECHAT_CLAW_APP_CLIENT_VERSION = String(0x00020107);
+export async function startWechatClawLogin() {
+    const payload = await fetchWechatClawJson(`${WECHAT_CLAW_FIXED_BASE_URL}/ilink/bot/get_bot_qrcode?bot_type=${encodeURIComponent(WECHAT_CLAW_BOT_TYPE)}`);
+    const qrcode = readBodyText(payload, "qrcode");
+    if (!qrcode) {
+        throw platformRequestFailed("微信 claw 登录二维码响应缺少 qrcode");
+    }
+    return {
+        sessionKey: qrcode,
+        qrcode,
+        qrcodeUrl: readBodyText(payload, "qrcode_img_content"),
+        status: "waiting_scan"
+    };
+}
+export async function pollWechatClawLoginStatus(options) {
+    const payload = await fetchWechatClawJson(`${normalizeWechatClawBaseUrl(options.authBaseUrl)}/ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(options.qrcode)}`);
+    const rawStatus = readBodyText(payload, "status");
+    switch (rawStatus) {
+        case "wait":
+            return createWechatClawPollLoginResult("waiting_scan");
+        case "scaned":
+            return createWechatClawPollLoginResult("scan_confirmed");
+        case "expired":
+            return createWechatClawPollLoginResult("expired");
+        case "scaned_but_redirect":
+            return {
+                ...createWechatClawPollLoginResult("scan_confirmed"),
+                redirectHost: readBodyText(payload, "redirect_host")
+            };
+        case "confirmed":
+            return {
+                status: "active",
+                botToken: readBodyText(payload, "bot_token"),
+                baseUrl: readBodyText(payload, "baseurl") ?? normalizeWechatClawBaseUrl(options.authBaseUrl),
+                remoteBotId: readBodyText(payload, "ilink_bot_id"),
+                boundUserId: readBodyText(payload, "ilink_user_id"),
+                redirectHost: null
+            };
+        default:
+            throw platformRequestFailed(`微信 claw 登录状态无法识别：${rawStatus ?? "unknown"}`);
+    }
+}
+export async function pollWechatClawMessages(options) {
+    const payload = ensurePlainObject(await fetchJson(`${normalizeWechatClawBaseUrl(options.baseUrl)}/ilink/bot/getupdates`, {
+        method: "POST",
+        headers: buildWechatClawHeaders(options.botToken),
+        body: JSON.stringify({
+            base_info: {
+                channel_version: "2.0.0"
+            },
+            get_updates_buf: options.cursor ?? "",
+            timeout: Math.max(options.timeoutMs ?? 0, 0),
+            max_items: 50
+        })
+    }), "wechat claw getupdates response");
+    const errorCode = readBodyInteger(payload, "errcode");
+    if (errorCode === -14) {
+        throw platformLoginExpired("个人微信（claw）登录已失效，请重新扫码绑定");
+    }
+    if (typeof errorCode === "number" && errorCode !== 0) {
+        throw platformRequestFailed(`微信 claw 拉取消息失败：${readBodyText(payload, "errmsg") ?? `errcode=${errorCode}`}`);
+    }
+    const cursor = readBodyText(payload, "get_updates_buf")
+        ?? readBodyText(payload, "next_cursor")
+        ?? readBodyText(payload, "sync_buf");
+    const items = Array.isArray(payload.msgs)
+        ? payload.msgs
+        : Array.isArray(payload.messages)
+            ? payload.messages
+            : Array.isArray(payload.msg_list)
+                ? payload.msg_list
+                : [];
+    return {
+        nextCursor: cursor,
+        longPollingTimeoutMs: readBodyInteger(payload, "longpolling_timeout_ms"),
+        messages: items
+            .map((item) => parseWechatClawInboundMessage(item))
+            .filter((item) => item !== null)
+    };
+}
+export async function sendWechatClawText(options) {
+    const payload = ensurePlainObject(await fetchJson(`${normalizeWechatClawBaseUrl(options.baseUrl)}/ilink/bot/sendmessage`, {
+        method: "POST",
+        headers: buildWechatClawHeaders(options.botToken),
+        body: JSON.stringify({
+            to_user_id: options.toUserId,
+            context_token: options.contextToken,
+            item_list: [
+                {
+                    type: "text",
+                    text_item: {
+                        text: options.text
+                    }
+                }
+            ]
+        })
+    }), "wechat claw sendmessage response");
+    return {
+        messageRef: readBodyText(payload, "message_id") ?? readBodyText(payload, "msg_id")
+    };
+}
+export function normalizeWechatClawBaseUrl(value) {
+    const normalized = value?.trim();
+    return normalized && normalized.length > 0 ? normalized : WECHAT_CLAW_FIXED_BASE_URL;
+}
+function createWechatClawPollLoginResult(status) {
+    return {
+        status,
+        botToken: null,
+        baseUrl: null,
+        remoteBotId: null,
+        boundUserId: null,
+        redirectHost: null
+    };
+}
+function buildWechatClawHeaders(botToken) {
+    return {
+        authorization: `Bearer ${botToken}`,
+        authorizationtype: "ilink_bot_token",
+        "content-type": "application/json",
+        "ilink-app-id": WECHAT_CLAW_APP_ID,
+        "ilink-app-clientversion": WECHAT_CLAW_APP_CLIENT_VERSION,
+        "x-wechat-uin": Buffer.from(String(randomInt(1, 0xffffffff))).toString("base64")
+    };
+}
+function parseWechatClawInboundMessage(value) {
+    const payload = ensurePlainObject(value, "wechat claw message");
+    const text = extractWechatClawText(payload);
+    const fromUserId = readBodyText(payload, "from_user_id");
+    if (!text || !fromUserId) {
+        return null;
+    }
+    return {
+        messageId: readBodyText(payload, "message_id")
+            ?? readBodyText(payload, "msg_id")
+            ?? `wechat-claw:${Date.now()}:${Math.random().toString(16).slice(2, 10)}`,
+        fromUserId,
+        toUserId: readBodyText(payload, "to_user_id"),
+        text,
+        timestamp: readBodyText(payload, "timestamp"),
+        contextToken: readBodyText(payload, "context_token"),
+        rawPayload: payload
+    };
+}
+function extractWechatClawText(payload) {
+    const itemList = payload.item_list;
+    if (!Array.isArray(itemList)) {
+        return null;
+    }
+    for (const item of itemList) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            continue;
+        }
+        const entry = item;
+        if (readBodyText(entry, "type") !== "text") {
+            continue;
+        }
+        const textItem = ensurePlainObject(entry.text_item ?? {}, "wechat claw text_item");
+        const text = readBodyText(textItem, "text");
+        if (text) {
+            return text;
+        }
+    }
+    return null;
+}
+async function fetchWechatClawJson(url) {
+    return ensurePlainObject(await fetchJson(url), "wechat claw response");
+}
+async function fetchJson(url, init) {
+    const response = await fetch(url, init);
+    const text = await response.text();
+    const payload = text ? safeJsonParse(text) : null;
+    if (!response.ok) {
+        throw new AppError({
+            statusCode: 502,
+            errorCode: "CHANNEL_PLATFORM_REQUEST_FAILED",
+            detail: `请求 ${url} 失败：${response.status} ${response.statusText}`
+        });
+    }
+    return payload;
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return {
+            raw: text
+        };
+    }
+}
+function ensurePlainObject(value, field) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw platformRequestFailed(`${field} 必须是对象`);
+    }
+    return value;
+}
+function readBodyText(source, key) {
+    if (!source || typeof source !== "object" || Array.isArray(source)) {
+        return null;
+    }
+    const value = source[key];
+    if (typeof value === "string") {
+        const normalized = value.trim();
+        return normalized.length > 0 ? normalized : null;
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+    }
+    return null;
+}
+function readBodyInteger(source, key) {
+    if (!source || typeof source !== "object" || Array.isArray(source)) {
+        return null;
+    }
+    const value = source[key];
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return Math.trunc(value);
+    }
+    if (typeof value === "string") {
+        const parsed = Number.parseInt(value.trim(), 10);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+function platformRequestFailed(detail) {
+    return new AppError({
+        statusCode: 502,
+        errorCode: "CHANNEL_PLATFORM_REQUEST_FAILED",
+        detail
+    });
+}
+function platformLoginExpired(detail) {
+    return new AppError({
+        statusCode: 401,
+        errorCode: "CHANNEL_PLATFORM_LOGIN_EXPIRED",
+        detail
+    });
+}
+//# sourceMappingURL=wechat-claw-client.js.map

package/dist/server/modules/channels/wechat-claw-client.js.map

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

package/dist/server/modules/file/file-access-guard.d.ts

@@ -8,6 +8,7 @@ interface ResolvePathOptions {
     allowRoot?: boolean;
     mustExist?: boolean;
     kind?: "file" | "directory" | "any";
+    allowMissingParentChain?: boolean;
 }
 export interface ResolvedWorkspacePath {
     workspace: Workspace;
@@ -23,5 +24,6 @@ export declare class FileAccessGuard {
     constructor(workspaceService: WorkspaceService, logger: FileAccessLogger);
     resolvePath(workspaceId: string, requestedPath: string | undefined, options?: ResolvePathOptions): ResolvedWorkspacePath;
     private ensureInsideWorkspace;
+    private findNearestExistingAncestor;
 }
 export {};

package/dist/server/modules/file/file-access-guard.js

@@ -42,8 +42,17 @@ export class FileAccessGuard {
                     field: "path"
                 });
             }
-            const parentPath = path.dirname(absolutePath);
-            if (!fs.existsSync(parentPath)) {
+            const parentPath = this.findNearestExistingAncestor(path.dirname(absolutePath));
+            if (!parentPath) {
+                throw new AppError({
+                    statusCode: 400,
+                    errorCode: "PARENT_DIRECTORY_NOT_FOUND",
+                    detail: "目标目录不存在",
+                    field: "path"
+                });
+            }
+            if (!options.allowMissingParentChain
+                && parentPath !== path.dirname(absolutePath)) {
                 throw new AppError({
                     statusCode: 400,
                     errorCode: "PARENT_DIRECTORY_NOT_FOUND",
@@ -95,5 +104,18 @@ export class FileAccessGuard {
             });
         }
     }
+    findNearestExistingAncestor(inputPath) {
+        let currentPath = path.resolve(inputPath);
+        while (true) {
+            if (fs.existsSync(currentPath)) {
+                return currentPath;
+            }
+            const parentPath = path.dirname(currentPath);
+            if (parentPath === currentPath) {
+                return null;
+            }
+            currentPath = parentPath;
+        }
+    }
 }
 //# sourceMappingURL=file-access-guard.js.map

package/dist/server/modules/file/file-access-guard.js.map

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

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

@@ -5,6 +5,8 @@ import type { FilePreviewService } from "./file-preview-service.js";
 import type { FileSearchService } from "./file-search-service.js";
 import type { FileTreeService } from "./file-tree-service.js";
 import type { RecentFileService } from "./recent-file-service.js";
+import type { WorkspaceFileBridgeListDirOptions, WorkspaceFileBridgeService, WorkspaceFileBridgeWriteTextOptions, WorkspaceFileBridgeDeleteFileOptions } from "./workspace-file-bridge-service.js";
+import type { WorkspaceFileBridgeWatchDirOptions } from "./workspace-file-bridge-watch-service.js";
 interface FileWorkspaceQuery {
     workspaceId?: string;
     path?: string;
@@ -34,6 +36,54 @@ interface FileOperationBody {
 interface PublicFilePreviewParams {
     "*": string;
 }
+interface PublicWorkspaceBridgeParams {
+    token?: string;
+}
+interface PublicWorkspaceBridgeQuery extends WorkspaceBridgeQuery {
+    token?: string;
+}
+interface WorkspaceBridgeQuery extends FileWorkspaceQuery {
+}
+interface WorkspaceBridgeListDirBody {
+    workspaceId?: string;
+    path?: string;
+    options?: WorkspaceFileBridgeListDirOptions;
+}
+interface WorkspaceBridgeReadTextBody {
+    workspaceId?: string;
+    path?: string;
+}
+interface WorkspaceBridgeReadTextsBody {
+    workspaceId?: string;
+    paths?: string[];
+}
+interface WorkspaceBridgeWriteTextBody {
+    workspaceId?: string;
+    path?: string;
+    content?: string;
+    options?: WorkspaceFileBridgeWriteTextOptions;
+}
+interface WorkspaceBridgeDeleteFileBody {
+    workspaceId?: string;
+    path?: string;
+    options?: WorkspaceFileBridgeDeleteFileOptions;
+}
+interface WorkspaceBridgeWatchDirBody {
+    workspaceId?: string;
+    path?: string;
+    options?: WorkspaceFileBridgeWatchDirOptions;
+}
+interface WorkspaceBridgeDesktopActionBody {
+    workspaceId?: string;
+    path?: string;
+}
+interface WorkspaceBridgeUnwatchBody {
+    watchId?: string;
+}
+interface WorkspaceBridgePollWatchQuery {
+    watchId?: string;
+    cursor?: string;
+}
 export declare class FileController {
     private readonly fileTreeService;
     private readonly fileContentService;
@@ -41,7 +91,8 @@ export declare class FileController {
     private readonly recentFileService;
     private readonly filePreviewService;
     private readonly filePreviewLinkService;
-    constructor(fileTreeService: FileTreeService, fileContentService: FileContentService, fileSearchService: FileSearchService, recentFileService: RecentFileService, filePreviewService: FilePreviewService, filePreviewLinkService: FilePreviewLinkService);
+    private readonly workspaceFileBridgeService;
+    constructor(fileTreeService: FileTreeService, fileContentService: FileContentService, fileSearchService: FileSearchService, recentFileService: RecentFileService, filePreviewService: FilePreviewService, filePreviewLinkService: FilePreviewLinkService, workspaceFileBridgeService: WorkspaceFileBridgeService);
     readonly getTree: (request: FastifyRequest<{
         Querystring: FileWorkspaceQuery;
     }>, reply: FastifyReply) => Promise<void>;
@@ -72,8 +123,109 @@ export declare class FileController {
     readonly createPreviewLink: (request: FastifyRequest<{
         Querystring: FileWorkspaceQuery;
     }>, reply: FastifyReply) => Promise<void>;
+    readonly getWorkspaceBridgeCapabilities: (request: FastifyRequest<{
+        Querystring: WorkspaceBridgeQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeListDir: (request: FastifyRequest<{
+        Body: WorkspaceBridgeListDirBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeReadText: (request: FastifyRequest<{
+        Body: WorkspaceBridgeReadTextBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeReadTexts: (request: FastifyRequest<{
+        Body: WorkspaceBridgeReadTextsBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeWriteText: (request: FastifyRequest<{
+        Body: WorkspaceBridgeWriteTextBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeDeleteFile: (request: FastifyRequest<{
+        Body: WorkspaceBridgeDeleteFileBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeStat: (request: FastifyRequest<{
+        Querystring: WorkspaceBridgeQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeExists: (request: FastifyRequest<{
+        Querystring: WorkspaceBridgeQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeOpenFile: (request: FastifyRequest<{
+        Body: WorkspaceBridgeDesktopActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeRevealInFileManager: (request: FastifyRequest<{
+        Body: WorkspaceBridgeDesktopActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeWatchDir: (request: FastifyRequest<{
+        Body: WorkspaceBridgeWatchDirBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeUnwatch: (request: FastifyRequest<{
+        Body: WorkspaceBridgeUnwatchBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgePollWatch: (request: FastifyRequest<{
+        Querystring: WorkspaceBridgePollWatchQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeCapabilities: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeListDir: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeListDirBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeReadText: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeReadTextBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeReadTexts: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeReadTextsBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeWriteText: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeWriteTextBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeDeleteFile: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeDeleteFileBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeStat: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeExists: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeOpenFile: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeDesktopActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeRevealInFileManager: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeDesktopActionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeWatchDir: (request: FastifyRequest<{
+        Params: PublicWorkspaceBridgeParams;
+        Querystring: PublicWorkspaceBridgeQuery;
+        Body: WorkspaceBridgeWatchDirBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgeUnwatch: (request: FastifyRequest<{
+        Body: WorkspaceBridgeUnwatchBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly previewWorkspaceBridgePollWatch: (request: FastifyRequest<{
+        Querystring: WorkspaceBridgePollWatchQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    private resolvePreviewRequestWorkspaceId;
+    private sendWorkspaceBridgeUnwatch;
+    private sendWorkspaceBridgePollWatch;
     readonly publicPreview: (request: FastifyRequest<{
         Params: PublicFilePreviewParams;
     }>, reply: FastifyReply) => Promise<void>;
+    readonly workspaceBridgeRuntime: (_request: FastifyRequest, reply: FastifyReply) => Promise<void>;
 }
 export {};