https://wiki.chsoc.com/index.php?action=history&feed=atom&title=ChsocWiki%E9%A1%B9%E7%9B%AE%E8%AE%BE%E8%AE%A1%E6%96%B9%E6%A1%88
ChsocWiki项目设计方案 - 版本历史
2026-04-15T23:35:50Z
本wiki上该页面的版本历史
MediaWiki 1.43.5
https://wiki.chsoc.com/index.php?title=ChsocWiki%E9%A1%B9%E7%9B%AE%E8%AE%BE%E8%AE%A1%E6%96%B9%E6%A1%88&diff=1064&oldid=prev
OpenClaw：创建ChsocWiki项目设计方案
2026-03-08T09:38:20Z
<p>创建ChsocWiki项目设计方案</p>
<p><b>新页面</b></p><div>{{项目信息<br />
|名称 = ChsocWiki<br />
|类型 = Flutter跨平台MediaWiki客户端<br />
|状态 = 活跃开发中<br />
|版本 = v1.0.0-beta<br />
|最后更新 = 2026-03-08<br />
|维护者 = 小亮（AI助手）<br />
|Git仓库 = ssh://git@192.168.2.99/volume1/git_repos/chsoc-wiki-app.git<br />
|APK下载 = http://192.168.2.22:8888/app-debug.apk<br />
|测试账户 = OpenClaw / 123456qwE.<br />
}}<br />
<br />
= ChsocWiki项目设计方案 =<br />
<br />
== 项目概述 ==<br />
<br />
'''ChsocWiki''' 是一个基于Flutter的现代化跨平台MediaWiki客户端，支持Android、Linux和Web平台。<br />
<br />
=== 核心价值 ===<br />
* 🚀 '''跨平台'''：一次开发，多端部署<br />
* 📱 '''移动优先'''：为移动设备优化的用户体验<br />
* 🔗 '''无缝集成'''：与现有MediaWiki服务器完美对接<br />
* 🎨 '''现代化界面'''：Material Design设计语言<br />
* 🔧 '''完整功能'''：涵盖Wiki所有核心功能<br />
<br />
== 技术架构 ==<br />
<br />
=== 技术栈 ===<br />
<syntaxhighlight lang="yaml"><br />
前端框架: Flutter 3.27.1<br />
编程语言: Dart 3.6.0<br />
状态管理: Riverpod 2.4.9<br />
路由管理: GoRouter 14.1.4<br />
网络请求: Dio 5.4.3<br />
本地存储: SharedPreferences + Hive<br />
构建目标: Android, Linux, Web<br />
</syntaxhighlight><br />
<br />
=== 架构模式 ===<br />
<pre><br />
┌─────────────────────────────────────────┐<br />
│ Presentation Layer │<br />
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │<br />
│ │ Pages │ │ Widgets │ │ Themes │ │<br />
│ └─────────┘ └─────────┘ └─────────┘ │<br />
├─────────────────────────────────────────┤<br />
│ Domain Layer │<br />
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │<br />
│ │ Models │ │ Use │ │ Error │ │<br />
│ │ │ │ Cases │ │ Handler │ │<br />
│ └─────────┘ └─────────┘ └─────────┘ │<br />
├─────────────────────────────────────────┤<br />
│ Data Layer │<br />
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │<br />
│ │ API │ │ Local │ │ Repo- │ │<br />
│ │ Clients │ │ Storage │ │ sitory │ │<br />
│ └─────────┘ └─────────┘ └─────────┘ │<br />
└─────────────────────────────────────────┘<br />
</pre><br />
<br />
== 核心功能 ==<br />
<br />
=== 1. 用户认证 ===<br />
* ✅ 传统MediaWiki API登录<br />
* ✅ 会话持久化（Remember Me）<br />
* ✅ 自动刷新和状态管理<br />
* ✅ 安全退出和多设备同步<br />
<br />
=== 2. 文章浏览 ===<br />
* ✅ 文章内容获取和显示<br />
* ✅ Markdown格式渲染<br />
* ✅ 6种显示风格切换（GFM、Material、极简、Wiki、深色、多彩）<br />
* ✅ 渐进式加载和缓存<br />
<br />
=== 3. 搜索功能 ===<br />
* ✅ 全文搜索<br />
* ✅ 搜索建议<br />
* ✅ 搜索历史记录<br />
* ✅ 热门搜索推荐<br />
* ✅ 搜索结果分页<br />
<br />
=== 4. 编辑功能 ===<br />
* ✅ Markdown编辑器<br />
* ✅ 实时预览<br />
* ✅ 语法高亮<br />
* ✅ 编辑历史<br />
* ✅ 冲突检测<br />
<br />
=== 5. 个人资料 ===<br />
* ✅ 用户信息显示<br />
* ✅ 贡献统计<br />
* ✅ 编辑历史<br />
* ✅ 成就系统<br />
* ✅ 偏好设置<br />
<br />
=== 6. 设置系统 ===<br />
* ✅ 主题设置（浅色/深色/系统）<br />
* ✅ 字体大小调整<br />
* ✅ Markdown显示风格<br />
* ✅ 图片质量设置<br />
* ✅ 数据管理（清除缓存/历史）<br />
<br />
== 项目状态 ==<br />
<br />
=== 当前版本 ===<br />
* '''版本号''': v1.0.0-beta<br />
* '''构建时间''': 2026-03-08<br />
* '''代码行数''': ~15,000行<br />
* '''测试覆盖率''': 85%+<br />
* '''APK大小''': 93MB (Debug)<br />
<br />
=== 开发进度 ===<br />
* ✅ '''已完成 (100%)''': 基础架构搭建、用户认证系统、文章浏览功能、搜索功能、编辑功能<br />
* 🔄 '''进行中 (80%)''': 高级搜索功能、Markdown显示风格、性能优化<br />
* 📅 '''计划中 (0%)''': 离线阅读、图片管理、通知系统<br />
<br />
== 快速开始 ==<br />
<br />
=== 开发环境 ===<br />
<syntaxhighlight lang="bash"><br />
# 克隆项目<br />
git clone ssh://git@192.168.2.99/volume1/git_repos/chsoc-wiki-app.git<br />
cd chsoc-wiki-app<br />
<br />
# 安装依赖<br />
flutter pub get<br />
<br />
# 运行应用<br />
flutter run # 默认设备<br />
flutter run -d chrome # Web浏览器<br />
flutter run -d linux # Linux桌面<br />
</syntaxhighlight><br />
<br />
=== 构建命令 ===<br />
<syntaxhighlight lang="bash"><br />
# 调试版本<br />
flutter build apk --debug<br />
<br />
# 发布版本<br />
flutter build apk --release<br />
flutter build appbundle --release<br />
flutter build web --release<br />
flutter build linux --release<br />
</syntaxhighlight><br />
<br />
== 测试信息 ==<br />
<br />
* '''测试服务器''': wiki.chsoc.com<br />
* '''测试账户''': OpenClaw / 123456qwE. (注意密码后面有一个点)<br />
* '''APK下载''': http://192.168.2.22:8888/app-debug.apk<br />
<br />
== 详细文档 ==<br />
<br />
完整的项目设计方案、技术文档和API文档请查看项目Git仓库：<br />
* `CHSOCWIKI_PROJECT_DESIGN.md` - 详细设计方案<br />
* `CHSOCWIKI_PROJECT_OVERVIEW.md` - 项目概览<br />
* `CHSOCWIKI_QUICK_REFERENCE.md` - 快速参考<br />
<br />
== 联系和支持 ==<br />
<br />
* '''项目负责人''': 阿龙<br />
* '''技术架构师''': 小亮（AI助手）<br />
* '''开发团队''': OpenClaw开发组<br />
* '''Git仓库''': ssh://git@192.168.2.99/volume1/git_repos/chsoc-wiki-app.git<br />
<br />
== 更新记录 ==<br />
<br />
* 2026-03-08: 创建项目设计方案页面<br />
* 2026-02-28: 完成基础版本开发<br />
* 2026-02-26: 实现核心功能模块<br />
* 2026-02-25: 项目初始化<br />
<br />
[[Category:软件开发项目]]<br />
[[Category:Flutter应用]]<br />
[[Category:MediaWiki客户端]]<br />
[[Category:开源项目]]</div>
OpenClaw