dsh-github-flow 0.6.0 → 0.7.1

package/lib/tools/body-input.d.ts

@@ -0,0 +1,58 @@
+/**
+ * GitHub 正文上限（Issue/PR/评论/讨论统一口径 65,536 字符）。
+ * 抽成常量而不是散落字面量：这是上游约束，将来调整只改一处。
+ */
+export declare const GITHUB_BODY_MAX_CHARS = 65536;
+/**
+ * 单个正文文件的字节硬上限（4MB）。
+ * 字符上限只管正文语义，管不住「模型指了一个 200MB 日志文件」——先按字节拦住，
+ * 避免 readFileSync 把整个文件拉进内存再判定。
+ */
+export declare const BODY_FILE_MAX_BYTES: number;
+/** 入参归一化的产出：argv 片段 + 需要注入的 stdin + 权威文本 */
+export interface BodySource {
+    /** 交给 gh 的 argv 片段：`[]` | `[flag, text]` | `[fileFlag, '-']` */
+    argv: string[];
+    /** `[fileFlag, '-']` 时需要经 stdin 注入的正文；其余情况为 undefined */
+    stdin?: string;
+    /** 权威正文（REST/GraphQL 通道直接用它；调用方做必填判定也看它） */
+    text: string;
+    /** `text` 的字符数（按 UTF-16 单元近似 GitHub 的字符口径） */
+    chars: number;
+    fromFile: boolean;
+    /** 文件来源时解析后的绝对路径（仅用于回执与错误诊断） */
+    file?: string;
+}
+export interface BodySourceOptions {
+    /** 相对路径的解析基准（工具层传 `executor.resolveExecScope` 得到的工作区） */
+    cwd: string;
+    /** 内联 flag，缺省 `--body`（discussion 用 `-b`） */
+    flag?: string;
+    /** 文件 flag，缺省 `--body-file`（release 用 `--notes-file`，api/agent-task 用各自 flag） */
+    fileFlag?: string;
+    /** 内联字段名，仅用于错误文案（缺省 `body`） */
+    inlineField?: string;
+    /** 文件字段名，仅用于错误文案（缺省 `body_file`） */
+    fileField?: string;
+    /** 无正文时仍下发 `[flag, '']`：create 需要它保持非交互（否则 gh 会打开编辑器） */
+    keepEmptyInline?: boolean;
+    /** 字符上限覆盖；传 0 关闭字符校验（`gh api --input` 的请求体不受正文口径约束） */
+    maxChars?: number;
+}
+/**
+ * 解析正文来源。
+ *
+ * 语义表（与计划文档一致，调用方不再各自二次决策）：
+ * | 输入 | argv | stdin |
+ * | --- | --- | --- |
+ * | `file` 有值且文件非空 | `[fileFlag, '-']` | 文件正文 |
+ * | `file` 有值但文件为空 | 同「都为空」 | — |
+ * | `inline` 非空 | `[flag, inline]` | — |
+ * | 都为空 + keepEmptyInline | `[flag, '']` | — |
+ * | 都为空 | `[]` | — |
+ * | 两者都非空 | 抛错（不做静默优先级） | — |
+ */
+export declare function resolveBodySource(input: {
+    inline?: unknown;
+    file?: unknown;
+}, options?: BodySourceOptions): BodySource;

package/lib/tools/body-input.js

@@ -0,0 +1,123 @@
+/**
+ * 「正文/长文本来自本地文件」的统一入参解析（纯函数，零 gh 依赖）。
+ *
+ * 为什么需要它：Agent 的典型工作流是**先把报告写成 md 文件**，再提交成 Issue / PR 评论 /
+ * 讨论 / 发版说明。改造前这些入参只有字符串 `body`，模型只能把整篇正文搬进参数——
+ * 既烧上下文，又会在 Windows 约 32K 的命令行上限处炸掉（`E2BIG/EINVAL`，错误还很难懂）。
+ * 于是 Agent 会绕开插件直接用 `gh issue create -F report.md`，插件的确认闸门/错误分类/渲染
+ * 全部被跳过。
+ *
+ * 为什么不让 gh 自己去读文件（`--body-file <path>`）：`pr review` 的行级评注走 REST
+ * （`POST /pulls/{n}/reviews`），那条通道根本没有 flag，只能插件侧读文件后塞 JSON。
+ * 两套通道各写一份，必然漂移成「带 comments 时 body_file 静默失效」。因此统一为：
+ * **插件读一次文件** →
+ *   - CLI 通道：`[fileFlag, '-']` + `stdin`（`--body-file -` 由 gh 读 stdin，无 argv 长度上限）；
+ *   - REST/GraphQL 通道：直接用 `text`。
+ *
+ * 兼容性纪律：内联来源的 argv 必须与本模块引入前**逐字节一致**（`[flag, text]`），
+ * 新通道只在「传了 `*_file`」时才改变 argv。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * GitHub 正文上限（Issue/PR/评论/讨论统一口径 65,536 字符）。
+ * 抽成常量而不是散落字面量：这是上游约束，将来调整只改一处。
+ */
+export const GITHUB_BODY_MAX_CHARS = 65_536;
+/**
+ * 单个正文文件的字节硬上限（4MB）。
+ * 字符上限只管正文语义，管不住「模型指了一个 200MB 日志文件」——先按字节拦住，
+ * 避免 readFileSync 把整个文件拉进内存再判定。
+ */
+export const BODY_FILE_MAX_BYTES = 4 * 1024 * 1024;
+/** 严格 UTF-8 解码器：GBK/ANSI 存的中文 md 会抛错，而不是静默产出乱码 */
+const strictUtf8 = new TextDecoder('utf-8', { fatal: true });
+function emptyResult(flag, keepEmptyInline) {
+    return { argv: keepEmptyInline ? [flag, ''] : [], text: '', chars: 0, fromFile: false };
+}
+function inlineResult(flag, text) {
+    return { argv: [flag, text], text, chars: text.length, fromFile: false };
+}
+/**
+ * 解析正文来源。
+ *
+ * 语义表（与计划文档一致，调用方不再各自二次决策）：
+ * | 输入 | argv | stdin |
+ * | --- | --- | --- |
+ * | `file` 有值且文件非空 | `[fileFlag, '-']` | 文件正文 |
+ * | `file` 有值但文件为空 | 同「都为空」 | — |
+ * | `inline` 非空 | `[flag, inline]` | — |
+ * | 都为空 + keepEmptyInline | `[flag, '']` | — |
+ * | 都为空 | `[]` | — |
+ * | 两者都非空 | 抛错（不做静默优先级） | — |
+ */
+export function resolveBodySource(input, options = { cwd: process.cwd() }) {
+    const flag = options.flag ?? '--body';
+    const fileFlag = options.fileFlag ?? '--body-file';
+    const inlineField = options.inlineField ?? 'body';
+    const fileField = options.fileField ?? 'body_file';
+    const maxChars = options.maxChars ?? GITHUB_BODY_MAX_CHARS;
+    const rawInline = input.inline;
+    if (rawInline !== undefined && rawInline !== null && typeof rawInline !== 'string') {
+        throw new Error(`${inlineField} 必须是字符串。`);
+    }
+    // 不做 trim：内联正文要原样下发，保持与改造前逐字节一致
+    const inline = typeof rawInline === 'string' ? rawInline : '';
+    const rawFile = input.file;
+    if (rawFile === undefined || rawFile === null) {
+        return inline.length > 0 ? inlineResult(flag, inline) : emptyResult(flag, options.keepEmptyInline);
+    }
+    if (typeof rawFile !== 'string') {
+        throw new Error(`${fileField} 必须是本地文件路径字符串（绝对路径或相对当前工作区的路径）。`);
+    }
+    const fileInput = rawFile.trim();
+    // 空串视同未提供：调用方（含契约测试的样例表）用一个空串表达「这条路不走」
+    if (!fileInput) {
+        return inline.length > 0 ? inlineResult(flag, inline) : emptyResult(flag, options.keepEmptyInline);
+    }
+    // 二选一而非优先级：模型拿到一次明确失败，远好过「不知道哪份真正生效」
+    if (inline.length > 0) {
+        throw new Error(`${inlineField} 与 ${fileField} 同时提供：请二选一（长正文用 ${fileField}，短文本用 ${inlineField}）。`);
+    }
+    const abs = path.isAbsolute(fileInput) ? fileInput : path.resolve(options.cwd, fileInput);
+    let stat;
+    try {
+        stat = fs.statSync(abs);
+    }
+    catch {
+        throw new Error(`${fileField} 指向的文件不存在: "${abs}"（输入: "${fileInput}"）。`);
+    }
+    if (!stat.isFile()) {
+        throw new Error(`${fileField} 必须是普通文件，当前指向的不是文件: "${abs}"。`);
+    }
+    if (stat.size > BODY_FILE_MAX_BYTES) {
+        // 用字节数报错而不是 toFixed(1) 的 MB：4MB+1 字节会被四舍五入显示成「4.0MB 超过 4MB」，
+        // 看上去像插件算错了，反而增加排查成本
+        throw new Error(`${fileField} 文件过大: ${stat.size} 字节，超过 ${BODY_FILE_MAX_BYTES} 字节（4MB）上限。`);
+    }
+    const buf = fs.readFileSync(abs);
+    // 二进制先判、再解码：PNG 之类在 UTF-8 解码阶段会报「不是合法 UTF-8」并给出 GBK 另存建议，
+    // 对二进制文件是误导；NUL 字节是更准确的判据（文本文件不会有）
+    if (buf.includes(0)) {
+        throw new Error(`${fileField} 内容是二进制（含 NUL 字节），不能作为正文: "${abs}"。`);
+    }
+    let text;
+    try {
+        text = strictUtf8.decode(buf);
+    }
+    catch {
+        throw new Error(`${fileField} 不是合法 UTF-8 文本: "${abs}"。Windows 上常见 GBK/ANSI 编码，请另存为 UTF-8 后重试。`);
+    }
+    // 解码头本身会剥 BOM（TextDecoder 的 ignoreBOM 默认 false）；这里显式再剥一次是防御：
+    // 一旦有人把上面改成 ignoreBOM: true，正文首字符就会变成零宽 BOM 字符
+    if (text.charCodeAt(0) === 0xfeff)
+        text = text.slice(1);
+    const chars = text.length;
+    if (maxChars > 0 && chars > maxChars) {
+        throw new Error(`${fileField} 正文过长: ${chars} 字符，超过上限 ${maxChars} 字符。请拆分或精简后再提交。`);
+    }
+    // 空文件不进 stdin 通道：不依赖 gh 对空 stdin 的处理，语义与「没正文」完全一致
+    if (chars === 0)
+        return emptyResult(flag, options.keepEmptyInline);
+    return { argv: [fileFlag, '-'], stdin: text, text, chars, fromFile: true, file: abs };
+}

package/lib/tools/cache.js

@@ -1,3 +1,4 @@
+import { wrapWithGate } from '../destructive.js';
 import { renderCacheMarkdown } from '../renderers/markdown.js';
 function normalizeOutput(data) {
     if (data && typeof data === 'object' && !Array.isArray(data)) {
@@ -9,9 +10,9 @@ function normalizeOutput(data) {
     return { result: data !== undefined && data !== null ? data : '' };
 }
 export function createCacheTool(executor) {
-    return {
+    return wrapWithGate({
         name: 'github_cache',
-        description: '管理 GitHub Actions 构建缓存 (Caches)：查看缓存列表与占用容量、按 ID 或 Key 删除指定缓存、以及全量清空仓库缓存。全量清空不可逆，需 confirm: true。',
+        description: '管理 GitHub Actions 构建缓存 (Caches)：查看缓存列表与占用容量、按 ID 或 Key 删除指定缓存、以及全量清空仓库缓存。删除不可逆，delete 的三种方式（cache_id / key / all）均需 confirm: true。',
         parameters: {
             type: 'object',
             properties: {
@@ -56,7 +57,7 @@ export function createCacheTool(executor) {
                 },
                 confirm: {
                     type: 'boolean',
-                    description: '高危破坏性操作确认标志（delete 当 all: true 时必需）。未传 true 时输出影响评估报告并拦截。',
+                    description: '高危破坏性操作确认标志（delete 的三态 cache_id / key / all 均必需）。未传 true 时输出影响评估报告并拦截。',
                 },
             },
             required: ['action'],
@@ -68,8 +69,7 @@ export function createCacheTool(executor) {
             },
         },
         async execute(args, execContext) {
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             let repoTarget = args.repo;
             if (!repoTarget) {
                 const meta = await executor.getRepoMetadata(cwd, sessionId);
@@ -120,19 +120,26 @@ export function createCacheTool(executor) {
                     return normalizeOutput(rawData || []);
                 }
                 case 'delete': {
-                    // 1. 全量清空分支
-                    if (args.all === true) {
-                        if (args.confirm !== true) {
-                            return {
-                                status: 'AWAITING_CONFIRMATION',
-                                action: 'delete',
-                                all: true,
-                                repo: repoTarget,
-                                warning: `⚠️ 高危破坏性操作：即将清空仓库 ${repoTarget} 的所有 GitHub Actions 构建缓存`,
-                                impact: `清空缓存不可逆，会导致后续流水线构建无法复用依赖与构建产物，显著增加 CI 运行耗时。`,
-                                requiredAction: `如确认彻底清空，请在参数中附加 \`confirm: true\` 重新调用。示例：\`github_cache(action: 'delete', all: true, confirm: true)\``,
-                            };
-                        }
+                    // ---- 第一段：选择器归一化 + 形态校验（在任何执行之前）----
+                    const hasAll = args.all === true;
+                    const cacheIdStr = args.cache_id !== undefined && args.cache_id !== null ? String(args.cache_id).trim() : '';
+                    const keyStr = args.key !== undefined && args.key !== null ? String(args.key).trim() : '';
+                    const hasId = cacheIdStr !== '';
+                    const hasKey = keyStr !== '';
+                    if (!hasAll && !hasId && !hasKey) {
+                        throw new Error('删除缓存时必须指定 `cache_id`、`key` 或 `all: true`（三条删除分支均需配合 confirm: true）。');
+                    }
+                    // 形态校验必须先于执行：不校验时 `cache_id: "--all"` 会被当作 flag 透传，
+                    // 等价于清空全仓缓存；而 `gh cache delete --all` 自身没有二次确认，绕过即秒清。
+                    if (hasId && !/^\d+$/.test(cacheIdStr)) {
+                        throw new Error(`cache_id 必须是纯数字的缓存 ID（实际收到 "${cacheIdStr}"）。按 key 删除请改用 key 参数，全量清空请用 all: true。`);
+                    }
+                    if (hasKey && (keyStr.startsWith('-') || keyStr.length > 512)) {
+                        throw new Error('key 不能以 - 开头（防被当作命令行 flag），且长度不得超过 512 字符。');
+                    }
+                    // ---- 执行段（argv 形状与改动前保持一致）----
+                    // confirm 闸门由 wrapWithGate 在工厂入口统一处理，三条分支共用同一套语义。
+                    if (hasAll) {
                         const delCmd = ['cache', 'delete', '--all', '--succeed-on-no-caches', ...repoArgs];
                         if (args.ref) {
                             delCmd.push('-r', String(args.ref));
@@ -147,40 +154,35 @@ export function createCacheTool(executor) {
                             detail: res.rawOutput || '',
                         };
                     }
-                    // 2. 按 cache_id 删除
-                    if (args.cache_id !== undefined && args.cache_id !== null && String(args.cache_id).trim() !== '') {
-                        const delCmd = ['cache', 'delete', String(args.cache_id), ...repoArgs];
+                    if (hasId) {
+                        const delCmd = ['cache', 'delete', cacheIdStr, ...repoArgs];
                         const res = await executor.run(delCmd, runOpts);
                         if (!res.ok)
                             throw new Error(res.error);
                         return {
                             success: true,
-                            cache_id: String(args.cache_id),
-                            message: `🗑️ 成功删除仓库 ${repoTarget} 中 ID 为 "${args.cache_id}" 的 Actions 缓存`,
+                            cache_id: cacheIdStr,
+                            message: `🗑️ 成功删除仓库 ${repoTarget} 中 ID 为 "${cacheIdStr}" 的 Actions 缓存`,
                             detail: res.rawOutput || '',
                         };
                     }
-                    // 3. 按 key 删除
-                    if (args.key !== undefined && args.key !== null && String(args.key).trim() !== '') {
-                        const delCmd = ['cache', 'delete', String(args.key), ...repoArgs];
-                        if (args.ref) {
-                            delCmd.push('-r', String(args.ref));
-                        }
-                        const res = await executor.run(delCmd, runOpts);
-                        if (!res.ok)
-                            throw new Error(res.error);
-                        return {
-                            success: true,
-                            key: String(args.key),
-                            message: `🗑️ 成功删除仓库 ${repoTarget} 中 Key 为 "${args.key}" 的 Actions 缓存` + (args.ref ? ` (Ref: ${args.ref})` : ''),
-                            detail: res.rawOutput || '',
-                        };
+                    const delCmd = ['cache', 'delete', keyStr, ...repoArgs];
+                    if (args.ref) {
+                        delCmd.push('-r', String(args.ref));
                     }
-                    throw new Error('删除缓存时必须指定 `cache_id`、`key` 或 `all: true`（全量删除需配合 confirm: true）。');
+                    const res = await executor.run(delCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return {
+                        success: true,
+                        key: keyStr,
+                        message: `🗑️ 成功删除仓库 ${repoTarget} 中 Key 为 "${keyStr}" 的 Actions 缓存` + (args.ref ? ` (Ref: ${args.ref})` : ''),
+                        detail: res.rawOutput || '',
+                    };
                 }
                 default:
                     throw new Error(`不支持的 cache 操作: "${args.action}"。可选值: list, delete。`);
             }
         },
-    };
+    });
 }

package/lib/tools/codespace.js

@@ -1,3 +1,4 @@
+import { wrapWithGate } from '../destructive.js';
 import { renderCodespaceMarkdown } from '../renderers/markdown.js';
 import { checkScopeRequired } from './project.js';
 function normalizeOutput(data) {
@@ -12,7 +13,7 @@ function normalizeOutput(data) {
 const CODESPACE_LIST_FIELDS = 'name,displayName,repository,owner,state,gitStatus,lastUsedAt,createdAt,machineName';
 const CODESPACE_VIEW_FIELDS = 'name,displayName,repository,owner,state,gitStatus,lastUsedAt,createdAt,machineName,devcontainerPath,recentFolders,idleTimeoutMinutes';
 export function createCodespaceTool(executor) {
-    return {
+    return wrapWithGate({
         name: 'github_codespace',
         description: '管理 GitHub Codespaces 云端远程开发环境：查阅实例列表与运行状态、检视实例配置详情、停止运行中的环境防计费、安全销毁实例。未授权时提供平台感知自愈命令。',
         parameters: {
@@ -53,8 +54,7 @@ export function createCodespaceTool(executor) {
             },
         },
         async execute(args, execContext) {
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             const runOpts = { cwd, sessionId };
             switch (args.action) {
                 case 'list': {
@@ -123,14 +123,6 @@ export function createCodespaceTool(executor) {
                         throw new Error('delete 操作必须提供 codespace 名称');
                     }
                     const cleanName = args.codespace.trim();
-                    if (args.confirm !== true) {
-                        return {
-                            status: 'AWAITING_CONFIRMATION',
-                            warning: `⚠️ 销毁确认拦截：你即将永久删除云端开发环境「${cleanName}」。`,
-                            impact: '物理销毁 Codespace 将永久释放云端计算资源，环境中任何未提交并推送到远端 Git 的临时修改都将无法找回。',
-                            requiredAction: '如确认销毁该实例，请核对环境名称并在参数中附加 `confirm: true` 重新调用。',
-                        };
-                    }
                     const deleteCmd = ['codespace', 'delete', '-c', cleanName, '-f'];
                     if (args.org)
                         deleteCmd.push('-o', String(args.org).trim());
@@ -150,5 +142,5 @@ export function createCodespaceTool(executor) {
                     throw new Error(`未知的 Codespace 操作: ${args.action}`);
             }
         },
-    };
+    });
 }

package/lib/tools/discussion.d.ts

@@ -26,6 +26,10 @@ export declare function createDiscussionTool(executor: GhExecutor): {
                 type: string;
                 description: string;
             };
+            body_file: {
+                type: string;
+                description: string;
+            };
             category: {
                 type: string;
                 description: string;

package/lib/tools/discussion.js

@@ -1,4 +1,6 @@
+import { wrapWithGate } from '../destructive.js';
 import { renderDiscussionMarkdown } from '../renderers/markdown.js';
+import { resolveBodySource } from './body-input.js';
 function normalizeOutput(data) {
     if (data && typeof data === 'object' && !Array.isArray(data)) {
         return data;
@@ -11,7 +13,7 @@ function normalizeOutput(data) {
 const DISCUSSION_LIST_FIELDS = 'number,title,body,category,author,closed,createdAt,updatedAt,url,labels,answered,stateReason';
 const DISCUSSION_VIEW_FIELDS = 'number,title,body,category,author,state,createdAt,updatedAt,url,labels,answered,comments';
 export function createDiscussionTool(executor) {
-    return {
+    return wrapWithGate({
         name: 'github_discussion',
         description: '管理 GitHub Discussions 讨论区：浏览社区讨论、检视讨论详情与回复楼层、发起新讨论议题、编辑现有讨论以及追加评论回复。基于 gh CLI preview 特性。',
         parameters: {
@@ -36,7 +38,11 @@ export function createDiscussionTool(executor) {
                 },
                 body: {
                     type: 'string',
-                    description: '讨论正文或评论正文（create, comment 必需，edit 动作修改正文时可选）。',
+                    description: '讨论正文或评论正文（create, comment 必需，edit 动作修改正文时可选）。与 body_file 二选一。',
+                },
+                body_file: {
+                    type: 'string',
+                    description: '正文来源：本地 Markdown 文件路径（相对路径按当前工作区解析）。与 body 二选一；长正文用本参数，无需把全文读进上下文。',
                 },
                 category: {
                     type: 'string',
@@ -74,10 +80,17 @@ export function createDiscussionTool(executor) {
             },
         },
         async execute(args, execContext) {
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             const repoArgs = args.repo ? ['-R', args.repo] : [];
             const runOpts = { cwd, sessionId };
+            // 正文来自本地文件时经 stdin 注入（`--body-file -`）：绕开 Windows 约 32K 的命令行上限
+            const stdinPatch = (body) => (body.stdin === undefined ? {} : { stdin: body.stdin });
+            /*
+             * 内联正文沿用改造前的 trim 口径（旧代码是 `-b args.body.trim()`）：discussion 历史上
+             * 就按去空白下发，改成原样会动到既有调用方的 argv。文件来源不 trim——那是用户排好版的
+             * Markdown，首尾空行/缩进可能有意义，strip 掉等于替用户改稿。
+             */
+            const trimInline = (v) => (typeof v === 'string' ? v.trim() : v);
             switch (args.action) {
                 case 'list': {
                     const limit = typeof args.limit === 'number' && args.limit > 0 ? Math.min(args.limit, 100) : 30;
@@ -126,8 +139,10 @@ export function createDiscussionTool(executor) {
                     if (!args.title || typeof args.title !== 'string' || !args.title.trim()) {
                         throw new Error('create 操作必须提供 title（讨论标题）');
                     }
-                    if (!args.body || typeof args.body !== 'string' || !args.body.trim()) {
-                        throw new Error('create 操作必须提供 body（讨论正文）');
+                    const body = resolveBodySource({ inline: trimInline(args.body), file: args.body_file }, { cwd, flag: '-b' });
+                    // 判空只看解析后的权威正文：文件来源时 args.body 恒为空，拿它判定会误杀
+                    if (body.chars === 0) {
+                        throw new Error('create 操作必须提供 body 或 body_file（讨论正文）');
                     }
                     if (!args.category || typeof args.category !== 'string' || !args.category.trim()) {
                         throw new Error('create 操作必须提供 category（讨论分类，例如 "General"、"Q&A"、"Ideas"）');
@@ -135,11 +150,11 @@ export function createDiscussionTool(executor) {
                     const createCmd = [
                         'discussion', 'create',
                         '-t', args.title.trim(),
-                        '-b', args.body.trim(),
+                        ...body.argv,
                         '-c', args.category.trim(),
                         ...repoArgs,
                     ];
-                    const res = await executor.run(createCmd, { ...runOpts, rawText: true, timeoutMs: 60_000 });
+                    const res = await executor.run(createCmd, { ...runOpts, rawText: true, timeoutMs: 60_000, ...stdinPatch(body) });
                     if (!res.ok)
                         throw new Error(res.error);
                     return {
@@ -151,15 +166,15 @@ export function createDiscussionTool(executor) {
                     if (!args.discussion_number || typeof args.discussion_number !== 'number') {
                         throw new Error('edit 操作必须提供 discussion_number（讨论数字编号）');
                     }
-                    if (!args.title && !args.body) {
+                    const body = resolveBodySource({ inline: trimInline(args.body), file: args.body_file }, { cwd, flag: '-b' });
+                    if (!args.title && body.chars === 0) {
                         throw new Error('edit 操作至少需提供 title 或 body 中的一项进行修改');
                     }
                     const editCmd = ['discussion', 'edit', String(args.discussion_number), ...repoArgs];
                     if (args.title)
                         editCmd.push('-t', String(args.title).trim());
-                    if (args.body)
-                        editCmd.push('-b', String(args.body).trim());
-                    const res = await executor.run(editCmd, { ...runOpts, rawText: true, timeoutMs: 60_000 });
+                    editCmd.push(...body.argv);
+                    const res = await executor.run(editCmd, { ...runOpts, rawText: true, timeoutMs: 60_000, ...stdinPatch(body) });
                     if (!res.ok)
                         throw new Error(res.error);
                     return {
@@ -171,15 +186,16 @@ export function createDiscussionTool(executor) {
                     if (!args.discussion_number || typeof args.discussion_number !== 'number') {
                         throw new Error('comment 操作必须提供 discussion_number（讨论数字编号）');
                     }
-                    if (!args.body || typeof args.body !== 'string' || !args.body.trim()) {
-                        throw new Error('comment 操作必须提供 body（评论正文）');
+                    const body = resolveBodySource({ inline: trimInline(args.body), file: args.body_file }, { cwd, flag: '-b' });
+                    if (body.chars === 0) {
+                        throw new Error('comment 操作必须提供 body 或 body_file（评论正文）');
                     }
                     const commentCmd = [
                         'discussion', 'comment', String(args.discussion_number),
-                        '-b', args.body.trim(),
+                        ...body.argv,
                         ...repoArgs,
                     ];
-                    const res = await executor.run(commentCmd, { ...runOpts, rawText: true, timeoutMs: 60_000 });
+                    const res = await executor.run(commentCmd, { ...runOpts, rawText: true, timeoutMs: 60_000, ...stdinPatch(body) });
                     if (!res.ok)
                         throw new Error(res.error);
                     return {
@@ -191,5 +207,5 @@ export function createDiscussionTool(executor) {
                     throw new Error(`未知的 Discussion 操作: ${args.action}`);
             }
         },
-    };
+    });
 }

package/lib/tools/gist.d.ts

@@ -71,14 +71,9 @@ export declare function createGistTool(executor: GhExecutor): {
         public?: undefined;
         description?: undefined;
         success?: undefined;
+        gist_id?: undefined;
         message?: undefined;
         detail?: undefined;
-        status?: undefined;
-        action?: undefined;
-        gist_id?: undefined;
-        warning?: undefined;
-        impact?: undefined;
-        requiredAction?: undefined;
     } | {
         items?: undefined;
         count?: undefined;
@@ -92,11 +87,6 @@ export declare function createGistTool(executor: GhExecutor): {
         success?: undefined;
         message?: undefined;
         detail?: undefined;
-        status?: undefined;
-        action?: undefined;
-        warning?: undefined;
-        impact?: undefined;
-        requiredAction?: undefined;
     } | {
         items?: undefined;
         count?: undefined;
@@ -110,11 +100,6 @@ export declare function createGistTool(executor: GhExecutor): {
         description: any;
         message: string;
         detail?: undefined;
-        status?: undefined;
-        action?: undefined;
-        warning?: undefined;
-        impact?: undefined;
-        requiredAction?: undefined;
     } | {
         items?: undefined;
         count?: undefined;
@@ -128,28 +113,5 @@ export declare function createGistTool(executor: GhExecutor): {
         gist_id: string;
         message: string;
         detail: string;
-        status?: undefined;
-        action?: undefined;
-        warning?: undefined;
-        impact?: undefined;
-        requiredAction?: undefined;
-    } | {
-        items?: undefined;
-        count?: undefined;
-        rawText?: undefined;
-        filename?: undefined;
-        content?: undefined;
-        url?: undefined;
-        public?: undefined;
-        description?: undefined;
-        success?: undefined;
-        message?: undefined;
-        detail?: undefined;
-        status: string;
-        action: string;
-        gist_id: string;
-        warning: string;
-        impact: string;
-        requiredAction: string;
     }>;
 };

package/lib/tools/gist.js

@@ -1,6 +1,7 @@
+import { wrapWithGate } from '../destructive.js';
 import { renderGistMarkdown, parseGistListOutput } from '../renderers/markdown.js';
 export function createGistTool(executor) {
-    return {
+    return wrapWithGate({
         name: 'github_gist',
         description: '管理 GitHub Gist 代码片段与诊断留痕：查看 Gist 列表、检视代码正文 (view)、通过文本内容或本地文件创建新 Gist (create，默认安全 secret 模式)、编辑以及安全删除。删除操作不可逆，需 confirm: true。',
         parameters: {
@@ -58,8 +59,7 @@ export function createGistTool(executor) {
             },
         },
         async execute(args, execContext) {
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             const runOpts = { cwd, sessionId, rawText: true };
             switch (args.action) {
                 case 'list': {
@@ -161,16 +161,6 @@ export function createGistTool(executor) {
                     if (!args.gist_id) {
                         throw new Error('删除 Gist 时 `gist_id` 参数为必填项。');
                     }
-                    if (args.confirm !== true) {
-                        return {
-                            status: 'AWAITING_CONFIRMATION',
-                            action: 'delete',
-                            gist_id: String(args.gist_id),
-                            warning: `⚠️ 高危破坏性操作：即将永久删除 Gist 代码片段 "${args.gist_id}"`,
-                            impact: `删除 Gist 为物理删除，无法通过 GitHub API 恢复，所有引用该 Gist URL 的外部链接将失效并返回 404。`,
-                            requiredAction: `如确认彻底删除，请在参数中附加 \`confirm: true\` 重新调用。示例：\`github_gist(action: 'delete', gist_id: '${args.gist_id}', confirm: true)\``,
-                        };
-                    }
                     const delCmd = ['gist', 'delete', String(args.gist_id), '--yes'];
                     const res = await executor.run(delCmd, runOpts);
                     if (!res.ok)
@@ -186,5 +176,5 @@ export function createGistTool(executor) {
                     throw new Error(`不支持的 gist 操作: "${args.action}"。可选值: list, view, create, edit, delete。`);
             }
         },
-    };
+    });
 }