Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

TaskServer 3 (CCSync v3) Bugs and Improvements

已关闭
#617 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
45/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
停滞
技术栈
dart, flutter
领域
mobile

调研方向

首先阅读 origin.dart、complete.dart、manage_task_champion_creds_controller.dart、task.dart、profiles_list.dart 和 profile_view.dart,以梳理每项请求的变更。添加或更新 TaskForC.fromJson、completeTask 异常处理和超时配置的单元测试。所有五项验收标准均通过且列出的回归测试覆盖这些变更,即表示完成。

由索引模型根据 Issue 内容生成。

描述

Description

Several issues were identified in the TaskServer 3 (CCSync v3) integration of the Flutter application.
These include bugs affecting reliability, missing parsing functionality, and UI improvements to make configuration clearer.

This issue proposes fixes and enhancements to improve stability, error handling, and usability.


Problems Identified

1. Hardcoded Origin URL

File: origin.dart

Problem

The origin parameter is currently hardcoded to:

http://localhost:8080

This prevents the application from connecting to remote or user-configured backend servers.

Proposed Solution

Replace the hardcoded value with a dynamic function:

Future getOrigin()

This function retrieves the backend URL from:

CredentialsStorage.getApiUrl()


2. Invalid ScaffoldMessenger Context

File: complete.dart

Problem

The code attempts to call:

ScaffoldMessenger.of(context as BuildContext)

This may cause runtime crashes when the BuildContext is invalid or disposed.

Proposed Solution

Remove the unsafe UI call and instead:

  • Throw exceptions for non-200 HTTP responses
  • Allow the caller to handle UI feedback.

3. Excessive Timeout Duration

File: manage_task_champion_creds_controller.dart

Problem

The HTTP timeout is set to:

Duration(seconds: 10000)

(~166 minutes)

This prevents the application from failing quickly when the server is unreachable.

Proposed Solution

Reduce the timeout to:

Duration(seconds: 10)

This improves responsiveness when the TaskServer is unavailable.


4. Missing Annotation Parsing

File: task.dart

Problem

The TaskForC model initializes annotations as an empty list:

annotations = []

This ignores annotation data returned by the server.

Proposed Solution

Update the fromJson method to parse annotations dynamically using:

Annotation.fromJson


5. Mode Selector Visibility

Files

  • profiles_list.dart
  • profile_view.dart
Problem

The TW2 / TW3 / TW3C mode selector is buried inside the profile view and lacks visibility.

Users cannot easily determine the currently active mode.

Proposed Solution

Add a getModeLabel callback to display the currently selected mode as a subtitle in the Change Mode option.


Acceptance Criteria

  • Origin URL is dynamically retrieved
  • ScaffoldMessenger crash is removed
  • Timeout duration is reduced
  • Task annotations are parsed correctly
  • Current mode is visible in the profile UI

Tests

Unit tests should verify:

  • Annotation parsing in TaskForC.fromJson
  • Exception handling in completeTask
  • Timeout configuration regression
主要语言
Dart
星标
244
派生
180
平均合并
16 小时 19 分钟
30 天内合并 PR
4

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

CCExtractor/taskwarrior-flutter 的其他 Issue

查看 CCExtractor/taskwarrior-flutter 的全部 Issue

相似的 Issue

更多 Dart Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。