TFS 2018 集成

WinCode 内置了对 TFS 2018 的集成,让开发者在 AI 对话过程中能够直接查询工作项、引用需求、关联 Bug。TFS 集成由 tfs 服务与 TfsWorkItemsWorkspace 工作区组成,前者负责与后端通信,后者提供可视化的交互界面。

配置(TfsConfig)

TFS 集成的配置(TfsConfig)由后端持久化,前端通过 tfsLoad() / tfsSave(config) 读写。配置包含:

• 服务器地址 serverUrl
• PAT 令牌 patToken(敏感信息,后端加密存储)
• 集合列表 collections 与默认集合 selectedCollection
• 默认项目 defaultProject

在设置页面里,TfsConfig 组件允许输入服务器地址和 PAT,并通过 tfsTest 测试连接,或通过 tfsFetchCollections 拉取可用的 TFS 集合。

TfsWorkItemsWorkspace

这是 TFS 集成的主工作区。打开后会:

1. 调用 tfsLoad() 读取配置,并自动选中 WINNING-6.0 集合或第一个可访问的集合。
2. 加载该集合下的查询快捷方式(tfsQueryShortcutList)。
3. 支持多种查询方式:
   • 我的任务:tfsMyTasks(context)
   • 未关闭 Bug:tfsOpenBugs(context)
   • 批量查询:tfsWorkItemBatch(ids, context)
   • 自定义 WIQL:tfsRunWiql(request)

WIQL 是 TFS 的工作项查询语言,WinCode 内置了默认的 WIQL 模板,也允许用户自行输入 WIQL 语句。查询结果以表格形式展示,点击某条工作项后,工作区会显示它的详情,并提供"在外部浏览器打开""复制为引用""发送到当前聊天"等操作。

查询快捷方式

高频的 WIQL 查询可以保存为快捷方式(TfsQueryShortcut)。tfsQueryShortcutSave 将查询保存到数据库,后续可以直接从下拉菜单中一键执行,适合团队内部沉淀常用的工作项视图。

TfsMcpCard

对于 Claude 对话中用到的 TFS MCP 工具,设置页面还提供了一个 TfsMcpCard,用于管理 TFS 相关的 MCP 服务器开关与 PAT 注入。MCP 工具会在 AI 需要操作 TFS 时被自动调用。

相关文档

• API 端点与网关配置
• 企业集成概览