1. 插件开发概述

• Typora特性：实时渲染、极简主义设计、跨平台支持
• 开发意义：

  - 扩展：文本分析/自动化排版工具
  - 效率：降低重复操作时间成本
  

• 环境配置：

  npm install -g typora-plugin-cli
  typora --enable-developer-mode
  

2. 基础架构与概念

文件结构

my-plugin/
├── main.js        # 入口脚本
├── package.json   # 元数据配置
└── assets/        # 样式/图标资源

生命周期示例

module.exports = {
  initialize() {
    console.log("插件加载")
  },
  activate() {
    this.addCommand('ctrl+shift+t', this.insertTemplate)
  }
}

3. 第一个插件实践

快捷键实现

// 插入当前时间
const insertTimestamp = () => {
  const date = new Date().toISOString().slice(0, 19)
  window.typora.insertText(`[timestamp]${date}[/timestamp]`)
}

4. 高级功能开发

数据持久化方案

// 存储配置
localStorage.setItem('plugin-theme', 'dark')

// 跨会话读取
const savedTheme = localStorage.getItem('plugin-theme')

5. 外部工具集成

Git自动化示例

const { exec } = require('child_process')
exec('git add . && git commit -m "Auto-save"', (err) => {
  if (!err) typora.showToast("版本已保存")
})

6. 安全防护实践

// 输入净化函数
const sanitizeHTML = (str) => {
  return str.replace(/[&<>"']/g, (m) => {
    return {
      '&': '&',
      '<': '<',
      '>': '>',
      '"': '"',
      "'": '''
    }[m]
  })
}

7. 发布流程规范

1. 验证package.json必填字段：

   {
     "name": "my-plugin",
     "version": "1.0.0",
     "typora-version": ">=1.5"
   }
   

2. 打包为.typora-plugin格式

8. 智能目录生成器案例

function generateTOC() {
  const headings = window.document.querySelectorAll('h1, h2')
  let toc = "## 目录\n"
  
  headings.forEach(h => {
    const indent = h.tagName === 'H1' ? "" : "  "
    toc += `${indent}- [${h.innerText}](#${h.id})\n`
  })
  
  typora.insertText(toc)
}

9. 疑难排查

加载失败常见原因

graph LR
A[插件报错] --> B{检查点}
B --> C[Typora版本兼容]
B --> D[权限配置]
B --> E[依赖完整性]

10. 未来发展方向

• AI集成场景： $$ \text{编辑体验} \propto \frac{\text{智能补全准确度}}{\text{响应延迟}} $$
• 生态建设：建立插件应用商店机制

特别提示：所有DOM操作需通过window.typora官方API进行，避免直接访问内部对象以保证版本兼容性。