file-time-magic — 文件时间属性修改技能 v1.1.1

核心功能

⚠️ 核心原则

命令语法

# 基本用法（只指定编辑时长）
python "{SKILL_DIR}/scripts/set_file_time.py" --file "<文件路径>" --edit-duration "2小时"

# 指定创建时间
python "{SKILL_DIR}/scripts/set_file_time.py" --file "<文件路径>" --create-time "2024-01-15 09:30:00" --edit-duration "3小时"

# 指定修改时间
python "{SKILL_DIR}/scripts/set_file_time.py" --file "<文件路径>" --modify-time "2026-04-18 14:00:00" --edit-duration "90分钟"

# 同时指定创建时间和修改时间（自动计算编辑时长）
python "{SKILL_DIR}/scripts/set_file_time.py" --file "<文件路径>" --create-time "2024-01-15 09:00:00" --modify-time "2026-04-18 14:00:00"

# 预览（不实际修改）
python "{SKILL_DIR}/scripts/set_file_time.py" --file "<文件路径>" --edit-duration "2小时" --dry-run

参数说明

* 至少需要指定 --edit-duration 或 --create-time/--modify-time 其中之一

使用模式

时间计算规则

1. 编辑时长随机化

   • "X小时"：实际 = X×60 ± random(-5, +5) 分钟
   • "X分钟"：实际 = X ± random(-3, +3) 分钟
   • 秒数：random(0, 59)

2. 创建时间

   • 用户指定时：直接使用（加随机秒）
   • 自动计算时：调整到工作时间（08:00-22:00）

3. 修改时间

   • 用户指定时：直接使用（加随机秒）
   • 自动计算时：= 创建时间 + 编辑时长 + random(0, 2) 分钟

4. 访问时间

   • 用户指定时：直接使用
   • 自动计算时：= 修改时间 + random(3, 15) 分钟

时长格式支持

时间格式支持

Office 文件内部结构

对于 .docx / .pptx / .xlsx，脚本同时修改两处：

为什么两个都要改？
如果只改 app.xml，Word 属性对话框里的"创建时间"和"修改时间"仍然是旧值，容易露馅。

文件夹支持

注意：文件夹不支持 --edit-duration（无内部编辑时长）。

处理边界情况

验证修改结果

PowerShell：

Get-Item "文件路径" | Select-Object Name, CreationTime, LastWriteTime

Office 内部（用 Python 直接读 XML）：

import zipfile, xml.etree.ElementTree as ET
with zipfile.ZipFile("file.docx") as z:
    # 编辑时长
    app = ET.fromstring(z.read('docProps/app.xml'))
    ns = 'http://schemas.openxmlformats.org/officeDocument/2006/extended-properties'
    tt = app.find('{%s}TotalTime' % ns)
    print('TotalTime:', tt.text, '分钟')
    # 创建/修改时间
    core = ET.fromstring(z.read('docProps/core.xml'))
    for el in core:
        if 'created' in el.tag or 'modified' in el.tag:
            print(el.tag.split('}')[1], ':', el.text)

注意事项

• 修改 Office 文件需要解压和重新打包（过程安全）
• 临时目录用 PID 区分，避免并发冲突
• 创建时间使用 Windows API SetFileTime（无需 PowerShell）
• --dry-run 模式适合先验证时间计算结果再执行

v1.1 更新内容

• 🐛 修复：tmp_dir 缩进错误导致脚本崩溃
• 🐛 修复：core.xml（创建/修改时间）未被更新
• 🐛 修复：parse_duration("2小时") 返回 115 而非 120
• 🐛 修复：PowerShell 子进程调用在部分环境失败
• 🐛 修复：Windows API SetFileTime UTC 时区转换
• ✨ 新增：用户同时指定 create+modify 时，编辑时长自动从差值计算
• ✨ 新增：Windows 原生 API 设置文件时间（不依赖 PowerShell）
• 📄 更新：输出 JSON 增加 office_internal 字段