openyida 2026.7.26-beta.3 → 2026.7.27-beta.1

package/README.md

@@ -414,6 +414,8 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida data <action> <resource> [args]` | Unified data management (form/process/task/subform) |
 | `openyida task-center <type> [options]` | Global task center (todo/processed/cc etc.) |
 | `openyida basic-info <overview\|commodity\|grant\|capacity\|quota\|abs-path\|dataflow\|i18n\|domain>` | Query organization basic info, capacity, quotas, and domain settings |
+| `openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]` | Fetch Markdown content from a DingTalk document |
+| `openyida read-dingtalk-tingji <taskUuid> [--json]` | Fetch DingTalk Tingji details by task UUID |
 | `openyida get-permission <appType> <formUuid>` | Query form permission config |
 | `openyida save-permission <appType> <formUuid> ...` | Save form permission config |
 | `openyida corp-manager <search-user\|list\|add\|remove\|address-book> ...` | Manage platform admins and address book permissions |

package/bin/yida.js

@@ -869,6 +869,18 @@ async function main() {
       break;
     }
 
+    case 'read-dingtalk-doc': {
+      const { run } = require('../lib/document/document-markdown');
+      await run(args);
+      break;
+    }
+
+    case 'read-dingtalk-tingji': {
+      const { run } = require('../lib/document/tingji');
+      await run(args);
+      break;
+    }
+
     case 'doctor': {
       const { run } = require('../lib/core/doctor');
       await run(args);

package/lib/core/command-manifest.js

@@ -402,9 +402,17 @@ const COMMAND_SIDE_EFFECTS = new Map([
     'integration.list',
     'list-forms',
     'process.preview',
+    'read-dingtalk-tingji',
     'verify-short-url',
   ], sideEffect('remote_read')),
 
+  ['read-dingtalk-doc', sideEffect('mixed', {
+    mutates_yida: false,
+    mutates_local: true,
+    read_actions: ['<docUrl>', '<docUrl> --json'],
+    mutating_actions: ['<docUrl> --output <file>', '<docUrl> -o <file>'],
+  })],
+
   ['asset', sideEffect('mixed', {
     mutates_yida: false,
     mutates_local: true,
@@ -620,11 +628,24 @@ const COMMAND_PERMISSIONS = new Map([
     'integration.list',
     'list-forms',
     'process.preview',
+    'read-dingtalk-tingji',
     'verify-short-url',
   ], permission('allow', 'read', {
     reason: 'Read-only, diagnostic, validation, or manifest discovery command.',
   })),
 
+  ['read-dingtalk-doc', actionDependentPermission({
+    preauthorized_actions: [
+      '<docUrl> --output <file>',
+      '<docUrl> -o <file>',
+    ],
+    preauthorized_patterns: [{
+      type: 'argv_contains_any',
+      values: ['http://', 'https://'],
+      description: 'A valid document URL is present; optional output writes are non-destructive local operations.',
+    }],
+  })],
+
   ...permissionEntries([
     'eval',
   ], actionDependentPermission({
@@ -1038,6 +1059,12 @@ const COMMAND_GROUPS = [
       command('basic-info', ['basic-info'], 'basic-info <overview|commodity|grant|capacity|quota|abs-path|dataflow|i18n|domain>', 'help.cmd_basic_info', {
         output: 'json',
       }),
+      command('read-dingtalk-doc', ['read-dingtalk-doc'], 'read-dingtalk-doc <docUrl> [--output <file>] [--json]', 'help.cmd_read_dingtalk_doc', {
+        output: 'text|json',
+      }),
+      command('read-dingtalk-tingji', ['read-dingtalk-tingji'], 'read-dingtalk-tingji <taskUuid> [--json]', 'help.cmd_read_dingtalk_tingji', {
+        output: 'json',
+      }),
       command('get-permission', ['get-permission'], 'get-permission <appType> <formUuid>', 'help.cmd_get_permission'),
       command('save-permission', ['save-permission'], 'save-permission <appType> <formUuid> ...', 'help.cmd_save_permission'),
       command('corp-manager', ['corp-manager'], 'corp-manager <search-user|list|add|remove|address-book> ...', 'help.cmd_corp_manager', { output: 'json' }),

package/lib/core/locales/en.js

@@ -47,6 +47,8 @@ module.exports = {
     cmd_data: 'Unified data management (form/process/task/subform)',
     cmd_task_center: 'Global task center (todo/processed/cc etc.)',
     cmd_basic_info: 'Query organization basic info, capacity, quotas, and domain settings',
+    cmd_read_dingtalk_doc: 'Fetch Markdown content from a DingTalk document',
+    cmd_read_dingtalk_tingji: 'Fetch DingTalk Tingji details by task UUID',
     cmd_get_permission: 'Query form permission config',
     cmd_save_permission: 'Save form permission config',
     cmd_corp_manager: 'Manage platform admins and address book permissions',

package/lib/core/locales/zh.js

@@ -47,6 +47,8 @@ module.exports = {
     cmd_data: '统一数据管理（表单/流程/任务/子表单）',
     cmd_task_center: '全局任务中心（待办/已处理/抄送等）',
     cmd_basic_info: '查询组织基本信息、容量、额度和域名设置',
+    cmd_read_dingtalk_doc: '获取钉钉文档的 Markdown 内容',
+    cmd_read_dingtalk_tingji: '按任务 UUID 获取钉钉听记详情',
     cmd_get_permission: '查询表单权限配置',
     cmd_save_permission: '保存表单权限配置',
     cmd_corp_manager: '管理平台管理员与通讯录权限',

package/lib/core/utils.js

@@ -916,6 +916,18 @@ async function httpGet(baseUrl, requestPath, queryParams, cookiesOrOptions, mayb
           });
           return;
         }
+        if (optionsOverride.responseType === 'text') {
+          if (Number(res.statusCode) < 200 || Number(res.statusCode) >= 300) {
+            resolve({
+              success: false,
+              errorMsg: `HTTP ${res.statusCode}`,
+              __httpStatus: res.statusCode,
+            });
+            return;
+          }
+          resolve(data);
+          return;
+        }
         try {
           const parsed = JSON.parse(data);
           if (isLoginExpired(parsed)) {

package/lib/document/document-markdown.js

@@ -0,0 +1,113 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { createAuthRef, createYidaClient } = require('../core/yida-client');
+const { throwUsage } = require('../core/command-errors');
+
+const API_PATH = '/query/document/markdown.json';
+
+function parseArgs(args) {
+  const parsed = { docUrl: '', output: '', json: false, help: false };
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index];
+    if (arg === '--help' || arg === '-h') {
+      parsed.help = true;
+    } else if (arg === '--json') {
+      parsed.json = true;
+    } else if ((arg === '--output' || arg === '-o') && args[index + 1]) {
+      parsed.output = args[++index];
+    } else if (!arg.startsWith('--') && !parsed.docUrl) {
+      parsed.docUrl = arg;
+    } else {
+      throwUsage('Usage: openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]');
+    }
+  }
+  return parsed;
+}
+
+function validateDocUrl(docUrl) {
+  if (!docUrl) {
+    throwUsage('Usage: openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]');
+  }
+  let parsed;
+  try {
+    parsed = new URL(docUrl);
+  } catch {
+    throw new Error('docUrl must be a valid HTTP(S) URL');
+  }
+  if (!['http:', 'https:'].includes(parsed.protocol)) {
+    throw new Error('docUrl must be a valid HTTP(S) URL');
+  }
+  return parsed.toString();
+}
+
+function unwrapMarkdownResponse(response) {
+  if (typeof response !== 'string') {
+    const detail = response && (response.errorMsg || response.message);
+    throw new Error(detail || 'Failed to fetch document Markdown');
+  }
+
+  const trimmed = response.trim();
+  if (!trimmed.startsWith('{')) {
+    return response;
+  }
+
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return response;
+  }
+
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    return response;
+  }
+  if (parsed.success === false) {
+    throw new Error(parsed.errorMsg || parsed.message || 'Failed to fetch document Markdown');
+  }
+  if (typeof parsed.content === 'string') {
+    return parsed.content;
+  }
+  return response;
+}
+
+async function fetchDocumentMarkdown(docUrl, options = {}) {
+  const authRef = options.authRef || createAuthRef();
+  const client = options.client || createYidaClient({ authRef });
+  const response = await client.get(API_PATH, { docUrl: validateDocUrl(docUrl) }, {
+    responseType: 'text',
+    timeout: options.timeout || 300000,
+  });
+  return unwrapMarkdownResponse(response);
+}
+
+async function run(args) {
+  const parsed = parseArgs(args);
+  if (parsed.help) {
+    console.log('Usage: openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]');
+    return { help: true };
+  }
+  const docUrl = validateDocUrl(parsed.docUrl);
+  const content = await fetchDocumentMarkdown(docUrl);
+  if (parsed.output) {
+    const outputPath = path.resolve(parsed.output);
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, content, 'utf8');
+    const result = { success: true, docUrl, output: outputPath, length: content.length };
+    console.log(JSON.stringify(result, null, 2));
+    return result;
+  }
+  const result = { success: true, docUrl, content };
+  console.log(parsed.json ? JSON.stringify(result, null, 2) : content);
+  return result;
+}
+
+module.exports = {
+  API_PATH,
+  parseArgs,
+  validateDocUrl,
+  unwrapMarkdownResponse,
+  fetchDocumentMarkdown,
+  run,
+};

package/lib/document/tingji.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const { createAuthRef, createYidaClient } = require('../core/yida-client');
+const { throwUsage } = require('../core/command-errors');
+
+const API_PATH = '/query/document/tingji.json';
+
+function parseArgs(args) {
+  const parsed = { taskUuid: '', help: false };
+  for (const arg of args) {
+    if (arg === '--help' || arg === '-h') {
+      parsed.help = true;
+    } else if (arg === '--json') {
+      continue;
+    } else if (!arg.startsWith('--') && !parsed.taskUuid) {
+      parsed.taskUuid = arg;
+    } else {
+      throwUsage('Usage: openyida read-dingtalk-tingji <taskUuid> [--json]');
+    }
+  }
+  return parsed;
+}
+
+function validateTaskUuid(taskUuid) {
+  const normalized = String(taskUuid || '').trim();
+  if (!normalized) {
+    throwUsage('Usage: openyida read-dingtalk-tingji <taskUuid> [--json]');
+  }
+  if (normalized.length > 256 || /[\r\n]/.test(normalized)) {
+    throw new Error('taskUuid is invalid');
+  }
+  return normalized;
+}
+
+async function fetchTingjiDetail(taskUuid, options = {}) {
+  const authRef = options.authRef || createAuthRef();
+  const client = options.client || createYidaClient({ authRef });
+  const response = await client.get(API_PATH, { taskUuid: validateTaskUuid(taskUuid) }, {
+    timeout: options.timeout || 300000,
+  });
+  if (!response || response.success === false || response.__needLogin || response.__csrfExpired) {
+    const detail = response && (response.errorMsg || response.message);
+    throw new Error(detail || 'Failed to fetch Tingji detail');
+  }
+  return response.content !== undefined ? response.content : response;
+}
+
+async function run(args) {
+  const parsed = parseArgs(args);
+  if (parsed.help) {
+    console.log('Usage: openyida read-dingtalk-tingji <taskUuid> [--json]');
+    return { help: true };
+  }
+  const taskUuid = validateTaskUuid(parsed.taskUuid);
+  const detail = await fetchTingjiDetail(taskUuid);
+  const result = { success: true, taskUuid, detail };
+  console.log(JSON.stringify(result, null, 2));
+  return result;
+}
+
+module.exports = { API_PATH, parseArgs, validateTaskUuid, fetchTingjiDetail, run };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.7.26-beta.3",
+  "version": "2026.7.27-beta.1",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",

package/yida-skills/SKILL.md

@@ -167,13 +167,15 @@ OpenYida builder 默认使用 `create-app / create-form / create-page / generate
 | `yida-skills/integration` | 连接器、外部 API、执行动作、设计器数据源、集成自动化、逻辑流 | `yida-integration`、`yida-connector`、`yida-connector-safe-actions`、`yida-data-source-connectors` |
 | `yida-skills/access` | 平台/应用/表单/页面权限、公开访问、分享 | `yida-corp-manager`、`yida-app-permission`、`yida-form-permission`、`yida-page-config` |
 | `yida-skills/ops` | Sequence、主键冲突、VOC 反馈 | `yida-db-seq-fix`、`yida-voc` |
-| `yida-skills/agent` | 导出对话、会议纪要/闪记转 PRD | `yida-export-conversation`、`yida-flash-note-to-prd` |
+| `yida-skills/agent` | 导出对话、读取钉钉文档/听记、会议纪要/闪记转 PRD | `yida-export-conversation`、`yida-document-markdown`、`yida-tingji`、`yida-flash-note-to-prd` |
 
 ### 高频分歧
 
 | 用户意图 | 选哪个 |
 |------|------|
 | 从零搭一个完整应用/系统 | `yida-app`；默认 `fast_build`，不要自动升级到深度设计 |
+| 读取钉钉在线文档正文 | `yida-document-markdown`，使用登录态接口获取 Markdown |
+| 按 taskUuid 读取钉钉听记 | `yida-tingji`，将听记任务 ID 原样传入命令 |
 | 只创建应用壳并拿 appType | `yida-create-app` |
 | 创建自定义展示页资源 | `yida-create-page`，之后默认接 `yida-canvas-custom-page` 和 `yida-publish-page` |
 | 开发表单字段结构 / 增删改字段 | `yida-create-form-page` |

package/yida-skills/skills/yida-document-markdown/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: yida-document-markdown
+description: 获取钉钉文档、钉钉在线文档或知识库文档的完整 Markdown 内容。用户提供文档链接并要求读取、提取、总结或继续处理文档内容时使用。
+---
+
+# 获取钉钉文档 Markdown
+
+## 严格要求 (MUST DO)
+
+- 使用 `openyida read-dingtalk-doc "<docUrl>"` 读取文档内容
+- 将用户提供的钉钉文档 URL 原样传给 `docUrl` 参数
+- 仅基于命令返回的 Markdown 执行总结、转 PRD 或其他下游任务
+
+## 命令
+
+```bash
+openyida read-dingtalk-doc "<docUrl>"
+openyida read-dingtalk-doc "<docUrl>" --json
+openyida read-dingtalk-doc "<docUrl>" --output ./document.md
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `docUrl` | 是 | 可访问的钉钉文档 HTTP(S) 链接 |
+| `--json` | 否 | 输出包含原始链接和 Markdown 的 JSON |
+| `--output`, `-o` | 否 | 将 Markdown 写入指定文件；若文件已存在则覆盖 |
+
+## 执行流程
+
+1. 确认用户已提供文档链接。
+2. 默认运行 `openyida read-dingtalk-doc "<docUrl>"` 获取纯 Markdown；需要结构化结果时使用 `--json`。
+3. 仅在用户要求保存文件或后续任务需要文件输入时使用 `--output`，并明确告知写入路径。
+4. 检查命令成功结果，再按用户要求处理 Markdown。
+
+## 异常处理
+
+| 场景 | 处理方式 |
+|------|----------|
+| 未登录或登录失效 | 运行 `openyida auth status`，必要时执行 `openyida login` |
+| 400 | 检查 `docUrl` 是否为空或格式错误 |
+| 文档无权限或不存在 | 请用户确认当前钉钉账号权限与链接有效性 |
+| 请求超时 | 稍后重试；文档转换最长可能等待 300 秒 |
+
+## 完成标准
+
+命令成功返回非推测的 Markdown 内容，或成功写入用户指定文件。

package/yida-skills/skills/yida-tingji/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: yida-tingji
+description: 按 taskUuid 获取钉钉听记、会议录音转写、会议纪要或 AI 听记的完整详情。用户提供听记任务 ID 并要求读取、整理、总结或转 PRD 时使用。
+---
+
+# 获取钉钉听记详情
+
+## 严格要求 (MUST DO)
+
+- 使用 `openyida read-dingtalk-tingji "<taskUuid>"` 读取听记详情
+- 将用户提供的 `taskUuid` 原样传入，不自行转换或校验其格式
+- 读取成功后，根据用户要求提取会议摘要、关键决策、行动项或生成 PRD
+- 默认不要在回复中展示带签名参数的资源 URL；用户明确要求原始结果时再输出完整 JSON
+
+## 命令
+
+```bash
+openyida read-dingtalk-tingji "<taskUuid>"
+openyida read-dingtalk-tingji "<taskUuid>" --json
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `taskUuid` | 是 | 钉钉听记任务 ID，按原值传入 |
+| `--json` | 否 | 显式声明 JSON 输出；当前命令默认即为 JSON |
+
+## 执行流程
+
+1. 从用户输入或听记链接上下文中取得准确的 `taskUuid`；无法确定时请用户补充。
+2. 运行 `openyida read-dingtalk-tingji "<taskUuid>" --json`。
+3. 检查成功结果，再按用户要求提取会议摘要、发言内容、决策或待办。
+
+## 异常处理
+
+| 场景 | 处理方式 |
+|------|----------|
+| 未登录或登录失效 | 运行 `openyida auth status`，必要时执行 `openyida login` |
+| 400 | 检查 `taskUuid` 是否为空 |
+| 听记无权限或不存在 | 请用户确认当前钉钉账号权限和 `taskUuid` |
+| 请求超时 | 稍后重试；接口最长可能等待 300 秒 |
+
+## 完成标准
+
+命令成功返回指定 `taskUuid` 对应的真实听记详情。

package/yida-skills/skills-index.json

@@ -89,6 +89,30 @@
         "基础信息"
       ]
     },
+    {
+      "name": "yida-document-markdown",
+      "path": "skills/yida-document-markdown/SKILL.md",
+      "display_name": "钉钉文档 Markdown",
+      "description": "获取钉钉文档、钉钉在线文档或知识库文档的完整 Markdown 内容。用户提供文档链接并要求读取、提取、总结或继续处理文档内容时使用。",
+      "category": "yida-skills/agent",
+      "tags": ["钉钉文档", "Markdown", "文档链接", "内容提取"],
+      "aliases": ["读取钉钉文档", "文档转 Markdown"],
+      "command_ids": ["read-dingtalk-doc"],
+      "done_when": "命令成功返回真实 Markdown 内容，或成功写入指定文件。",
+      "requires_login": true
+    },
+    {
+      "name": "yida-tingji",
+      "path": "skills/yida-tingji/SKILL.md",
+      "display_name": "钉钉听记详情",
+      "description": "按 taskUuid 获取钉钉听记、会议录音转写、会议纪要或 AI 听记的完整详情。用户提供听记任务 ID 并要求读取、整理、总结或转 PRD 时使用。",
+      "category": "yida-skills/agent",
+      "tags": ["钉钉听记", "会议纪要", "taskUuid", "语音转写"],
+      "aliases": ["读取听记", "获取会议记录"],
+      "command_ids": ["read-dingtalk-tingji"],
+      "done_when": "命令成功返回指定 taskUuid 对应的真实听记详情。",
+      "requires_login": true
+    },
     {
       "name": "yida-business-rule",
       "path": "skills/yida-business-rule/SKILL.md",
@@ -1159,6 +1183,11 @@
       "description": "非宜搭业务资源本身的 agent 辅助能力：导出对话、会议/闪记转 PRD。",
       "signals": [
         "导出对话",
+        "钉钉文档",
+        "读取文档",
+        "Markdown 内容",
+        "钉钉听记",
+        "taskUuid",
         "会议纪要",
         "闪记",
         "PRD"