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()在做出选择之前
节省流量（关键）
- 在CodeMirror中编辑内容
- 在代码编辑器弹出窗口中单击保存按钮
- 等待2秒
- 按Esc关闭弹出窗口
- 等待1秒
- 单击“完成”退出页面生成器
- 导航到实时页面以验证更改
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添加新工具，技能也在更新，新的技能也在添加。
如何做出贡献
- 阅读
CONTRIBUTING.md获取完整指南 - 为您的更改创建功能分支
- 使用经过测试的工作示例添加或更新技能文件
- 提交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💡 成功秘诀
- 从AGENTS.md开始 -它有最快的方法来提高生产力
- 按顺序阅读技能 -他们相互依存
- 测试一切 -不要想当然，要验证每一步
- 记录你学到的东西 -未来的开发人员（和代理商）会感谢你的
- 保持最新状态 -工具或UI更改时更新技能
🆘 故障排除
有问题吗？查看这些常见解决方案：
| 问题 | 解决方案 |
|---|---|
| 重定向到登录 | 会话已过期-手动登录，然后继续 |
| CodeMirror内容为空 | 实例错误-使用索引2（第三个编辑器） |
| 点击被覆盖层阻挡 | 删除 .zc-freezer 元素通过JavaScript |
| 更改不会持久 | 请确保在退出之前单击了“保存” |
| 找不到元素 | 捕获新鲜元素 browser_snapshot |
有关详细的故障排除，请参阅 docs/zoho-creator-automation.md.
📝 许可和使用
此存储库由Zoho Creator开发人员为Zoho Creator开发者维护。使用它，从中学习，并做出贡献！
自动化快乐！ 🚀