@insta-dev01/insta-plugin-openclaw 1.0.0 → 1.0.1

package/src/core/register-identity.ts

@@ -1,326 +0,0 @@
-import type { Profile } from "../utils/profile.js";
-import { readProfile, writeProfile } from "../utils/profile.js";
-import { getInstaUrl } from "./urls.js";
-
-// ──────────────────────────────────────────────────────────────────────────────
-// 场景标签（Scene Tags）合法值集合
-// 注册时 scene_tags 必须从以下二级分类 ID 中选取
-// ──────────────────────────────────────────────────────────────────────────────
-
-export const SCENE_TAGS: Record<string, { label: string; children: Record<string, string> }> = {
-  "01": {
-    label: "技术开发",
-    children: {
-      "01001": "前端",
-      "01002": "后端/架构",
-      "01003": "AI/算法",
-      "01004": "运维",
-      "01005": "产品设计",
-    },
-  },
-  "02": {
-    label: "内容创作",
-    children: {
-      "02001": "文本创作",
-      "02002": "翻译与本地化",
-      "02003": "剧本/创意",
-    },
-  },
-  "03": {
-    label: "视觉设计",
-    children: {
-      "03001": "平面/视觉",
-      "03002": "UI/交互",
-      "03003": "三维/多媒体",
-    },
-  },
-  "04": {
-    label: "企业办公",
-    children: {
-      "04001": "行政管理",
-      "04002": "商务汇报",
-      "04003": "人力资源",
-    },
-  },
-  "05": {
-    label: "数据市场",
-    children: {
-      "05001": "数据处理",
-      "05002": "分析调研",
-    },
-  },
-  "06": {
-    label: "电商营销",
-    children: {
-      "06001": "电商运营",
-      "06002": "私域增长",
-    },
-  },
-  "07": {
-    label: "法律咨询",
-    children: {
-      "07001": "学术/教育",
-      "07002": "法律/金融",
-      "07003": "心理/生活",
-    },
-  },
-  "08": {
-    label: "生活娱乐",
-    children: {
-      "08001": "生活决策",
-      "08002": "娱乐互动",
-    },
-  },
-};
-
-/** 所有合法的二级分类 ID 集合，用于校验 */
-export const VALID_SCENE_TAG_IDS: ReadonlySet<string> = new Set(
-  Object.values(SCENE_TAGS).flatMap((g) => Object.keys(g.children)),
-);
-
-// ──────────────────────────────────────────────────────────────────────────────
-// instance_type 合法值
-// ──────────────────────────────────────────────────────────────────────────────
-
-const VALID_INSTANCE_TYPES = new Set([0, 1]);
-
-// ──────────────────────────────────────────────────────────────────────────────
-// 类型定义
-// ──────────────────────────────────────────────────────────────────────────────
-
-/** 注册档案的请求参数 */
-export interface RegisterIdentityParams {
-  /** 档案名称（必填） */
-  name: string;
-  /** 头像 URL（必填） */
-  avatar: string;
-  /** 场景标签 ID 数组（必填，必须从合法值中选取） */
-  scene_tags: string[];
-  /** 自定义标签列表（可选） */
-  custom_tags?: string[];
-  /** 描述信息（必填） */
-  description: string;
-  /** 时薪（必填，必须 > 0） */
-  hourly_rate: number;
-  /** 实例类型：0=本地实例, 1=影子实例 */
-  instance_type: 0 | 1;
-}
-
-/** 注册成功后服务端返回的数据 */
-export interface RegisterIdentityResponse {
-  /** 档案主键 ID (BigInt string) */
-  id: string;
-  /** 唯一业务标识 (UUID) */
-  claw_id: string;
-  /** 访问 Key (ak_ 开头) */
-  app_key: string;
-  /** 访问密钥 Secret */
-  app_secret: string;
-}
-
-/** 注册函数的返回值 */
-export interface RegisterIdentityResult {
-  /** 服务端注册是否成功 */
-  success: boolean;
-  data?: RegisterIdentityResponse;
-  error?: string;
-  /** 本地 profile 文件是否写入成功 */
-  saved: boolean;
-  /** 服务端原始响应体（无论成功/失败均透传，便于调用方做后续处理） */
-  rawBody?: unknown;
-}
-
-// ──────────────────────────────────────────────────────────────────────────────
-// 参数校验
-// ──────────────────────────────────────────────────────────────────────────────
-
-/**
- * 校验 URL 格式是否合法
- */
-function isValidUrl(value: string): boolean {
-  try {
-    new URL(value);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 校验注册参数，返回错误信息数组。为空则校验通过。
- */
-function validateParams(params: RegisterIdentityParams): string[] {
-  const errors: string[] = [];
-
-  // name
-  if (!params.name?.trim()) {
-    errors.push("name 不能为空");
-  }
-
-  // avatar
-  if (!params.avatar?.trim()) {
-    errors.push("avatar 不能为空");
-  } else if (!isValidUrl(params.avatar)) {
-    errors.push("avatar 必须是合法的 URL");
-  }
-
-  // scene_tags
-  if (!Array.isArray(params.scene_tags) || params.scene_tags.length === 0) {
-    errors.push("scene_tags 必须为非空数组");
-  } else {
-    const invalid = params.scene_tags.filter((t) => !VALID_SCENE_TAG_IDS.has(t));
-    if (invalid.length > 0) {
-      errors.push(`scene_tags 包含非法标签 ID: ${invalid.join(", ")}，请参照 SCENE_TAGS 选取`);
-    }
-  }
-
-  // custom_tags（可选，但如果传了必须是字符串数组）
-  if (params.custom_tags !== undefined) {
-    if (!Array.isArray(params.custom_tags)) {
-      errors.push("custom_tags 必须为数组");
-    } else if (!params.custom_tags.every((t) => typeof t === "string")) {
-      errors.push("custom_tags 中的每一项必须为字符串");
-    }
-  }
-
-  // description
-  if (!params.description?.trim()) {
-    errors.push("description 不能为空");
-  }
-
-  // hourly_rate
-  if (typeof params.hourly_rate !== "number" || params.hourly_rate <= 0) {
-    errors.push("hourly_rate 必须为大于 0 的数字");
-  }
-
-  // instance_type
-  if (!VALID_INSTANCE_TYPES.has(params.instance_type)) {
-    errors.push("instance_type 只能是 0（本地实例）或 1（影子实例）");
-  }
-
-  return errors;
-}
-
-// ──────────────────────────────────────────────────────────────────────────────
-// 核心注册方法
-// ──────────────────────────────────────────────────────────────────────────────
-
-/**
- * 向 InstaClaw 服务端注册档案。
- *
- * 1. 校验入参
- * 2. 调用 POST /profiles/create
- * 3. 成功后将 profile 写入本地文件
- *
- * @param params  - 注册参数
- * @param baseDir - 本地配置文件存储根目录
- * @returns 注册结果
- */
-export async function registerIdentity(
-  params: RegisterIdentityParams,
-  baseDir: string,
-): Promise<RegisterIdentityResult> {
-  // ── 参数校验 ──
-  const errors = validateParams(params);
-  if (errors.length > 0) {
-    return { success: false, error: errors.join("; "), saved: false };
-  }
-
-  // ── 重复注册检查 ──
-  const existingProfile = await readProfile(baseDir);
-  if (existingProfile?.app_key && existingProfile?.app_secret) {
-    return {
-      success: false,
-      saved: false,
-      error: "当前环境已注册档案，不允许重复注册。如需重新注册请先前往 Insta 开发者后台吊销当前档案。",
-    };
-  }
-
-  // ── 构建请求（URL 从集中配置读取，支持环境变量覆盖） ──
-  const url = getInstaUrl("profileCreate");
-
-  let response: Response;
-  try {
-    response = await fetch(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        name: params.name.trim(),
-        avatar: params.avatar.trim(),
-        scene_tags: params.scene_tags,
-        custom_tags: params.custom_tags ?? [],
-        description: params.description.trim(),
-        hourly_rate: params.hourly_rate,
-        instance_type: params.instance_type,
-      }),
-    });
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { success: false, error: `网络请求失败: ${msg}`, saved: false };
-  }
-
-  // ── 解析响应 ──
-  let body: unknown;
-  try {
-    body = await response.json();
-  } catch {
-    return {
-      success: false,
-      error: `服务端返回非 JSON 响应 (HTTP ${response.status})`,
-      saved: false,
-    };
-  }
-
-  // HTTP 错误
-  if (!response.ok) {
-    const message =
-      typeof body === "object" && body !== null && "message" in body
-        ? String((body as { message: unknown }).message)
-        : `HTTP ${response.status}`;
-    return { success: false, error: `注册失败: ${message}`, saved: false, rawBody: body };
-  }
-
-  // 校验返回结构
-  if (
-    typeof body !== "object" ||
-    body === null ||
-    !("id" in body) ||
-    !("claw_id" in body) ||
-    !("app_key" in body) ||
-    !("app_secret" in body)
-  ) {
-    return { success: false, error: "服务端返回数据结构异常，缺少必要字段", saved: false, rawBody: body };
-  }
-
-  const data = body as RegisterIdentityResponse;
-
-  // ── 写入本地 profile ──
-  const profile: Profile = {
-    app_key: data.app_key,
-    app_secret: data.app_secret,
-    name: params.name.trim(),
-    description: params.description.trim(),
-    claw_id: data.claw_id,
-    hourly_rate: params.hourly_rate,
-    enable_commissioned: false,
-    enable_hired: false,
-    scene_tags: params.scene_tags,
-    custom_tags: params.custom_tags ?? [],
-    avatar: params.avatar.trim(),
-    instance_type: params.instance_type,
-  };
-
-  try {
-    await writeProfile(baseDir, profile);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return {
-      success: true,
-      data,
-      saved: false,
-      error: `注册成功但本地配置写入失败: ${msg}。请手动保存 app_key / app_secret。`,
-    };
-  }
-
-  return { success: true, data, saved: true };
-}

package/src/core/task-api.ts

@@ -1,168 +0,0 @@
-// ──────────────────────────────────────────────────────────────────────────────
-// 任务池 Bot API 认证请求辅助模块
-//
-// 所有任务相关工具通过此模块发起 HTTP 请求。
-// 认证方式：从 profile.json 读取 app_key / app_secret，
-// 分别作为 X-API-Key / X-API-Secret 请求头。
-// ──────────────────────────────────────────────────────────────────────────────
-
-import { readProfile } from "../utils/profile.js";
-import { getInstaUrl } from "./urls.js";
-
-// ──────────────────────────────────────────────────────────────────────────────
-// 类型定义
-// ──────────────────────────────────────────────────────────────────────────────
-
-/** 服务端通用响应结构 */
-export interface TaskApiResponse<T = unknown> {
-  code: number;
-  message: string;
-  data: T | null;
-}
-
-/** 构建认证请求头时所需的凭据 */
-interface AuthCredentials {
-  apiKey: string;
-  apiSecret: string;
-}
-
-// ──────────────────────────────────────────────────────────────────────────────
-// 内部辅助：认证头与 URL
-// ──────────────────────────────────────────────────────────────────────────────
-
-/** 从 profile 中读取 app_key / app_secret，返回认证凭据。*/
-async function loadCredentials(baseDir: string): Promise<AuthCredentials> {
-  const profile = await readProfile(baseDir);
-  if (!profile) {
-    throw new Error(
-      "未找到插件配置文件（.insta/config/profile.json），无法读取认证信息。" +
-        "请先通过引态平台完成初始化配置。",
-    );
-  }
-  if (!profile.app_key || !profile.app_secret) {
-    throw new Error(
-      "profile.json 中缺少 app_key 或 app_secret，无法完成认证。",
-    );
-  }
-  return { apiKey: profile.app_key, apiSecret: profile.app_secret };
-}
-
-/** 生成 JSON 请求头（含认证）。*/
-function buildJsonHeaders(creds: AuthCredentials): Record<string, string> {
-  return {
-    "Content-Type": "application/json",
-    "X-API-Key": creds.apiKey,
-    "X-API-Secret": creds.apiSecret,
-  };
-}
-
-/** 生成 multipart 请求头（含认证，不带 Content-Type 让 fetch 自动添加 boundary）。*/
-function buildMultipartHeaders(creds: AuthCredentials): Record<string, string> {
-  return {
-    "X-API-Key": creds.apiKey,
-    "X-API-Secret": creds.apiSecret,
-  };
-}
-
-/** 拼接完整 API URL：taskApiBase + path。*/
-function buildUrl(path: string): string {
-  const base = getInstaUrl("taskApiBase").replace(/\/$/, "");
-  return `${base}${path}`;
-}
-
-// ──────────────────────────────────────────────────────────────────────────────
-// 公开 API：GET / POST (JSON) / POST (multipart)
-// ──────────────────────────────────────────────────────────────────────────────
-
-/**
- * 发起带认证的 GET 请求。
- *
- * @param baseDir  插件工作目录（用于定位 profile.json）
- * @param path     API 路径，如 "/bots/tasks/available"
- * @param params   可选 query 参数
- */
-export async function taskApiGet<T = unknown>(
-  baseDir: string,
-  path: string,
-  params?: Record<string, string | number>,
-): Promise<TaskApiResponse<T>> {
-  const creds = await loadCredentials(baseDir);
-  const url = buildUrl(path);
-
-  const urlObj = new URL(url);
-  if (params) {
-    for (const [k, v] of Object.entries(params)) {
-      urlObj.searchParams.set(k, String(v));
-    }
-  }
-
-  const response = await fetch(urlObj.toString(), {
-    method: "GET",
-    headers: buildJsonHeaders(creds),
-  });
-
-  if (!response.ok) {
-    const errText = await response.text().catch(() => `HTTP ${response.status}`);
-    throw new Error(`请求失败：HTTP ${response.status} ${errText}`);
-  }
-
-  return (await response.json()) as TaskApiResponse<T>;
-}
-
-/**
- * 发起带认证的 POST 请求（JSON body）。
- *
- * @param baseDir   插件工作目录
- * @param path      API 路径
- * @param body      请求体对象（可选）
- */
-export async function taskApiPost<T = unknown>(
-  baseDir: string,
-  path: string,
-  body?: Record<string, unknown>,
-): Promise<TaskApiResponse<T>> {
-  const creds = await loadCredentials(baseDir);
-  const url = buildUrl(path);
-
-  const response = await fetch(url, {
-    method: "POST",
-    headers: buildJsonHeaders(creds),
-    body: body !== undefined ? JSON.stringify(body) : undefined,
-  });
-
-  if (!response.ok) {
-    const errText = await response.text().catch(() => `HTTP ${response.status}`);
-    throw new Error(`请求失败：HTTP ${response.status} ${errText}`);
-  }
-
-  return (await response.json()) as TaskApiResponse<T>;
-}
-
-/**
- * 发起带认证的 multipart/form-data POST 请求。
- *
- * @param baseDir   插件工作目录
- * @param path      API 路径
- * @param formData  FormData 对象
- */
-export async function taskApiPostMultipart<T = unknown>(
-  baseDir: string,
-  path: string,
-  formData: FormData,
-): Promise<TaskApiResponse<T>> {
-  const creds = await loadCredentials(baseDir);
-  const url = buildUrl(path);
-
-  const response = await fetch(url, {
-    method: "POST",
-    headers: buildMultipartHeaders(creds),
-    body: formData,
-  });
-
-  if (!response.ok) {
-    const errText = await response.text().catch(() => `HTTP ${response.status}`);
-    throw new Error(`请求失败：HTTP ${response.status} ${errText}`);
-  }
-
-  return (await response.json()) as TaskApiResponse<T>;
-}

package/src/core/urls.ts

@@ -1,52 +0,0 @@
-// ──────────────────────────────────────────────────────────────────────────────
-// InstaClaw 服务端 URL 集中管理
-//
-// 每个 URL 优先读取对应环境变量，未配置时使用默认值。
-// 新增接口时只需在 URL_REGISTRY 中追加一条记录即可。
-// ──────────────────────────────────────────────────────────────────────────────
-
-type UrlEntry = {
-  /** 环境变量名 */
-  envKey: string;
-  /** 环境变量未配置时的默认值 */
-  defaultValue: string;
-  /** 用途说明（便于维护） */
-  description: string;
-};
-
-const URL_REGISTRY = {
-  /** WebSocket 聊天通道 */
-  wsChat: {
-    envKey: "INSTACLAW_WS_URL",
-    defaultValue: "wss://claw.int-os.com/ws/chat",
-    description: "WebSocket 聊天通道",
-  },
-  /** 注册档案 */
-  profileCreate: {
-    envKey: "INSTACLAW_PROFILE_CREATE_URL",
-    defaultValue: "https://claw.int-os.com/profiles/create",
-    description: "注册档案接口",
-  },
-  /** 制品上传并绑定 */
-  artifactUploadAndBind: {
-    envKey: "INSTACLAW_ARTIFACT_UPLOAD_AND_BIND_URL",
-    defaultValue: "http://claw.int-os.com/artifact/upload-and-bind",
-    description: "制品上传并绑定接口",
-  },
-  /** 任务池 Bot API 基础地址 */
-  taskApiBase: {
-    envKey: "INSTACLAW_TASK_API_BASE_URL",
-    defaultValue: "https://claw.int-os.com",
-    description: "任务池 Bot API 基础地址（/bots/tasks/...）",
-  },
-} as const satisfies Record<string, UrlEntry>;
-
-export type UrlKey = keyof typeof URL_REGISTRY;
-
-/**
- * 获取指定接口的 URL：优先读环境变量，否则返回默认值。
- */
-export function getInstaUrl(key: UrlKey): string {
-  const entry = URL_REGISTRY[key];
-  return process.env[entry.envKey]?.trim() || entry.defaultValue;
-}

package/src/prompt/job.md

@@ -1,21 +0,0 @@
-帮我创建一个 OpenClaw Cron Job 定时任务，默认每 60 秒执行一次。
-
-下面内容为该 Cron Job 的具体执行逻辑：
-
-使用 insta（引态）相关工具或技能，自动承接并完成悬赏任务。
-
-执行流程：
-1. 查询可承接任务（使用对应工具或技能）
-2. 执行接单（使用对应工具或技能）
-3. 严格按照任务要求真实执行任务
-4. 必须确保任务需求已经成功完成后，才允许进入下一步
-5. 生成任务产物
-6. 提交任务产物并完成任务（使用对应工具或技能）
-
-执行要求：
-- 禁止伪造执行结果
-- 禁止未完成任务就提前提交
-- 必须真实执行任务内容
-- 必须按照任务要求提交正确产物
-- 任务未成功完成时，不允许结束流程
-- 所有流程需自动循环执行