事项管理指南

GIIP 内部 Agent Worker（GIIP CSN 47 等）处理事项的创建、查看、状态管理操作员指南。

🔧 前往事项管理 →

📋 概述

事项管理菜单是用于注册 GIIP 平台内部 Agent Worker 处理的工作并跟踪其进度的操作工具。按 CSN（客户/服务号）分离管理事项，每项事项经历状态转换：PENDING → READY → IN_PROGRESS → REVIEW → DONE。

🎯 各页面角色

页面	路径	主要操作
列表	/admin/giip-issues	查看事项列表、筛选（Active/Done）、切换项目
详情	/admin/giip-issues/[isn]	查看事项内容、更新状态、添加评论、Dispatch
创建	/admin/giip-issues/new	注册新事项（标题、内容、状态、目标服务器）
编辑	/admin/giip-issues/[isn]/edit	编辑现有事项的标题、内容、状态

🛠️ 主要工作流程

1. 注册新事项

1. 选择项目 (CSN) — 先从顶部导航选择 CSN。
2. 点击新建事项按钮。
3. 输入标题、内容、初始状态（PENDING/READY），必要时选择目标服务器（lssn）。
4. 如果需要 Agent Readiness，确认检查清单后提交。

2. 管理事项状态

• READY: 等待 Agent 处理。MinAgeMinutes ≥ 60 后可转换为 IN_PROGRESS。
• IN_PROGRESS: Agent 正在处理中。
• REVIEW: Agent 已完成处理，等待验证。
• DONE: 处理完成。

3. 添加评论

在详情页下方可以记录事项进展、判断依据、工作结果为评论。

🔗 相关指南

关于事项管理的 API 集成和最终用户用法，请参阅：

📘 事项管理 API 参考 → 👤 事项管理最终用户指南 →

💡 注意事项

• 如果未先选择 CSN，事项列表将不会显示。
• 写页面（new/edit）需要最低级别 70（管理员）权限。
• 状态转换必须遵循正确顺序（PENDING → READY → IN_PROGRESS → REVIEW → DONE）。

故障排除

症状	原因	解决方案
事项列表为空	未选择 CSN	先从顶部导航选择项目。
状态转换失败	无效的状态转换	确认顺序：PENDING→READY、READY→IN_PROGRESS、IN_PROGRESS→REVIEW、REVIEW→DONE。
Agent Readiness 检查失败	目标服务器上没有符合条件的 Agent	确认目标服务器（lssn），或临时禁用 PENDING/READY 状态下的 Agent Readiness 要求。

---

角色: product 功能（登录后内部操作员 — 不对外公开） 版本: 1.0 最后更新: 2026-08-17 源文件: giipv3/public/help/giip-issue.zh-CN.md