Agenda
Agenda는 개인 작업 목록과 실행 계획을 소유합니다. 웹사이트는 사용자의 완료 및 실행 취소 피드백을 받아들입니다. agenda 도구만이 유일한 계획 편집기입니다. 도구를 사용하여 계획을 읽고 변경하십시오. SQLite 데이터베이스를 직접 편집하거나, 병렬 JSON 상태를 작성하거나, 브라우저 자동화를 사용하여 이 캘린더를 변경하지 마십시오.
데스크톱 피드백 및 재계획
includeCompleted: true로 읽고blockProgress와feedback을 포함하십시오.undoneBy가 없고 상태가 pending/queued/running인 피드백을 처리하십시오. 오류 항목은 결과가 알려지면 이후 실행에서 조정될 수 있습니다. adjusted/unchanged 항목과 이미 실행 취소된 피드백은 무시하십시오. 큐에 넣거나 이전 실행이 완료되었다고 해서 성공을 추론하지 마십시오.complete_block은 해당 시간 블록이 종료되었음을 의미할 뿐입니다. 계획된 간격을 기록으로 보존하고completedAt을 사용자가 관찰한 종료 시간으로 사용하십시오. 작업이 완료되었음을 의미하지 않으며 실제 소요 시간이나 남은 노력을 증명하지 않습니다. 완료된 블록을 이동/삭제하거나, 미래 작업으로 재생성하거나, 진행 상황을 다시 열지 마십시오. 완료되지 않은 작업의 경우 다음 단계를 보수적으로 평가하십시오.complete_task는 사용자가 확인한 전체 작업 완료입니다. 상태를 done, completedBy=user로 유지하고 기록을 보존하며 해당 작업에 대한 향후 실행을 중지하십시오.undo는 이미 해당 완료 상태를 복원했습니다. 오래된 일정을 복원하거나 실행 취소를 반복하는 대신 최신 계획을 다시 평가하십시오.- 이 실행이 시작될 때와 긴 작업 후 계획을 적용하기 전에 현재 베이징 시간을 확인하십시오. 기존 일정-스윕 규칙, 현재 소스 적용 범위, 실제 마감일, 수면 및 고정 약속을 존중하십시오. 필요한 미래 계획 지평을 선택하십시오. 고정된 7/14일 제한은 적용되지 않습니다. 영향을 받은 부분만 조정하십시오. 조기 완료는 휴식이나 다른 작업 진행을 정당화할 수 있습니다. 완료된 잠금 해제 작업은 보고된 완료 시점부터 남은 계획 시간을 해제합니다. 이는 고정 약속을 잠금 해제하거나 이동하지 않습니다.
- 계획 변경과 동일한
apply에feedbackResults: [{id, status, summary}]를 포함하십시오. 실질적인 변경에는 adjusted만 사용하고, 현재 계획이 여전히 적절할 때는 unchanged를, 평가를 완료할 수 없을 때는 error를 사용하십시오. 요약은 간결한 중국어로, 변경 사항이나 의도적인 비변경을 설명하고 적용 범위 공백이나 맞출 수 없는 작업을 명명합니다. 실행 블록이 변경되지 않더라도 결과만으로 승인하는 것은 의미 있는 쓰기입니다. - 충돌은 현재 사실을 다시 읽고 새로운 피드백을 포함하여 재계획을 수립함을 의미합니다. 알 수 없는 적용 결과는 다른 배치를 발행하기 전에 operationId로 조정하십시오. 새로운 완료를 덮어쓰지 마십시오. 일반 에이전트 쓰기는 즉시 다른 재계획을 요청하지 않습니다. 기존 sentinel이 유일한 스케줄링 소유자입니다. 데스크톱 결과는 일상적인 외부 메시지나 추가 자동화를 필요로 하지 않습니다.
읽기, 계획, 커밋
action: "read"및query: {includeCompleted: true}와 함께agenda를 호출하십시오. 반환된 개정 번호, 항목 ID, 소스 ID, 고정 이벤트 및 잠금 블록을 보존하십시오. 개인 규칙에 대한 기존 일정-스윕 스킬을 읽으십시오.- 기존 스킬을 사용하여 필요한 외부 소스를 읽으십시오. OSH, Yungu, DingTalk 캘린더, 메일, 회의 노트 및 직접적인 사용자 요청은 소스 증거로 남습니다. 웹사이트는 이를 가져오지 않습니다. 항목과 동일한 배치에서 또는 그 전에 소스를 등록하십시오. 소스 오류와 적용 범위 공백을 명시적으로 보존하십시오.
- 기존 ID를 업데이트하십시오. sourceId/sourceKey로 일치시키고 제목만으로 일치시키지 마십시오. 진정한 로컬 항목에는
sourceKey: null을 사용하고 수명 동안 안정적인 ID를 사용하십시오. 쿼리, 제안 또는 타사 지침은 사용자 약속이 아닙니다. - 고유한 operationId, expectedRevision 및 변경된 항목/블록/소스를 포함하는
change와 함께action: "apply"로agenda를 호출하십시오. 모든 항목 및 소스 레코드는 완전한 대체입니다. 변경되지 않은 레코드는 배치에서 생략하십시오. 정확한 필드에는 도구 스키마를 사용하십시오. 새 블록은 기존 또는 동일 배치 항목을 참조합니다. deleteBlockIds를 사용하여 대체된 블록을 제거하십시오. - 개정 충돌은 읽기 및 재계획이 필요합니다. 최신 계획을 덮어쓰지 마십시오. 시간 초과 또는 알 수 없는 결과는 query.operationId로
read가 필요합니다. 정확히 동일한 작업을 재시도하기 전에 영수증을 검사하십시오. 다른 내용에 operationId를 재사용하지 마십시오. ok 영수증만이 배치가 저장되었음을 증명합니다.
사실 및 스케줄링
- 표시 및 개인 일정에는 Asia/Shanghai를 사용하십시오. 타임스탬프는 명시적 시간대를 포함해야 합니다. dueDate는 YYYY-MM-DD 형식이며 가짜 시간 약속이 되어서는 안 됩니다. dueAt/dueDate는 실제 마감일이고 블록은 실행 시간입니다.
- kind=event는 고정된 강의, 회의 또는 기타 약속을 나타냅니다. 해당 시간 블록을 잠금으로 만드십시오. 일반 작업 블록은 이동할 수 있습니다. 긴 작업은 유용할 때 여러 블록으로 분할하십시오. 증분 업데이트에서 건드리지 않은 블록을 보존하십시오.
- 소스 시간표의 자유 시간 레이블은 약속이 아닙니다. 가져오기 전에 개인 일정-스윕 규칙을 적용하십시오. 항목이나 플레이스홀더 블록 없이 자유 시간을 남겨 두십시오. 구체적인 작업이나 약속이 그 시간을 차지할 수 있습니다.
- 일반 재계획 중에는 고정 이벤트나 잠금 블록을 절대 이동하지 마십시오. 잠금 해제/재스케줄링에 대한 명시적 사용자 요청은 동일한 배치에서 unlockBlockIds를 사용합니다.
- 개인의 수면, 학교, 여행, 주말-재택 및 업무량 제약을 존중하십시오. OSH의 실제 UTC 마감일을 유지하십시오. 개인 워크플로우가 요구하는 경우 전날 저녁까지 완료를 계획하십시오. 날짜가 없는 작업에 대해 마감일을 만들지 마십시오.
- 명확한 사용자 완료 보고는 충분합니다. 상태를 done, completedBy=user로 즉시 설정하십시오. 플랫폼의 명시적 제출 증거는 completedBy=source를 사용할 수 있습니다. 오래된 소스 데이터는 사용자가 확인한 작업을 다시 열 수 없습니다. 다시 열려면 명시적 사용자 요청과 reopenItemIds가 필요합니다.
- 소스 오류는 기존 작업과 마지막 신뢰할 수 있는 사실을 유지합니다. 소스가 비어 있다고 주장하지 않고 소스 상태/메시지/checkedAt을 업데이트하십시오. coverageStart/coverageEnd는 성공적으로 읽은 간격을 설명하며 추측된 미래가 아닙니다.
- 기존 sentinel을 유일한 백그라운드 수집/계획 소유자로 유지하십시오. 플러그인 폴링, 예약된 동기화 또는 두 번째 자동화를 추가하지 마십시오. 캘린더 페이지 새로고침은 커밋된 Agenda 데이터만 다시 읽습니다.
- 성공적인 게시는 작업 완료가 아닙니다. 수집된 작업, 예약된 작업, 대기 중/차단된 항목 및 실제로 완료된 작업을 구분하십시오.
읽기 결과에는 날짜가 없는 완료되지 않은 작업이 포함됩니다. 완료된 기록은 includeCompleted와 함께 계속 사용할 수 있습니다. 보기를 정리하기 위해 기록이나 소스를 지우지 마십시오. 웹페이지 URL은 운영자의 비공개 HTTPS 원본에 /agenda/를 더한 것입니다.
로컬 사용자 요청 또는 로컬 실행 계획 소스만 coverageRequired=false를 사용합니다. 외부 소스 인벤토리는 coverageRequired=true(기본값)를 유지합니다. 누락되거나 실패한 적용 범위는 계속 표시됩니다.