Obsidian/工具相关/工时填写.md

工时填写

下次怎么叫 AI 填写

推荐直接这样说：

填写工时，时间从 6月26日 到 6月30日，不备份，填完提交审核。
日志按工时考核月取 Obsidian 日志文件，内容按日期下面编号行原样填写，不带日期标题。

如果不确定是否备份，可以这样说：

填写工时，时间从 7月26日 到 7月30日。先问我要不要备份。

固定路径

• Obsidian 根目录：F:\AI\Obsidian
• 工时日志目录：F:\AI\Obsidian\日志\2026
• 工时工具：D:\softWare\timetrack-ui\项目工时管理.exe
• 长期记录：F:\AI\Obsidian\agent.md

换电脑后如果路径变了，先告诉 AI 新路径。

日志文件选择规则

工时系统按考核月统计，周期通常是：

• 上月 26 日到本月 25 日，属于本月考核月。

因此日志文件按考核月取：

• 2026-05-26 到 2026-06-25：取 日志6月.md
• 2026-06-26 到 2026-07-25：取 日志7月.md
• 2026-07-26 到 2026-08-25：取 日志8月.md

例如用户说“填写 6月26日到6月30日”，应取：

F:\AI\Obsidian\日志\2026\日志7月.md

工作内容提取规则

日志格式示例：

06.13 周六：
1.流转：
2.解决： 、
3.新增语音可见即可说功能
4.车控模块添加可见即可说的功能
5.分析鱼快倒车来电声音会从车机发出

提交到工时系统时只填日期标题下面的编号内容：

1.流转：
2.解决： 、
3.新增语音可见即可说功能
4.车控模块添加可见即可说的功能
5.分析鱼快倒车来电声音会从车机发出

注意：

• 不填写 06.13 周六： 这种日期标题。
• 保留 1.流转：。
• 保留 2.解决：，即使后面为空或只有符号。
• 保留编号行原始顺序。
• 去掉日期段落之间多余空行。
• 不要自己改写、总结或删减工作内容。

填写原则

只提交同时满足以下条件的日期：

• HR 系统有考勤工时。
• 日志内容非空。
• 工时系统当前未登记或未提交。

跳过以下日期：

• HR 工时为空或系统提示“没有考勤工时”。
• 日志为空。
• 已提交审核或已审核通过。

默认填写：

• 项目名称：固定选择 座舱类迭代项目集。
• 比例：100%
• 单日一条明细。
• 工作内容：取日志中对应日期编号行。
• 提交后点击或调用“提交审核”。

项目注意事项：

• 用户已明确要求项目名称必须选择 座舱类迭代项目集。
• 如果系统配置或接口逻辑会把项目自动校正到其他项目，应先停止提交并告诉用户，不要继续按错误项目提交。
• 提交后必须查询详情确认项目名称或项目 ID 对应的是 座舱类迭代项目集。

工时工具连接方式

优先使用 Electron 调试接口，比坐标点击稳定。

如果工时工具已打开但调试端口不可用，可以重启并带调试端口：

$exe = 'D:\softWare\timetrack-ui\项目工时管理.exe'
Get-Process | Where-Object { $_.Path -eq $exe } | Stop-Process -Force
Start-Sleep -Seconds 2
Start-Process -FilePath $exe -ArgumentList '--remote-debugging-port=9222','--remote-allow-origins=*'

检查调试端口：

Invoke-RestMethod -Uri 'http://127.0.0.1:9222/json/version'
Invoke-RestMethod -Uri 'http://127.0.0.1:9222/json/list'

页面通常类似：

file:///D:/softWare/timetrack-ui/resources/app.asar/dist/index.html#/home

常用接口线索

在页面上下文中调用接口，使用工具已有登录态，不要打印 token、密码或刷新令牌。

常用接口：

GET  /act/xmProjectWorktime/getHomeCalendarWorkTime/{考核月}
GET  /act/xmProject/xmProjectList?userId={userId}&workDate={YYYY-MM-DD}
GET  /act/hrUserWorktime/detail?userId={userId}&workDate={YYYY-MM-DD}
GET  /act/xmProjectWorktime/{id}
POST /act/xmProjectWorktime/save

注意：

• 真正提交审核使用 POST /act/xmProjectWorktime/save。
• 不要直接用 /act/xmProjectWorktime/checkSubmitTask 代替提交，之前直接调用会返回权限不足。
• 如果接口返回“用户凭证已过期”，优先让工具刷新登录态，或让用户重新登录；不要记录或展示密码/token。

提交 Payload 参考

字段形状参考：

{
  "id": "",
  "state": "",
  "userId": "1399",
  "deptId": 0,
  "workDate": "2026-06-26",
  "hrHours": "8",
  "totalHours": "",
  "agentFlag": 0,
  "detailList": [
    {
      "id": "",
      "workId": "",
      "projectId": "项目ID",
      "hours": "",
      "ratio": 100,
      "workContent": "日志编号内容",
      "remark": ""
    }
  ],
  "createdBy": "",
  "createdTime": "",
  "updatedBy": "",
  "updatedTime": "",
  "appVersion": 1
}

提交后校验

提交后必须重新查日历和详情：

• checkFlag: 3 表示等待审核/已提交审核。
• 有 id、lastTaskId、procInstId 说明流程已生成。
• 再查详情确认 workContent、projectId、ratio 写入正确。

最终回复用户时列出：

• 总共提交几条。
• 成功日期。
• 跳过日期和原因。
• 每天实际提交的工作内容。
• 每天实际选择的项目名称、比例和 HR 工时。
• 明确告诉用户“填写了什么”，包括实际写入系统的工作内容。
• 如果发现系统自动校正项目或内容与预期不一致，要说明并标记为风险。

已知经验

• 2026-06-25 已提交审核，checkFlag=3。
• 2026-06-26 到 2026-06-30 已提交审核，共 5 条。
• 2026-07 考核月系统配置曾将项目从 座舱类迭代项目集 自动校正为 基于国产高性能SOC边缘算力的设备自主诊断与预警系统。用户后续明确要求项目名称必须选择 座舱类迭代项目集，如果再次出现自动校正，应先停止并告知用户。

安全要求

• 操作开始前先确认是否备份，除非用户已明确说“不备份”。
• 不在文档中保存密码、token、refresh token、验证码。
• 不覆盖用户已有日志内容。
• 不删除或回退用户文件。
• 完成后把关键结果追加到 agent.md。