DevTrack

DevTrack 的功能

• 监测提交，不会打断或替代常规 Git 命令。
• 在 v3.3.0 开发线中报告已完成的工作，不跟踪工时或每项任务的耗时。
• 将 feature/AUTH-42-refresh-token 等带工单名称的分支映射到工作项。
• 根据已完成的工作，生成可供审核的工单更新和每日工作总结。
• 将客户端本地 SQLite 作为事实来源，默认使用 Ollama 提供本地 AI 功能。
• 通过十个只读 MCP 工具，向兼容的助手共享当前工作和 DevTrack Sage 知识。

DevTrack 生成的内容不会自动发布。PM 更新、状态转换和交付内容都会放入待处理操作队列，直到获得批准。匿名遥测也需要主动选择加入，默认处于禁用状态。

开始使用

DevTrack 支持 Windows、macOS 和 Linux。需要安装 Git。核心 Go 客户端、SQLite 存储、Git 监测、队列和 MCP 功能都不需要 Python 或 AI 模型。托管 AI 功能需要 uv、PostgreSQL 和 LLM 提供商；默认使用 Ollama。

1. 安装

请使用引导式下载页面，或直接安装最新稳定版本：

Linux 或 macOS

curl -fsSL https://devtrack.cloud/install.sh | sh

Windows PowerShell

irm https://devtrack.cloud/install.ps1 | iex

手动下载的二进制文件和校验和可在 GitHub Releases 获取。

稳定版 v3.2.0 保留了原有的工时跟踪行为。修复和移除相关改动位于 dev 分支的 860b91b，为 v3.3.0 做好准备；滚动开发版本使用 dev-<commit>。向 dev 推送代码不会升级已安装的二进制文件，也不会发布新的稳定版本。请参阅开发版本说明和资格验证计划。

devtrack version

2. 配置代码库

在你希望 DevTrack 监测的 Git 代码库中运行设置程序：

cd /path/to/your/repository
devtrack setup
devtrack start
devtrack status
devtrack doctor

设置向导会配置运行模式、代码库、LLM、身份信息和可选的 PM 集成。评估仅限本地的使用方式时，请将 PM 集成设为 none。托管模式的可选 Python 服务需要 PostgreSQL；在准备该服务和模型期间，Go 原生功能仍可使用。

3. 尝试工作流

使用以工单命名的分支，并像平常一样提交：

git switch -c feature/AUTH-42-refresh-token
git commit -m "fix auth redirect"

devtrack logs
devtrack queue
devtrack eod

queue 可让你在批准任何操作前检查暂存的操作。完整的首次运行指南请参阅 快速入门。

在开发版本系列中，capture 会枚举本地各分支顶端尚未记录的提交，因此处理期间快速提交和切换分支的操作也会被纳入。请保持守护进程运行：启动时会导入现有历史记录，但无法保证会补录守护进程停止期间产生的提交。

devtrack work start AUTH-42 会选择备用工单上下文；work stop 会清除该上下文，work status 则会显示它。这些命令不会启动或停止计时器。devtrack work report 会通过配置的服务生成基于提交的 EOD 报告。

事故、用户故事、缺陷和任务都会根据其工作项引用进行映射：例如，Jira 事故 hotfix/OPS-123-restore-login、Azure DevOps 用户故事 feature/ADO-456-add-export，或 GitHub issue fix/GH-42-handle-timeout。PM 系统决定工作项类型，分支类型则不会。规范分支的优先级高于显式提交引用，后者又高于已选定的工单上下文。运行 devtrack ticket convention 和 devtrack ticket check <branch> 可查看规则；运行 devtrack ticket link <commit-hash> <ticket-ref> 可修正已发现的映射。 配置、冲突和示例请参阅工作项与工单映射。

devtrack eod status 和 devtrack eod show 会读取本地及服务端历史记录中的最新报告。 devtrack queue list --all 会显示两个存储位置中的近期操作。服务端操作使用 server:123 这样的 ID：将完整 ID 传给 queue approve、queue reject 或 queue edit。纯数字 ID 对应本地操作。服务不可用时会明确报告。

Agent 记忆与 DevTrack Sage

将 DevTrack 的只读 MCP 服务添加到当前项目：

devtrack mcp setup
devtrack mcp test
devtrack mcp status

设置完成后，重新加载支持 MCP 的助手。之后它可以读取当前工单上下文、提交、待处理操作、EOD 上下文、语音信息以及已发布的 Sage 知识。MCP 无法批准操作或修改 DevTrack 数据。

DevTrack Sage 会从受支持的编码框架中捕获有用的命令活动，并将重复工作整理为可搜索的本地 Markdown 知识：

devtrack sage status
devtrack sage search "docker compose"
devtrack sage topics

详见 MCP 与 Agent 记忆和 DevTrack Sage。

接下来

我想要……	指南
安装或升级 DevTrack	下载
完成首次运行工作流	快速入门
了解部署选项	安装
配置代码仓库、集成或模型	配置
查找命令	CLI 参考
连接 AI 助手	MCP 与 Agent 记忆
使用本地命令知识	DevTrack Sage
解决安装或运行时问题	故障排除
查看隐私与数据流	隐私
验证自动捕获和报告功能	基本工作流测试
映射事故、用户故事、缺陷和任务	工作项与工单映射
查看 v3.3.0 开发边界	开发版本说明

贡献者和维护者可以从代码仓库的文档索引和 架构文档开始了解。

隐私

默认情况下，Go、SQLite 和 Ollama 路径均在本地运行。只有为相应操作配置后，数据才会发送到外部 PM 系统、交付渠道和云端大模型。除非通过 devtrack telemetry on 显式启用，否则遥测功能始终处于关闭状态。启用外部服务前，请阅读完整的隐私指南。

许可证

DevTrack 使用 DevTrack Community License：个人使用和最多 10 人的团队可免费使用；更大的团队和托管使用则需要企业许可证。