AGENTS.md@01_PROJECTS/_example_cli_tool git:20261008.e5b1ec6A

Immutable. This exact content never changes and is served at /api/v1/blob/3b8a5bbb2bb91aeb.

# CLI 工具示例 — 项目配置

> 本文件由 AOS 管理，Agent 操作本项目时自动加载

> 状态：全部阶段完成（开发 / 测试 / 文档），示例就绪 ｜ 更新 2026-10
> 单元测试 4/4 通过（`src/tests/test_parser.py`）；parser / filters / reporter 三模块结构，零外部依赖。项目作为 AOS 单一项目结构范例展示，无活跃任务。

---

## 项目基本信息

| 字段 | 值 |
|------|-----|
| 项目名称 | CLI 工具示例 |
| 项目类型 | cli_tool |
| 技术栈 | Python 3.10+, argparse, setuptools, JSON |
| 创建时间 | 2026-06-25 |
| AOS 项目路径 | 01_PROJECTS/_example_cli_tool/ |

---

## 状态记录

| 项 | 值 |
|----|-----|
| 状态载体 | 本文件头部「状态摘要」节（v2 项目两件套：AGENTS.md + README.md，不设独立状态文件） |
| 更新规则 | 阶段切换或关键节点时覆盖更新摘要；过程历史追加至 `06_LOGS/{project}/` |

---

## 命令地图
- 构建命令: `pip install -e src/`（setuptools，安装出 `loganalyzer` 命令；零外部依赖）
- 测试命令: `python -m unittest discover -s src/tests -t src`（unittest 标准库，test_parser.py 4 个用例）
- 运行命令: 已安装则 `loganalyzer --help`；未安装在 `src/` 目录下 `python -m loganalyzer --help`

## 项目专属约束

- 代码必须遵循 PEP 8 规范
- 所有公共函数必须有 docstring
- 支持 Python 3.10+ 环境
- 依赖仅使用标准库（零外部依赖）

---

## 敏感信息（迁移时重点关注）

> ⚠ 以下信息在迁移、部署、环境切换时必须重点核查

| 类型 | 内容 | 说明 | 迁移注意事项 |
|------|------|------|-------------|
| 端口 | 无 | 本项目为 CLI 工具，无服务端口 | — |
| 接口 | 无 | 本项目无 API 接口 | — |
| 路径 | src/ | 源代码目录 | 路径结构需保持一致 |
| 环境变量 | 无 | 本项目无环境变量 | — |
| 依赖服务 | 无 | 本项目无外部依赖 | — |
| 定时任务 | 无 | 本项目无定时任务 | — |

---

## 关联项目

| 关联项目 | 关系 | 说明 |
|----------|------|------|
| 无 | — | — |

---

## 知识引用（禁止复制内容，只引用路径）

- 无