# ztc1522021381/windows-agent-ops architecture

> Architecture diagram of the GitHub repository ztc1522021381/windows-agent-ops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ztc1522021381/windows-agent-ops
- Repository: https://github.com/ztc1522021381/windows-agent-ops

## Overview

windows-agent-ops is an Agent Skill for operating reliably in a sandboxed Windows environment, not a single application with one runtime pipeline. Its principal workflow is to consult the environment rules, diagnose a Windows or application issue, apply a targeted repair or deployment action, and verify the result. The repository also documents browser automation and MCP-service checks as distinct capabilities. The sampled scripts support the tool-to-OS and tool-to-service links below; documentation-only procedures are represented without inventing implementation links.

Main entry points: [`scripts/check_pending_delete.py`](https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/check_pending_delete.py) (Pending-delete check), [`scripts/parallel_download.py`](https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/parallel_download.py) (Parallel downloader), [`SKILL.md`](https://github.com/ztc1522021381/windows-agent-ops/blob/main/SKILL.md) (Environment rules), [`references/wps-office-repair.md`](https://github.com/ztc1522021381/windows-agent-ops/blob/main/references/wps-office-repair.md) (WPS repair case)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Operational guidance"]
  node_skill["Environment rules<br/>[SKILL.md]"]
  node_wps_case["WPS repair case"]
end

subgraph group_windows_ops["Windows operations"]
  node_pending_check["Pending-delete check"]
  node_downloader["Parallel downloader"]
  node_replacer["Locked-file replacer"]
end

subgraph group_automation["Automation tools"]
  node_mcp_smoke["MCP stdio check<br/>[mcp_stdio_smoke.py]"]
  node_edge_tool["Edge CDP automation<br/>[edge_cdp.js]"]
end

node_agent(("Agent or user"))
node_windows["Windows sandbox"]
node_registry[("Windows registry")]
node_filesystem["Windows filesystem"]
node_http_server["HTTP file server"]
node_mcp_service["MCP service"]
node_edge["Edge browser"]
node_web["Web page"]

node_agent -->|"consults"| node_skill
node_agent -->|"consults"| node_wps_case
node_skill -->|"guides diagnosis"| node_agent
node_wps_case -->|"guides repair"| node_agent
node_agent -->|"runs"| node_pending_check
node_pending_check -->|"reads entries"| node_registry
node_pending_check -->|"checks paths"| node_filesystem
node_agent -->|"runs"| node_downloader
node_downloader -->|"requests ranges"| node_http_server
node_downloader -->|"writes and verifies"| node_filesystem
node_agent -->|"runs"| node_replacer
node_replacer -->|"compares and replaces"| node_filesystem
node_agent -->|"runs"| node_mcp_smoke
node_mcp_smoke -->|"starts and queries"| node_mcp_service
node_agent -->|"runs"| node_edge_tool
node_edge_tool -->|"controls via CDP"| node_edge
node_edge -->|"navigates"| node_web

click node_skill "https://github.com/ztc1522021381/windows-agent-ops/blob/main/SKILL.md"
click node_wps_case "https://github.com/ztc1522021381/windows-agent-ops/blob/main/references/wps-office-repair.md"
click node_pending_check "https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/check_pending_delete.py"
click node_downloader "https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/parallel_download.py"
click node_replacer "https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/replace_locked_files.py"
click node_mcp_smoke "https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/mcp_stdio_smoke.py"
click node_edge_tool "https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/edge_cdp.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_wps_case,node_agent,node_edge toneBlue
class node_pending_check,node_downloader,node_replacer,node_registry toneAmber
class node_mcp_smoke,node_edge_tool,node_http_server toneMint
class node_windows,node_filesystem,node_mcp_service,node_web toneIndigo
```

## Components

### Operational guidance

- [Environment rules](https://github.com/ztc1522021381/windows-agent-ops/blob/main/SKILL.md): `SKILL.md`
- [WPS repair case](https://github.com/ztc1522021381/windows-agent-ops/blob/main/references/wps-office-repair.md): `references/wps-office-repair.md`

### Windows operations

- [Pending-delete check](https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/check_pending_delete.py): `scripts/check_pending_delete.py`
- [Parallel downloader](https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/parallel_download.py): `scripts/parallel_download.py`
- [Locked-file replacer](https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/replace_locked_files.py): `scripts/replace_locked_files.py`

### Automation tools

- [MCP stdio check](https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/mcp_stdio_smoke.py): `scripts/mcp_stdio_smoke.py`
- [Edge CDP automation](https://github.com/ztc1522021381/windows-agent-ops/blob/main/scripts/edge_cdp.js): `scripts/edge_cdp.js`

### Other components

- **Agent or user**
- **Windows sandbox**
- **Windows registry**
- **Windows filesystem**
- **HTTP file server**
- **MCP service**
- **Edge browser**
- **Web page**

## Connections

- Agent or user → Environment rules: consults
- Agent or user → WPS repair case: consults
- Environment rules → Agent or user: guides diagnosis
- WPS repair case → Agent or user: guides repair
- Agent or user → Pending-delete check: runs
- Pending-delete check → Windows registry: reads entries
- Pending-delete check → Windows filesystem: checks paths
- Agent or user → Parallel downloader: runs
- Parallel downloader → HTTP file server: requests ranges
- Parallel downloader → Windows filesystem: writes and verifies
- Agent or user → Locked-file replacer: runs
- Locked-file replacer → Windows filesystem: compares and replaces
- Agent or user → MCP stdio check: runs
- MCP stdio check → MCP service: starts and queries
- Agent or user → Edge CDP automation: runs
- Edge CDP automation → Edge browser: controls via CDP
- Edge browser → Web page: navigates