@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/TestCheck/index.js

@@ -0,0 +1,11 @@
+/**
+ * TestCheck 模块统一导出
+ *
+ * 外部使用：
+ *   import { TestCheck, CheckStatus } from './TestCheck/index.js';
+ *   const checker = new TestCheck({ sseHub, storage });
+ *   const result = await checker.runCheck({ taskId, taskDir, acceptanceCriteria });
+ */
+
+export { TestCheck, CheckStatus } from './TestCheck.js';
+export { default } from './TestCheck.js';

package/vendor/Server/library/McpToolGuide.js

@@ -0,0 +1,280 @@
+/**
+ * McpToolGuide —— MCP 工具引导 prompt 段落生成器
+ *
+ * 职责：
+ *   从 MCP/config.json 读取下游 Server 名称 + 扫描 MCP/scripts/ 解析 @tool 注释，
+ *   生成引导性 prompt 段落，提醒 AI 主动使用 MCP 工具。
+ *
+ * 设计原则：
+ *   - 折中方式：prompt 只写引导性文字，不列具体工具名和参数。
+ *     工具发现交给 opencode MCP 协议（opencode 启动时已通过 tools/list 拿到全部工具信息）。
+ *   - 数据驱动：从 config.json + scripts/ 动态生成，新增/删除工具无需改代码。
+ *   - 不缓存：每次调用都重新读取，确保新增工具即时被发现。
+ *   - 静默失败：配置文件不存在或读取异常时返回空字符串，不影响主流程。
+ *
+ * 脚本头部注释约定（与 MCP/src/registry/ScriptRegistry.js 一致）：
+ *   # @tool <名称>              — 必填，工具名（中文可用）
+ *   # @description <描述>        — 工具描述
+ *   # @hidden                   — 可选，标记此脚本不展示在引导 prompt 中
+ *
+ * config.json 控制项（可选，位于 scripts 节点下）：
+ *   "guideExclude": ["tool_name", ...]  — 黑名单：列出的工具不展示
+ *   "guideInclude": ["tool_name", ...]  — 白名单：仅展示列出的工具（优先于 guideExclude）
+ *
+ * 对于下游 Server，可在 server 配置中加 "guideHidden": true 隐藏该 Server。
+ *
+ * 优先级：脚本 @hidden > guideInclude 白名单 > guideExclude 黑名单
+ *
+ * @example
+ * import { McpToolGuide } from '../library/McpToolGuide.js';
+ *
+ * const guide = new McpToolGuide('D:/code/3rdLibraryLoop/MCP/config.json');
+ * const segment = guide.buildToolGuide();
+ * // → "## 可用的 MCP 工具\n你已通过 MCP Gateway 获得以下工具..."
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** 只解析脚本前 N 行的注释（与 ScriptRegistry 保持一致） */
+const MAX_SCAN_LINES = 20;
+
+/** 允许的脚本扩展名 */
+const ALLOWED_EXTENSIONS = ['.sh', '.py', '.js'];
+
+class McpToolGuide {
+    /** @type {string} MCP config.json 绝对路径 */
+    #configPath = '';
+
+    /**
+     * @param {string} [configPath] - MCP config.json 路径，默认相对当前文件推导
+     */
+    constructor(configPath) {
+        if (configPath) {
+            this.#configPath = path.resolve(configPath);
+        } else {
+            // 默认：Server/library/ → 上两级 → MCP/config.json
+            const here = path.dirname(fileURLToPath(import.meta.url));
+            this.#configPath = path.resolve(here, '..', '..', 'MCP', 'config.json');
+        }
+    }
+
+    /**
+     * 生成 MCP 工具引导 prompt 段落。
+     *
+     * 从 config.json 读取下游 Server 名称 + 扫描 scripts/ 解析 @tool 注释，
+     * 拼接为引导性段落（不列工具参数 schema）。
+     *
+     * @returns {string} prompt 段落文本，无工具时返回空字符串
+     */
+    buildToolGuide() {
+        const tools = this._collectTools();
+        if (tools.length === 0) return '';
+
+        const lines = [
+            '## 可用的 MCP 工具',
+            '你已通过 MCP Gateway 获得以下工具，请根据任务需要主动调用：',
+            ''
+        ];
+
+        for (const t of tools) {
+            lines.push(`- **${t.label}** — ${t.hint}`);
+        }
+
+        lines.push('');
+        lines.push('遇到不确定的技术问题时，建议先用知识库搜索是否有相关经验可参考。');
+
+        return lines.join('\n');
+    }
+
+    /**
+     * 收集所有可用工具信息（下游 Server + 脚本），并应用可见性过滤。
+     *
+     * 过滤优先级：
+     *   1. 脚本 @hidden 注释 → 永久隐藏
+     *   2. config scripts.guideInclude 白名单 → 仅展示列出的（Server + 脚本统一）
+     *   3. config scripts.guideExclude 黑名单 → 排除列出的
+     *   4. Server 配置 guideHidden: true → 隐藏该 Server
+     *
+     * @returns {Array<{label: string, hint: string}>}
+     * @private
+     */
+    _collectTools() {
+        const config = this._readConfig();
+        if (!config) return [];
+
+        const scriptsConfig = config.scripts || {};
+        const guideInclude = scriptsConfig.guideInclude; // string[] | undefined
+        const guideExclude = scriptsConfig.guideExclude || []; // string[]
+        const excludeSet = new Set(guideExclude);
+
+        const tools = [];
+
+        // ── 1. 下游 MCP Server ──
+        const servers = config.downstreamServers || {};
+        for (const [name, conf] of Object.entries(servers)) {
+            if (!conf || conf.enabled === false) continue;
+            // Server 级隐藏
+            if (conf.guideHidden === true) continue;
+            // 白名单模式：不在白名单中的隐藏
+            if (guideInclude && !guideInclude.includes(name)) continue;
+            // 黑名单
+            if (excludeSet.has(name)) continue;
+
+            tools.push({
+                label: name,
+                hint: this._serverHint(name, conf)
+            });
+        }
+
+        // ── 2. 本地脚本工具 ──
+        const scripts = this._scanScripts(config);
+        for (const s of scripts) {
+            // 脚本 @hidden 注释
+            if (s.hidden) continue;
+            // 白名单模式
+            if (guideInclude && !guideInclude.includes(s.toolName)) continue;
+            // 黑名单
+            if (excludeSet.has(s.toolName)) continue;
+
+            tools.push({
+                label: s.toolName,
+                hint: s.description
+            });
+        }
+
+        return tools;
+    }
+
+    /**
+     * 读取并解析 config.json。
+     * @returns {object|null} 配置对象，读取失败返回 null
+     * @private
+     */
+    _readConfig() {
+        try {
+            const raw = fs.readFileSync(this.#configPath, 'utf-8');
+            return JSON.parse(raw);
+        } catch (err) {
+            return null;
+        }
+    }
+
+    /**
+     * 根据下游 Server 名称生成用途提示。
+     * @param {string} name - Server 名称
+     * @param {object} conf - Server 配置
+     * @returns {string}
+     * @private
+     */
+    _serverHint(name, conf) {
+        // 已知的下游 Server 给出更友好的描述
+        // FIXME: 后续需要根据实际情况修改
+        const known = {
+            'kb-server': '知识库搜索（全文检索，返回带相关性分数的条目）。测试阶段只允许查询，禁止调用 create_entry、update_entry、delete_entry',
+            'gitcode': 'GitCode 平台仓库操作'
+        };
+        if (known[name]) return known[name];
+        // 未知 Server：用 url 或 type 推导
+        if (conf.url) return `${conf.type || 'remote'} Server (${conf.url})`;
+        return `${conf.type || 'remote'} Server`;
+    }
+
+    /**
+     * 扫描脚本目录，解析每个脚本的 @tool + @description 注释。
+     *
+     * @param {object} config - MCP 配置对象
+     * @returns {Array<{toolName: string, description: string}>}
+     * @private
+     */
+    _scanScripts(config) {
+        if (!config.scriptsDir) return [];
+        if (config.scripts && config.scripts.enabled === false) return [];
+
+        // scriptsDir 是相对路径，相对于 config.json 所在目录
+        const configDir = path.dirname(this.#configPath);
+        const scriptsDir = path.resolve(configDir, config.scriptsDir);
+
+        let files;
+        try {
+            files = fs.readdirSync(scriptsDir);
+        } catch {
+            return [];
+        }
+
+        const allowed = (config.scripts && config.scripts.allowedExtensions) || ALLOWED_EXTENSIONS;
+        const results = [];
+
+        for (const file of files) {
+            const filePath = path.join(scriptsDir, file);
+            const meta = this._parseScriptMeta(filePath, allowed);
+            if (meta) results.push(meta);
+        }
+
+        return results;
+    }
+
+    /**
+     * 解析单个脚本的元数据。
+     * 复用 ScriptRegistry._parseScriptMeta 的正则逻辑，额外解析 @hidden 标记。
+     *
+     * @param {string} filePath - 脚本文件绝对路径
+     * @param {string[]} allowed - 允许的扩展名
+     * @returns {{toolName: string, description: string, hidden: boolean}|null} 无 @tool 注释返回 null
+     * @private
+     */
+    _parseScriptMeta(filePath, allowed) {
+        let stat;
+        try {
+            stat = fs.statSync(filePath);
+        } catch {
+            return null;
+        }
+        if (!stat.isFile()) return null;
+
+        const ext = path.extname(filePath);
+        if (!allowed.includes(ext)) return null;
+
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+        } catch {
+            return null;
+        }
+
+        const lines = content.split('\n').slice(0, MAX_SCAN_LINES);
+
+        let rawName = '';
+        let description = '';
+        let hidden = false;
+
+        for (const line of lines) {
+            const toolMatch = line.match(/@tool\s+(.+)/);
+            if (toolMatch) {
+                rawName = toolMatch[1].trim();
+                continue;
+            }
+            const descMatch = line.match(/@description\s+(.+)/);
+            if (descMatch) {
+                description = descMatch[1].trim();
+                continue;
+            }
+            if (/@hidden\b/.test(line)) {
+                hidden = true;
+                continue;
+            }
+        }
+
+        if (!rawName) return null;
+
+        return {
+            toolName: `script_${rawName}`,
+            description: description || `Script: ${rawName}`,
+            hidden
+        };
+    }
+}
+
+export { McpToolGuide };
+export default McpToolGuide;

package/vendor/Server/library/StatsService.js

@@ -0,0 +1,127 @@
+/**
+ * StatsService — 统计服务模块
+ *
+ * 提供统一的统计功能，供路由和 CLIController 等模块直接调用。
+ * 独立于 HTTP 层，可以直接在代码中调用进行计数。
+ */
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// 统计数据存储路径：db/web/visit-stats.json
+const STATS_DIR = process.env.WEB_STATS_ROOT
+    ? process.env.WEB_STATS_ROOT
+    : fileURLToPath(new URL('../../../db/web', import.meta.url));
+const STATS_FILE = path.join(STATS_DIR, 'visit-stats.json');
+
+/**
+ * 确保统计目录和文件存在
+ */
+async function ensureStatsFile() {
+    try {
+        await fs.mkdir(STATS_DIR, { recursive: true });
+        try {
+            await fs.access(STATS_FILE);
+        } catch {
+            // 文件不存在，创建初始数据
+            const initialData = {
+                visitCount: 0,
+                sessionCount: 0,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString()
+            };
+            await fs.writeFile(STATS_FILE, JSON.stringify(initialData, null, 2), 'utf-8');
+            console.info('统计数据文件已创建', { path: STATS_FILE });
+        }
+    } catch (err) {
+        console.error('确保统计文件失败', { error: err.message });
+        throw err;
+    }
+}
+
+/**
+ * 读取统计数据
+ */
+async function readStats() {
+    await ensureStatsFile();
+    const content = await fs.readFile(STATS_FILE, 'utf-8');
+    return JSON.parse(content);
+}
+
+/**
+ * 写入统计数据
+ */
+async function writeStats(data) {
+    await ensureStatsFile();
+    data.updatedAt = new Date().toISOString();
+    await fs.writeFile(STATS_FILE, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+/**
+ * 统计服务类
+ */
+export class StatsService {
+    /**
+     * 增加访问计数
+     * @returns {Promise<number>} 返回更新后的访问次数
+     */
+    static async incrementVisitCount() {
+        try {
+            const stats = await readStats();
+            stats.visitCount += 1;
+            await writeStats(stats);
+            console.debug('访问计数更新', { visitCount: stats.visitCount });
+            return stats.visitCount;
+        } catch (err) {
+            console.error('访问计数更新失败', { error: err.message });
+            throw err;
+        }
+    }
+
+    /**
+     * 增加 Session 调用计数
+     * @returns {Promise<number>} 返回更新后的 Session 调用次数
+     */
+    static async incrementSessionCount() {
+        try {
+            const stats = await readStats();
+            stats.sessionCount = (stats.sessionCount || 0) + 1;
+            await writeStats(stats);
+            console.debug('Session 调用计数更新', { sessionCount: stats.sessionCount });
+            return stats.sessionCount;
+        } catch (err) {
+            console.error('Session 调用计数更新失败', { error: err.message });
+            // 不抛出异常，避免影响正常业务流程
+            return stats?.sessionCount || 0;
+        }
+    }
+
+    /**
+     * 获取当前访问计数
+     * @returns {Promise<number>}
+     */
+    static async getVisitCount() {
+        const stats = await readStats();
+        return stats.visitCount || 0;
+    }
+
+    /**
+     * 获取当前 Session 调用计数
+     * @returns {Promise<number>}
+     */
+    static async getSessionCount() {
+        const stats = await readStats();
+        return stats.sessionCount || 0;
+    }
+
+    /**
+     * 获取完整统计数据
+     * @returns {Promise<object>}
+     */
+    static async getAllStats() {
+        return await readStats();
+    }
+}
+
+export default StatsService;

package/vendor/Server/library/cstTime.js

@@ -0,0 +1,16 @@
+/**
+ * 将 epoch 毫秒或 Date 格式化为北京时间字符串（ISO 8601 带时区偏移 +08:00）。
+ *
+ * 使用 +08:00 偏移而非 'Z'，使存储和显示均为北京时间；
+ * 同时 Date.parse 仍可正确解析，不影响卡死检测的时间计算。
+ *
+ * @param {number|Date} [input] - epoch 毫秒或 Date 对象，不传则取当前时间
+ * @returns {string} 如 "2026-07-27T15:12:08.774+08:00"
+ */
+export function nowCST(input) {
+    const d = input != null ? new Date(input) : new Date();
+    return d.toLocaleString('sv-SE', { timeZone: 'Asia/Shanghai', hour12: false })
+        .replace(' ', 'T') + '+08:00';
+}
+
+export default nowCST;

package/vendor/Server/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "third-library-loop-server",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "3rdLibraryLoop Server - SKILL 选择器 Agent 及相关服务",
+  "main": "server.js",
+  "scripts": {
+    "test:selector": "node Agent/SkillSelector/__tests__/run-sample.js"
+  },
+  "dependencies": {
+    "@opencode-ai/sdk": "^1.18.6",
+    "better-sqlite3": "^13.0.1",
+    "dotenv": "^17.0.0",
+    "openai": "^4.0.0"
+  },
+  "_comment": "vendored from Server/; dependencies aligned with cli package.json by prepack"
+}

package/vendor/VERSION

@@ -0,0 +1,3 @@
+0.0.1
+built=2026-09-01T09:36:22.210Z
+sha=ff4cc7f00a31ca5f

package/workflows/pr-check.mjs

@@ -0,0 +1,106 @@
+/**
+ * pr-check.mjs —— PR 代码检视工作流
+ *
+ * 等价封装前端「PR 代码检视」面板（Web/public/js/codecheck.js）的单步骤固定编排：
+ *   - SKILL 映射与前端 _CC_SKILL_MAP 一致
+ *   - taskId 沿用 codecheck_ 前缀（前端历史页按 taskIdPrefix=codecheck_ 过滤，
+ *     CLI 提交的任务在前端 PR 检视历史页可见）
+ *   - title 格式 'PR检视|{libraryType}|{prUrl}'（供前端历史恢复解析）
+ *
+ * 注册约定见 cli/README.md「工作流机制」章节：默认导出声明对象，自动注册。
+ */
+
+// 与前端 _CC_SKILL_MAP 同构（arkts 为默认）
+const SKILL_MAP = {
+    arkts: 'arkts-code-check',
+    flutter: 'flutter-code-check',
+    rn: 'rn-code-check',
+    tpccplus: 'tpc-cpp-check',
+};
+
+/**
+ * 从 PR URL 解析 owner / repo / prNumber（等价前端 codecheck.js 的 _ccParsePrUrl）。
+ * @param {string} prUrl
+ * @returns {{ owner: string, repo: string, prNumber: string }}
+ */
+function parsePrUrl(prUrl) {
+    const fallback = { owner: 'unknown', repo: 'unknown', prNumber: '0' };
+    if (!prUrl) return fallback;
+    try {
+        const url = new URL(prUrl);
+        const parts = url.pathname.split('/').filter(Boolean);
+        // 典型: /owner/repo/pulls/123 或 /owner/repo/pull/123
+        let pullIdx = -1;
+        for (let i = 0; i < parts.length; i++) {
+            if (/^pulls?$/.test(parts[i])) { pullIdx = i; break; }
+        }
+        if (pullIdx >= 2) {
+            return {
+                owner: parts[0],
+                repo: parts[1],
+                prNumber: parts[pullIdx + 1] || '0',
+            };
+        }
+        // 回退：用 pathname 中的段拼接
+        if (parts.length >= 2) {
+            return {
+                owner: parts[0],
+                repo: parts[1],
+                prNumber: parts[parts.length - 1] || '0',
+            };
+        }
+    } catch { /* 非法 URL，走 fallback */ }
+    return fallback;
+}
+
+/** 时间戳（base36，等价前端 Date.now().toString(36)）。 */
+function ts36() {
+    return Date.now().toString(36);
+}
+
+export default {
+    name: 'pr-check',
+    description: 'PR 代码检视（等价前端 PR 检视面板，单步骤固定编排）',
+    params: [
+        { flag: 'pr-url', required: true, describe: 'PR 地址，如 https://gitcode.com/owner/repo/pulls/123' },
+        { flag: 'library-type', required: false, describe: '库类型：arkts(默认)/flutter/rn/tpccplus' },
+    ],
+    buildTaskDef(params) {
+        const prUrl = String(params['pr-url'] || '');
+        if (!prUrl) throw new Error('缺少必填参数 --pr-url');
+
+        const libType = String(params['library-type'] || 'arkts').toLowerCase();
+        const skillName = SKILL_MAP[libType];
+        if (!skillName) {
+            throw new Error(`不支持的库类型: ${libType}（可选: ${Object.keys(SKILL_MAP).join(' / ')}）`);
+        }
+
+        const prInfo = parsePrUrl(prUrl);
+        const taskId = `codecheck_${prInfo.owner}_${prInfo.repo}_${prInfo.prNumber}_${ts36()}`;
+
+        // 与前端 doCodeCheck 构造的 taskDescription / title 完全一致
+        const taskDescription = [
+            '请对以下 PR 进行代码检视。',
+            '',
+            `PR 地址: ${prUrl}`,
+        ].join('\n');
+
+        return {
+            taskId,
+            title: `PR检视|${libType}|${prUrl}`,
+            skillDirectory: '',
+            loopCount: 0,
+            steps: [{
+                stepId: 1,
+                taskDescription,
+                dependId: 0,
+                nextStepId: 0,
+                failStepId: 0,
+                maxRetries: 3,
+                skillDirectory: '',
+                specifiedSkill: skillName,
+                inputReport: '',
+            }],
+        };
+    },
+};