Skip to content

feat(feedback): add a minimal in-app feedback form #190

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
CNDY1390 merged 7 commits into from
Nov 10, 2026
Merged

feat(feedback): add a minimal in-app feedback form #190

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
7861825
feat(feedback): add in-app feedback form
CNDY1390 Nov 9, 2026
2b9dd8e
style(feedback): shorten submission copy
CNDY1390 Nov 9, 2026
12bd0c2
feat(feedback): make profile sharing opt-in
CNDY1390 Nov 9, 2026
b95a9c5
feat(feedback): add optional image attachments
CNDY1390 Nov 9, 2026
9e6f72f
fix(feedback): retain image uploads and allow individual retries
CNDY1390 Nov 9, 2026
5cbf292
fix(feedback): explain invalid and excess image selections
CNDY1390 Nov 9, 2026
904dadb
fix(feedback): preserve backend authentication errors
CNDY1390 Nov 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
282 changes: 282 additions & 0 deletions lib/pages/feedback_page.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,282 @@
import 'dart:async';

import 'package:flutter/material.dart';
import 'package:image_picker/image_picker.dart';

import '../services/feedback_service.dart';
import '../utils/platform.dart';
import '../widgets/adaptive_button.dart';
import '../widgets/adaptive_page_navigation.dart';
import '../widgets/app_shell/app_shell_metrics.dart';
import '../widgets/blurred_app_bar.dart';
import '../widgets/ios/ios_native_navigation_bar.dart';

class FeedbackPage extends StatefulWidget {
const FeedbackPage({super.key, required this.service});
final FeedbackService service;

@override
State<FeedbackPage> createState() => _FeedbackPageState();
}

class _FeedbackPageState extends State<FeedbackPage> {
final _message = TextEditingController();
final _contact = TextEditingController();
final _images = <FeedbackImage>[];
bool _picking = false;
bool _includeUsername = false;
bool _includeEmail = false;
bool _busy = false;
bool _sent = false;
String? _error;

@override
void dispose() {
_message.dispose();
_contact.dispose();
super.dispose();
}

Future<void> _submit() async {
if (_busy || _picking || _sent) return;
FocusScope.of(context).unfocus();
setState(() {
_busy = true;
_error = null;
});
try {
await widget.service.submit(
_message.text,
includeUsername: _includeUsername,
includeEmail: _includeEmail,
contact: _contact.text,
images: _images,
onImageChanged: _refreshImages,
);
if (mounted) setState(() => _sent = true);
} catch (error) {
if (mounted) {
setState(() {
_error = error is TimeoutException
? '未能确认送达，内容已保留，请稍后再试'
: error is Exception && error.toString().startsWith('Exception: ')
? error.toString().substring(11)
: '反馈未发送成功，内容已保留';
});
}
} finally {
if (mounted) setState(() => _busy = false);
}
}

Future<void> _pickImages() async {
if (_picking || _busy || _images.length >= 9) return;
setState(() {
_picking = true;
_error = null;
});
try {
final files = await ImagePicker().pickMultiImage(
maxWidth: 1920,
maxHeight: 1920,
imageQuality: 85,
requestFullMetadata: false,
);
if (files.length > 9 - _images.length) throw Exception('最多添加 9 张图片');
final selected = <FeedbackImage>[];
for (final file in files) {
if (await file.length() > FeedbackService.imageLimit) throw Exception('每张图片请勿超过 4 MB');
final bytes = await file.readAsBytes();
try {
final decoded = await decodeImageFromList(bytes);
decoded.dispose();
} catch (_) {
throw Exception('图片无法读取，请换一张图片');
}
selected.add(FeedbackImage(bytes));
}
if (mounted) setState(() => _images.addAll(selected));
} catch (error) {
if (mounted) {
setState(
() => _error = error is Exception && error.toString().startsWith('Exception: ')
? error.toString().substring(11)
: '未能添加图片，请重试',
);
}
} finally {
if (mounted) setState(() => _picking = false);
}
}

void _refreshImages() {
if (mounted) setState(() {});
}

Future<void> _retryImage(FeedbackImage image) async {
if (_busy || _picking) return;
setState(() {
_busy = true;
_error = null;
});
try {
await widget.service.uploadImage(image, onChanged: _refreshImages);
} catch (_) {
if (mounted) setState(() => _error = '图片上传失败，可重试或移除');
} finally {
if (mounted) setState(() => _busy = false);
}
}

@override
Widget build(BuildContext context) {
final useIosChrome = isIos();
final topInset = useIosChrome || usesLegacyIosChrome()
? 0.0
: adaptiveTopBarHeight() + MediaQuery.viewPaddingOf(context).top;
return Scaffold(
extendBodyBehindAppBar: !useIosChrome && !usesLegacyIosChrome(),
appBar: useIosChrome
? IosNativeNavigationBar(
title: '问题反馈 / 功能建议',
leadingItems: const [
IosNativeNavigationBarItem(
id: 'back',
title: 'Settings',
sfSymbol: 'chevron.left',
accessibilityLabel: '返回 Settings',
placementGroup: 'leading-main',
),
],
onItemPressed: (_) => unawaited(maybePopAdaptivePage<void>(context)),
)
: const BlurredAppBar(title: Text('问题反馈 / 功能建议')),
body: ListView(
padding: EdgeInsets.fromLTRB(
20,
topInset + 20,
20,
AppShellMetrics.bottomContentPaddingOf(context) + 20,
),
children: _sent
? const [
SizedBox(height: 40),
Icon(Icons.check_circle_outline, size: 64),
SizedBox(height: 20),
Text('反馈已发送', textAlign: TextAlign.center),
]
: [
TextField(
controller: _message,
enabled: !_busy,
minLines: 6,
maxLines: 12,
maxLength: 2000,
decoration: const InputDecoration(
hintText: '描述问题或建议',
border: OutlineInputBorder(),
),
),
const SizedBox(height: 12),
if (_images.isNotEmpty)
Wrap(
spacing: 8,
runSpacing: 8,
children: [
for (var i = 0; i < _images.length; i++)
Stack(
children: [
Image.memory(
_images[i].bytes,
width: 88,
height: 88,
fit: BoxFit.cover,
),
if (_images[i].uploading)
const Positioned.fill(
child: Center(child: CircularProgressIndicator()),
),
if (_images[i].failed)
Positioned(
bottom: 0,
left: 0,
right: 0,
child: FilledButton(
onPressed:
_busy ? null : () => unawaited(_retryImage(_images[i])),
child: const Text('重试'),
),
)
else if (_images[i].uploaded)
const Positioned(
bottom: 0,
left: 0,
child: Icon(Icons.check_circle, color: Colors.green),
),
Positioned(
top: 0,
right: 0,
child: IconButton.filledTonal(
tooltip: '移除第 ${i + 1} 张图片',
icon: const Icon(Icons.close, size: 18),
onPressed: _busy || _picking
? null
: () => setState(() => _images.removeAt(i)),
),
),
],
),
],
),
AdaptiveButton(
label: '添加图片（${_images.length}/9）',
icon: Icons.add_photo_alternate_outlined,
sfSymbol: 'photo.badge.plus',
loading: _picking,
onPressed: _busy || _picking || _images.length >= 9
? null
: () => unawaited(_pickImages()),
),
CheckboxListTile(
title: const Text('发送用户名'),
value: _includeUsername,
onChanged: _busy ? null : (value) => setState(() => _includeUsername = value!),
controlAffinity: ListTileControlAffinity.leading,
contentPadding: EdgeInsets.zero,
),
CheckboxListTile(
title: const Text('发送邮箱'),
value: _includeEmail,
onChanged: _busy ? null : (value) => setState(() => _includeEmail = value!),
controlAffinity: ListTileControlAffinity.leading,
contentPadding: EdgeInsets.zero,
),
TextField(
controller: _contact,
enabled: !_busy,
maxLength: 200,
decoration: const InputDecoration(
labelText: '补充联系方式（选填）',
border: OutlineInputBorder(),
),
),
const SizedBox(height: 12),
const Text('自动附带 App 版本和平台。'),
if (_error != null) ...[
const SizedBox(height: 16),
Text(_error!, style: TextStyle(color: Theme.of(context).colorScheme.error)),
],
const SizedBox(height: 20),
AdaptiveButton(
label: '提交反馈',
icon: Icons.send_outlined,
sfSymbol: 'paperplane',
role: AdaptiveButtonRole.prominent,
loading: _busy,
onPressed: _busy || _picking ? null : () => unawaited(_submit()),
),
],
),
);
}
}
18 changes: 18 additions & 0 deletions lib/pages/settings_page.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@ import 'package:package_info_plus/package_info_plus.dart';
import 'package:techpie/services/auth_service.dart';
import 'package:url_launcher/url_launcher.dart';

import '../services/api_base_url.dart';
import '../services/feedback_service.dart';
import '../services/service_provider.dart';
import '../services/sync_service.dart';
import '../services/theme_service.dart';
Expand All @@ -32,6 +34,7 @@ import 'account_deletion_page.dart';
import 'debug_log_page.dart';
import 'debug_webview_page.dart';
import 'developer_lab_page.dart';
import 'feedback_page.dart';
import 'sync_settings_page.dart';
import 'third_party_accounts_page.dart';
import 'watch_settings_page.dart';
Expand Down Expand Up @@ -331,6 +334,21 @@ class _SettingsPageState extends State<SettingsPage> {
),
const Divider(),

ListTile(
leading: const Icon(Icons.feedback_outlined),
title: const Text('问题反馈 / 功能建议'),
trailing: const Icon(Icons.chevron_right),
onTap: () async {
if (!auth.isLoggedIn) await startUniAuthLogin(context);
if (!context.mounted || !auth.isLoggedIn) return;
await pushAdaptivePage<void>(
context,
builder: (_) => FeedbackPage(
service: FeedbackService(auth, apiBaseUrl(sp.storageService)),
),
);
},
),
ListTile(
leading: const Icon(Icons.privacy_tip_outlined),
title: const Text('隐私政策与使用支持'),
Expand Down
Loading
Loading