openyida AGENTS.md

A developer guide for OpenYida, a command-line tool that lets AI control the Yida low-code platform for building apps, managing forms, and publishing pages.

In plain words
What is it for?
Working on OpenYida commands, its Python and Vue code, platform integrations, database migrations, tests, and Git workflows.
Why use it?
It gives an AI coding assistant the project structure, technology choices, testing rules, and collaboration requirements needed to make appropriate changes.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/openyida/openyida/agents-md
Clone the repo
git clone --depth 1 https://github.com/openyida/openyida

Made for: Codex, OpenCode.

Per session 5,810 This file is loaded in full into every session.
When invoked 5,810 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.05810 $0.05810
Opus 5 $0.02905 $0.02905
Sonnet 5 $0.01162 $0.01162
Haiku 4.5 $0.00581 $0.00581

Measured 2d ago against content hash 5e7c22b8c819, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

openyida AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

│ │ ├── curl-parser.js # cURL 命令解析
AGENTS.md · 263 lines

How it starts

The opening of the file, as written. The whole thing — 263 lines — stays where its author put it; the contents beside it link to each section on GitHub.

OpenYida — AI Agent 开发指引

本文件为 AI 编程助手(Codex、Claude Code、Cursor、OpenCode、Qoder 等)提供项目上下文,帮助 AI 更准确地理解项目结构和开发规范。

项目简介

OpenYida 是一个 CLI 工具,让开发者通过 AI 对话驱动宜搭低代码平台,实现应用的创建、表单管理、页面发布等全流程操作。

核心定位:AI 编程工具 × 宜搭低代码平台 的桥接层。

项目结构

openyida/
├── bin/
│   └── yida.js              # CLI 入口,解析命令并路由到 lib/
├── lib/
│   ├── core/                # 核心基础模块
│   │   ├── utils.js         # 公共工具函数(Token、HTTP、路径等)
│   │   ├── chalk.js         # 终端彩色输出公共样式模块(统一 chalk 风格)
│   │   ├── i18n.js          # 国际化支持
│   │   ├── locales/         # 语言包(zh、en、zh-HK、ja、ko、fr、de、es、pt、ar、hi、vi)
│   │   ├── env.js           # 检测 AI 工具环境(Codex/Claude/Cursor/Copilot/Qoder/千问办公 等)
│   │   ├── env-cmd.js       # env 命令入口(显示当前环境信息)
│   │   ├── env-manager.js   # 多环境配置管理(私有化部署多环境切换)
│   │   ├── copy.js          # 初始化 project 工作目录
│   │   ├── sample.js        # sample 命令(输出代码示例到工作目录)
│   │   ├── check-update.js  # npm registry 版本查询与 SemVer 比较
│   │   ├── check-data.js    # 数据异常检测(流程表单数据校验)
│   │   ├── update.js        # npm 全局安装的 24h 自动更新与手动 self-update
│   │   ├── doctor.js        # 环境诊断与自动修复
│   │   ├── query-data.js    # 统一数据管理命令(表单/流程/任务/子表单)
│   │   ├── task-center.js   # 全局任务中心(待办/我创建的/我已处理/抄送/代提交)
│   │   └── babel-transform/ # Babel 编译器(用于自定义页面)
│   ├── auth/                # 登录认证模块
│   │   ├── token-auth.js    # OAuth loopback + token 登录态管理
│   │   ├── token-store.js   # 本地 token session 存储
│   │   ├── oauth-loopback.js # OAuth 回调监听与授权码换取
│   │   └── org.js           # 组织管理(列出/切换组织)
│   ├── basic-info/          # 企业基础信息查询(版本 / 授权 / 域名)
│   │   └── basic-info.js    # 企业版本、授权信息与域名管理
│   ├── bridge/              # 浏览器桥接服务(本地 HTTP 代理连接宜搭页面)
│   │   └── bridge.js        # Bridge HTTP 服务器(本地代理 + 页面唤起)
│   ├── samples/             # 代码示例/模板(通过 openyida sample 命令输出到工作目录)
│   │   ├── yida-chart/            # ECharts 图表示例(7个)
│   │   ├── yida-custom-page/      # 自定义页面模板(2个)
│   │   ├── yida-create-app/       # 应用创建模板(1个)
│   │   ├── yida-data-management/  # 表单字段模板(1个)
│   │   ├── yida-density/          # 密度切换示例(1个)
│   │   └── yida-table-form/       # 表格表单示例(1个)
│   ├── a2a/                 # A2A 协议服务器(Agent-to-Agent HTTP 通信)
│   │   ├── cmd.js           # a2a 命令入口(参数解析与启动)
│   │   └── server.js        # A2A HTTP 服务实现(JSON-RPC 路由)
│   ├── agent-center/        # 智能代理任务中心(代理人任务管理)
│   │   ├── agent-center.js  # 代理人任务命令(创建/更新/取消/查询)
│   │   └── api.js           # 代理人 API 请求封装
│   ├── aggregate-table/     # 聚合表管理(虚拟视图 / 聚合表单)
│   │   └── aggregate-table.js # 聚合表创建与配置
│   ├── ai/                  # AI 能力(文生文 / 识图)
│   │   └── ai.js            # AI 命令入口(txtFromAI / 图片识别)
│   ├── app/                 # 应用 / 表单 / 页面管理
│   │   ├── app-list.js      # yida-app-list:查询我的应用列表(名称/appType/地址)
│   │   ├── create-app.js    # 创建宜搭应用
│   │   ├── create-page.js   # 创建自定义展示页面
│   │   ├── create-form.js   # 创建 / 更新表单页面
│   │   ├── get-schema.js    # 获取表单 Schema
│   │   ├── generate-page.js # 基于模板生成自定义页面源码
│   │   ├── check-page.js    # 自定义页面规范检查
│   │   ├── compile.js       # 本地编译自定义页面
│   │   ├── publish.js       # 编译并发布自定义页面(Babel 转译)
│   │   ├── export-app.js    # 导出应用(生成迁移包)
│   │   ├── import-app.js    # 导入迁移包,重建应用
│   │   └── update-form-config.js  # 更新表单配置
│   ├── app-permission/      # 应用权限管理(管理员角色配置)
│   │   └── app-permission.js # 应用管理员角色分配(主管理/数据/应用管理员)
│   ├── page-config/         # 页面公开访问 / 分享配置
│   │   ├── verify-short-url.js    # 验证短链接 URL
│   │   ├── save-share-config.js   # 保存公开访问 / 分享配置
│   │   └── get-page-config.js     # 查询页面公开访问 / 分享配置
│   ├── permission/          # 表单权限管理
│   │   ├── get-permission.js      # 查询表单权限配置
│   │   └── save-permission.js     # 保存表单权限配置
│   ├── process/             # 流程管理
│   │   ├── configure-process.js   # 配置并发布流程规则
│   │   ├── create-process.js      # 创建流程表单(一体化)
│   │   └── preview-process.js     # 流程预览(可视化流程图 + 高亮当前节点)
│   ├── conversation/        # AI 对话管理
│   │   ├── collector.js     # 对话记录收集
│   │   ├── formatter.js     # 对话格式化
│   │   └── export-conversation.js  # 导出对话记录
│   ├── feedback/            # 体验反馈收集(表单化反馈提交)
│   │   └── feedback.js      # 反馈表单创建与提交(自动检测 AI 工具环境)
│   ├── flash-note/          # 闪记转 PRD
│   │   └── flash-to-prd.js  # 闪记转高质量 prompt(支持会议识别)
│   ├── formula/             # 公式求值引擎(宜搭公式本地计算)
│   │   └── evaluate.js      # 宜搭公式解析与求值(支持 60+ 内置函数)
│   ├── dingtalk/            # 钉钉链接生成(AppLink / 页面链接构建)
│   │   └── dingtalk-link.js # 钉钉 AppLink URL 与页面链接生成
│   ├── dws/                 # 钉钉 CLI 集成
│   │   └── dws-wrapper.js   # 钉钉 CLI 包装器(通讯录/日历/待办/审批等)
│   ├── i18n-management/     # 应用多语言管理(语言包配置)
│   │   └── i18n-management.js # 应用级多语言资源管理(12 种语言)
│   ├── integration/         # 集成 & 自动化
│   │   └── integration-create.js  # 创建集成逻辑流
│   ├── connector/           # HTTP 连接器管理
│   │   ├── api.js                 # 连接器 API 请求封装
│   │   ├── connector-list.js
│   │   ├── connector-create.js
│   │   ├── connector-detail.js
│   │   ├── connector-delete.js
│   │   ├── connector-add-action.js
│   │   ├── connector-list-actions.js
│   │   ├── connector-delete-action.js
│   │   ├── connector-test.js
│   │   ├── connector-list-connections.js
│   │   ├── connector-create-connection.js
│   │   ├── connector-smart-create.js
│   │   ├── connector-parse-api.js
│   │   ├── connector-gen-template.js
│   │   ├── curl-parser.js         # cURL 命令解析
│   │   ├── doc-parser.js          # API 文档解析
│   │   ├── response-parser.js     # 响应结构解析
│   │   ├── action-generator.js    # Action 自动生成
│   │   └── desc-generator.js      # 描述自动生成
│   ├── corp-efficiency/     # 企业效能分析(平台管理效能指标)
│   │   └── corp-efficiency.js # 效能概览 / 详情 / 分组 / 通知
│   ├── corp-manager/        # 平台权限管理(管理员 / 通讯录可见性)
│   │   ├── api.js           # 管理员与通讯录 API 封装
│   │   └── corp-manager.js  # 管理员增删查 / 通讯录可见性配置
│   ├── cdn/                 # CDN / OSS 管理
│   │   ├── cdn-config.js          # CDN 配置读写
│   │   ├── cdn-config-cmd.js      # CDN 配置命令
│   │   ├── cdn-upload.js          # 上传图片到 OSS/CDN
│   │   └── cdn-refresh.js         # 刷新 CDN 缓存
│   ├── mcp/                 # MCP 协议服务器(Model Context Protocol)
│   │   └── server.js        # MCP JSON-RPC 服务实现(工具注册与调用)
│   ├── report/              # 宜搭报表管理
│   │   ├── create-report.js       # 创建报表(入口)
│   │   ├── index.js               # 创建报表主流程
│   │   ├── append.js              # 向已有报表追加图表
│   │   ├── chart-builder.js       # 图表 Schema 构建
│   │   ├── http.js                # 报表 HTTP 请求封装
│   │   └── constants.js           # 常量与 ID 生成工具
│   ├── db/                  # 数据库工具
│   │   └── db-seq-fix.js          # PostgreSQL Sequence 自动修复(解决主键序列漂移)
├── project/
│   ├── config.json          # 应用配置(appType、pageId 等)
│   └── pages/               # 自定义页面源码目录
├── yida-skills/
│   ├── SKILL.md             # 源码态技能入口(索引表,列出所有子技能)
│   ├── skills/              # 子技能目录(每个 skill 自包含 SKILL.md + references/)
│   └── references/           # 跨 skill 共享参考文档(yida-api、model-api、query-condition-guide)
└── scripts/
    ├── postinstall.js       # 安装后脚本(环境检测 + 配置注入)
    ├── e2e-real/            # 真实环境确定性 CLI 链路测试(runner/full-runner/skill-coverage/cleanup)
    ├── eval/               # Skill 测评 harness(路由测评 + 端到端截图打分),见下文
    ├── validate-ci.sh       # CI 校验脚本
    └── validate-structure.js # 项目结构校验

Read the full file on GitHub · 263 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 263 lines · 5,810 tokens per session scan A 5e7c22b8c819

Subscribe to this mod's changes

openyida AGENTS.md is an instructions file published in the GitHub repository openyida/openyida (208 stars, last pushed 2d ago), licensed MIT. It adds 5,810 tokens to every session, about $0.0290 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.