📖 使用说明

首次使用

1. 访问 工作日志首页，使用管理员账户登录：admin / 000000
2. 登录后在 设置 → 修改密码 中修改默认密码
3. 在 设置 → 个人信息 中设置显示名称
4. 点击 编辑 按钮进入编辑模式，开始添加标签和工作记录

日常使用

1. 查看记录：通过日期导航（◀ ▶）或点击日期选择器切换日期
2. 添加记录：进入编辑模式 → 点击标签列下方的 + 添加工作
3. 编辑/删除：编辑模式下，悬浮卡片右上角出现操作按钮
4. 管理标签：编辑模式下，点击 + 新标签 添加，点击列头 × 删除
5. 统计图表：向下滚动到页面底部，展开统计面板
6. 项目管理：点击顶部 📊 项目 进入项目管理页面

项目管理

1. 在项目管理页面点击 新建项目
2. 填写项目名称、描述，选择关联标签（支持模糊搜索所有用户的标签）
3. 系统自动按标签匹配工作日志，聚合统计各成员的工作量
4. 点击项目卡片进入详情，查看柱状图、饼图和工作明细

工作流程

典型场景

获取 API Token

有两种方式获取 Token：

方式一：网页端获取

1. 登录工作日志网页
2. 点击 设置 → API Token 标签页
3. 复制显示的 Token 值

方式二：API 自动注册

HTTPPOST /api/agent/auth
Content-Type: application/json

{}

→ 返回: { "success": true, "user": { "id": 3, "username": "agent_xxxx", "api_token": "abc123..." } }

首次调用自动创建 Agent 专用账户，默认密码 000000，后续可登录网页修改。

Agent 认证

自动创建新用户（不传参数）或登录已有用户。

响应示例：

{
  "success": true,
  "user": {
    "id": 3,
    "username": "agent_mpj52yvm",
    "password": "000000",
    "api_token": "50cbc1af236578d6c219ee762c6f7c7c6e236c8722417ae1"
  }
}

Agent 上传工作记录

响应示例：

{
  "success": true,
  "id": 28,
  "user_id": 3,
  "username": "agent_mpj52yvm"
}

Agent 拉取工作记录

响应示例：

{
  "logs": [
    { "id": 28, "date": "2026-05-24", "tag": "ai运营师", "content": "...", "time": "10:00", "duration": "6h" }
  ],
  "total": 1
}

📊 报表查询（核心接口）

统一报表查询接口，支持按项目/个人查询今日/本周/自定义时间段的工作内容。Agent 通过此接口获取数据生成日报、周报。

典型用法

响应结构（type=project）

{
  "type": "project",
  "period": "week",
  "range": { "start": "2026-05-18", "end": "2026-05-24" },
  "summary": { "totalMin": 360, "totalHours": 6, "recordCount": 1 },
  "project": { "id": 2, "name": "云南交投ai运营", "tags": ["ai运营师"] },
  "byUser": [
    { "username": "agent_mpj52yvm", "displayName": "...", "totalMin": 360, "recordCount": 1 }
  ],
  "byDate": [
    { "date": "2026-05-24", "totalMin": 360,
      "records": [{ "id": 28, "tag": "...", "content": "...", "time": "10:00", "duration": "6h" }]
    }
  ],
  "records": [ ... ]
}

响应结构（type=personal）

{
  "type": "personal",
  "period": "today",
  "range": { "start": "2026-05-24", "end": "2026-05-24" },
  "summary": { "totalMin": 360, "totalHours": 6, "recordCount": 1 },
  "person": { "userId": 3, "username": "agent_mpj52yvm", "displayName": "..." },
  "byTag": [
    { "tag": "ai运营师", "totalMin": 360, "count": 1 }
  ],
  "byDate": [ ... ],
  "records": [ ... ]
}

项目列表查询

获取所有项目列表，用于查找 project_id。

响应示例：

{
  "projects": [
    { "id": 2, "name": "云南交投ai运营", "tags": ["ai运营师","云南交投项目"], "description": null }
  ]
}

工作记录增删改

通过 action 字段区分操作类型。

其他接口