diff --git a/.gitignore b/.gitignore index f56a046..d10127c 100644 --- a/.gitignore +++ b/.gitignore @@ -29,3 +29,6 @@ data/work_items.csv Thumbs.db Desktop.ini .DS_Store + +# 运行时日志（WebView2/crashpad 报错输出） +debug.log diff --git a/README.md b/README.md index 8ca3c99..4d22946 100644 --- a/README.md +++ b/README.md @@ -12,33 +12,25 @@ TFS 2013 工作项批量导入工具集，用于把 Excel/CSV 里的工时台账 | 迭代 | `2026年Sprint\2026年Sprint10` | | 认证 | 域账号 NTLM（内网直连，不走代理） | -## 两套工具，先用哪个 +## 工具一览 -| | [TfsExcelImporter](TfsExcelImporter)（C# WinForms） | [tfs_import.py](tfs_import.py)（Python CLI） | -| --- | --- | --- | -| 通信协议 | TFS Client OM（VS/Team Explorer 同款内部 SOAP） | REST `/_apis/wit/*` | -| 适用 | **本环境可用**。该 TFS 2013 实例只有 `/_apis/projects` 通，`wit/fields`、`wit/classificationnodes`、`wit/wiql` 全部 404 | 服务器开放了 wit REST 路由时使用 | -| 数据源 | `.xlsx`（默认模板随程序发布） | `data/work_items.csv`（GBK/UTF-8 均可，需自备） | -| 界面 | 图形界面，预览后导入 | 命令行，`--dry-run` 先校验 | +仓库只有一套工具：[TfsExcelImporter](TfsExcelImporter)（C# WinForms 桌面版），数据源为 `.xlsx`（默认模板随程序发布），图形界面预览后导入。 -Python 版在本环境会因 REST 路由 404 而失败，保留用于其它 TFS 实例或接口可用时的批量脚本化导入。 +通信走 TFS Client OM（VS/Team Explorer 同款内部 SOAP）：该 TFS 2013 实例只有 `/_apis/projects` 通，`wit/fields`、`wit/classificationnodes`、`wit/wiql` 全部 404，REST 路线走不通。原先另有一套 Python CLI（REST `/_apis/wit/*`）实现，因上述限制无法在本环境工作，已移除。 ## 目录结构 ``` TFSImport/ -├── tfs_import.py # Python 命令行导入器（REST） -├── config.json # Python 版配置 -├── requirements.txt # requests / requests-ntlm ├── data/ -│ └── work_items.example.csv # 列结构与示例行（UTF-8 BOM）；真实台账不入库 +│ └── work_items.csv # 本地工时台账（含人员/项目，不入库） ├── templates/ │ └── TFS导入模板.xlsx # 默认模板：构建时嵌入 exe，「导出Excel模板」原样导出 ├── tools/ │ ├── make_icon.py # 生成 app.ico（9 个尺寸帧，纯标准库 SDF 栅格化 + 手写 PNG/ICO） │ ├── pe_icon.py # 解析 exe 的 PE 图标资源，导出某帧 PNG（换图标后核对用） │ └── win_screenshot.py # 冒烟截图：拉起 exe、PrintWindow 抓窗、导出标题栏图标（ctypes） -└── TfsExcelImporter/ # C# WinForms 桌面版（主用） +└── TfsExcelImporter/ # C# WinForms 桌面版 ├── TfsExcelImporter.csproj # net48 + ClosedXML + TFS ExtendedClient 14.* ├── FodyWeavers.xml # Costura 单文件打包配置（便携版） ├── NativeLibraryLoader.cs # 释放并预加载内嵌的 TFS native DLL @@ -56,7 +48,7 @@ TFSImport/ ## 快速开始 -### C# 桌面版（主用） +### 桌面版 ```powershell dotnet build TfsExcelImporter.sln -c Release @@ -75,8 +67,8 @@ python tools/win_screenshot.py TfsExcelImporter\bin\Release\net48\TfsExcelImport 界面按 4 步排：顶部状态条常驻显示服务器/项目/类型与连接状态，四张卡片一次只展开一张（展开一张会把其它收成一行摘要），预览表格永远占满剩余高度。 -1. **步骤 1 连接**：填 URL、项目、工作项类型、认证方式与域账号，点「测试连接」——右上状态灯变绿即连通；内网保持「使用系统代理」**不勾选**。 -2. **步骤 2 选数据**：点「加载迭代列表」选目标迭代（也可手填完整路径）；点「导出 Excel 模板」拿默认模板，或「浏览...」选已有 `.xlsx`。需要挂父项时填「父 PBI Id」（默认全部挂同一个；Excel 里加 `PBI Id` 列可逐行指定不同父项）。 +1. **步骤 1 连接**：填 URL、项目、工作项类型与账号密码（认证固定 NTLM，用户名可写 `user` 或 `DOMAIN\user`），点「测试连接」——右上状态灯变绿即连通。 +2. **步骤 2 选数据**：点「加载迭代列表」选目标迭代（也可手填完整路径）；点「导出 Excel 模板」拿默认模板，或「浏览...」选已有 `.xlsx`。需要挂父项时填「父 PBI Id」（默认全部挂同一个；Excel 里加 `PBI Id` 列可逐行指定不同父项）；勾「跳过已存在标题」按「项目/类型/迭代 + 标题」去重。字段校验**不可绕过**，不合法时日志会直接告诉你改哪一列。 3. **步骤 3 预览核对**：选完文件自动读表，表格里逐行核对；缺迭代/文件路径无效时红字直接标在对应输入框下方，不再弹框。 4. **步骤 4 导入**：底部操作条点「开始导入 TFS」，进度条 + `n/m` + 成功/跳过/失败三个计数实时更新，日志抽屉逐行输出 `OK/SKIP/FAIL` 与工作项 ID；跑完点「打开报告 CSV」看逐行结果。 5. 历史数据 Area 不对、或漏挂父项时，展开底部「高级工具」用「按迭代修 Area」「补挂父项」批量纠正；Area 路径也在这一栏里填（以前只能手改 config.json）。 @@ -105,39 +97,27 @@ copy TfsExcelImporter\bin\Release\net48\TfsExcelImporter.exe dist\ 前提：目标机需有 .NET Framework 4.8（Win10 1903+ / Win11 系统自带，一般无需额外安装）。`FodyWeavers.xml` 是 Costura 的打包配置，删掉它或用 `-p:FodyDisable=true` 构建即回到「exe + 一堆 DLL」的普通输出。 -### Python 版 - -```powershell -pip install -r requirements.txt -python tfs_import.py --dry-run # 只校验数据与字段映射，不写入 -python tfs_import.py --list-fields # 列出服务器全部字段（显示名/引用名） -python tfs_import.py # 正式导入 -python tfs_import.py --link-existing # 已导入的项补挂父链接（不新建） -python tfs_import.py --skip-existing-titles # 跳过服务器已有的同标题项 -python tfs_import.py --input other.csv --limit 5 -``` - -每次运行在 `data/import_report_<时间戳>.csv` 生成逐行结果报告（行号 / Title / 结果 / WorkItemId / 错误）。 - ## 配置说明 桌面版的配置落在 exe 同目录的 `config.json`（界面改动后自动写回）；exe 目录不可写时回退到 `%AppData%\TfsExcelImporter\config.json`。 -配置的语义、留空字段如何解析见 [tfs_import.py:49](tfs_import.py#L49) 与 [Config.cs](TfsExcelImporter/Config.cs)，关键字段： +配置的语义、留空字段如何解析见 [Config.cs](TfsExcelImporter/Config.cs)，关键字段： | 键 | 说明 | | --- | --- | -| `tfs_url` / `project` / `work_item_type` | 目标集合、项目、工作项类型（`Task` 或 `Product Backlog Item`） | -| `iteration_path` | 可只写 `2026年Sprint\2026年Sprint10`，程序自动补项目名前缀 | -| `auth.mode` | `ntlm`（域账号，典型）/ `basic` / `default`（当前 Windows 凭据，仅桌面版） | -| `field_refs` | 语义名 → 字段引用名；自定义字段留空时按 `resolve_fields_by_display_name` 的显示名在服务器字段表里查（支持前缀模糊匹配，如 `Completed` → `Completed Work`） | -| `parent_title` / `parent_id` | 父工作项，二选一；按标题匹配不到会直接报错并提示改用 `parent_id` | -| `bypass_rules` | 是否请求绕过字段校验规则；桌面版走 Client OM（14.x 无 `SaveFlags.BypassRules`），实际由服务器规则决定 | -| `skip_existing_titles` | 同项目/同类型/同迭代下按标题去重 | +| `TfsUrl` / `Project` / `WorkItemType` | 目标集合、项目、工作项类型（`Task` 或 `Product Backlog Item`） | +| `IterationPath` | 可只写 `2026年Sprint\2026年Sprint10`，程序自动补项目名前缀 | +| `AreaPath` | 区域路径；界面「高级工具」栏也可改 | +| `Username` / `Password` | 认证固定 NTLM，用户名可写 `user` 或 `DOMAIN\user` | +| `FinancialProjectRef` / `CompletedRef` / `LogDateRef` / `OriginalEstimateRef` | 自定义字段引用名；留空则按显示名在服务器字段表里查（支持前缀模糊匹配，如 `Completed` → `Completed Work`） | +| `ParentPbiId` | 所有 Task 默认挂接的父 PBI Id；Excel 每行 `PBI Id` 列可覆盖 | +| `SkipExistingTitles` | 同项目/同类型/同迭代下按标题去重 | +| `DefaultState` | Excel `State` 列留空时的默认值 | +| `LastExcelPath` | 上次选中的数据文件，界面回填用 | > 配置里含明文密码，请勿提交到共享仓库；`config.json` 保持空值，凭据本地填写。 -## Excel / CSV 列 +## Excel 列 桌面版 Excel 模板 = 仓库里的 `templates\TFS导入模板.xlsx`，界面「导出Excel模板」直接复制它： @@ -153,37 +133,24 @@ python tfs_import.py --input other.csv --limit 5 系统日期列（`Created Date` / `Closed Date`）已从模板移除：`System.CreatedDate` 由服务器按导入时间填写，`Microsoft.VSTS.Common.ClosedDate` 不再写入、保持为空。 -Python 版仍读 `data/work_items.example.csv` 的旧列（含 `CreatedDate`、`ClosedDate`、`Notes`），未随模板调整。 - -真实台账含人员与项目信息，不入库；本地准备数据文件： - -```powershell -copy data\work_items.example.csv data\work_items.csv # Python 版默认读这个路径，已在 .gitignore 里 -``` +真实台账含人员与项目信息，不入库，放在 `data\work_items.csv`（已在 `.gitignore` 里）。 - 表头按名匹配，顺序不限，`AssignedTo` / `Assigned To` 等价；缺列按模板顺序兜底，但该列已被别的表头占用时不套用位置（旧版模板文件不会串列）。 -- 空 `Title` 的行直接跳过；`State` 为空时用 `default_state`；未识别的列（如 `Group`）忽略。 +- 空 `Title` 的行直接跳过；`State` 为空时用 `DefaultState`；未识别的列（如 `Group`）忽略。 - 日期支持 `yyyy-MM-dd[ / ][ HH:mm[:ss]]` 等格式，Excel 日期序列号（如 `46300`）会被还原成日期。 -- CSV 从 Excel 另存时注意编码，脚本按 `utf-8-sig` → `gbk` 依次尝试。 ## 环境坑点 这些是实测结论，改代码前先看： - **wit REST 路由全 404**：TFS 2013 RTM/低 Update 不带 `/_apis/wit/*`，`Classification.asmx?WSDL` 也被禁 → 桌面版整体走 Client OM（NuGet `Microsoft.TeamFoundationServer.ExtendedClient` 钉 `14.*`，对应 VS2015 客户端代际；15.x 不兼容 TFS 2013）。 -- **502 Bad Gateway**：TFS OM 内部用 `HttpWebRequest`，默认跟随 IE 系统代理，代理会拦内网 TFS。桌面版默认把 `WebRequest.DefaultWebProxy` 置空直连；确实要走代理时勾「使用系统代理」并带上 Windows 凭据过代理认证。 +- **502 Bad Gateway**：TFS OM 内部用 `HttpWebRequest`，默认跟随 IE 系统代理，代理会拦内网 TFS。桌面版固定把 `WebRequest.DefaultWebProxy` 置空强制直连，界面不提供代理开关（本机若只能经代理上网，程序会直连失败）。 - **TF400276 / 关闭状态只读**：改已关闭工作项的 Area 会被拒；`FixAreaAsync` 走「重新打开 → 改 Area → 还原状态」的状态循环，中途失败回滚状态。 - **`System.CreatedDate` 写不进去**：OM 14.x 没有 `SaveFlags.BypassRules`（15.x 才加），该字段服务器托管；`Microsoft.VSTS.Common.ClosedDate` 在 `State=Done` 时按普通字段可尝试写入。模板已去掉日期列，所以导入不再走这条路——若某模板要求 `Done` 必填 Closed Date，需另加列或改回写日期。 -- **孤立 Task 在积压工作页不可见**：TFS 2013 的 backlog/任务板按「父项 → 子任务」组织，没挂父链接的 Task 只能在查询里看到，所以导入必须带 `parent_title`/`parent_id`。 +- **字段校验不可绕过**：OM 14.x 没有 `SaveFlags.BypassRules`，旧界面上那个 `bypassRules` 勾选从未真正生效，已移除。校验失败时日志与 report CSV 直接给出「字段(原因) → 怎么改」，列表字段还会列出允许值，按提示改 Excel 对应列后重跑即可。 +- **孤立 Task 在积压工作页不可见**：TFS 2013 的 backlog/任务板按「父项 → 子任务」组织，没挂父链接的 Task 只能在查询里看到，所以导入必须带父项（界面填父 PBI Id，或 Excel 里加 `PBI Id` 列）。 - **DNS 解析失败 / 超时**：多为 VPN 或网络断开，不是代码问题；桌面版会对这类异常附加排查提示。 ## 验证 -改动 Python 版后至少跑： - -```powershell -python -m py_compile tfs_import.py -python tfs_import.py --dry-run -``` - -桌面版改完跑一次 `--limit` 级别的小批量导入（先删服务器已有同标题项或开启跳过），并在积压工作页展开父项确认子任务可见。 +桌面版改完，先用只含几行的 Excel 跑一次小批量导入（先删服务器已有同标题项或勾「跳过已存在标题」），再在积压工作页展开父项确认子任务可见；改动涉及界面布局或图标时，跑 `python tools/win_screenshot.py` 抓图核对。确认无误后再跑全量。 diff --git a/TfsExcelImporter/Config.cs b/TfsExcelImporter/Config.cs index b120770..0cdc9c7 100644 --- a/TfsExcelImporter/Config.cs +++ b/TfsExcelImporter/Config.cs @@ -18,17 +18,13 @@ namespace TfsExcelImporter // 可选：区域路径 public string AreaPath { get; set; } = ""; - // ntlm | basic | default(当前 Windows 凭据) - public string AuthMode { get; set; } = "ntlm"; + // 认证固定 NTLM：用户名可写 user，也可写 DOMAIN\user public string Username { get; set; } = ""; public string Password { get; set; } = ""; - public string Domain { get; set; } = ""; - // 是否走 IE 系统代理。内网 TFS 请保持 false（直连）； - // 代理/网关常对 HttpClient 请求返回 502（浏览器例外名单直连，.NET 不一定继承） - public bool UseSystemProxy { get; set; } = false; - - public bool BypassRules { get; set; } = true; + // 旧版本有 BypassRules 开关，已移除：TFS 2013 对应的 Client OM 14.x 没有 SaveFlags.BypassRules + // （15.x 才加，而 15.x 不兼容 TFS 2013），勾选从未生效。旧 config.json 里的残留键由 + // Newtonsoft 按默认 MissingMemberHandling.Ignore 忽略，不需要手工清理。 public bool SkipExistingTitles { get; set; } = true; public string DefaultState { get; set; } = "To Do"; diff --git a/TfsExcelImporter/CueBanner.cs b/TfsExcelImporter/CueBanner.cs new file mode 100644 index 0000000..412a525 --- /dev/null +++ b/TfsExcelImporter/CueBanner.cs @@ -0,0 +1,45 @@ +using System; +using System.Runtime.InteropServices; +using System.Windows.Forms; + +namespace TfsExcelImporter +{ + /// + /// 输入框空态占位文字（cue banner）。net48 的 TextBox 没有 PlaceholderText， + /// 用原生 EM_SETCUEBANNER 实现；ComboBox（DropDown）要发给它内嵌的 Edit 子窗口， + /// 直接发给组合框本体无效。文字只在输入框为空时显示，与 Web 表单 placeholder 手感一致。 + /// + internal static class CueBanner + { + private const int EM_SETCUEBANNER = 0x1501; + private const uint GW_CHILD = 5; + + [DllImport("user32.dll", CharSet = CharSet.Unicode)] + private static extern IntPtr SendMessage(IntPtr hWnd, int msg, IntPtr wParam, string lParam); + + [DllImport("user32.dll")] + private static extern IntPtr GetWindow(IntPtr hWnd, uint cmd); + + /// 设置占位文字。控件句柄可能尚未创建，挂 HandleCreated 兜底； + /// wParam=1 让占位文字在聚焦时也显示（有真实输入后自然消失）。 + public static void Set(Control c, string text) + { + if (c == null || string.IsNullOrEmpty(text)) return; + Action apply = () => Send(c, text); + if (c.IsHandleCreated) apply(); + c.HandleCreated += (s, e) => apply(); + } + + private static void Send(Control c, string text) + { + IntPtr target = c.Handle; + if (c is ComboBox) + { + // DropDown 组合框的内嵌 Edit 子窗口：cue banner 只认它 + target = GetWindow(c.Handle, GW_CHILD); + if (target == IntPtr.Zero) return; + } + SendMessage(target, EM_SETCUEBANNER, (IntPtr)1, text); + } + } +} diff --git a/TfsExcelImporter/MainForm.cs b/TfsExcelImporter/MainForm.cs index e34a31f..a34f159 100644 --- a/TfsExcelImporter/MainForm.cs +++ b/TfsExcelImporter/MainForm.cs @@ -35,7 +35,6 @@ namespace TfsExcelImporter private void WireEvents() { - _cmbAuth.SelectedIndexChanged += (s, e) => { UpdateAuthUi(); OnFieldChanged(); }; _btnTest.Click += async (s, e) => await TestConnectionAsync(); _btnLoadIterations.Click += async (s, e) => await LoadIterationsAsync(); _btnBrowse.Click += (s, e) => BrowseExcel(); @@ -45,13 +44,11 @@ namespace TfsExcelImporter _btnFixArea.Click += async (s, e) => await FixAreaAsync(); _btnLinkParent.Click += async (s, e) => await LinkParentAsync(); - foreach (var tb in new[] { _txtUrl, _txtProject, _txtType, _txtUser, _txtPwd, _txtDomain, + foreach (var tb in new[] { _txtUrl, _txtProject, _txtType, _txtUser, _txtPwd, _txtExcel, _txtParentPbi, _txtAreaPath }) tb.TextChanged += (s, e) => OnFieldChanged(); _cmbIteration.TextChanged += (s, e) => OnFieldChanged(); _chkSkip.CheckedChanged += (s, e) => OnFieldChanged(); - _chkBypass.CheckedChanged += (s, e) => OnFieldChanged(); - _chkProxy.CheckedChanged += (s, e) => OnFieldChanged(); FormClosing += (s, e) => { try { SaveUiToConfig(); } catch { } }; } @@ -62,37 +59,19 @@ namespace TfsExcelImporter RefreshSummaries(); } - // ------------------------------------------------------------- 认证区联动 - private void UpdateAuthUi() - { - bool needCreds = _cmbAuth.SelectedItem != null && _cmbAuth.SelectedItem.ToString() != "default"; - _txtUser.Enabled = needCreds; - _txtPwd.Enabled = needCreds; - _txtDomain.Enabled = needCreds; - _fUser.Invalid = false; - _fPwd.Invalid = false; - _fDomain.Invalid = false; - } - // ------------------------------------------------------------- 配置互转 private void LoadConfigToUi() { _txtUrl.Text = _cfg.TfsUrl; _txtProject.Text = _cfg.Project; _txtType.Text = _cfg.WorkItemType; - _cmbAuth.SelectedItem = _cfg.AuthMode; - if (_cmbAuth.SelectedItem == null) _cmbAuth.SelectedItem = "ntlm"; _txtUser.Text = _cfg.Username; _txtPwd.Text = _cfg.Password; - _txtDomain.Text = _cfg.Domain; - _chkProxy.Checked = _cfg.UseSystemProxy; _cmbIteration.Text = _cfg.IterationPath; _txtExcel.Text = _cfg.LastExcelPath; _txtAreaPath.Text = _cfg.AreaPath; _chkSkip.Checked = _cfg.SkipExistingTitles; - _chkBypass.Checked = _cfg.BypassRules; _txtParentPbi.Text = _cfg.ParentPbiId; - UpdateAuthUi(); } private void SaveUiToConfig() @@ -100,16 +79,12 @@ namespace TfsExcelImporter _cfg.TfsUrl = _txtUrl.Text.Trim(); _cfg.Project = _txtProject.Text.Trim(); _cfg.WorkItemType = _txtType.Text.Trim(); - _cfg.AuthMode = _cmbAuth.SelectedItem != null ? _cmbAuth.SelectedItem.ToString() : "ntlm"; _cfg.Username = _txtUser.Text.Trim(); _cfg.Password = _txtPwd.Text; - _cfg.Domain = _txtDomain.Text.Trim(); - _cfg.UseSystemProxy = _chkProxy.Checked; _cfg.IterationPath = _cmbIteration.Text.Trim(); _cfg.LastExcelPath = _txtExcel.Text.Trim(); _cfg.AreaPath = _txtAreaPath.Text.Trim(); _cfg.SkipExistingTitles = _chkSkip.Checked; - _cfg.BypassRules = _chkBypass.Checked; _cfg.ParentPbiId = _txtParentPbi.Text.Trim(); _cfg.Save(); } @@ -168,7 +143,7 @@ namespace TfsExcelImporter SetConnection("连接失败", ChipKind.Danger); SetBadgeOf(_cardConn, BadgeKind.Warn); Log("连接失败: " + FirstLine(ex.Message)); - Log("排查: 内网请确认「使用系统代理」保持关闭；DNS 失败多为 VPN 或未连内网。"); + Log("排查: 程序固定直连（不走本机系统代理）；DNS 失败多为 VPN 或未连内网。"); _cardConn.Expanded = true; _cardConn.ApplyHeight(); Relayout(); @@ -237,7 +212,7 @@ namespace TfsExcelImporter SetBadgeOf(_cardConn, BadgeKind.Warn); ShowError(_errIteration, _fIteration, _cardData, "迭代列表加载失败，可手填完整路径"); Log("加载迭代失败: " + FirstLine(ex.Message)); - Log("排查: 内网请确认「使用系统代理」保持关闭；DNS 失败多为 VPN 或未连内网。"); + Log("排查: 程序固定直连（不走本机系统代理）；DNS 失败多为 VPN 或未连内网。"); } finally { @@ -551,7 +526,7 @@ namespace TfsExcelImporter var pbiText = !string.IsNullOrWhiteSpace(row.PbiId) ? row.PbiId.Trim() : _cfg.ParentPbiId; int? parentPbi = int.TryParse(pbiText, out var pbiNum) ? pbiNum : (int?)null; - var id = await client.CreateWorkItemAsync(_cfg.Project, _cfg.WorkItemType, fields, _chkBypass.Checked, parentPbi); + var id = await client.CreateWorkItemAsync(_cfg.Project, _cfg.WorkItemType, fields, parentPbi); ok++; report.AppendLine($"{line},\"{row.Title}\",OK,{id},"); Log($"[{i + 1}/{_rows.Count}] OK #{id} {row.Title}"); @@ -574,7 +549,7 @@ namespace TfsExcelImporter SetConnection("连接失败", ChipKind.Danger); SetRunBadge(BadgeKind.Warn); Log("导入中断: " + FirstLine(ex.Message)); - Log("排查: 内网请确认「使用系统代理」保持关闭；DNS 失败多为 VPN 或未连内网。"); + Log("排查: 程序固定直连（不走本机系统代理）；DNS 失败多为 VPN 或未连内网。"); } finally { diff --git a/TfsExcelImporter/MainFormUi.cs b/TfsExcelImporter/MainFormUi.cs index 02c9d8a..c34704d 100644 --- a/TfsExcelImporter/MainFormUi.cs +++ b/TfsExcelImporter/MainFormUi.cs @@ -17,11 +17,8 @@ namespace TfsExcelImporter private TextBox _txtUrl = new TextBox(); private TextBox _txtProject = new TextBox(); private TextBox _txtType = new TextBox(); - private ComboBox _cmbAuth = new ComboBox(); private TextBox _txtUser = new TextBox(); private TextBox _txtPwd = new TextBox { UseSystemPasswordChar = true }; - private TextBox _txtDomain = new TextBox(); - private CheckBox _chkProxy = new CheckBox(); private ComboBox _cmbIteration = new ComboBox(); private TextBox _txtExcel = new TextBox(); @@ -31,7 +28,6 @@ namespace TfsExcelImporter private Button _btnBrowse = new Button(); private Button _btnTemplate = new Button(); private CheckBox _chkSkip = new CheckBox(); - private CheckBox _chkBypass = new CheckBox(); private DataGridView _grid = new DataGridView(); private Button _btnPreview = new Button(); @@ -52,9 +48,12 @@ namespace TfsExcelImporter private Card _cardConn, _cardData, _cardPreview, _cardLog, _cardAdv; private Surface _actionBar; private StepBadge _badgeRun; - private InputField _fUrl, _fProject, _fType, _fAuth, _fUser, _fPwd, _fDomain, + private InputField _fUrl, _fProject, _fType, _fUser, _fPwd, _fIteration, _fExcel, _fParent, _fArea; private Label _errIteration, _errExcel, _errParent, _errArea; + private Label[] _connRowCaptions; // 第 1 步第二行的标签（重排时要跟着一起摆） + private InputField[] _connRowFields; // 同排的四个输入框 + private int _connRowY; private EmptyState _lblEmpty; private StatusChip _chipConn, _chipOk, _chipSkip, _chipFail; @@ -237,35 +236,94 @@ namespace TfsExcelImporter private void BuildCardConn() { _cardConn = MakeCard(1, "连接 TFS 服务器", true, Theme.Px(44)); - _cmbAuth.DropDownStyle = ComboBoxStyle.DropDownList; - _cmbAuth.Items.AddRange(new object[] { "ntlm", "basic", "default" }); _fUrl = NewField(_txtUrl, 620, true); _fProject = NewField(_txtProject, 150, false); - _fType = NewField(_txtType, 180, false); - _fAuth = NewField(_cmbAuth, 170, false); - _fDomain = NewField(_txtDomain, 150, false); - _fUser = NewField(_txtUser, 180, false); - _fPwd = NewField(_txtPwd, 200, true); + _fType = NewField(_txtType, 150, false); + _fUser = NewField(_txtUser, 150, false); + _fPwd = NewField(_txtPwd, 150, true); + + // 空态占位提示（cue banner）：只在该输入框没填内容时显示 + CueBanner.Set(_txtUrl, "如 http://server:8080/tfs/DefaultCollection"); + CueBanner.Set(_txtProject, "如 Tools_Dev"); + CueBanner.Set(_txtType, "如 Task"); + CueBanner.Set(_txtUser, "留空用当前 Windows 身份"); + CueBanner.Set(_txtPwd, "域账号密码（同上可选）"); _btnTest = NewButton("测试连接", BtnKind.Secondary, IconKind.Bolt, 130); - _chkProxy = NewCheck("使用系统代理", "内网 TFS 请保持关闭，勾选后常被代理拦成 502"); int y = _cardConn.HeaderH + Theme.S12; - // 三行表单共用一条字段左缘：标签列宽取各行最大值，同列字段宽度归一 - int w1 = MaxLabelWidth("服务器 URL", "团队项目", "域"); - int w2 = MaxLabelWidth("工作项类型", "用户"); - int w3 = MaxLabelWidth("认证方式", "密码"); - y = Row(_cardConn, y, 42, new Lbl("服务器 URL", w1), _fUrl); + y = Row(_cardConn, y, 42, new Lbl("服务器 URL", MaxLabelWidth("服务器 URL")), _fUrl); Track(_fUrl, _cardConn, M, 0); - y = Row(_cardConn, y, 42, new Lbl("团队项目", w1), _fProject, - new Lbl("工作项类型", w2), _fType, new Lbl("认证方式", w3), _fAuth); - y = Row(_cardConn, y, 42, new Lbl("域", w1), _fDomain, - new Lbl("用户", w2), _fUser, new Lbl("密码", w3), _fPwd, G, _btnTest); - y = Row(_cardConn, y, 26, _chkProxy); + + // 第二行：项目 / 类型 / 用户 / 密码 + 测试连接同排，四个输入框等宽、整行铺满卡片内容区。 + // 标签自建并留引用——窗口变宽时要连标签一起重摆，Row() 建完就丢引用做不到。 + _connRowY = y; + var captions = new[] { "团队项目", "工作项类型", "用户", "密码" }; + _connRowCaptions = new Label[captions.Length]; + _connRowFields = new[] { _fProject, _fType, _fUser, _fPwd }; + for (int i = 0; i < captions.Length; i++) + { + // 标签宽度由布局按各自文字量给（不死板地共用一条定宽列）：四个标签字数不同 + // （2~5 字），共用定宽列会让「用户」「密码」和自己的输入框之间空出一大截。 + var lbl = new Label + { + Text = captions[i], + Font = Theme.Body, + ForeColor = Theme.Ink2, + AutoSize = false, // 宽度每次重排时按文字量给 + TextAlign = ContentAlignment.MiddleRight, // 文字右缘贴住输入框 + BackColor = Theme.Card + }; + _cardConn.Controls.Add(lbl); + _connRowCaptions[i] = lbl; + _connRowFields[i].AccessibleName = captions[i]; + _cardConn.Controls.Add(_connRowFields[i]); + } + _cardConn.Controls.Add(_btnTest); + _layoutExtras.Add(LayoutConnRow); + + y = _connRowY + Theme.Px(42); _cardConn.BodyH = y - _cardConn.HeaderH + Theme.S8; } + /// + /// 第 1 步第二行排布：四个输入框同宽，整行（含「测试连接」）刚好铺满卡片内容区。 + /// 每个标签只占自己文字的宽度，于是「文字 → 输入框」恒为 6px、「输入框 → 下一个标签」 + /// 恒为 S12，四组间距完全一致；省下的宽度全给输入框，输入框因此比按定宽标签列算的更宽。 + /// 每次重排按当期卡片宽度重算，缩放/拉伸下都不溢出、不留白。 + /// + private void LayoutConnRow() + { + if (_connRowFields == null || _connRowCaptions == null) return; + int gap = Theme.S12; // 组与组之间 + int lblGap = Theme.Px(6); // 标签文字 → 输入框（全行同一个值） + int n = _connRowFields.Length; + int avail = _cardConn.Width - M * 2; + + // 每个标签只占自己文字宽度（+2px 防末字被裁），省下的宽度全部喂给输入框， + // 这样「文字→输入框」和「输入框→下一个标签」两处间距在四组上都是同一个值。 + var lblW = new int[n]; + int textSum = 0; + for (int i = 0; i < n; i++) + { + lblW[i] = Theme.TextWidth(_connRowCaptions[i].Text, Theme.Body) + Theme.Px(2); + textSum += lblW[i]; + } + int boxW = (avail - textSum - n * lblGap - (n - 1) * gap - G - _btnTest.Width) / n; + boxW = Math.Max(Theme.Px(96), boxW); + + int x = M; + for (int i = 0; i < n; i++) + { + _connRowCaptions[i].SetBounds(x, _connRowY, lblW[i], Theme.FieldH); + x += lblW[i] + lblGap; + _connRowFields[i].SetBounds(x, _connRowY, boxW, Theme.FieldH); + x += boxW + gap; + } + _btnTest.SetBounds(x - gap + G, _connRowY, _btnTest.Width, Theme.BtnH); + } + // --- 步骤 2：迭代与数据源 --- private void BuildCardData() { @@ -276,11 +334,14 @@ namespace TfsExcelImporter _fExcel = NewField(_txtExcel, 500, true); _fParent = NewField(_txtParentPbi, 150, true); + CueBanner.Set(_cmbIteration, "选择或手填完整迭代路径，如 Tools_Dev\\Sprint 1"); + CueBanner.Set(_txtExcel, "选择 .xlsx 文件，或点右侧「浏览…」"); + CueBanner.Set(_txtParentPbi, "如 219975"); + _btnLoadIterations = NewButton("加载迭代列表", BtnKind.Secondary, IconKind.Fetch, 130); _btnBrowse = NewButton("浏览…", BtnKind.Secondary, IconKind.Folder, 92); _btnTemplate = NewButton("导出 Excel 模板", BtnKind.Secondary, IconKind.Doc, 142); _chkSkip = NewCheck("跳过已存在标题", ""); - _chkBypass = NewCheck("bypassRules（绕过字段校验规则）", ""); // 三行字段对齐同一条左缘：标签列宽取最大值 int wLbl = MaxLabelWidth("目标迭代", "Excel 文件", "父 PBI Id"); @@ -292,8 +353,12 @@ namespace TfsExcelImporter AnchorRight(_btnTemplate, _cardData, M, _fExcel.Top); AnchorRight(_btnBrowse, _cardData, _btnTemplate.Width + G + M, _fExcel.Top); Track(_fExcel, _cardData, _btnTemplate.Width + _btnBrowse.Width + G * 2 + M, 0); - y = Row(_cardData, y, 42, new Lbl("父 PBI Id", wLbl), _fParent, "Task 默认挂到该 backlog item；Excel 里加 PBI Id 列可逐行覆盖"); - y = Row(_cardData, y, 24, _chkSkip, 2 * G, _chkBypass); + y = Row(_cardData, y, 42, new Lbl("父 PBI Id", wLbl), _fParent, + new Hint("Task 默认挂到该 backlog item；Excel 里加 PBI Id 列可逐行覆盖")); + // 勾选项不再贴着标签起头：整体右移到上面三行输入框的左缘（跳过标签列）。 + // 只有「去重」这一个开关；字段校验不可绕过（OM 14.x 无 BypassRules），失败时由 + // TfsClient 输出可操作的修复提示。 + y = Row(_cardData, y, 32, _fParent.Left - M, _chkSkip); _errIteration = AddErrorUnder(_cardData, _fIteration); _errExcel = AddErrorUnder(_cardData, _fExcel); @@ -474,11 +539,13 @@ namespace TfsExcelImporter _cardAdv = MakeCard(0, "高级工具", true, Theme.Px(36)); _cardAdv.ShowBadge = false; _fArea = NewField(_txtAreaPath, 420, true); + CueBanner.Set(_txtAreaPath, "如 Tools_Dev\\导入工具，留空则沿用工作项现有 Area"); _btnFixArea = NewButton("按迭代修 Area", BtnKind.Secondary, IconKind.Wrench, 158); _btnLinkParent = NewButton("补挂父项", BtnKind.Secondary, IconKind.Tree, 120); int y = _cardAdv.HeaderH + Theme.S12; - y = Row(_cardAdv, y, 52, "Area 路径", _fArea, "改 Area 与补挂父项都按上面的「目标迭代」筛选已有工作项"); + y = Row(_cardAdv, y, 52, "Area 路径", _fArea, + new Hint("改 Area 与补挂父项都按上面的「目标迭代」筛选已有工作项")); y = Row(_cardAdv, y, 34, _btnFixArea, G, _btnLinkParent, G, "已关闭的工作项会被临时重新打开，完成后自动还原状态"); _errArea = AddErrorUnder(_cardAdv, _fArea); _cardAdv.BodyH = y - _cardAdv.HeaderH + Theme.S8; @@ -494,6 +561,14 @@ namespace TfsExcelImporter public Lbl(string text, int minWidth) { Text = text; MinWidth = minWidth; } } + /// 紧跟在字段后面的灰色说明（Caption 字号 + Ink3）：非标签、不参与标签列宽计算。 + private class Hint + { + public readonly string Text; + + public Hint(string text) { Text = text; } + } + /// 一组标签文字的最大实测宽度，用作对齐列宽。 private static int MaxLabelWidth(params string[] texts) { @@ -532,6 +607,23 @@ namespace TfsExcelImporter if (item is int) { x += (int)item; continue; } + var hint = item as Hint; + if (hint != null) + { + var hl = new Label + { + Text = hint.Text, + Font = Theme.Caption, + ForeColor = Theme.Ink3, + AutoSize = true, + BackColor = Theme.Card + }; + hl.SetBounds(x, y + (Theme.FieldH - hl.PreferredHeight) / 2, hl.PreferredWidth, hl.PreferredHeight); + card.Controls.Add(hl); + x += hl.Width + Theme.S12; + continue; + } + var c = item as Control; if (c == null) continue; int top = y + Math.Max(0, (Theme.FieldH - c.Height) / 2); @@ -793,8 +885,7 @@ namespace TfsExcelImporter { ShortHost(_txtUrl.Text.Trim()), _txtProject.Text.Trim(), - _txtType.Text.Trim(), - _cmbAuth.SelectedItem != null ? _cmbAuth.SelectedItem.ToString() : "ntlm" + _txtType.Text.Trim() })); _cardData.SetSummary(string.Join(" · ", new[] { diff --git a/TfsExcelImporter/TfsClient.cs b/TfsExcelImporter/TfsClient.cs index 4d8459d..073336c 100644 --- a/TfsExcelImporter/TfsClient.cs +++ b/TfsExcelImporter/TfsClient.cs @@ -23,31 +23,18 @@ namespace TfsExcelImporter public TfsClient(AppConfig cfg) { - ICredentials cred; - var mode = (cfg.AuthMode ?? "ntlm").ToLowerInvariant(); - if (mode == "default") - { - cred = CredentialCache.DefaultCredentials; - } - else - { - var user = string.IsNullOrEmpty(cfg.Domain) ? cfg.Username : cfg.Domain + "\\" + cfg.Username; - cred = new NetworkCredential(user, cfg.Password ?? ""); - } + // 认证固定 NTLM：用户名可写 user（用当前登录域），也可写 DOMAIN\user 显式指定域。 + var user = (cfg.Username ?? "").Trim(); + var pwd = cfg.Password ?? ""; + var sep = user.IndexOf('\\'); + ICredentials cred = sep > 0 + ? new NetworkCredential(user.Substring(sep + 1), pwd, user.Substring(0, sep)) + : new NetworkCredential(user, pwd); _tpc = new TfsTeamProjectCollection(new Uri(cfg.TfsUrl), cred); // TFS OM 内部用 HttpWebRequest 传输，默认跟随 IE 系统代理——实测代理会拦内网 TFS 返回 502。 - // 默认直连；勾选"使用系统代理"时保留系统代理并带 Windows 凭据过代理认证。 - if (!cfg.UseSystemProxy) - { - WebRequest.DefaultWebProxy = new WebProxy(); // 空 WebProxy = 不走代理，直连 - } - else - { - var p = WebRequest.DefaultWebProxy ?? new WebProxy(); - p.Credentials = CredentialCache.DefaultCredentials; - WebRequest.DefaultWebProxy = p; - } + // 因此固定直连：把 DefaultWebProxy 置空，不读取本机系统代理设置。 + WebRequest.DefaultWebProxy = new WebProxy(); } /// WorkItemStore 惰性初始化（首次调用会下载字段/类型元数据，耗时数秒属正常）。 @@ -187,14 +174,16 @@ namespace TfsExcelImporter /// /// 创建工作项（OM Save）。返回新工作项 ID。 - /// 说明：OM 14.x 的 SaveFlags 无 BypassRules（15.x 才加入，且 15.x 不兼容 TFS 2013）—— + /// 说明：字段校验不可绕过——OM 14.x 的 SaveFlags 无 BypassRules（15.x 才加入，且 15.x 不兼容 TFS 2013）， + /// 因此校验失败时直接把「哪个字段 / 什么原因 / 怎么改」写进异常（见 CheckInvalid）， + /// 不做静默降级，避免产出违反模板规则的脏数据。 /// System.CreatedDate 为服务器管理的只读字段，无法写入（取导入时间）； /// Microsoft.VSTS.Common.ClosedDate 在 State=Done 时按普通规则通常可写：尝试写入， /// 校验或保存失败则清空该字段降级为普通保存（保证行导入成功）。 /// parentPbiId 非空时，通过 System.LinkTypes.Hierarchy(Reverse=Parent) 挂接到该 PBI。 /// public async Task CreateWorkItemAsync(string project, string workItemType, - List> fields, bool bypassRules, int? parentPbiId = null) + List> fields, int? parentPbiId = null) { return await Task.Run(() => { @@ -269,14 +258,77 @@ namespace TfsExcelImporter return null; } + /// + /// 把 wi.Validate() 的结果整理成「字段(原因) → 怎么改」的单行提示。 + /// 单行是硬要求：这段文字会写进 import_report.csv，换行会破坏 CSV 的行结构。 + /// private static string CheckInvalid(WorkItem wi) { var invalid = wi.Validate(); if (invalid.Count == 0) return null; - var names = new StringBuilder(); + var sb = new StringBuilder(); foreach (Field f in invalid) - names.Append(f.Name).Append("(").Append(FieldStatusText(f)).Append("); "); - return names.ToString(); + { + if (sb.Length > 0) sb.Append("；"); + sb.Append(f.Name).Append('(').Append(FieldStatusText(f)).Append(") → ") + .Append(FixHint(f)); + } + return sb.ToString(); + } + + /// + /// 按字段状态给出修复动作：导入失败时用户拿到的应该是「补哪一列、改成什么」， + /// 而不是只有一句「字段校验失败」。注意校验无法绕过（OM 14.x 无 BypassRules）。 + /// + private static string FixHint(Field f) + { + switch (f.Status.ToString()) + { + case "InvalidEmpty": + case "InvalidNull": + return "必填但没值：Excel 补上这一列，并确认字段映射是否对上" + AllowedHint(f); + case "InvalidTooLong": + return "值超长：截断到上限内（TFS 字符串字段默认上限 255 字符）"; + case "InvalidType": + return "类型不匹配，该字段是 " + FieldTypeText(f) + "：检查单元格里是文本还是数字/日期"; + case "InvalidValue": + case "InvalidList": + return "值不在允许范围" + AllowedHint(f); + case "InvalidFormat": + return "格式不对：日期写 yyyy-MM-dd，数字不要带单位或千分位"; + case "InvalidComputed": + return "计算字段不可写：把这一列从 Excel 去掉"; + case "InvalidNotNew": + return "只在新建时可设置：不要对已存在工作项改这一列"; + default: + return "按服务器返回的规则修正该字段的值"; + } + } + + /// 列出字段的允许值（列表字段 InvalidList 的主因），最多展开 8 个。 + private static string AllowedHint(Field f) + { + try + { + var vals = new List(); + int total = 0; + foreach (object v in f.AllowedValues) + { + total++; + if (vals.Count < 8) vals.Add(Convert.ToString(v)); + } + if (vals.Count == 0) return ""; + return "（允许值: " + string.Join(" / ", vals.ToArray()) + + (total > vals.Count ? " 等 " + total + " 项" : "") + "）"; + } + catch { return ""; } + } + + /// 字段类型（String / Integer / DateTime ...），用于提示类型不匹配。 + private static string FieldTypeText(Field f) + { + try { return f.FieldDefinition.FieldType.ToString(); } + catch { return "未知类型"; } } /// 把 FieldStatus 翻译为可读原因（用字符串匹配，避免不同 OM 版本枚举成员差异）。 diff --git a/TfsExcelImporter/config.json b/TfsExcelImporter/config.json index 0f4b896..3a3ecb8 100644 --- a/TfsExcelImporter/config.json +++ b/TfsExcelImporter/config.json @@ -4,12 +4,8 @@ "WorkItemType": "Task", "IterationPath": "", "AreaPath": "Tools_Dev\\DataTechnologies", - "AuthMode": "ntlm", "Username": "", "Password": "", - "Domain": "", - "UseSystemProxy": false, - "BypassRules": true, "SkipExistingTitles": true, "DefaultState": "To Do", "FinancialProjectRef": "", diff --git a/config.json b/config.json deleted file mode 100644 index afc4f4b..0000000 --- a/config.json +++ /dev/null @@ -1,36 +0,0 @@ -{ - "tfs_url": "http://pdtfs01.dev.goldenstand.cn:8080/tfs/DefaultCollection", - "project": "Tools_Dev", - "team": "DataTechnologies", - "work_item_type": "Task", - "parent_title": "陈首林", - "parent_id": "", - "iteration_path": "2026年Sprint\\2026年Sprint10", - "area_path": "", - "auth": { - "mode": "ntlm", - "username": "chenshoulin", - "password": "Password72", - "domain": "" - }, - "field_refs": { - "title": "System.Title", - "state": "System.State", - "assigned_to": "System.AssignedTo", - "financial_project": "", - "completed": "", - "log_date": "", - "created_date": "System.CreatedDate", - "closed_date": "Microsoft.VSTS.Common.ClosedDate", - "iteration_path": "System.IterationPath", - "area_path": "System.AreaPath" - }, - "resolve_fields_by_display_name": { - "financial_project": "FinancialProject", - "completed": "Completed", - "log_date": "LogDate" - }, - "bypass_rules": true, - "skip_existing_titles": true, - "default_state": "To Do" -} diff --git a/data/work_items.example.csv b/data/work_items.example.csv deleted file mode 100644 index 8fc2205..0000000 --- a/data/work_items.example.csv +++ /dev/null @@ -1,3 +0,0 @@ -Title,State,AssignedTo,FinancialProject,Completed,LogDate,CreatedDate,ClosedDate,PBI Id,Notes -20261012 - 示例：货载报告解析并上传凭证受托报告相关内容,To Do,张三,信托 - 上海信托,5,2026-10-12,2026-10-30 11:14,,,示例行，导入前请删除 -20261009 示例：受托报告bug修复,Done,李四,信托 - 上海信托,8,2026-10-09,2026-10-10 18:20:00,2026-10-30 18:00:00,219975,PBI Id 列可逐行指定父项，留空则用配置里的 parent_title/parent_id diff --git a/debug.log b/debug.log deleted file mode 100644 index c7e4ba1..0000000 --- a/debug.log +++ /dev/null @@ -1,6 +0,0 @@ -[1101/171941.143:ERROR:third_party\crashpad\crashpad\util\win\registration_protocol_win.cc:108] CreateFile: 系统找不到指定的文件。 (0x2) -[1101/173900.093:ERROR:third_party\crashpad\crashpad\util\win\registration_protocol_win.cc:108] CreateFile: 系统找不到指定的文件。 (0x2) -[1101/184906.941:ERROR:third_party\crashpad\crashpad\util\win\registration_protocol_win.cc:108] CreateFile: 系统找不到指定的文件。 (0x2) -[1101/191310.883:ERROR:third_party\crashpad\crashpad\util\win\registration_protocol_win.cc:108] CreateFile: 系统找不到指定的文件。 (0x2) -[1101/193634.522:ERROR:third_party\crashpad\crashpad\util\win\registration_protocol_win.cc:108] CreateFile: 系统找不到指定的文件。 (0x2) -[1101/195235.112:ERROR:third_party\crashpad\crashpad\util\win\registration_protocol_win.cc:108] CreateFile: 系统找不到指定的文件。 (0x2) diff --git a/requirements.txt b/requirements.txt deleted file mode 100644 index eab4b7f..0000000 --- a/requirements.txt +++ /dev/null @@ -1,2 +0,0 @@ -requests>=2.28 -requests-ntlm>=1.2 diff --git a/tfs_import.py b/tfs_import.py deleted file mode 100644 index 9c9ed9f..0000000 --- a/tfs_import.py +++ /dev/null @@ -1,467 +0,0 @@ -#!/usr/bin/env python3 -""" -TFS 2013 工作项批量导入工具 - -目标环境（来自截图）: - 服务器 : http://pdtfs01.dev.goldenstand.cn:8080/tfs/DefaultCollection - 团队项目 : Tools_Dev - 团队 : DataTechnologies - 迭代路径 : 2026年Sprint\\2026年Sprint10 (URL: .../_backlogs/Iteration/2026%E5%B9%B4Sprint/2026%E5%B9%B4Sprint10) - -数据源: data/work_items.csv（Title/State/AssignedTo/FinancialProject/Completed/LogDate/CreatedDate/ClosedDate） -字段映射: config.json -> field_refs；留空的自定义字段按显示名自动解析。 - -用法: - python tfs_import.py --dry-run # 只校验数据与字段，不写入 - python tfs_import.py # 正式导入 - python tfs_import.py --link-existing # 已导入的项补挂父链接(不新建) - python tfs_import.py --input other.csv # 指定数据文件 - python tfs_import.py --skip-existing-titles # 跳过已存在同标题工作项 - python tfs_import.py --list-fields # 列出服务器全部字段(显示名/引用名) - -认证(config.json auth.mode): - ntlm : 域\\用户 + 密码（TFS 2013 典型配置） - basic : 服务器开了基本身份验证时使用 - 默认凭据: username 留空则尝试当前 Windows 凭据(仅 basic/ntlm 均需显式账号，TFS 2013 一般用 ntlm) -""" - -from __future__ import annotations - -import argparse -import csv -import json -import sys -import time -from datetime import datetime -from pathlib import Path - -try: - import requests -except ImportError: - print("缺少依赖 requests，请先: pip install -r requirements.txt", file=sys.stderr) - sys.exit(2) - -BASE_DIR = Path(__file__).resolve().parent -API_VER = "1.0" -DATE_FMT_IN = ["%Y-%m-%d %H:%M:%S", "%Y/%m/%d %H:%M:%S", "%Y-%m-%d", "%Y/%m/%d", "%Y-%m-%d %H:%M"] - - -# ---------------------------------------------------------------- 配置与数据 - -def load_config(path: Path) -> dict: - with path.open("r", encoding="utf-8") as f: - return json.load(f) - - -def load_rows(path: Path) -> list[dict]: - # 依次尝试 utf-8-sig / gbk，兼容新旧 CSV 编码 - rows: list[dict] | None = None - last_err: Exception | None = None - for enc in ("utf-8-sig", "gbk"): - try: - with path.open("r", encoding=enc, newline="") as f: - reader = csv.DictReader(f) - rows = [r for r in reader if (r.get("Title") or "").strip()] - break - except UnicodeDecodeError as e: - last_err = e - if rows is None: - raise SystemExit(f"无法读取 CSV {path}（utf-8/gbk 均失败）: {last_err}") - return rows - - -def parse_dt(value: str) -> str | None: - """把 CSV 里的时间统一成 TFS 接受的 ISO 格式；空值返回 None。""" - value = (value or "").strip() - if not value: - return None - for fmt in DATE_FMT_IN: - try: - return datetime.strptime(value, fmt).strftime("%Y-%m-%dT%H:%M:%S") - except ValueError: - continue - raise ValueError(f"无法解析时间: {value!r}") - - -# ---------------------------------------------------------------- HTTP 会话 - -def build_session(cfg: dict) -> requests.Session: - auth = cfg.get("auth", {}) - mode = (auth.get("mode") or "ntlm").lower() - sess = requests.Session() - sess.verify = False - sess.headers.update({"Accept": "application/json"}) - - user = auth.get("username") or "" - pwd = auth.get("password") or "" - domain = auth.get("domain") or "" - - if mode == "ntlm": - from requests_ntlm import HttpNtlmAuth - if not user or not pwd: - raise SystemExit("ntlm 模式需要 config.json 里配置 auth.username / auth.password") - login = f"{domain}\\{user}" if domain else user - sess.auth = HttpNtlmAuth(login, pwd) - elif mode == "basic": - if not user or not pwd: - raise SystemExit("basic 模式需要 config.json 里配置 auth.username / auth.password") - sess.auth = (f"{domain}\\{user}" if domain else user, pwd) - else: - raise SystemExit(f"未知 auth.mode: {mode}") - return sess - - -def tfs_send(sess: requests.Session, method: str, url: str, *, retries: int = 3, - **kwargs) -> requests.Response: - """带退避重试的请求：502/503/504 网关错误或网络异常时最多重试 retries 次。""" - kwargs.setdefault("timeout", 60) - resp: requests.Response | None = None - for attempt in range(1, retries + 1): - try: - resp = sess.request(method, url, **kwargs) - except requests.RequestException as e: - if attempt == retries: - raise - wait = 3 * attempt - print(f"[重试] {method.upper()} {url} 网络异常: {e}；{wait}s 后第 {attempt + 1} 次尝试") - time.sleep(wait) - continue - if resp.status_code in (502, 503, 504) and attempt < retries: - wait = 3 * attempt - print(f"[重试] {method.upper()} {url} -> {resp.status_code}；{wait}s 后第 {attempt + 1} 次尝试") - time.sleep(wait) - continue - return resp - raise RuntimeError(f"请求重试 {retries} 次后仍失败: {method.upper()} {url}") - - -def tfs_get(sess: requests.Session, url: str, params: dict | None = None) -> dict: - resp = tfs_send(sess, "get", url, params=params) - if resp.status_code >= 400: - raise RuntimeError(f"GET {url} -> {resp.status_code}: {resp.text[:500]}") - return resp.json() - - -def tfs_wiql(sess: requests.Session, url: str, wiql: str) -> dict: - resp = tfs_send(sess, "post", url, params={"api-version": API_VER}, json={"query": wiql}) - if resp.status_code >= 400: - raise RuntimeError(f"WIQL 查询失败 {resp.status_code}: {resp.text[:500]}") - return resp.json() - - -# ---------------------------------------------------------------- 字段解析 - -def resolve_fields(sess: requests.Session, base: str, cfg: dict) -> dict: - """返回 {语义名: 引用名}。优先用 config.field_refs 显式值，其次按显示名查服务器字段表。""" - refs = dict(cfg.get("field_refs") or {}) - by_display = cfg.get("resolve_fields_by_display_name") or {} - need_lookup = [k for k, v in by_display.items() if not refs.get(k)] - if not need_lookup: - return refs - - data = tfs_get(sess, f"{base}/_apis/wit/fields", params={"api-version": API_VER}) - catalog = data.get("value", []) - lower_map = {} - for f in catalog: - lower_map.setdefault(f.get("name", "").strip().lower(), f.get("referenceName")) - - for key in need_lookup: - display = by_display.get(key) or key - ref = lower_map.get(display.strip().lower()) - if not ref: - # 宽松匹配: 显示名以配置词开头(如 Completed -> Completed Work) - for f in catalog: - name = f.get("name", "").strip().lower() - if name.startswith(display.strip().lower()): - ref = f.get("referenceName") - print(f"[字段] {key}: {display!r} 模糊匹配到 {f.get('name')!r} -> {ref}") - break - if not ref: - avail = ", ".join(sorted({f.get("name", "") for f in catalog if f.get("name")}))[:800] - raise SystemExit( - f"字段 {key} 的显示名 {display!r} 在服务器上找不到，请在 config.json 的 " - f"field_refs 里显式配置引用名。\n服务器字段(截断): {avail}" - ) - refs[key] = ref - print(f"[字段] {key}: {display!r} -> {ref}") - return refs - - -# ---------------------------------------------------------------- 重复检测 - -def existing_titles(sess: requests.Session, base: str, project: str, iteration: str, - type_name: str) -> set[str]: - wiql = ( - "SELECT [System.Title] FROM WorkItems " - f"WHERE [System.TeamProject] = '{project}' " - f"AND [System.WorkItemType] = '{type_name}' " - f"AND [System.IterationPath] = '{iteration}'" - ) - data = tfs_wiql(sess, f"{base}/{project}/_apis/wit/wiql", wiql) - ids = [w["id"] for w in data.get("workItems", [])] - titles: set[str] = set() - for i in range(0, len(ids), 50): - chunk = ids[i:i + 50] - data = tfs_get( - sess, - f"{base}/_apis/wit/workitems", - params={"ids": ",".join(map(str, chunk)), "fields": "System.Title", "api-version": API_VER}, - ) - for item in data.get("value", []): - titles.add(item.get("fields", {}).get("System.Title", "")) - return titles - - -# ---------------------------------------------------------------- 构造与提交 - -def build_patch(row: dict, refs: dict, cfg: dict, iteration_full: str, area: str) -> list[dict]: - ops: list[dict] = [] - - def add(ref: str | None, value): - if not ref or value is None or value == "": - return - ops.append({"op": "add", "path": f"/fields/{ref}", "value": value}) - - add(refs["title"], row["Title"].strip()) - add(refs["state"], (row.get("State") or cfg.get("default_state") or "To Do").strip()) - add(refs["assigned_to"], (row.get("AssignedTo") or "").strip()) - add(refs["iteration_path"], iteration_full) - if area: - add(refs["area_path"], area) - - add(refs.get("financial_project"), (row.get("FinancialProject") or "").strip()) - - completed = (row.get("Completed") or "").strip() - if completed: - add(refs.get("completed"), float(completed) if "." in completed else int(completed)) - - log_date = parse_dt(row.get("LogDate")) - if log_date: - add(refs.get("log_date"), log_date) - - # CreatedDate / ClosedDate 是系统字段，常规接口不可写；bypassRules=true 时部分模板可写。 - created = parse_dt(row.get("CreatedDate")) - if created: - add(refs.get("created_date"), created) - closed = parse_dt(row.get("ClosedDate")) - if closed: - add(refs.get("closed_date"), closed) - - return ops - - -def create_work_item(sess: requests.Session, base: str, project: str, type_name: str, - ops: list[dict], bypass_rules: bool) -> dict: - url = f"{base}/{project}/_apis/wit/workitems/${requests.utils.quote(type_name)}" - params = {"api-version": API_VER} - if bypass_rules: - params["bypassRules"] = "true" - headers = {"Content-Type": "application/json-patch+json"} - resp = tfs_send(sess, "patch", url, params=params, headers=headers, - data=json.dumps(ops, ensure_ascii=False)) - if resp.status_code >= 400: - raise RuntimeError(f"PATCH {url} -> {resp.status_code}: {resp.text[:800]}") - return resp.json() - - -# ---------------------------------------------------------------- 父项挂接 - -def query_work_item_ids(sess: requests.Session, base: str, project: str, - type_name: str, iteration: str) -> list[int]: - wiql = ( - "SELECT [System.Id] FROM WorkItems " - f"WHERE [System.TeamProject] = '{project}' " - f"AND [System.WorkItemType] = '{type_name}' " - f"AND [System.IterationPath] = '{iteration}'" - ) - data = tfs_wiql(sess, f"{base}/{project}/_apis/wit/wiql", wiql) - return [w["id"] for w in data.get("workItems", [])] - - -def find_parent_id(sess: requests.Session, base: str, project: str, cfg: dict) -> int | None: - """解析父工作项：优先 config.parent_id，其次按 parent_title 全项目精确匹配标题。""" - pid = str(cfg.get("parent_id") or "").strip() - if pid: - return int(pid) - title = (cfg.get("parent_title") or "").strip() - if not title: - return None - safe_title = title.replace("'", "''") - wiql = ( - "SELECT [System.Id] FROM WorkItems " - f"WHERE [System.TeamProject] = '{project}' " - f"AND [System.Title] = '{safe_title}' " - "AND [System.WorkItemType] <> 'Task'" - ) - data = tfs_wiql(sess, f"{base}/{project}/_apis/wit/wiql", wiql) - items = data.get("workItems", []) - if not items: - raise SystemExit( - f"按标题找不到父工作项: {title!r}\n" - f"请把 config.json 的 parent_title 改成积压工作里已有的条目标题，" - f"或直接填 parent_id。" - ) - if len(items) > 1: - print(f"[父项] 警告: 标题 {title!r} 匹配到 {len(items)} 条，取最新创建的一条") - # 取 CreatedDate 最大（最新）的一条 - return max(int(w["id"]) for w in items) - - -def task_has_parent(item: dict) -> bool: - for rel in item.get("relations") or []: - if rel.get("rel") == "System.LinkTypes.Hierarchy-Reverse": - return True - return False - - -def link_parent(sess: requests.Session, base: str, task_id: int, parent_id: int) -> None: - ops = [{ - "op": "add", - "path": "/relations/-", - "value": { - "rel": "System.LinkTypes.Hierarchy-Reverse", - "url": f"{base}/_apis/wit/workitems/{parent_id}", - }, - }] - url = f"{base}/_apis/wit/workitems/{task_id}" - resp = tfs_send( - sess, "patch", url, - params={"api-version": API_VER}, - headers={"Content-Type": "application/json-patch+json"}, - data=json.dumps(ops), - ) - if resp.status_code >= 400: - raise RuntimeError(f"挂接 #{task_id} -> #{parent_id} 失败 {resp.status_code}: {resp.text[:500]}") - - -def link_existing_tasks(sess: requests.Session, base: str, project: str, cfg: dict, - iteration_full: str, parent_id: int) -> int: - """把已导入的同类型/同迭代 Task 补挂到父项下；已有父的跳过。""" - type_name = cfg["work_item_type"] - ids = query_work_item_ids(sess, base, project, type_name, iteration_full) - print(f"[补挂] 找到 {type_name} {len(ids)} 条，父项 #{parent_id}") - linked = skipped = failed = 0 - for tid in ids: - try: - data = tfs_get(sess, f"{base}/_apis/wit/workitems/{tid}", params={"api-version": API_VER}) - if task_has_parent(data): - skipped += 1 - continue - link_parent(sess, base, tid, parent_id) - linked += 1 - print(f"[补挂] OK #{tid} -> #{parent_id}") - except Exception as e: - failed += 1 - print(f"[补挂] FAIL #{tid} -> {e}") - print(f"[补挂] 汇总: 成功 {linked} / 已有父跳过 {skipped} / 失败 {failed}") - return 0 if not failed else 1 - - -# ---------------------------------------------------------------- 主流程 - -def main() -> int: - ap = argparse.ArgumentParser(description="TFS 2013 工作项批量导入") - ap.add_argument("--config", default=str(BASE_DIR / "config.json")) - ap.add_argument("--input", default=str(BASE_DIR / "data" / "work_items.csv")) - ap.add_argument("--dry-run", action="store_true", help="只校验不写入") - ap.add_argument("--skip-existing-titles", action="store_true", help="跳过服务器已存在的同标题项") - ap.add_argument("--list-fields", action="store_true", help="列出服务器字段表后退出") - ap.add_argument("--link-existing", action="store_true", - help="把已导入的同类型/同迭代工作项补挂到父项下(不新建)") - ap.add_argument("--limit", type=int, default=0, help="只处理前 N 条(调试用)") - args = ap.parse_args() - - cfg = load_config(Path(args.config)) - base = cfg["tfs_url"].rstrip("/") - project = cfg["project"] - type_name = cfg["work_item_type"] - iteration_cfg = cfg.get("iteration_path") or "" - iteration_full = f"{project}\\{iteration_cfg}" if iteration_cfg and not iteration_cfg.startswith(project) else iteration_cfg - area = cfg.get("area_path") or "" - bypass_rules = bool(cfg.get("bypass_rules", True)) - - # --link-existing 不读数据文件，直接进补挂流程 - if args.link_existing: - sess = build_session(cfg) - parent_id = find_parent_id(sess, base, project, cfg) - if not parent_id: - raise SystemExit("--link-existing 需要配置 parent_title 或 parent_id") - print(f"[父项] #{parent_id}") - print(f"[迭代] {iteration_full}") - return link_existing_tasks(sess, base, project, cfg, iteration_full, parent_id) - - rows = load_rows(Path(args.input)) - if args.limit: - rows = rows[: args.limit] - print(f"[数据] 共 {len(rows)} 行待导入: {args.input}") - - sess = build_session(cfg) - - if args.list_fields: - data = tfs_get(sess, f"{base}/_apis/wit/fields", params={"api-version": API_VER}) - for f in sorted(data.get("value", []), key=lambda x: x.get("name", "")): - print(f"{f.get('referenceName', ''):<55} {f.get('name', '')}") - return 0 - - refs = resolve_fields(sess, base, cfg) - print(f"[迭代] {iteration_full}") - - parent_id = find_parent_id(sess, base, project, cfg) - if parent_id: - print(f"[父项] #{parent_id}") - else: - print("[父项] 未配置 parent_title/parent_id，导入的项不挂父链接") - - known: set[str] = set() - if args.skip_existing_titles or args.dry_run: - try: - known = existing_titles(sess, base, project, iteration_full, type_name) - print(f"[去重] 服务器同类型/同迭代已有 {len(known)} 条") - except Exception as e: - print(f"[去重] 查询失败(继续): {e}") - - ok = fail = skipped = 0 - report_path = BASE_DIR / "data" / f"import_report_{time.strftime('%Y%m%d_%H%M%S')}.csv" - with report_path.open("w", encoding="utf-8-sig", newline="") as rf: - writer = csv.writer(rf) - writer.writerow(["行号", "Title", "结果", "WorkItemId", "错误"]) - - for idx, row in enumerate(rows, 1): - title = row["Title"].strip() - try: - if args.skip_existing_titles and title in known: - skipped += 1 - writer.writerow([idx, title, "SKIP", "", "标题已存在"]) - print(f"[{idx}/{len(rows)}] SKIP {title}") - continue - - ops = build_patch(row, refs, cfg, iteration_full, area) - - if args.dry_run: - ok += 1 - writer.writerow([idx, title, "DRY", "", json.dumps(ops, ensure_ascii=False)[:200]]) - print(f"[{idx}/{len(rows)}] DRY {title} ({len(ops)} ops)") - continue - - result = create_work_item(sess, base, project, type_name, ops, bypass_rules) - wid = result.get("id") - if parent_id and wid: - try: - link_parent(sess, base, int(wid), parent_id) - print(f"[挂接] #{wid} -> 父项 #{parent_id}") - except Exception as e: - print(f"[挂接] FAIL #{wid} -> {e}") - ok += 1 - writer.writerow([idx, title, "OK", wid, ""]) - print(f"[{idx}/{len(rows)}] OK #{wid} {title}") - except Exception as e: - fail += 1 - writer.writerow([idx, title, "FAIL", "", str(e)[:500]]) - print(f"[{idx}/{len(rows)}] FAIL {title} -> {e}") - - print(f"\n[汇总] 成功 {ok} / 跳过 {skipped} / 失败 {fail}；报告: {report_path}") - return 1 if fail else 0 - - -if __name__ == "__main__": - sys.exit(main()) diff --git a/tools/win_screenshot.py b/tools/win_screenshot.py index ec435da..103eb59 100644 --- a/tools/win_screenshot.py +++ b/tools/win_screenshot.py @@ -146,6 +146,22 @@ def crop_zoom(src_png_w, src_png_h, rgba, cw, ch, scale, path, ox=0, oy=0): def main(): + # 必须声明 DPI 感知：否则 GetWindowRect 返回的是被系统虚拟化（/缩放比）的坐标， + # 抓出来的图只有窗口左上角一块，高 DPI 下右/下必被裁掉。 + # Win10 起用 shcore 的 per-monitor 感知最可靠，老系统退回 user32.SetProcessDPIAware。 + aware = False + try: + ctypes.windll.shcore.SetProcessDpiAwareness(2) # PROCESS_PER_MONITOR_DPI_AWARE + aware = True + except Exception: + pass + if not aware: + try: + aware = bool(u32.SetProcessDPIAware()) + except Exception: + pass + print("dpi aware:", aware) + exe = sys.argv[1] out = sys.argv[2] icon_dump = sys.argv[3] if len(sys.argv) > 3 else None