AI导哈

Zoho Creator自动化工具集

一个为Zoho Creator开发者提供的自动化工具集，结合Playwright MCP和Zoho MCP工具，实现数据操作和UI自定义的自动化。

  • by aathira-r-19635
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 aathira-r-19635/zoho-creator-skills

使用说明

Zoho创作者自动化技能

使用Playwright MCP和Zoho MCP工具自动化Zoho Creator的粒度代理技能的实时知识库。由Zoho Creator开发人员为Zoho Creator开发者打造。

🎯 此回购解决了什么问题

Zoho MCP为 数据操作 （记录、表格、报告），但不适用于 UI/页面定制这些技能通过向代理展示如何使用Playwright MCP自动化Zoho Creator页面构建器并进行视觉更改来弥合这一差距。

🚀 快速开始

我想。。。

…在Zoho Code IDE中设置MCP

→ Read skills/zoho-code-mcp-setup.md
→ 配置 .zcode/ai/mcp.json，激活MCP扩展，重新加载IDE

…自动化数据操作

→ Read skills/zoho-mcp-basics.md 和 skills/zoho-mcp-data-operations.md
→ 直接使用Zoho MCP工具（无需浏览器自动化）

…更改页面布局或UI

→ Read skills/playwright-zoho-login.md
→ 遵循技能依赖链→ 页面生成器→ 代码编辑器→ save

…编辑HTML代码段

→ Read skills/playwright-code-editor.md 用于CodeMirror编辑模式
→ 包括完整的查找和替换工作流程

…贡献新技能

→ Read CONTRIBUTING.md 获取完整的贡献者指南

📚 技能概述

Zoho MCP技能

技能 目的 何时使用
zoho-code-mcp-setup 在Zoho Code IDE中配置MCP 首次IDE设置
zoho-mcp-basics 列出应用程序、表单、报告、页面 获取应用程序元数据
zoho-mcp-data-operations 添加、更新、查询、删除记录 处理数据

剧作家MCP技巧

技能 目的 何时使用
playwright-zoho-login 导航到Zoho Creator并处理登录 启动任何浏览器自动化
playwright-zoho-page-builder 访问HTML代码片段编辑器 编辑页面布局
playwright-code-editor 以编程方式编辑CodeMirror内容 更改HTML/CSS/JS
playwright-zoho-save 保存更改并在实时页面上验证 完成UI更改
playwright-network-monitoring 捕获Zoho API调用 调试和学习

发展技能

技能 目的 何时使用
github-identity-enforcement 确保提交的Git标识正确 在进行任何提交之前

🔑 主要学习内容

会话保持

  • 剧作家 MCP 自动持续 浏览器会话 .playwright-mcp/
  • 登录Cookie（包括 zccpn 令牌）在会话之间保存
  • 未来的代理会自动继承活动会话，无需重新登录
  • 出于安全考虑，会话数据被忽略

CodeMirror编辑

  • HTML内容存在于 第三个CodeMirror实例 （索引2）在帧0中
  • 使用 cm.setSelection() + cm.replaceSelection() 用于精确编辑
  • UI行号从1开始；CodeMirror使用基于0的索引
  • 总是打电话 cm.focus() 在做出选择之前

节省流量（关键）

  1. 在CodeMirror中编辑内容
  2. 在代码编辑器弹出窗口中单击保存按钮
  3. 等待2秒
  4. 按Esc关闭弹出窗口
  5. 等待1秒
  6. 单击“完成”退出页面生成器
  7. 导航到实时页面以验证更改

Zoho保存API

当你保存一个HTML片段时，Zoho会调用API：

POST /appbuilder/{account}/{app}/storeFunction
Body: appLinkName=&text={encoded HTML}&zohoruntime=&zccpn=&parentPageId=&htmlviewid=&linkName=&scripttype=htmlpagemodify

🏗️ 建筑

┌─────────────────────────────────────────────────────────┐
│                    Zoho Creator                         │
├──────────────────┬──────────────────────────────────────┤
│  Zoho MCP Tools  │     Playwright MCP Tools             │
│  (Data Only)     │     (UI Automation)                  │
├──────────────────┼──────────────────────────────────────┤
│ • Get Apps       │ • Navigate to page builder           │
│ • Get Forms      │ • Click HTML Snippet                 │
│ • Get Reports    │ • Open CodeMirror editor             │
│ • Add Records    │ • Edit code via CodeMirror API       │
│ • Update Records │ • Save via button click or API       │
│ • Delete Records │ • Verify on live page                │
│ • Get Fields     │                                      │
│ • Approvals      │                                      │
└──────────────────┴──────────────────────────────────────┘

📖 文档

文件 目的
AGENTS.md AI代理的快速参考-请先阅读此内容
CONTRIBUTING.md 完整的开发者贡献者指南
docs/zoho-creator-automation.md 端到端自动化工作流程
skills/*.md 个人精细技能

🤝 贡献

这是一个 活体储存库 它与Zoho Creator生态系统一起发展。随着Zoho Creator MCP添加新工具，技能也在更新，新的技能也在添加。

如何做出贡献

  1. 阅读 CONTRIBUTING.md 获取完整指南
  2. 为您的更改创建功能分支
  3. 使用经过测试的工作示例添加或更新技能文件
  4. 提交PR以供审核

我们所需要的

  • ✅ 新的自动化模式和工作流程
  • ✅ Zoho Creator UI更改时的更新
  • ✅ 发布新MCP工具时的简化
  • ✅ 常见问题的故障排除指南
  • ✅ 最佳实践和性能优化

🔄 MCP演进

Zoho Creator MCP正在迅速发展。随着新工具的添加：

  • 一些Playwright浏览器自动化步骤可能变得不必要
  • 数据操作变得更简单
  • 新功能出现

我们积极维护此回购，以：

  • 当有更好的工具可用时，简化技能
  • 弃用过时的方法
  • 文档从旧方法到新方法的转换
  • 保持一切最新状态并经过测试

⚙️ 开发人员设置

# Clone the repo
git clone https://github.com/aathira-r-19635/zoho-creator-skills.git
cd zoho-creator-skills

# Configure your corporate Git identity
git config --local user.name "your-github-username"
git config --local user.email "your.email@zohocorp.com"

# Verify setup
git config user.name
git config user.email
git remote -v

重要：仅使用您的公司Zoho GitHub帐户进行提交。不应使用个人账户。

📊 仓库结构

zoho-creator-skills/
├── AGENTS.md                    # Agent quick reference
├── CONTRIBUTING.md              # Contributor guide
├── README.md                    # This file
├── docs/
│   └── zoho-creator-automation.md  # End-to-end workflows
└── skills/
    ├── playwright-zoho-login.md      # Login & session management
    ├── playwright-zoho-page-builder.md  # Page builder navigation
    ├── playwright-code-editor.md     # CodeMirror editing
    ├── playwright-zoho-save.md       # Save & verify
    ├── playwright-network-monitoring.md  # API monitoring
    ├── zoho-code-mcp-setup.md        # Zoho Code IDE MCP configuration
    ├── zoho-mcp-basics.md            # Zoho MCP overview
    ├── zoho-mcp-data-operations.md   # Record operations
    └── github-identity-enforcement.md  # Git identity rules

💡 成功秘诀

  1. 从AGENTS.md开始 -它有最快的方法来提高生产力
  2. 按顺序阅读技能 -他们相互依存
  3. 测试一切 -不要想当然，要验证每一步
  4. 记录你学到的东西 -未来的开发人员（和代理商）会感谢你的
  5. 保持最新状态 -工具或UI更改时更新技能

🆘 故障排除

有问题吗？查看这些常见解决方案：

问题 解决方案
重定向到登录 会话已过期-手动登录，然后继续
CodeMirror内容为空 实例错误-使用索引2（第三个编辑器）
点击被覆盖层阻挡 删除 .zc-freezer 元素通过JavaScript
更改不会持久 请确保在退出之前单击了“保存”
找不到元素 捕获新鲜元素 browser_snapshot

有关详细的故障排除，请参阅 docs/zoho-creator-automation.md.

📝 许可和使用

此存储库由Zoho Creator开发人员为Zoho Creator开发者维护。使用它，从中学习，并做出贡献！

自动化快乐！ 🚀

相关 MCP