Document Scanning

文档扫描

Supported File Types

支持的文件类型

Extension	Type	Sub-Agent
.docx	Word document	word-accessibility
.xlsx	Excel workbook	excel-accessibility
.pptx	PowerPoint presentation	powerpoint-accessibility
.pdf	PDF document	pdf-accessibility

扩展名	类型	Sub-Agent
.docx	Word 文档	word-accessibility
.xlsx	Excel 工作簿	excel-accessibility
.pptx	PowerPoint 演示文稿	powerpoint-accessibility
.pdf	PDF 文档	pdf-accessibility

File Discovery Commands

文件发现命令

PowerShell (Windows)

powershell

undefined

powershell

undefined

Non-recursive scan

Get-ChildItem -Path "<folder>" -File -Include .docx,.xlsx,.pptx,.pdf

Recursive scan

Get-ChildItem -Path "<folder>" -File -Include .docx,.xlsx,.pptx,.pdf -Recurse | Where-Object { $.Name -notlike '~$*' -and $.Name -notlike '.tmp' -and $_.Name -notlike '.bak' } | Where-Object { $_.FullName -notmatch '\/[\/]' }

undefined

Get-ChildItem -Path "<folder>" -File -Include .docx,.xlsx,.pptx,.pdf -Recurse | Where-Object { $.Name -notlike '~$*' -and $.Name -notlike '.tmp' -and $_.Name -notlike '.bak' } | Where-Object { $_.FullName -notmatch '\/[\/]' }

undefined

Bash (macOS)

bash

undefined

bash

undefined

Non-recursive scan

find "<folder>" -maxdepth 1 -type f ( -name ".docx" -o -name ".xlsx" -o -name ".pptx" -o -name ".pdf" ) ! -name "~$*"

Recursive scan

find "<folder>" -type f ( -name ".docx" -o -name ".xlsx" -o -name ".pptx" -o -name ".pdf" )
! -name "~$" ! -name ".tmp" ! -name ".bak"
! -path "/.git/" ! -path "/node_modules/" ! -path "/pycache/" ! -path "/.vscode/*"

undefined

find "<folder>" -type f ( -name ".docx" -o -name ".xlsx" -o -name ".pptx" -o -name ".pdf" )
! -name "~$" ! -name ".tmp" ! -name ".bak"
! -path "/.git/" ! -path "/node_modules/" ! -path "/pycache/" ! -path "/.vscode/*"

undefined

Delta Detection

变更检测

Git-based

基于Git

bash

undefined

bash

undefined

Files changed since last commit

git diff --name-only HEAD~1 HEAD -- '.docx' '.xlsx' '.pptx' '.pdf'

Files changed since a specific tag

git diff --name-only <tag> HEAD -- '.docx' '.xlsx' '.pptx' '.pdf'

Files changed in the last N days

git log --since="N days ago" --name-only --diff-filter=ACMR --pretty="" -- '.docx' '.xlsx' '.pptx' '.pdf' | sort -u

undefined

git log --since="N days ago" --name-only --diff-filter=ACMR --pretty="" -- '.docx' '.xlsx' '.pptx' '.pdf' | sort -u

undefined

Timestamp-based (PowerShell)

基于时间戳（PowerShell）

powershell

undefined

powershell

undefined

Files modified since a specific date

Get-ChildItem -Path "<folder>" -File -Include .docx,.xlsx,.pptx,.pdf -Recurse | Where-Object { $_.LastWriteTime -gt [datetime]"2025-01-01" }

undefined

Get-ChildItem -Path "<folder>" -File -Include .docx,.xlsx,.pptx,.pdf -Recurse | Where-Object { $_.LastWriteTime -gt [datetime]"2025-01-01" }

undefined

Files to Skip

需要跳过的文件

Always exclude these patterns during scanning:

```
~$*
```
- Office lock/temp files (created when a document is open)
```
*.tmp
```
- Temporary files
```
*.bak
```
- Backup files
Files inside
```
.git/
```
,
```
node_modules/
```
,
```
.vscode/
```
,
```
__pycache__/
```
directories

扫描过程中请始终排除以下模式的文件：

```
~$*
```
- Office 锁定/临时文件（文档打开时创建）
```
*.tmp
```
- 临时文件
```
*.bak
```
- 备份文件
位于
```
.git/
```
、
```
node_modules/
```
、
```
.vscode/
```
、
```
__pycache__/
```
目录下的文件

Scan Configuration Files

扫描配置文件

File	Purpose
`.a11y-office-config.json`	Rule enable/disable for Word, Excel, PowerPoint
`.a11y-pdf-config.json`	Rule enable/disable for PDF scanning

文件名	用途
`.a11y-office-config.json`	Word、Excel、PowerPoint 的规则启用/禁用配置
`.a11y-pdf-config.json`	PDF 扫描的规则启用/禁用配置

Scan Profiles

扫描方案

Profile	Rules	Severities	Use Case
Strict	All	Error, Warning, Tip	Public-facing, legally required documents
Moderate	All	Error, Warning	Most organizations
Minimal	All	Error only	Triaging large document libraries

方案	规则范围	严重级别	适用场景
严格	全部	错误、警告、提示	面向公众、法律要求合规的文档
中等	全部	错误、警告	绝大多数组织使用
极简	全部	仅错误	对大型文档库进行初步分类排查

Context Passing Format

上下文传递格式

When delegating to a sub-agent, always provide this context block:

text

undefined

委派任务给Sub-Agent时，请始终提供以下上下文块：

text

undefined

Document Scan Context

File: [full path]
Scan Profile: [strict | moderate | minimal]
Severity Filter: [error, warning, tip]
Disabled Rules: [list or "none"]
User Notes: [any specifics]
Part of Batch: [yes/no - if yes, indicate X of Y]

undefined

File: [full path]
Scan Profile: [strict | moderate | minimal]
Severity Filter: [error, warning, tip]
Disabled Rules: [list or "none"]
User Notes: [any specifics]
Part of Batch: [yes/no - if yes, indicate X of Y]

undefined

document-scanning

Original

Translation

Document Scanning

文档扫描

Supported File Types

支持的文件类型

File Discovery Commands

文件发现命令

PowerShell (Windows)

PowerShell (Windows)

Non-recursive scan

Non-recursive scan

Recursive scan

Recursive scan

Bash (macOS)

Bash (macOS)

Non-recursive scan

Non-recursive scan

Recursive scan

Recursive scan

Delta Detection

变更检测

Git-based

基于Git

Files changed since last commit

Files changed since last commit

Files changed since a specific tag

Files changed since a specific tag

Files changed in the last N days

Files changed in the last N days

Timestamp-based (PowerShell)

基于时间戳（PowerShell）

Files modified since a specific date

Files modified since a specific date

Files to Skip

需要跳过的文件

Scan Configuration Files

扫描配置文件

Scan Profiles

扫描方案

Context Passing Format

上下文传递格式

Document Scan Context

Document Scan Context