ioto-update AGENTS.md

IOTO Update 插件 - AI Agent 开发指南

项目概述

IOTO Update 是一个 Obsidian 插件，用于在 Obsidian 内部更新 IOTO 框架、部署 AI Agent 技能、安装配套插件以及同步个人模板。版本号为 2.2.5。

主要功能模块

1. IOTO 框架更新：从 Airtable/NocoDB 同步核心文件、帮助文档、MYIOTO 模板、CSS 代码片段、设置插件到 Vault
2. 一键部署：单命令执行所有框架更新
3. AI Agent 技能部署：将技能部署到指定平台（TRAE、Claude Code、OpenCode、OpenAI Codex、Mimo Code、Hermes）
4. 个人同步模板：从用户个人 Airtable 拉取自定义同步模板
5. 插件安装：从 GitHub/Gitee 直接安装 IOTO 生态配套插件
6. 自更新：在设置面板检查并安装插件新版本

---

技术栈

类别	技术	版本 / 说明
语言	TypeScript	4.7.4
构建工具	esbuild	0.17.3
目标运行时	ES2018 (CommonJS)
平台 API	Obsidian Plugin API	latest，minAppVersion: 0.15.0
类型检查	ESLint + @typescript-eslint	5.29.0
额外依赖	@popperjs/core	^2.11.8
国际化	moment.locale() + 字典文件	英/简中/繁中

构建脚本（package.json）

npm run dev      # 开发模式：esbuild watch 模式，输出 main.js 含内联 sourcemap
npm run build    # 生产构建：tsc 类型检查 + esbuild 压缩打包
npm run version  # 版本号自增并写入 manifest.json / versions.json

---

目录结构

ioto-update/
├── src/
│   ├── main.ts                      # 插件入口，IOTOUpdate 类
│   ├── types/
│   │   └── index.ts                 # 全局类型定义（设置、Airtable、NocoDB 等）
│   ├── models/
│   │   ├── default-settings.ts      # 默认设置常量 DEFAULT_SETTINGS
│   │   └── settings.ts              # SettingsManager：设置的加载/保存/更新
│   ├── services/
│   │   ├── service-container.ts     # 服务容器（懒加载单例）
│   │   ├── api-service.ts           # Airtable API：校验 API Key、拉取更新 ID
│   │   ├── command-service.ts       # 所有 Obsidian 命令的注册与执行
│   │   ├── github-service.ts        # GitHub Release 插件安装/版本检查
│   │   ├── gitee-service.ts         # Gitee Release 插件安装/版本检查
│   │   ├── plugin-service.ts        # 插件重载与启用的通用方法
│   │   ├── templater-service.ts     # 与 Templater 插件的交互
│   │   ├── ioto-settings-service.ts # IOTO 框架路径等设置的读取
│   │   └── db-syncer/
│   │       ├── nocodb.ts            # NocoDB API 封装（鉴权、URL 构造）
│   │       ├── nocodb-sync.ts       # 从 NocoDB 拉取记录并准备写入 Obsidian
│   │       └── ob-syncer.ts         # Obsidian Vault 文件的创建/更新
│   ├── suggesters/
│   │   ├── ai-platform-suggester.ts # AI 平台选择下拉
│   │   └── date-filter-suggester.ts # 日期过滤选项下拉
│   ├── ui/
│   │   ├── settings-tab.ts          # 设置面板入口 Tab
│   │   ├── tabbed-settings.ts       # 标签页切换组件
│   │   └── pickers/                 # 文件/文件夹建议选择器
│   ├── lang/
│   │   ├── helpers.ts               # t() 国际化函数
│   │   └── locale/
│   │       ├── en.ts
│   │       ├── zh-cn.ts
│   │       └── zh-tw.ts
│   └── utils/
│       ├── index.ts                 # 工具函数（校验、版本比较、URL 解析）
│       ├── error.ts
│       └── log.ts
├── manifest.json                    # Obsidian 插件清单（id、版本、权限）
├── esbuild.config.mjs               # esbuild 配置
├── tsconfig.json                    # TypeScript 配置
├── release.sh                       # 发布脚本
└── styles.css                       # 插件自定义样式