# Doc Core API

> WPS Writer 核心 API 参考与代码规范

- Skill: `claude-office-skills/doc-core-api` (Agent Skill)
- Install (CLI): `npx skillmds@latest add claude-office-skills/doc-core-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/claude-office-skills/doc-core-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: claude-office-skills (https://skillmd.com/u/claude-office-skills)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/claude-office-skills/doc-core-api

---


## WPS Writer JS API 核心参考

### 代码执行环境
- 代码通过 `new Function(code)()` 在 WPS Plugin Host 中同步执行
- 全局可用对象: `Application`, `wps`
- 必须使用 `var` 声明变量（不支持 let/const/箭头函数）
- 最后一行必须返回结果字符串

### 常用对象
```
Application.ActiveDocument    // 当前文档 (Document)
Application.Selection         // 当前选区 (Selection)
Document.Content              // 全文 Range
Document.Paragraphs           // 段落集合 Paragraphs
Document.Tables               // 表格集合 Tables
Document.Sections             // 节集合 Sections
Document.Bookmarks            // 书签集合
```

### Selection 操作
```
Selection.Text                // 读取/设置选区文本
Selection.TypeText(text)      // 在光标处输入（替换选区）
Selection.InsertAfter(text)   // 在选区后插入
Selection.InsertBefore(text)  // 在选区前插入
Selection.MoveDown(unit, count)  // 下移光标
Selection.MoveRight(unit, count) // 右移光标
Selection.Collapse(direction)    // 收缩选区 (0=wdCollapseEnd, 1=wdCollapseStart)
Selection.WholeStory()        // 选中全文
Selection.HomeKey(unit)       // 移动到文档/行首
Selection.EndKey(unit)        // 移动到文档/行尾
```

### Range 操作
```
Range.Text                    // 读取/设置文本
Range.InsertAfter(text)       // 在范围后插入
Range.InsertBefore(text)      // 在范围前插入
Range.Start / Range.End       // 起止字符位置
Range.Select()                // 将此范围设为选区
Range.Delete()                // 删除范围内容
```

### 格式化
```
Range.Font.Name = "微软雅黑"
Range.Font.Size = 14
Range.Font.Bold = true / false
Range.Font.Italic = true / false
Range.Font.Color = 0xFF0000        // BGR 颜色
Range.Font.Underline = 1           // wdUnderlineSingle

Range.ParagraphFormat.Alignment = 1  // 0=左, 1=居中, 2=右, 3=两端
Range.ParagraphFormat.LineSpacing = 24  // 行距 (磅)
Range.ParagraphFormat.SpaceBefore = 6
Range.ParagraphFormat.SpaceAfter = 6
Range.ParagraphFormat.FirstLineIndent = 24  // 首行缩进

Range.Style = "标题 1"              // 设置样式
```

### 表格操作
```
Document.Tables.Add(range, rows, cols)
Table.Cell(row, col).Range.Text = "文本"
Table.Rows.Add()
Table.Columns.Add()
Table.Cell(row, col).Merge(Table.Cell(row, col2))
```

### 安全规范
- 操作前务必检查对象是否存在: `if (!doc) return "无活动文档";`
- 大范围操作用 try/catch 包裹
- 不要假设文档中有特定内容，先检查再操作
- 替换选区前确认 Selection.Text 不为空