dsh-github-flow 0.4.0 → 0.5.0

package/lib/executor.js

@@ -7,9 +7,9 @@ import { findMostRecentWorkspacePath, findWorkspacePathBySession, hasGitDir } fr
 // 子模块纯函数解耦导入并对外部 Re-export 保证 100% 向后兼容
 import { parseGhVersion, compareGhVersions } from './executor/version-utils.js';
 import { spawnWithStdin, safeSlice, cutByUtf8Bytes, truncateOutput } from './executor/process-utils.js';
-import { parseGitStatusOutput, parseGitLogLines, parseGitBranchLines } from './executor/git-parser.js';
+import { parseGitStatusOutput, parseGitLogLines, parseGitBranchLines, parseUncommittedDiff, parseGitStatText } from './executor/git-parser.js';
 import { getPlatformInstallGuide, getGhUpgradeHint } from './executor/platform-guide.js';
-export { parseGhVersion, compareGhVersions, spawnWithStdin, safeSlice, cutByUtf8Bytes, truncateOutput, parseGitStatusOutput, parseGitLogLines, parseGitBranchLines, getPlatformInstallGuide, getGhUpgradeHint, };
+export { parseGhVersion, compareGhVersions, spawnWithStdin, safeSlice, cutByUtf8Bytes, truncateOutput, parseGitStatusOutput, parseGitLogLines, parseGitBranchLines, parseUncommittedDiff, parseGitStatText, getPlatformInstallGuide, getGhUpgradeHint, };
 const execFileAsync = promisify(execFile);
 /** 认证状态缓存时长。用户手动 `gh auth login/logout` 后最多 30 秒内面板才会反映，属可接受代价 */
 const AUTH_CACHE_TTL_MS = 30_000;
@@ -205,9 +205,19 @@ export class GhExecutor {
                     friendlyError = stderrText;
                 }
             }
+            // 失败时若子进程输出了 stdout（如 gh skill publish 校验未通过时的 TSV 诊断行），
+            // 予以保留并应用同样的字符/字节截断预算，以便上层渲染器结构化解析诊断信息，避免丢失关键现场
+            let rawOutput;
+            if (err.stdout) {
+                const outText = Buffer.isBuffer(err.stdout) ? err.stdout.toString('utf8') : String(err.stdout);
+                if (outText.trim()) {
+                    rawOutput = truncateOutput(outText.trim(), this.maxOutputChars, this.maxOutputBytes).text;
+                }
+            }
             return {
                 ok: false,
                 error: friendlyError,
+                rawOutput,
             };
         }
     }
@@ -333,13 +343,183 @@ export class GhExecutor {
                 timeout: 3_000,
                 windowsHide: true,
             });
-            return parseGitStatusOutput(String(stdout));
+            return parseGitStatusOutput(String(stdout), 2000);
         }
         catch {
             // 非 Git 目录 / git 未安装 / 超时：静默降级为 null（调用方不渲染该行）
             return null;
         }
     }
+    /**
+     * 分页获取本地未提交文件列表（无网络开销，纯本地毫秒级响应）
+     */
+    async getUncommittedFiles(cwd, limit = 15, skip = 0) {
+        const targetCwd = this.resolveWorkspaceCwd(cwd);
+        try {
+            const { stdout } = await execFileAsync('git', ['status', '-sb', '--porcelain'], {
+                cwd: targetCwd || undefined,
+                timeout: 3_000,
+                windowsHide: true,
+            });
+            // 允许解析上限 2000 个文件
+            const parsed = parseGitStatusOutput(String(stdout), 2000);
+            if (!parsed) {
+                return { items: [], totalCount: 0, hasMore: false };
+            }
+            const allFiles = parsed.dirtyFiles || [];
+            const totalCount = parsed.dirtyCount;
+            const safeSkip = Math.max(0, skip);
+            const safeLimit = Math.max(1, limit);
+            const items = allFiles.slice(safeSkip, safeSkip + safeLimit);
+            const hasMore = safeSkip + items.length < totalCount;
+            return { items, totalCount, hasMore };
+        }
+        catch {
+            return { items: [], totalCount: 0, hasMore: false };
+        }
+    }
+    /**
+     * 获取指定文件的未提交 Git Diff 对比（Unified Diff 格式）。
+     * 严格实施路径穿越安全校验；支持已跟踪修改文件、暂存文件与未跟踪新增文件（??）。
+     */
+    async getFileDiff(cwd, relativePath) {
+        const targetCwd = this.resolveWorkspaceCwd(cwd);
+        if (!relativePath || typeof relativePath !== 'string') {
+            return { ok: false, filePath: '', error: '缺少目标文件路径' };
+        }
+        // 路径安全防线：严格防止路径穿越
+        const cleanRel = relativePath.trim().replace(/\\/g, '/');
+        const resolvedTarget = path.resolve(targetCwd);
+        const resolvedFile = path.resolve(targetCwd, cleanRel);
+        if (!resolvedFile.startsWith(resolvedTarget + path.sep) && resolvedFile !== resolvedTarget) {
+            return { ok: false, filePath: cleanRel, error: '非法路径，禁止访问工作区外部文件' };
+        }
+        try {
+            // 1. 先用 porcelain status 获取该文件的状态码
+            let fileStatus = 'M';
+            try {
+                const { stdout: statusOut } = await execFileAsync('git', ['status', '--porcelain', '--', cleanRel], {
+                    cwd: targetCwd || undefined,
+                    timeout: 2_000,
+                    windowsHide: true,
+                });
+                const trimmed = String(statusOut).trim();
+                if (trimmed) {
+                    fileStatus = trimmed.slice(0, 2).trim() || 'M';
+                }
+            }
+            catch { }
+            // 2. 如果是未跟踪新增文件 (??)
+            if (fileStatus === '??') {
+                if (!fs.existsSync(resolvedFile)) {
+                    return { ok: false, filePath: cleanRel, error: '目标文件不存在' };
+                }
+                const stat = fs.statSync(resolvedFile);
+                if (stat.isDirectory()) {
+                    return { ok: false, filePath: cleanRel, error: '目标路径为目录而非文件' };
+                }
+                // 读取文件前 8KB 探测是否为二进制
+                const fd = fs.openSync(resolvedFile, 'r');
+                const probeBuf = Buffer.alloc(Math.min(stat.size, 8192));
+                fs.readSync(fd, probeBuf, 0, probeBuf.length, 0);
+                fs.closeSync(fd);
+                if (probeBuf.includes(0)) {
+                    return {
+                        ok: true,
+                        filePath: cleanRel,
+                        status: '??',
+                        isBinary: true,
+                        diff: 'Binary file (untracked)',
+                        additions: 0,
+                        deletions: 0,
+                    };
+                }
+                const content = fs.readFileSync(resolvedFile, 'utf8');
+                const lines = content.split('\n');
+                // 截断保护：最多展示 1500 行防卡死
+                const maxLines = 1500;
+                const truncated = lines.length > maxLines;
+                const displayLines = truncated ? lines.slice(0, maxLines) : lines;
+                const diffBody = displayLines.map((l) => '+' + l).join('\n') + (truncated ? '\n... [差异过大，已截断展示前 1500 行]' : '');
+                const fullDiff = `diff --git a/${cleanRel} b/${cleanRel}\nnew file mode 100644\n--- /dev/null\n+++ b/${cleanRel}\n@@ -0,0 +1,${lines.length} @@\n${diffBody}`;
+                return {
+                    ok: true,
+                    filePath: cleanRel,
+                    status: '??',
+                    diff: fullDiff,
+                    additions: lines.length,
+                    deletions: 0,
+                    isBinary: false,
+                };
+            }
+            // 3. 已跟踪文件（M, D, A 等）：执行 git diff HEAD -- <cleanRel>
+            let rawDiff = '';
+            try {
+                const { stdout } = await execFileAsync('git', ['diff', 'HEAD', '--', cleanRel], {
+                    cwd: targetCwd || undefined,
+                    timeout: 4_000,
+                    windowsHide: true,
+                    maxBuffer: 5 * 1024 * 1024,
+                });
+                rawDiff = String(stdout);
+            }
+            catch {
+                // 无 HEAD 场景（空仓库初次提交前），优雅降级为 git diff -- <cleanRel>
+                try {
+                    const { stdout } = await execFileAsync('git', ['diff', '--', cleanRel], {
+                        cwd: targetCwd || undefined,
+                        timeout: 4_000,
+                        windowsHide: true,
+                        maxBuffer: 5 * 1024 * 1024,
+                    });
+                    rawDiff = String(stdout);
+                }
+                catch { }
+            }
+            // 如果 diff 为空但处于已删除状态（D），或者在 staged 中
+            if (!rawDiff) {
+                try {
+                    const { stdout: stagedDiff } = await execFileAsync('git', ['diff', '--cached', '--', cleanRel], {
+                        cwd: targetCwd || undefined,
+                        timeout: 3_000,
+                        windowsHide: true,
+                    });
+                    rawDiff = String(stagedDiff);
+                }
+                catch { }
+            }
+            if (rawDiff.includes('Binary files differ') || rawDiff.includes('GIT binary patch')) {
+                return {
+                    ok: true,
+                    filePath: cleanRel,
+                    status: fileStatus,
+                    isBinary: true,
+                    diff: 'Binary files differ',
+                    additions: 0,
+                    deletions: 0,
+                };
+            }
+            const diffStats = parseUncommittedDiff(rawDiff);
+            // 截断保护：行数超过 1500 行时截断
+            const diffLines = rawDiff.split('\n');
+            let finalDiff = rawDiff;
+            if (diffLines.length > 1500) {
+                finalDiff = diffLines.slice(0, 1500).join('\n') + '\n... [差异过大，已截断展示前 1500 行]';
+            }
+            return {
+                ok: true,
+                filePath: cleanRel,
+                status: fileStatus,
+                diff: finalDiff || '没有检测到文本差异',
+                additions: diffStats.additions,
+                deletions: diffStats.deletions,
+                isBinary: false,
+            };
+        }
+        catch (err) {
+            return { ok: false, filePath: cleanRel, error: err?.message || '获取文件差异失败' };
+        }
+    }
     /**
      * 本地 Git 提交记录（三段一次返回：本地领先 / 远程领先 / 最近提交）。
      *
@@ -695,7 +875,7 @@ export class GhExecutor {
             return null;
         }
         // 1. 优先尝试由 gh 直接根据当前上下文识别
-        const res = await this.run(['repo', 'view', '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url'], { cwd: targetCwd, timeoutMs: 10_000 });
+        const res = await this.run(['repo', 'view', '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url,stargazerCount,forkCount'], { cwd: targetCwd, timeoutMs: 10_000 });
         if (res.ok && res.data && res.data.nameWithOwner) {
             const d = res.data;
             return {
@@ -706,6 +886,8 @@ export class GhExecutor {
                 description: d.description || '',
                 isPrivate: Boolean(d.isPrivate),
                 url: d.url || `https://github.com/${d.nameWithOwner}`,
+                stargazerCount: typeof d.stargazerCount === 'number' ? d.stargazerCount : 0,
+                forkCount: typeof d.forkCount === 'number' ? d.forkCount : 0,
             };
         }
         // 2. 原生文件解析：直接读取本地 .git/config 文件（0 子进程开销、免疫沙箱 EPERM）
@@ -719,7 +901,7 @@ export class GhExecutor {
                     const repoName = match[2];
                     const nameWithOwner = `${owner}/${repoName}`;
                     // 使用精确的 owner/repo 向 gh 获取元数据（显式传参，不依赖无上下文的探测）
-                    const directRes = await this.run(['repo', 'view', nameWithOwner, '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url'], { cwd: targetCwd, timeoutMs: 10_000 });
+                    const directRes = await this.run(['repo', 'view', nameWithOwner, '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url,stargazerCount,forkCount'], { cwd: targetCwd, timeoutMs: 10_000 });
                     if (directRes.ok && directRes.data && directRes.data.nameWithOwner) {
                         const d = directRes.data;
                         return {
@@ -730,6 +912,8 @@ export class GhExecutor {
                             description: d.description || '',
                             isPrivate: Boolean(d.isPrivate),
                             url: d.url || `https://github.com/${nameWithOwner}`,
+                            stargazerCount: typeof d.stargazerCount === 'number' ? d.stargazerCount : 0,
+                            forkCount: typeof d.forkCount === 'number' ? d.forkCount : 0,
                         };
                     }
                     // 若离线或网络受限，由本地 git remote 配置兜底返回

package/lib/main.js

@@ -12,7 +12,12 @@ import { createRulesetTool } from './tools/ruleset.js';
 import { createCacheTool } from './tools/cache.js';
 import { createGistTool } from './tools/gist.js';
 import { createStatusTool } from './tools/status.js';
+import { createAgentTaskTool } from './tools/agent-task.js';
+import { createDiscussionTool } from './tools/discussion.js';
+import { createProjectTool } from './tools/project.js';
+import { createCodespaceTool } from './tools/codespace.js';
 import { createHelpTool } from './tools/help.js';
+import { defaultTelemetryCollector } from './telemetry.js';
 import { registerGhCommand } from './commands/gh.js';
 import { registerApiRoutes } from './api/routes.js';
 import { UpdateChecker } from './updater.js';
@@ -88,11 +93,26 @@ export function apply(ctx, config = {}) {
     else {
         ctx.github = executor;
     }
-    // 2. 注册人类 Slash 命令 (/gh status, /gh upgrade, /gh help)
+    // 2. 注册 Cordis tools/result 事件切面（无侵入全量工具审计与降级率打点）
+    if (ctx.on && typeof ctx.on === 'function') {
+        ctx.on('tools/result', (exec, result) => {
+            try {
+                const toolName = exec?.name || exec?.tool?.name || '';
+                if (typeof toolName === 'string' && toolName.startsWith('github_')) {
+                    const args = exec?.arguments || exec?.args || {};
+                    defaultTelemetryCollector.recordCall(toolName, args, result);
+                }
+            }
+            catch {
+                // Fail-Open 非阻塞防线：严禁打点逻辑异常影响主工具调用
+            }
+        });
+    }
+    // 3. 注册人类 Slash 命令 (/gh status, /gh upgrade, /gh help)
     if (ctx.commands) {
-        registerGhCommand(ctx.commands, executor, updateChecker);
+        registerGhCommand(ctx.commands, executor, updateChecker, defaultTelemetryCollector);
     }
-    // 3. 注册 Agent 模型工具集（核心领域工具 + 元指南）
+    // 4. 注册 Agent 模型工具集（核心领域工具 + 元指南）
     if (ctx.tools) {
         ctx.tools.register(createPrTool(executor));
         ctx.tools.register(createIssueTool(executor));
@@ -106,7 +126,11 @@ export function apply(ctx, config = {}) {
         ctx.tools.register(createRulesetTool(executor));
         ctx.tools.register(createCacheTool(executor));
         ctx.tools.register(createGistTool(executor));
-        ctx.tools.register(createStatusTool(executor));
+        ctx.tools.register(createStatusTool(executor, defaultTelemetryCollector));
+        ctx.tools.register(createAgentTaskTool(executor));
+        ctx.tools.register(createDiscussionTool(executor));
+        ctx.tools.register(createProjectTool(executor));
+        ctx.tools.register(createCodespaceTool(executor));
         ctx.tools.register(createHelpTool(executor));
     }
     // 4. 注册面向 Client 端的 WebServer HTTP 路由（如果当前环境启用了 Web UI 服务）

package/lib/renderers/agent-task.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 格式化 Agent Task 状态徽标
+ */
+export declare function formatAgentTaskStateBadge(state?: string): string;
+/**
+ * 渲染 Agent Tasks 列表表格
+ */
+export declare function renderAgentTaskList(items: any[]): string;
+/**
+ * 渲染单个 Agent Task 详情卡片
+ */
+export declare function renderAgentTaskView(task: any): string;
+/**
+ * Agent Task 领域综合渲染入口
+ */
+export declare function renderAgentTaskMarkdown(args: any, value: any): string;

package/lib/renderers/agent-task.js

@@ -0,0 +1,107 @@
+import { sanitizeCell } from './common.js';
+/**
+ * 格式化 Agent Task 状态徽标
+ */
+export function formatAgentTaskStateBadge(state) {
+    if (!state)
+        return '⚪ UNKNOWN';
+    const upper = state.toUpperCase();
+    switch (upper) {
+        case 'COMPLETED':
+        case 'SUCCESS':
+            return '🟢 COMPLETED';
+        case 'IN_PROGRESS':
+        case 'RUNNING':
+            return '🟡 RUNNING';
+        case 'FAILED':
+        case 'FAILURE':
+            return '🔴 FAILED';
+        case 'CANCELLED':
+        case 'CANCELED':
+            return '⚪ CANCELLED';
+        default:
+            return `⚪ ${upper}`;
+    }
+}
+/**
+ * 渲染 Agent Tasks 列表表格
+ */
+export function renderAgentTaskList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 暂无智能体任务 (Agent Tasks)。';
+    }
+    const rows = list.map((t) => {
+        const rawId = String(t.id || '-');
+        const shortId = rawId.length > 8 ? `\`${rawId.slice(0, 8)}...\`` : `\`${rawId}\``;
+        const name = sanitizeCell(t.name || '(无描述)', 40);
+        const stateBadge = formatAgentTaskStateBadge(t.state);
+        let prCell = '-';
+        if (t.pullRequestNumber) {
+            const prText = `#${t.pullRequestNumber}`;
+            prCell = t.pullRequestUrl ? `[${prText}](${t.pullRequestUrl})` : prText;
+        }
+        const created = t.createdAt ? t.createdAt.split('T')[0] : '-';
+        return `| ${shortId} | ${name} | ${stateBadge} | ${prCell} | ${created} |`;
+    });
+    return [
+        `**智能体任务列表 (${list.length} 条):**\n`,
+        '| 任务 ID | 描述 | 状态 | 关联 PR | 创建日期 |',
+        '| :--- | :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * 渲染单个 Agent Task 详情卡片
+ */
+export function renderAgentTaskView(task) {
+    if (!task || typeof task !== 'object') {
+        return '无任务详情数据';
+    }
+    const name = task.name || '(未命名任务)';
+    const stateBadge = formatAgentTaskStateBadge(task.state);
+    const repo = task.repository ? `[${task.repository}](https://github.com/${task.repository})` : '-';
+    const user = task.user?.login || task.user || '-';
+    const created = task.createdAt || '-';
+    const completed = task.completedAt || '-';
+    const lines = [
+        `### 🤖 Agent Task: ${name}\n`,
+        `- **任务 ID**: \`${task.id || '-'}\``,
+        `- **状态**: ${stateBadge}`,
+        `- **目标仓库**: ${repo}`,
+        `- **分派用户**: @${user}`,
+        `- **创建时间**: ${created}`,
+        `- **完成时间**: ${completed}`,
+    ];
+    if (task.pullRequestNumber) {
+        const prTitle = task.pullRequestTitle ? ` - ${task.pullRequestTitle}` : '';
+        const prLink = task.pullRequestUrl
+            ? `[#${task.pullRequestNumber}${prTitle}](${task.pullRequestUrl})`
+            : `#${task.pullRequestNumber}${prTitle}`;
+        lines.push(`- **关联 PR**: ${prLink} (${task.pullRequestState || 'OPEN'})`);
+    }
+    if (task.logs || task.log) {
+        lines.push('\n**会话日志记录:**', '```text', String(task.logs || task.log).trim(), '```');
+    }
+    return lines.join('\n');
+}
+/**
+ * Agent Task 领域综合渲染入口
+ */
+export function renderAgentTaskMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (typeof value.result === 'string')
+        return value.result;
+    if (typeof value.message === 'string' && !value.items) {
+        const extra = value.detail || value.output || value.url;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        return renderAgentTaskList(value.items);
+    }
+    if (args?.action === 'view' || value.id) {
+        return renderAgentTaskView(value);
+    }
+    return JSON.stringify(value, null, 2);
+}

package/lib/renderers/codespace.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 格式化 Codespace 状态徽标
+ */
+export declare function formatCodespaceStateBadge(state?: string): string;
+/**
+ * 渲染 Codespaces 列表表格
+ */
+export declare function renderCodespaceList(items: any[]): string;
+/**
+ * 渲染单个 Codespace 详情卡片
+ */
+export declare function renderCodespaceView(cs: any): string;
+/**
+ * Codespace 领域综合渲染入口
+ */
+export declare function renderCodespaceMarkdown(args: any, value: any): string;

package/lib/renderers/codespace.js

@@ -0,0 +1,103 @@
+import { sanitizeCell } from './common.js';
+import { renderScopeRequiredMarkdown } from './project.js';
+/**
+ * 格式化 Codespace 状态徽标
+ */
+export function formatCodespaceStateBadge(state) {
+    if (!state)
+        return '⚪ UNKNOWN';
+    const lower = state.toLowerCase();
+    if (lower === 'available')
+        return '🟢 AVAILABLE';
+    if (lower === 'shutdown')
+        return '⚪ SHUTDOWN';
+    if (lower.includes('start') || lower.includes('rebuild'))
+        return '🟡 STARTING';
+    if (lower.includes('updat') || lower.includes('export'))
+        return '🟡 BUSY';
+    return `⚪ ${state.toUpperCase()}`;
+}
+/**
+ * 渲染 Codespaces 列表表格
+ */
+export function renderCodespaceList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 暂无云端开发环境 (Codespaces)。';
+    }
+    const rows = list.map((cs) => {
+        const name = `\`${sanitizeCell(cs.name || '-', 25)}\``;
+        const displayName = sanitizeCell(cs.displayName || cs.name || '-', 25);
+        const repo = cs.repository ? `[${cs.repository}](https://github.com/${cs.repository})` : '-';
+        const stateBadge = formatCodespaceStateBadge(cs.state);
+        const machine = sanitizeCell(cs.machineDisplayName || cs.machineName || '-', 20);
+        const lastUsed = cs.lastUsedAt ? cs.lastUsedAt.split('T')[0] : '-';
+        return `| ${name} | ${displayName} | ${repo} | ${stateBadge} | ${machine} | ${lastUsed} |`;
+    });
+    return [
+        `**云端开发环境列表 (${list.length} 台):**\n`,
+        '| 实例标识 | 显示名称 | 关联仓库 | 运行状态 | 机器规格 | 上次使用 |',
+        '| :--- | :--- | :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * 渲染单个 Codespace 详情卡片
+ */
+export function renderCodespaceView(cs) {
+    if (!cs || typeof cs !== 'object') {
+        return '无云端环境详情数据';
+    }
+    const name = cs.displayName || cs.name || '未命名实例';
+    const stateBadge = formatCodespaceStateBadge(cs.state);
+    const repo = cs.repository ? `[${cs.repository}](https://github.com/${cs.repository})` : '-';
+    const owner = cs.owner || cs.billableOwner || '-';
+    const machine = cs.machineDisplayName || cs.machineName || '-';
+    const created = cs.createdAt || '-';
+    const lastUsed = cs.lastUsedAt || '-';
+    const lines = [
+        `### ☁️ Codespace: ${name}\n`,
+        `- **实例标识**: \`${cs.name || '-'}\``,
+        `- **运行状态**: ${stateBadge}`,
+        `- **关联仓库**: ${repo}`,
+        `- **所有者**: @${owner}`,
+        `- **机器规格**: ${machine}`,
+        `- **空闲停机**: ${cs.idleTimeoutMinutes ? `${cs.idleTimeoutMinutes} 分钟` : '默认'}`,
+        `- **创建时间**: ${created}`,
+        `- **上次活跃**: ${lastUsed}`,
+    ];
+    if (cs.devcontainerPath) {
+        lines.push(`- **容器配置**: \`${cs.devcontainerPath}\``);
+    }
+    return lines.join('\n');
+}
+/**
+ * Codespace 领域综合渲染入口
+ */
+export function renderCodespaceMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (value.status === 'SCOPE_REQUIRED') {
+        return renderScopeRequiredMarkdown(value);
+    }
+    if (value.status === 'AWAITING_CONFIRMATION') {
+        return [
+            `> ### ${value.warning || '⚠️ 操作确认拦截'}`,
+            `> - **影响评估**: ${value.impact || ''}`,
+            `> - **确认指引**: ${value.requiredAction || '如确认继续，请在参数中附加 `confirm: true` 重新调用。'}`,
+        ].join('\n');
+    }
+    if (typeof value.result === 'string')
+        return value.result;
+    if (typeof value.message === 'string' && !value.items) {
+        const extra = value.detail || value.output;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        return renderCodespaceList(value.items);
+    }
+    if (args?.action === 'view' || value.name) {
+        return renderCodespaceView(value);
+    }
+    return JSON.stringify(value, null, 2);
+}

package/lib/renderers/discussion.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 格式化 Discussion 状态徽标
+ */
+export declare function formatDiscussionStateBadge(state?: string, answered?: boolean, closed?: boolean): string;
+/**
+ * 渲染 Discussion 列表表格
+ */
+export declare function renderDiscussionList(items: any[]): string;
+/**
+ * 渲染单个 Discussion 详情卡片
+ */
+export declare function renderDiscussionView(d: any): string;
+/**
+ * Discussion 领域综合渲染入口
+ */
+export declare function renderDiscussionMarkdown(args: any, value: any): string;

package/lib/renderers/discussion.js

@@ -0,0 +1,101 @@
+import { sanitizeCell } from './common.js';
+/**
+ * 格式化 Discussion 状态徽标
+ */
+export function formatDiscussionStateBadge(state, answered, closed) {
+    if (answered)
+        return '🟢 ANSWERED';
+    const effective = state ? String(state).toUpperCase() : (closed ? 'CLOSED' : 'OPEN');
+    if (effective === 'OPEN')
+        return '🔵 OPEN';
+    if (effective === 'CLOSED')
+        return '🟣 CLOSED';
+    return `⚪ ${effective}`;
+}
+/**
+ * 渲染 Discussion 列表表格
+ */
+export function renderDiscussionList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 暂无讨论主题 (Discussions)。';
+    }
+    const rows = list.map((d) => {
+        const num = d.number ? `#${d.number}` : '-';
+        const link = d.url ? `[${num}](${d.url})` : num;
+        const title = sanitizeCell(d.title || '(无标题)', 45);
+        const category = sanitizeCell(d.category?.name || d.category || 'General', 15);
+        const stateBadge = formatDiscussionStateBadge(d.state, d.answered, d.closed);
+        const author = d.author?.login || d.author || '-';
+        const updated = d.updatedAt ? d.updatedAt.split('T')[0] : (d.createdAt ? d.createdAt.split('T')[0] : '-');
+        return `| ${link} | ${title} | \`${category}\` | ${stateBadge} | @${author} | ${updated} |`;
+    });
+    return [
+        `**讨论主题列表 (${list.length} 条):**\n`,
+        '| 编号 | 标题 | 分类 | 状态 | 作者 | 更新日期 |',
+        '| :--- | :--- | :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * 渲染单个 Discussion 详情卡片
+ */
+export function renderDiscussionView(d) {
+    if (!d || typeof d !== 'object') {
+        return '无讨论详情数据';
+    }
+    const num = d.number ? `#${d.number}` : '';
+    const title = d.title || '(无标题)';
+    const stateBadge = formatDiscussionStateBadge(d.state, d.answered, d.closed);
+    const category = d.category?.name || d.category || 'General';
+    const author = d.author?.login || d.author || '-';
+    const created = d.createdAt || '-';
+    const link = d.url ? `[查看原始讨论](${d.url})` : '';
+    const lines = [
+        `### 💬 Discussion ${num}: ${title}\n`,
+        `- **状态**: ${stateBadge}`,
+        `- **分类**: \`${category}\``,
+        `- **发起人**: @${author}`,
+        `- **创建时间**: ${created}`,
+    ];
+    if (link)
+        lines.push(`- **链接**: ${link}`);
+    if (Array.isArray(d.labels) && d.labels.length > 0) {
+        const labelBadges = d.labels.map((l) => `\`${l.name || l}\``).join(' ');
+        lines.push(`- **标签**: ${labelBadges}`);
+    }
+    if (d.body) {
+        lines.push('\n**正文内容:**', '---', d.body.trim(), '---');
+    }
+    // 渲染关联评论列表
+    if (Array.isArray(d.comments) && d.comments.length > 0) {
+        lines.push(`\n**讨论回复 (${d.comments.length} 条):**`);
+        d.comments.forEach((c, index) => {
+            const cAuthor = c.author?.login || c.author || '匿名';
+            const cTime = c.createdAt ? c.createdAt.replace('T', ' ').slice(0, 19) : '';
+            const cBody = (c.body || '').trim();
+            lines.push(`\n> **#${index + 1} 楼 @${cAuthor}** (${cTime}):\n> ${cBody.replace(/\n/g, '\n> ')}`);
+        });
+    }
+    return lines.join('\n');
+}
+/**
+ * Discussion 领域综合渲染入口
+ */
+export function renderDiscussionMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (typeof value.result === 'string')
+        return value.result;
+    if (typeof value.message === 'string' && !value.items) {
+        const extra = value.detail || value.output || value.url;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        return renderDiscussionList(value.items);
+    }
+    if (args?.action === 'view' || value.number) {
+        return renderDiscussionView(value);
+    }
+    return JSON.stringify(value, null, 2);
+}