@ohos-cpf/3rdloop 0.0.4 → 0.0.6

package/vendor/Server/Skills/gitcode-repo-fork/scripts/gitcode-fork.cjs

@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+/**
+ * @tool gitcode-fork
+ * @description gitcode-repo-fork SKILL 的 GitCode Fork 辅助脚本：Token 用户查询、仓库信息（含权限与 parent 源仓库）、Fork 存在性探测、创建 Fork（内置幂等回查与就绪轮询）、分支存在性探测。所有请求统一使用 Authorization: Bearer 头认证（POST 写操作必须，GET 一致处理），避免 form body 内 token 被拒（401）。
+ * @param token: string - GitCode API Token（也可用环境变量 GIT_TOKEN 或 Server/.env 的 GIT_TOKEN）
+ * @param owner: string - 仓库所属空间（owner/组织）
+ * @param repo: string - 仓库名
+ * 子命令:
+ *   get-user                                    获取 Token 用户信息（fork 目标 namespace）
+ *   get-repo --owner x --repo y [--allow-missing]
+ *                                              获取仓库信息（id/default_branch/parent/permissions）；
+ *                                              --allow-missing 时 404 返回 {exists:false} 而非报错
+ *   get-branch --owner x --repo y --branch b    探测分支是否存在（200 存在 / 404 不存在）
+ *   create-fork --owner x --repo y [--name n] [--fork-owner me] [--timeout s]
+ *                                              创建 Fork 到 Token 用户名下（POST /repos/{owner}/{repo}/forks，
+ *                                              仅 fork 源仓库本身）；失败时自动回查已有 Fork（reused:true）；
+ *                                              创建后自动轮询就绪（Fork 为异步操作）。
+ *                                              --fork-owner：Token 无 read_user scope（GET /user 403）时
+ *                                              必传，用于指定 Fork 目标用户名（跳过 /user 查询）
+ *   wait-fork --owner x --repo y [--timeout s] [--interval s]
+ *                                              轮询 Fork 仓库可访问（刚创建的 Fork 可能短暂 404）
+ * 用法示例:
+ *   node gitcode-fork.cjs get-user --token "$GIT_TOKEN"
+ *   node gitcode-fork.cjs create-fork --token "$GIT_TOKEN" --owner CPF-RN --repo rntpc_lib --timeout 60
+ */
+
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const { URLSearchParams } = require('url');
+
+const BASE = 'https://gitcode.com/api/v5';
+
+// ---------- 参数解析 ----------
+function parseArgs(argv) {
+  const args = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') { args.help = true; continue; }
+    if (a.startsWith('--')) {
+      const key = a.slice(2).replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+      args[key] = argv[i + 1] && !argv[i + 1].startsWith('--') ? argv[++i] : true;
+    } else {
+      args._.push(a);
+    }
+  }
+  return args;
+}
+
+function die(msg, code = 1) {
+  console.error(JSON.stringify({ ok: false, error: msg }, null, 2));
+  process.exit(code);
+}
+
+function requireParam(args, names) {
+  for (const n of names) {
+    if (!args[n] || args[n] === true) die(`缺少必填参数 --${n.replace(/([A-Z])/g, '-$1').toLowerCase()}`);
+  }
+}
+
+// ---------- HTTP ----------
+/**
+ * 统一 Bearer 头认证（POST 写操作必须：token 放 form body 会被拒 401 token not found，
+ * 见 references/GITCODE_FORK_API.md 踩坑记录）。
+ * @param opts.allow404 boolean - 404 时返回 null（不 die），用于探测类调用
+ */
+async function api(method, endpoint, params, token, opts = {}) {
+  const url = new URL(BASE + endpoint);
+  const headers = { Authorization: `Bearer ${token}` };
+  let body = null;
+  if (method === 'GET') {
+    const search = new URLSearchParams();
+    for (const [k, v] of Object.entries(params || {})) search.set(k, String(v));
+    url.search = search.toString();
+  } else {
+    headers['Content-Type'] = 'application/x-www-form-urlencoded';
+    const form = new URLSearchParams();
+    for (const [k, v] of Object.entries(params || {})) form.set(k, String(v));
+    body = form.toString();
+  }
+  const res = await fetch(url, { method, headers, body });
+  const text = await res.text();
+  let json;
+  try { json = JSON.parse(text); } catch { json = { raw: text }; }
+  if (!res.ok) {
+    if (opts.allow404 && res.status === 404) return null;
+    const err = new Error(`GitCode API ${method} ${endpoint} -> HTTP ${res.status}: ${text.slice(0, 500)}`);
+    err.status = res.status;
+    throw err;
+  }
+  return json;
+}
+
+// ---------- Token 加载 ----------
+function resolveToken(args) {
+  if (args.token && args.token !== true) return args.token;
+  if (process.env.GIT_TOKEN) return process.env.GIT_TOKEN;
+  // 从 SKILL 目录向上回溯读取 Server/.env 的 GIT_TOKEN
+  // 本脚本位于 Server/Skills/gitcode-repo-fork/scripts/ → .env 在 ../../../.env
+  let dir = __dirname;
+  for (let i = 0; i < 4; i++) {
+    const envPath = path.join(dir, '.env');
+    if (fs.existsSync(envPath)) {
+      const m = fs.readFileSync(envPath, 'utf8').match(/^GIT_TOKEN=(.+)$/m);
+      if (m) return m[1].trim().replace(/^["']|["']$/g, '');
+    }
+    dir = path.dirname(dir);
+  }
+  return null;
+}
+
+// ---------- 结果提取 ----------
+function pickRepo(r, owner, repo) {
+  const parent = (r.parent && (r.parent.path_with_namespace || r.parent.full_path)) || null;
+  const perms = r.permissions && typeof r.permissions === 'object'
+    ? {
+        pull: !!r.permissions.pull,
+        push: !!r.permissions.push,
+        admin: !!r.permissions.admin,
+      }
+    : null;
+  return {
+    exists: true,
+    id: r.id,
+    owner: (r.namespace && (r.namespace.path || r.namespace.name)) || (r.owner && (r.owner.login || r.owner.name)) || owner,
+    repo: r.path || repo,
+    pathWithNamespace: r.full_path || r.path_with_namespace || `${owner}/${repo}`,
+    defaultBranch: r.default_branch || 'master',
+    fork: !!(r.fork || parent),
+    parent, // fork 仓库的直接源仓库（上游推断依据，ohos-lib-pr-push Phase 1.1 d 复用）
+    permissions: perms,
+    url: `https://gitcode.com/${(r.full_path || r.path_with_namespace || `${owner}/${repo}`).replace(/^\//, '')}`,
+  };
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// ---------- 子命令 ----------
+async function cmdGetUser(token) {
+  const u = await api('GET', '/user', {}, token);
+  console.log(JSON.stringify({
+    ok: true,
+    username: u.login || u.username, // 登录名 = fork 目标 namespace
+    name: u.name,
+    email: u.email,
+    id: u.id,
+  }, null, 2));
+}
+
+async function cmdGetRepo(args, token) {
+  requireParam(args, ['owner', 'repo']);
+  const allowMissing = args.allowMissing === true;
+  const r = await api('GET', `/repos/${args.owner}/${args.repo}`, {}, token, { allow404: allowMissing });
+  if (!r) {
+    console.log(JSON.stringify({ ok: true, exists: false, owner: args.owner, repo: args.repo }, null, 2));
+    return;
+  }
+  console.log(JSON.stringify({ ok: true, ...pickRepo(r, args.owner, args.repo) }, null, 2));
+}
+
+async function cmdGetBranch(args, token) {
+  requireParam(args, ['owner', 'repo', 'branch']);
+  const b = await api('GET', `/repos/${args.owner}/${args.repo}/branches/${encodeURIComponent(args.branch)}`, {}, token, { allow404: true });
+  console.log(JSON.stringify({ ok: true, exists: !!b, branch: (b && b.name) || args.branch }, null, 2));
+}
+
+async function waitForFork(token, owner, repo, timeoutSec, intervalSec) {
+  const start = Date.now();
+  const timeoutMs = timeoutSec * 1000;
+  const intervalMs = intervalSec * 1000;
+  // Fork 为异步操作：POST 成功后仓库可能短暂 404，轮询直到可访问
+  for (;;) {
+    const r = await api('GET', `/repos/${owner}/${repo}`, {}, token, { allow404: true });
+    if (r) {
+      return { waitedMs: Date.now() - start, repo: pickRepo(r, owner, repo) };
+    }
+    if (Date.now() - start >= timeoutMs) {
+      throw new Error(`等待 Fork 就绪超时（${timeoutSec}s）：${owner}/${repo} 仍不可访问。Fork 可能仍在后台创建，请稍后用 wait-fork 重试`);
+    }
+    await sleep(intervalMs);
+  }
+}
+
+async function cmdCreateFork(args, token) {
+  requireParam(args, ['owner', 'repo']);
+  const timeoutSec = parseInt(args.timeout, 10) || 60;
+  const forkName = (typeof args.name === 'string' && args.name) || args.repo;
+
+  // Fork 目标 namespace = Token 用户名下。
+  // 实测：Token 可能无 read_user scope（GET /user -> 403 no scopes:read_user），
+  // 此时必须由 --fork-owner 显式指定，否则给出可操作的错误提示。
+  let forkOwner;
+  if (typeof args.forkOwner === 'string' && args.forkOwner) {
+    forkOwner = args.forkOwner;
+  } else {
+    let user;
+    try {
+      user = await api('GET', '/user', {}, token);
+    } catch (e) {
+      if (e.status === 403) {
+        die(`获取 Token 用户失败（${e.message.slice(0, 200)}）。请传 --fork-owner 指定 Fork 目标用户名，或为 Token 增加 read_user scope 后重试`);
+      }
+      throw e;
+    }
+    forkOwner = user.login || user.username;
+  }
+
+  // 先探测幂等：已有 Fork 直接复用（避免依赖平台的"已存在"错误语义）
+  const existing = await api('GET', `/repos/${forkOwner}/${forkName}`, {}, token, { allow404: true });
+  if (existing) {
+    console.log(JSON.stringify({
+      ok: true, reused: true, note: 'Fork 已存在，直接复用（请校验 parent 是否指向目标源仓库）',
+      ...pickRepo(existing, forkOwner, forkName),
+    }, null, 2));
+    return;
+  }
+
+  // 创建 Fork（POST 必须 Bearer 头认证，token 不进 form body）
+  const params = {};
+  if (typeof args.name === 'string' && args.name) params.name = args.name;
+  let created;
+  try {
+    created = await api('POST', `/repos/${args.owner}/${args.repo}/forks`, params, token);
+  } catch (e) {
+    // 幂等回查：创建失败但仓库已出现（并发/平台异步语义）→ 复用；否则透出原始错误
+    const retry = await api('GET', `/repos/${forkOwner}/${forkName}`, {}, token, { allow404: true });
+    if (retry) {
+      console.log(JSON.stringify({
+        ok: true, reused: true, note: `create-fork 报错但 Fork 已存在，自动复用（原始错误：${e.message.slice(0, 200)}）`,
+        ...pickRepo(retry, forkOwner, forkName),
+      }, null, 2));
+      return;
+    }
+    die(e.message);
+  }
+
+  // 响应可能是 fork 仓库对象，也可能只是消息对象；统一以轮询结果为准
+  const wait = await waitForFork(token, forkOwner, forkName, timeoutSec, 3);
+  console.log(JSON.stringify({
+    ok: true,
+    reused: false,
+    forkOwner,
+    forkRepo: forkName,
+    forkUrl: `https://gitcode.com/${forkOwner}/${forkName}`,
+    ready: true,
+    waitedMs: wait.waitedMs,
+    ...wait.repo,
+  }, null, 2));
+}
+
+async function cmdWaitFork(args, token) {
+  requireParam(args, ['owner', 'repo']);
+  const timeoutSec = parseInt(args.timeout, 10) || 60;
+  const intervalSec = parseInt(args.interval, 10) || 3;
+  const wait = await waitForFork(token, args.owner, args.repo, timeoutSec, intervalSec);
+  console.log(JSON.stringify({
+    ok: true, ready: true, waitedMs: wait.waitedMs, ...wait.repo,
+  }, null, 2));
+}
+
+// ---------- 主流程 ----------
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const cmd = args._[0];
+  if (args.help || !cmd) {
+    console.log(fs.readFileSync(__filename, 'utf8').split('*/')[0]);
+    return;
+  }
+  const token = resolveToken(args);
+  if (!token) die('未找到 Token：请传 --token，或设置环境变量 GIT_TOKEN，或确保 Server/.env 中存在 GIT_TOKEN');
+
+  switch (cmd) {
+    case 'get-user': await cmdGetUser(token); break;
+    case 'get-repo': await cmdGetRepo(args, token); break;
+    case 'get-branch': await cmdGetBranch(args, token); break;
+    case 'create-fork': await cmdCreateFork(args, token); break;
+    case 'wait-fork': await cmdWaitFork(args, token); break;
+    default:
+      die(`未知子命令: ${cmd}（可用: get-user | get-repo | get-branch | create-fork | wait-fork）`);
+  }
+}
+
+main().catch((e) => die(e.message));

package/vendor/VERSION

@@ -1,3 +1,3 @@
-0.0.4
-built=2026-09-02T13:20:05.667Z
-sha=728055383fc2b950
+0.0.6
+built=2026-09-03T04:17:37.208Z
+sha=3dae4a21a88fb4e7

package/web/css/arktslibrarycheck.css

@@ -0,0 +1,322 @@
+/* ════════════════════════════════════════════════════════════════════
+ * arktslibrarycheck.css — ArkTS 仓库检视面板专用样式
+ *
+ * 依赖：theme.css（CSS 变量）、codecheck.css（cc-* 通用卡片/徽章/按钮样式）
+ * ════════════════════════════════════════════════════════════════════ */
+
+/* ─── 入参说明 ─────────────────────────────────────────────────────── */
+.akt-param-intro {
+    background: var(--card);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 12px 14px;
+}
+
+.akt-param-title {
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--text2);
+    margin-bottom: 10px;
+}
+
+.akt-param-grid {
+    display: grid;
+    grid-template-columns: repeat(2, 1fr);
+    gap: 8px;
+}
+
+@media (max-width: 900px) {
+    .akt-param-grid { grid-template-columns: 1fr; }
+}
+
+.akt-param-item {
+    display: flex;
+    flex-direction: column;
+    gap: 3px;
+    padding: 8px 10px;
+    background: var(--bg);
+    border: 1px solid var(--border-light);
+    border-radius: 6px;
+}
+
+.akt-param-name {
+    font-size: 11px;
+    font-weight: 600;
+    color: var(--blue);
+}
+
+.akt-param-code {
+    font-family: var(--mono);
+    font-size: 11px;
+    color: var(--text2);
+    background: var(--code-bg);
+    padding: 2px 6px;
+    border-radius: 4px;
+    word-break: break-all;
+    line-height: 1.5;
+}
+
+.akt-param-note {
+    font-size: 10px;
+    color: var(--text3);
+}
+
+.akt-param-tip {
+    margin-top: 10px;
+    font-size: 11px;
+    color: var(--text3);
+    padding-top: 8px;
+    border-top: 1px dashed var(--border-light);
+}
+
+/* ─── 评分概览面板 ─────────────────────────────────────────────────── */
+.akt-score-panel {
+    background: var(--bg);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 14px 16px;
+}
+
+.akt-score-panel-title {
+    font-size: 13px;
+    font-weight: 600;
+    color: var(--text);
+    margin-bottom: 10px;
+}
+
+.akt-score-overall-row {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 8px 12px;
+    background: var(--card);
+    border-radius: 6px;
+    margin-bottom: 10px;
+}
+
+.akt-score-label {
+    font-size: 12px;
+    font-weight: 700;
+    color: var(--text);
+    width: 64px;
+    flex-shrink: 0;
+}
+
+.akt-score-value {
+    font-size: 18px;
+    font-weight: 700;
+    font-family: var(--mono);
+    padding: 3px 12px;
+    border-radius: 6px;
+}
+
+.akt-score-weights {
+    font-size: 10px;
+    color: var(--text3);
+    margin-left: auto;
+    text-align: right;
+}
+
+.akt-score-grid {
+    display: grid;
+    grid-template-columns: repeat(4, 1fr);
+    gap: 8px;
+}
+
+@media (max-width: 900px) {
+    .akt-score-grid { grid-template-columns: repeat(2, 1fr); }
+}
+
+.akt-score-item {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    padding: 7px 10px;
+    background: var(--card);
+    border: 1px solid var(--border-light);
+    border-radius: 6px;
+}
+
+.akt-score-item-label {
+    font-size: 11px;
+    color: var(--text2);
+    flex-shrink: 0;
+}
+
+.akt-score-item-value {
+    font-size: 13px;
+    font-weight: 700;
+    font-family: var(--mono);
+    padding: 2px 8px;
+    border-radius: 4px;
+    color: var(--text3);
+}
+
+/* ─── 步骤进度面板 ─────────────────────────────────────────────────── */
+.akt-steps-panel {
+    background: var(--bg);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 14px 16px;
+}
+
+.akt-steps-title-row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 10px;
+    margin-bottom: 10px;
+    flex-wrap: wrap;
+}
+
+.akt-steps-title {
+    font-size: 13px;
+    font-weight: 600;
+    color: var(--text);
+    margin-bottom: 0;
+}
+
+/* ─── 打包下载全部报告按钮 ─────────────────────────────────────────── */
+.akt-archive-btn {
+    display: inline-flex;
+    align-items: center;
+    gap: 5px;
+    padding: 6px 14px;
+    border-radius: 6px;
+    font-size: 12px;
+    font-weight: 600;
+    background: rgba(52,199,89,0.12);
+    color: var(--green);
+    border: 1px solid rgba(52,199,89,0.3);
+    cursor: pointer;
+    white-space: nowrap;
+    flex-shrink: 0;
+    transition: all 0.15s;
+}
+.akt-archive-btn:hover:not(:disabled) {
+    background: rgba(52,199,89,0.2);
+    border-color: rgba(52,199,89,0.5);
+}
+.akt-archive-btn:disabled { opacity: 0.5; cursor: not-allowed; }
+
+.akt-steps-list {
+    display: flex;
+    flex-direction: column;
+}
+
+.akt-step-row {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    padding: 9px 0;
+    border-bottom: 1px dashed var(--border-light);
+}
+
+.akt-step-row:last-child { border-bottom: none; }
+
+.akt-step-icon {
+    width: 32px;
+    height: 32px;
+    font-size: 13px;
+    font-weight: 700;
+    border: 2px solid var(--border);
+    border-radius: 50%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background: var(--card);
+    color: var(--text2);
+    flex-shrink: 0;
+    transition: border-color 0.2s, background 0.2s, color 0.2s;
+}
+
+.akt-step-icon.running {
+    border-color: var(--blue);
+    background: rgba(0,113,227,0.08);
+}
+.akt-step-icon.completed {
+    border-color: var(--green);
+    background: rgba(52,199,89,0.1);
+    color: var(--green);
+}
+.akt-step-icon.failed {
+    border-color: var(--red);
+    background: rgba(255,59,48,0.1);
+    color: var(--red);
+}
+.akt-step-icon.skipped {
+    border-color: var(--gray);
+    background: rgba(142,142,147,0.08);
+    color: var(--gray);
+}
+
+.akt-step-info { flex: 1; min-width: 0; }
+
+.akt-step-name {
+    font-size: 13px;
+    font-weight: 600;
+    color: var(--text);
+    margin-bottom: 1px;
+}
+
+.akt-step-weight {
+    font-size: 10px;
+    font-weight: 400;
+    color: var(--text3);
+    font-family: var(--mono);
+}
+
+.akt-step-desc {
+    font-size: 11px;
+    color: var(--text3);
+    font-family: var(--mono);
+}
+
+.akt-step-actions {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    flex-shrink: 0;
+}
+
+.akt-step-score {
+    font-size: 12px;
+    font-weight: 700;
+    font-family: var(--mono);
+    padding: 3px 9px;
+    border-radius: 5px;
+}
+
+/* ─── 步骤对话按钮 ─────────────────────────────────────────────────── */
+.akt-session-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 30px;
+    height: 26px;
+    padding: 0;
+    border-radius: 6px;
+    font-size: 12px;
+    background: rgba(175,82,222,0.1);
+    color: var(--purple);
+    border: 1px solid rgba(175,82,222,0.3);
+    cursor: pointer;
+    white-space: nowrap;
+    transition: all 0.15s;
+}
+
+.akt-session-btn:hover:not(:disabled) {
+    background: rgba(175,82,222,0.2);
+    border-color: rgba(175,82,222,0.5);
+}
+
+.akt-session-btn:disabled { opacity: 0.4; cursor: not-allowed; }
+
+/* ─── 面板布局 ─────────────────────────────────────────────────────── */
+#p-arktslibrarycheck .panel-pad {
+    padding: 20px 24px;
+    overflow-y: auto;
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+}