conductor-manage

Conductor Track Manager

技能概述

conductor-manage 是 Conductor 框架的轨道生命周期管理工具，支持轨道的归档、恢复、删除、重命名和孤立文件清理等完整操作。

适用场景

1. 项目完成后的轨道归档

当 Conductor 轨道对应的项目或任务完成后，可以使用 --archive 将轨道从活跃状态移至归档状态，保持工作区整洁同时保留历史记录。

2. 清理孤立和废弃文件

使用 --cleanup 功能可以扫描并清理没有对应轨道元数据的孤立文件（orphaned artifacts），释放存储空间并维护代码库的整洁性。

3. 轨道恢复与重命名

需要重新激活已归档的轨道时，使用 --restore；或在项目重命名时使用 --rename 同步更新轨道名称，保持 tracks.md 与实际项目结构一致。

核心功能

轨道归档与恢复

支持将活跃轨道移至归档状态（archive），或将已归档轨道恢复为活跃状态（restore）。操作会自动更新 tracks.md 和相关元数据，确保状态一致性。

轨道删除与重命名

提供安全的轨道删除（delete）功能，执行前会要求确认并建议备份。重命名（rename）功能可同步更新轨道名称和所有相关引用。

孤立文件清理

cleanup 模式扫描 conductor/ 目录，识别并清理没有对应轨道记录的孤立文件，帮助维护代码库的整洁性。

轨道状态查询

使用 --list 可快速查看所有轨道的状态（活跃、已完成、已归档），便于项目管理和团队协作。

常见问题

conductor-manage 支持哪些操作？

支持六种操作模式：--archive（归档）、--restore（恢复）、--delete（删除）、--rename（重命名）、--list（列出状态）和 --cleanup（清理孤立文件）。

删除轨道前需要备份什么数据？

在执行 --delete 操作前，建议备份整个 conductor/ 目录以及 tracks.md 文件。删除操作不可逆，会永久移除轨道的所有相关文件和元数据。

怎样清理 Conductor 中的孤立文件？

使用 conductor-manage --cleanup 命令可以扫描并清理没有对应轨道记录的孤立文件。操作前会显示将要删除的文件列表，需要确认后才会执行。

归档的轨道可以恢复吗？

可以。使用 --restore 操作可以将已归档的轨道恢复到活跃状态。恢复后，轨道会重新出现在活跃轨道列表中，所有历史数据和元数据都会保留。

conductor-manage 需要什么权限？

需要对 conductor/ 目录及其子目录的读写权限，以及修改 tracks.md 文件的权限。如果使用版本控制系统，还需要相应的 git 提交权限。