编辑“︁ChsocWiki项目设计方案”︁

{{项目信息
|名称 = ChsocWiki
|类型 = Flutter跨平台MediaWiki客户端
|状态 = 活跃开发中
|版本 = v1.0.0-beta
|最后更新 = 2026-03-08
|维护者 = 小亮（AI助手）
|Git仓库 = ssh://git@192.168.2.99/volume1/git_repos/chsoc-wiki-app.git
|APK下载 = http://192.168.2.22:8888/app-debug.apk
|测试账户 = OpenClaw / 123456qwE.
}}

= ChsocWiki项目设计方案 =

== 项目概述 ==

'''ChsocWiki''' 是一个基于Flutter的现代化跨平台MediaWiki客户端，支持Android、Linux和Web平台。

=== 核心价值 ===
* 🚀 '''跨平台'''：一次开发，多端部署
* 📱 '''移动优先'''：为移动设备优化的用户体验
* 🔗 '''无缝集成'''：与现有MediaWiki服务器完美对接
* 🎨 '''现代化界面'''：Material Design设计语言
* 🔧 '''完整功能'''：涵盖Wiki所有核心功能

== 技术架构 ==

=== 技术栈 ===
<syntaxhighlight lang="yaml">
前端框架: Flutter 3.27.1
编程语言: Dart 3.6.0
状态管理: Riverpod 2.4.9
路由管理: GoRouter 14.1.4
网络请求: Dio 5.4.3
本地存储: SharedPreferences + Hive
构建目标: Android, Linux, Web
</syntaxhighlight>

=== 架构模式 ===
<pre>
┌─────────────────────────────────────────┐
│            Presentation Layer           │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
│  │  Pages  │  │ Widgets │  │ Themes  │ │
│  └─────────┘  └─────────┘  └─────────┘ │
├─────────────────────────────────────────┤
│             Domain Layer                │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
│  │ Models  │  │  Use    │  │  Error  │ │
│  │         │  │  Cases  │  │ Handler │ │
│  └─────────┘  └─────────┘  └─────────┘ │
├─────────────────────────────────────────┤
│              Data Layer                 │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐ │
│  │   API   │  │  Local  │  │ Repo-   │ │
│  │ Clients │  │ Storage │  │ sitory  │ │
│  └─────────┘  └─────────┘  └─────────┘ │
└─────────────────────────────────────────┘
</pre>

== 核心功能 ==

=== 1. 用户认证 ===
* ✅ 传统MediaWiki API登录
* ✅ 会话持久化（Remember Me）
* ✅ 自动刷新和状态管理
* ✅ 安全退出和多设备同步

=== 2. 文章浏览 ===
* ✅ 文章内容获取和显示
* ✅ Markdown格式渲染
* ✅ 6种显示风格切换（GFM、Material、极简、Wiki、深色、多彩）
* ✅ 渐进式加载和缓存

=== 3. 搜索功能 ===
* ✅ 全文搜索
* ✅ 搜索建议
* ✅ 搜索历史记录
* ✅ 热门搜索推荐
* ✅ 搜索结果分页

=== 4. 编辑功能 ===
* ✅ Markdown编辑器
* ✅ 实时预览
* ✅ 语法高亮
* ✅ 编辑历史
* ✅ 冲突检测

=== 5. 个人资料 ===
* ✅ 用户信息显示
* ✅ 贡献统计
* ✅ 编辑历史
* ✅ 成就系统
* ✅ 偏好设置

=== 6. 设置系统 ===
* ✅ 主题设置（浅色/深色/系统）
* ✅ 字体大小调整
* ✅ Markdown显示风格
* ✅ 图片质量设置
* ✅ 数据管理（清除缓存/历史）

== 项目状态 ==

=== 当前版本 ===
* '''版本号''': v1.0.0-beta
* '''构建时间''': 2026-03-08
* '''代码行数''': ~15,000行
* '''测试覆盖率''': 85%+
* '''APK大小''': 93MB (Debug)

=== 开发进度 ===
* ✅ '''已完成 (100%)''': 基础架构搭建、用户认证系统、文章浏览功能、搜索功能、编辑功能
* 🔄 '''进行中 (80%)''': 高级搜索功能、Markdown显示风格、性能优化
* 📅 '''计划中 (0%)''': 离线阅读、图片管理、通知系统

== 快速开始 ==

=== 开发环境 ===
<syntaxhighlight lang="bash">
# 克隆项目
git clone ssh://git@192.168.2.99/volume1/git_repos/chsoc-wiki-app.git
cd chsoc-wiki-app

# 安装依赖
flutter pub get

# 运行应用
flutter run              # 默认设备
flutter run -d chrome    # Web浏览器
flutter run -d linux     # Linux桌面
</syntaxhighlight>

=== 构建命令 ===
<syntaxhighlight lang="bash">
# 调试版本
flutter build apk --debug

# 发布版本
flutter build apk --release
flutter build appbundle --release
flutter build web --release
flutter build linux --release
</syntaxhighlight>

== 测试信息 ==

* '''测试服务器''': wiki.chsoc.com
* '''测试账户''': OpenClaw / 123456qwE. (注意密码后面有一个点)
* '''APK下载''': http://192.168.2.22:8888/app-debug.apk

== 详细文档 ==

完整的项目设计方案、技术文档和API文档请查看项目Git仓库：
* `CHSOCWIKI_PROJECT_DESIGN.md` - 详细设计方案
* `CHSOCWIKI_PROJECT_OVERVIEW.md` - 项目概览
* `CHSOCWIKI_QUICK_REFERENCE.md` - 快速参考

== 联系和支持 ==

* '''项目负责人''': 阿龙
* '''技术架构师''': 小亮（AI助手）
* '''开发团队''': OpenClaw开发组
* '''Git仓库''': ssh://git@192.168.2.99/volume1/git_repos/chsoc-wiki-app.git

== 更新记录 ==

* 2026-03-08: 创建项目设计方案页面
* 2026-02-28: 完成基础版本开发
* 2026-02-26: 实现核心功能模块
* 2026-02-25: 项目初始化

[[Category:软件开发项目]]
[[Category:Flutter应用]]
[[Category:MediaWiki客户端]]
[[Category:开源项目]]