# xs_unit_test_agent **Repository Path**: being_xyk/xs_unit_test_agent ## Basic Information - **Project Name**: xs_unit_test_agent - **Description**: XS内部的测试工具链Agent - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-14 - **Last Updated**: 2026-09-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # UnitTest_Agent 对玄宿地图服务器(XSMapServer)做**基于用户视角的黑盒测试**的工程:以飞书用户手册为行为基准,手册即测试用例来源,测试用例、中间产物、报告按「测试任务」一体管理。 ## 快速开始 ```bash # 1. 就位被测软件与测试数据(不入库,需本机准备) # Resource/XSTech/XSMapServer/ 被测软件安装目录(或运行安装包装到该路径) # Resource/Testdata/ 测试数据(image/dem/shp 等十余类) # 安装包:Resource/XSMapServer Setup 2.0.11.exe # 2. 配置飞书手册拉取凭证(模板见 .env.example) cp .env.example .env # 填 FEISHU_APP_ID / FEISHU_APP_SECRET / FEISHU_WIKI_SPACE_ID # 3. 安装 runner 依赖并拉取用户手册到本地镜像 pip install -r SourceCode/runner/requirements.txt node SourceCode/feishu-manual/feishu-pull.mjs <手册链接> --out "TestTasks/inputs/<手册名>" # 4. 执行测试(需 XSMapServer 已启动,8060 端口监听;数据与环境准备见 Document/testdata-preparation.md) python SourceCode/runner/run.py # 5. 打开结果管理界面(报告阅读 / 架构图,浏览器自动打开 http://127.0.0.1:18080/) start-testui.bat ``` 报告按任务分写在 `TestTasks/<任务>/reports/`,退出码非零即有失败;结果同时追加进结果库 `TestTasks/results.jsonl`(含 `sut_version` 被测版本字段)。 ## 目录结构 | 目录 | 内容 | |---|---| | `Resource/XSTech/`、`Resource/Testdata/`、安装包 | 被测软件与测试数据(gitignore,本机就位) | | `TestTasks/inputs/` | 飞书手册本地镜像(`feishu-pull.mjs` 拉取,只增不改) | | `TestTasks/` | 测试任务区:`TASK-NN-任务名/{cases,resources,reports}/` + `arch-map.json` 模块映射 + `format-spec.md` 用例格式规范 | | `TestTasks/arch/`、`TestTasks/sut.json` | 版本化架构图资产与被测版本唯一数据源(升级被测软件只改 sut.json) | | `SourceCode/runner/` | 测试执行器 `run.py`(YAML 用例 → 检查器 → 报告) | | `SourceCode/gui/` | 18080 结果管理界面(`start-testui.bat` 启动) | | `SourceCode/feishu-manual/` | 飞书手册拉取脚本(表格块已支持转 markdown) | | `Document/` | `architecture.md` 架构设计 / `xsmapserver-notes.md` 被测软件观测笔记 / `design-note.md` 轻量设计锁定 / `research/` 方案输入 | ## 文档导航 - **架构与接口资产**:`Document/architecture.md`(测试分层、工程数据流、管理界面形态)/ `Document/xsmapserver-notes.md`(已探测管理 API、疑似缺陷、存疑行为) - **Agent 操作指引**:`AGENTS.md`(目录职责、工作流、红线) - **用例格式规范**:`TestTasks/format-spec.md` - **交付流程状态**:`node .b_workflow/bin/bwf.js status`(BWorkflow 轻量模式:S0 → SL → S4 → S5) ## 当前状态 - 三个测试任务:TASK-01 服务列表(11 条)、TASK-03 稳定性(1 条)、TASK-04 矢量服务发布(18 条:7 条 API done 常规回归、8 条 GUI manual-only、3 条 todo),报告含执行摘要、缺陷反馈卡(带被测版本)、待确认问题清单; - 任务目录与手册按服务类型 1:1 拆分(一类型一任务一编码,跨类型通用用例归 SVC-PUB),原则见 `Document/design-note.md`(proposal-0007); - 18080 结果管理界面:任务树 + 报告/架构图双 tab、任务模块高亮、全图入口、按服务名筛选、报告级删除; - 被测版本(当前 XSMapServer 2.0.11)由 `TestTasks/sut.json` 单一来源全局跟踪; - 已记录多个疑似缺陷与存疑行为(发布接口间歇 10054、坏数据被接受发布、禁用后能力文档仍可见、矢量仅 WMS 时 GetMap 404 依赖 WMTS 注册等),详见 `Document/xsmapserver-notes.md`; - BWorkflow 轻量模式:S0 → SL → S4 → S5,已完成 7 个变更归档(见 `Document/archive/INDEX.md`)。 - 双 Agent 入口:`AGENTS.md` 为唯一正文,Kimi Code 直接读;Claude Code 经 `CLAUDE.md` 软链接与 `.claude/skills → .agents/skills` 软链接接入(本机专用,不入库)。