ossput 0.0.1

package/dist/setup/run-setup.js

@@ -0,0 +1,156 @@
+import { readFile } from "node:fs/promises";
+import { confirm } from "@inquirer/prompts";
+import { parseConfig } from "../config.js";
+import { indexExists, profileFilePath, writeProjectBinding, } from "../config-profiles.js";
+import { testConnectivity } from "./connectivity.js";
+import { buildMcpServerEntry, formatMergeAction, getPackageVersion, MCP_CLIENTS, mergeMcpConfig, readOurMcpEntry, MCP_SERVER_NAME, } from "./mcp-registry.js";
+import { promptOverwriteExisting, runInteractiveSetup, } from "./prompts.js";
+import { writeProfileConfig } from "./write-config.js";
+import { installAgentSkills } from "./skill-install.js";
+import { printConfigSummary, printError, printSuccessFooter, printWarn, ui, withSpinner, } from "./ui.js";
+const SERVER_NAME = MCP_SERVER_NAME;
+export async function runSetup(options = {}) {
+    let profileName;
+    let profileLabel;
+    let config;
+    let clientIds;
+    let skippedOssConfig = false;
+    let bindProject = false;
+    if (options.nonInteractive && options.configPath) {
+        const raw = JSON.parse(await readFile(options.configPath, "utf8"));
+        config = parseConfig(raw);
+        profileName = options.profileName?.trim() || "default";
+        clientIds = options.clientIds ?? MCP_CLIENTS.map((c) => c.id);
+        const path = await writeProfileConfig(profileName, config, {
+            setDefault: true,
+        });
+        console.log(ui.dim(`正在写入 → ${path}`));
+        console.log(ui.green(`✓ 配置已保存`));
+    }
+    else if (options.nonInteractive) {
+        throw new Error("--non-interactive 需要同时指定 --config <配置文件路径>");
+    }
+    else {
+        const interactive = await runInteractiveSetup();
+        profileName = interactive.profileName;
+        profileLabel = interactive.profileLabel;
+        config = interactive.config;
+        clientIds = interactive.clientIds;
+        skippedOssConfig = interactive.skippedOssConfig;
+        bindProject = interactive.bindProject;
+        if (!skippedOssConfig) {
+            const path = profileFilePath(profileName);
+            printConfigSummary(config, path, profileLabel ? { name: profileName, label: profileLabel } : { name: profileName });
+            const saveOk = await confirm({
+                message: "确认保存以上配置？",
+                default: true,
+            });
+            if (!saveOk) {
+                console.log(ui.dim("\n  已取消。\n"));
+                process.exit(0);
+            }
+            const hadIndex = await indexExists();
+            await writeProfileConfig(profileName, config, {
+                label: profileLabel,
+                setDefault: !hadIndex,
+            });
+            console.log(ui.green(`\n  ✓ 账号已保存（权限 600）`));
+            console.log(ui.dim(`    ${path}\n`));
+        }
+    }
+    if (!options.skipConnectivity && !skippedOssConfig) {
+        try {
+            await withSpinner("正在检测 OSS 连通性", async () => {
+                await testConnectivity(config);
+            });
+            console.log(ui.green("  ✓ Bucket 连通性正常，凭证有效"));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            printWarn(`OSS 连通性检测未通过：${msg}`);
+            printWarn("配置已保存，请检查 Region / Bucket / 密钥 / 网络后重试上传。");
+            const cont = options.nonInteractive
+                ? true
+                : await confirm({
+                    message: "是否仍继续写入 MCP 配置？",
+                    default: true,
+                });
+            if (!cont) {
+                console.log(ui.dim("\n  已中止。\n"));
+                process.exit(1);
+            }
+        }
+    }
+    else if (skippedOssConfig) {
+        printWarn("已跳过 OSS 连通性检测。");
+    }
+    if (bindProject) {
+        const p = await writeProjectBinding(profileName);
+        console.log(ui.green(`  ✓ 已写入 ${p}`));
+    }
+    const version = await getPackageVersion();
+    const entry = buildMcpServerEntry(version);
+    const mergedClients = [];
+    console.log("");
+    console.log(ui.bold("  正在注册 MCP 客户端…"));
+    for (const id of clientIds) {
+        const client = MCP_CLIENTS.find((c) => c.id === id);
+        if (!client) {
+            printWarn(`未知客户端：${id}`);
+            continue;
+        }
+        const mcpPath = client.resolveConfigPath();
+        if (!mcpPath) {
+            printWarn(`${client.displayName}：当前系统无默认配置路径，请手动添加。`);
+            continue;
+        }
+        try {
+            const existing = await readOurMcpEntry(mcpPath);
+            let force = true;
+            if (existing != null) {
+                const same = JSON.stringify(existing) === JSON.stringify(entry);
+                if (!same && !options.nonInteractive) {
+                    force = await promptOverwriteExisting(client.displayName);
+                    if (!force) {
+                        printWarn(`${client.displayName}：保留原有 MCP 条目，未修改。`);
+                        mergedClients.push({
+                            name: client.displayName,
+                            path: mcpPath,
+                            action: "已跳过",
+                        });
+                        continue;
+                    }
+                }
+            }
+            const result = await mergeMcpConfig(mcpPath, SERVER_NAME, entry, {
+                force,
+            });
+            mergedClients.push({
+                name: client.displayName,
+                path: mcpPath,
+                action: formatMergeAction(result),
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            printError(`${client.displayName}：${msg}`);
+        }
+    }
+    let skillResults = [];
+    if (!options.skipSkillInstall) {
+        console.log("");
+        console.log(ui.bold("  正在安装 Agent Skill（用户级，无需复制到项目）…"));
+        try {
+            skillResults = await installAgentSkills();
+            for (const r of skillResults) {
+                console.log(ui.dim(`    ${r.target.displayName} → ${r.action}`));
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            printWarn(`Agent Skill 安装失败：${msg}`);
+            printWarn("可稍后执行：ossput skill install");
+        }
+    }
+    printSuccessFooter(mergedClients, profileName, skillResults);
+}

package/dist/setup/skill-install.d.ts

@@ -0,0 +1,19 @@
+export declare const SKILL_NAME = "ossput";
+export type SkillTargetId = "cursor" | "claude";
+export interface SkillTarget {
+    id: SkillTargetId;
+    displayName: string;
+    resolvePath: () => string;
+}
+export declare const SKILL_TARGETS: SkillTarget[];
+/** npm 包内 `.cursor/skills/ossput` 的绝对路径 */
+export declare function resolveBundledSkillDir(): string;
+export interface SkillInstallResult {
+    target: SkillTarget;
+    dest: string;
+    action: string;
+}
+export declare function installSkillToTarget(target: SkillTarget, options?: {
+    preferSymlink?: boolean;
+}): Promise<SkillInstallResult>;
+export declare function installAgentSkills(targetIds?: SkillTargetId[]): Promise<SkillInstallResult[]>;

package/dist/setup/skill-install.js

@@ -0,0 +1,85 @@
+import { access, cp, lstat, mkdir, readlink, rm, symlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { constants } from "node:fs";
+import { fileURLToPath } from "node:url";
+export const SKILL_NAME = "ossput";
+export const SKILL_TARGETS = [
+    {
+        id: "cursor",
+        displayName: "Cursor（用户级）",
+        resolvePath: () => join(homedir(), ".cursor", "skills", SKILL_NAME),
+    },
+    {
+        id: "claude",
+        displayName: "Claude Code（用户级）",
+        resolvePath: () => join(homedir(), ".claude", "skills", SKILL_NAME),
+    },
+];
+/** npm 包内 `.cursor/skills/ossput` 的绝对路径 */
+export function resolveBundledSkillDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, "..", "..", ".cursor", "skills", SKILL_NAME);
+}
+async function pathExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function sameSymlinkTarget(linkPath, expectedSrc) {
+    try {
+        const st = await lstat(linkPath);
+        if (!st.isSymbolicLink())
+            return false;
+        const raw = await readlink(linkPath);
+        return resolve(dirname(linkPath), raw) === resolve(expectedSrc);
+    }
+    catch {
+        return false;
+    }
+}
+export async function installSkillToTarget(target, options) {
+    const src = resolve(resolveBundledSkillDir());
+    const dest = target.resolvePath();
+    try {
+        await access(src, constants.R_OK);
+    }
+    catch {
+        throw new Error(`找不到内置 Skill：${src}`);
+    }
+    if (await sameSymlinkTarget(dest, src)) {
+        return { target, dest, action: "已链接（无需更新）" };
+    }
+    if (await pathExists(dest)) {
+        await rm(dest, { recursive: true, force: true });
+    }
+    await mkdir(dirname(dest), { recursive: true });
+    const preferSymlink = options?.preferSymlink !== false;
+    if (preferSymlink) {
+        try {
+            const type = process.platform === "win32" ? "junction" : "dir";
+            await symlink(src, dest, type);
+            return { target, dest, action: "已创建符号链接" };
+        }
+        catch {
+            /* fall through to copy */
+        }
+    }
+    await cp(src, dest, { recursive: true });
+    return { target, dest, action: "已复制（符号链接不可用）" };
+}
+export async function installAgentSkills(targetIds) {
+    const ids = targetIds ?? SKILL_TARGETS.map((t) => t.id);
+    const results = [];
+    for (const id of ids) {
+        const target = SKILL_TARGETS.find((t) => t.id === id);
+        if (!target)
+            continue;
+        results.push(await installSkillToTarget(target));
+    }
+    return results;
+}

package/dist/setup/ui.d.ts

@@ -0,0 +1,49 @@
+export declare const ui: {
+    bold: (t: string) => string;
+    dim: (t: string) => string;
+    green: (t: string) => string;
+    yellow: (t: string) => string;
+    cyan: (t: string) => string;
+    red: (t: string) => string;
+};
+export declare function line(text?: string): void;
+/** 统一 inquirer 前缀，避免默认 `?` 与正文脱节 */
+export declare const inquirerTheme: {
+    style: {
+        answer: (text: string) => string;
+        highlight: (text: string) => string;
+        description: (text: string) => string;
+    };
+    prefix: string;
+};
+export declare function printWelcome(version: string): void;
+export declare function printStep(current: number, total: number, title: string): void;
+export declare function printBlock(title: string): void;
+export declare function maskSecret(value: string, visible?: number): string;
+export declare function printConfigSummary(config: {
+    region: string;
+    bucket: string;
+    prefix: string;
+    accessKeyId: string;
+    endpoint?: string | null;
+    presignExpiresSec: number;
+    allowedExtensions: string[];
+}, configPath: string, profile?: {
+    name: string;
+    label?: string;
+}): void;
+export declare function withSpinner<T>(label: string, fn: () => Promise<T>): Promise<T>;
+export declare function printSuccessFooter(clients: {
+    name: string;
+    path: string;
+    action: string;
+}[], activeProfile?: string, skills?: {
+    target: {
+        displayName: string;
+    };
+    dest: string;
+    action: string;
+}[]): void;
+export declare function printHint(message: string): void;
+export declare function printWarn(message: string): void;
+export declare function printError(message: string): void;

package/dist/setup/ui.js

@@ -0,0 +1,164 @@
+const supportsColor = process.stdout.isTTY && process.env.NO_COLOR !== "1" && process.env.TERM !== "dumb";
+function c(code, text) {
+    return supportsColor ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+export const ui = {
+    bold: (t) => c("1", t),
+    dim: (t) => c("2", t),
+    green: (t) => c("32", t),
+    yellow: (t) => c("33", t),
+    cyan: (t) => c("36", t),
+    red: (t) => c("31", t),
+};
+const MARGIN = "  ";
+export function line(text = "") {
+    console.log(MARGIN + text);
+}
+function rule(char = "─", width = 44) {
+    line(ui.dim(char.repeat(width)));
+}
+import { printAsciiLogo } from "./logo.js";
+/** 统一 inquirer 前缀，避免默认 `?` 与正文脱节 */
+export const inquirerTheme = {
+    style: {
+        answer: (text) => ui.green(text),
+        highlight: (text) => ui.cyan(text),
+        description: (text) => ui.dim(text),
+    },
+    prefix: supportsColor ? c("36", "›") : ">",
+};
+export function printWelcome(version) {
+    printAsciiLogo(version);
+    rule("═");
+    line(ui.bold("安装向导"));
+    line(ui.dim("阿里云 OSS 直传 · 一键配置 MCP"));
+    rule("═");
+    console.log("");
+    line(ui.dim("将依次完成："));
+    bullet("创建本机账号配置（profiles/，密钥不会写入 mcp.json）");
+    bullet("注册 Cursor / Claude Desktop 等 MCP 客户端");
+    bullet("检测与 Bucket 的连通性");
+    console.log("");
+    line(ui.dim("请在下方终端输入 AccessKey，勿粘贴到 AI 对话中。"));
+    console.log("");
+}
+function bullet(text) {
+    line(`${ui.dim("·")} ${text}`);
+}
+function numbered(n, text) {
+    line(`${ui.dim(String(n).padStart(2))}  ${text}`);
+}
+export function printStep(current, total, title) {
+    console.log("");
+    rule();
+    line(ui.dim(`[${current}/${total}]`) + "  " + ui.bold(title));
+    rule();
+    console.log("");
+}
+export function printBlock(title) {
+    console.log("");
+    line(ui.bold(title));
+}
+export function maskSecret(value, visible = 4) {
+    if (value.length <= visible)
+        return "****";
+    return `${value.slice(0, visible)}${"*".repeat(Math.min(12, value.length - visible))}`;
+}
+export function printConfigSummary(config, configPath, profile) {
+    printBlock("确认配置");
+    console.log("");
+    const rows = [
+        ...(profile
+            ? [
+                [
+                    "Profile",
+                    profile.label ? `${profile.name}（${profile.label}）` : profile.name,
+                ],
+            ]
+            : []),
+        ["Region", config.region],
+        ["Bucket", config.bucket],
+        ["Prefix", config.prefix ? config.prefix : "/ (根目录)"],
+        ["AccessKey ID", maskSecret(config.accessKeyId, 6)],
+        ["URL expires", `${config.presignExpiresSec}s`],
+        ["Endpoint", config.endpoint || ui.dim("(default public)")],
+        ["Extensions", config.allowedExtensions.join(", ")],
+        ["Config file", configPath],
+    ];
+    for (const [k, v] of rows) {
+        line(`${ui.dim(pad(k, 12))}  ${v}`);
+    }
+    console.log("");
+}
+function pad(s, n) {
+    const w = [...s].reduce((a, ch) => a + (ch.charCodeAt(0) > 127 ? 2 : 1), 0);
+    return s + " ".repeat(Math.max(0, n - w));
+}
+export async function withSpinner(label, fn) {
+    if (!process.stdout.isTTY) {
+        line(ui.dim(`${label}...`));
+        return fn();
+    }
+    const frames = ["-", "\\", "|", "/"];
+    let i = 0;
+    const timer = setInterval(() => {
+        process.stdout.write(`\r${MARGIN}${ui.cyan(frames[i++ % frames.length])} ${label}...`);
+    }, 120);
+    try {
+        return await fn();
+    }
+    finally {
+        clearInterval(timer);
+        process.stdout.write("\r\x1b[K");
+    }
+}
+export function printSuccessFooter(clients, activeProfile, skills = []) {
+    console.log("");
+    rule("═");
+    line(ui.green(ui.bold("安装完成")));
+    rule("═");
+    console.log("");
+    if (clients.length > 0) {
+        line(ui.bold("MCP 配置"));
+        for (const cl of clients) {
+            line(`  ${ui.dim("·")} ${cl.name}  ${ui.dim(`(${cl.action})`)}`);
+            line(ui.dim(`    ${cl.path}`));
+        }
+        console.log("");
+    }
+    if (skills.length > 0) {
+        line(ui.bold("Agent Skill（用户级）"));
+        for (const sk of skills) {
+            line(`  ${ui.dim("·")} ${sk.target.displayName}  ${ui.dim(`(${sk.action})`)}`);
+            line(ui.dim(`    ${sk.dest}`));
+        }
+        console.log("");
+    }
+    line(ui.bold("接下来"));
+    numbered(1, "完全退出并重新打开 Cursor / Claude Desktop / Claude Code");
+    numbered(2, "设置 → MCP → 确认 " + ui.bold("ossput") + " 已连接");
+    if (skills.length > 0) {
+        numbered(3, "新开 Agent 会话；Skill 已写入本机目录，无需复制到项目");
+    }
+    const n = skills.length > 0 ? 4 : 3;
+    if (activeProfile) {
+        numbered(n, `本仓库 profile: ${ui.bold(activeProfile)}（见 .ossput.json）`);
+        numbered(n + 1, "对 Agent 说：把 ./file.png 上传到 OSS，目录 demo/test");
+    }
+    else {
+        numbered(n, "对 Agent 说：把 ./file.png 上传到 OSS，目录 demo/test");
+    }
+    console.log("");
+    line(ui.dim("命令行：npx ossput put ./file.png --subdir demo/test"));
+    console.log("");
+}
+export function printHint(message) {
+    console.log("");
+    line(ui.dim(`提示：${message}`));
+}
+export function printWarn(message) {
+    line(ui.yellow(`注意：${message}`));
+}
+export function printError(message) {
+    line(ui.red(`错误：${message}`));
+}

package/dist/setup/write-config.d.ts

@@ -0,0 +1,5 @@
+import type { AppConfig } from "../types.js";
+export declare function writeProfileConfig(name: string, config: AppConfig, options?: {
+    label?: string;
+    setDefault?: boolean;
+}): Promise<string>;

package/dist/setup/write-config.js

@@ -0,0 +1,5 @@
+import { profileFilePath, saveProfile, } from "../config-profiles.js";
+export async function writeProfileConfig(name, config, options) {
+    await saveProfile(name, config, options);
+    return profileFilePath(name);
+}

package/dist/skill-cli.d.ts

@@ -0,0 +1,6 @@
+import { type SkillTargetId } from "./setup/skill-install.js";
+export interface SkillInstallOptions {
+    targets?: SkillTargetId[];
+}
+export declare function runSkillInstall(options?: SkillInstallOptions): Promise<void>;
+export declare function runSkillCommand(sub: string, _rest: string[], flags: Record<string, string | boolean>): Promise<number>;

package/dist/skill-cli.js

@@ -0,0 +1,34 @@
+import { installAgentSkills } from "./setup/skill-install.js";
+import { ui } from "./setup/ui.js";
+export async function runSkillInstall(options = {}) {
+    const results = await installAgentSkills(options.targets);
+    for (const r of results) {
+        console.log(ui.green(`✓ ${r.target.displayName}`) +
+            ui.dim(` — ${r.action}`) +
+            `\n  ${r.dest}`);
+    }
+    console.log("");
+    console.log(ui.dim("新开 Agent 会话后 Skill 生效；Claude Code 可用 /ossput 调用。"));
+}
+export async function runSkillCommand(sub, _rest, flags) {
+    switch (sub) {
+        case "install": {
+            let targets;
+            if (flags.cursor === true) {
+                targets = [...(targets ?? []), "cursor"];
+            }
+            if (flags.claude === true) {
+                targets = [...(targets ?? []), "claude"];
+            }
+            await runSkillInstall({ targets });
+            return 0;
+        }
+        default:
+            console.error(`Unknown skill command: ${sub || "(none)"}`);
+            console.log(`Usage:
+  ossput skill install          安装到 ~/.cursor/skills 与 ~/.claude/skills
+  ossput skill install --cursor   仅 Cursor
+  ossput skill install --claude   仅 Claude Code`);
+            return 1;
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+export interface AppConfig {
+    region: string;
+    bucket: string;
+    prefix: string;
+    accessKeyId: string;
+    accessKeySecret: string;
+    presignExpiresSec: number;
+    allowedExtensions: string[];
+    endpoint?: string | null;
+    /** 公网访问根 URL，如 https://cdn.example.com（无尾斜杠） */
+    publicBaseUrl?: string | null;
+    /** 是否允许 delete_object（默认 false，须在 profile 中显式开启） */
+    allowDelete?: boolean;
+}
+export interface OssputIndexConfig {
+    version: 1;
+    defaultProfile: string;
+    profiles: Record<string, {
+        label?: string;
+    }>;
+}
+export interface ProjectBinding {
+    profile: string;
+}
+export type ProfileBindingSource = "arg" | "env" | "project" | "default";
+export interface ResolvedProfile {
+    name: string;
+    source: ProfileBindingSource;
+    projectFile?: string;
+}
+export interface PrepareUploadResult {
+    bucket: string;
+    objectKey: string;
+    uploadUrl: string;
+    method: "PUT";
+    headers: Record<string, string>;
+    expiresAt: string;
+    maxSizeBytes: number;
+}
+export interface ConfirmUploadResult {
+    exists: boolean;
+    size: number;
+    etag?: string;
+    objectUrl: string;
+    lastModified?: string;
+}
+export interface UploadFileResult extends ConfirmUploadResult {
+    objectKey: string;
+}
+export interface OssObjectInfo {
+    objectKey: string;
+    size: number;
+    lastModified: string;
+    objectUrl: string;
+}
+export interface ListObjectsResult {
+    prefix: string;
+    count: number;
+    objects: OssObjectInfo[];
+    truncated: boolean;
+}
+export declare const MAX_FILE_BYTES: number;
+export interface DeleteObjectResult {
+    objectKey: string;
+    deleted: boolean;
+    objectUrl: string;
+}
+export interface BatchUploadResult {
+    subdir: string;
+    total: number;
+    succeeded: number;
+    failed: number;
+    results: Array<{
+        localPath: string;
+        ok: true;
+        result: UploadFileResult;
+    } | {
+        localPath: string;
+        ok: false;
+        error: string;
+    }>;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export const MAX_FILE_BYTES = 100 * 1024 * 1024;

package/dist/upload-pipeline.d.ts

@@ -0,0 +1,7 @@
+import type { AppConfig } from "./types.js";
+import type { ConfirmUploadResult, PrepareUploadResult, UploadFileResult } from "./types.js";
+export declare function prepareUpload(config: AppConfig, filename: string, contentType: string, subdir?: string, overwrite?: boolean): Promise<PrepareUploadResult>;
+/** Presigned PUT via Node fetch (no external curl). */
+export declare function putPresignedFile(uploadUrl: string, filePath: string, contentType: string): Promise<void>;
+export declare function confirmUpload(config: AppConfig, objectKey: string, expectedSizeBytes?: number): Promise<ConfirmUploadResult>;
+export declare function uploadFile(config: AppConfig, localPath: string, subdir?: string, contentType?: string): Promise<UploadFileResult>;