《人工智能与计算机概论》课程大作业设计规划方案
项目名称：基于Halo与OpenList的多功能团队协作与知识共享平台
队伍名称：404Found
一、 前言与项目愿景
在当今信息技术驱动的学习与研究环境中，高效的知识管理与团队协作能力已成为核心素养。本团队观察到，在课程小组作业、科创项目及学术研讨中，知识碎片化、文档版本混乱、沟通与创作平台分离的问题尤为突出。为解决这一实际痛点，我们决定设计并构建一个 “多功能团队协作与知识共享平台” 。
本项目旨在深度融合现代化的内容管理能力与高效的文档协同体验。我们选用Halo作为核心的内容创作与社区交互引擎，并计划整合OpenList以构建团队结构化文档库，以此打造一个集文章发布、团队空间、文档协同、即时交流于一体的综合性平台。我们的核心愿景是：“打破信息孤岛，为中小型团队提供一个一体化、轻量化、可扩展的协作中心，激发知识共创的潜能。”
二、 优秀作品阅读与评价
为汲取灵感，我们选择了“软件应用与开发”大类下的“Web应用与开发”与“大数据应用”方向进行作品赏析。
作品一：中国大学生计算机设计大赛获奖作品《智能实验室数据管理平台》
- 时代与领域洞察：紧扣“智能制造”与“实验室数字化”趋势，解决科研团队中实验数据记录分散、共享困难、安全性低的痛点。
- 核心场景与用户分析：面向高校实验室师生及研发团队。用户关键需求在于数据的结构化录入、团队内安全共享、版本追溯以及可视化分析。该作品通过角色权限和流程设计，满足了多人协同科研的需求。
- 功能架构与特色分析：其创新性在于将管理信息系统（MIS）的流程控制思维与科研场景深度结合。技术架构上实现了前后端分离，实用性强，为团队协作类工具设计提供了范本。
作品二：参考作品《大作业文本分析案例-红楼梦分析》
- 时代与领域洞察：体现了“数据驱动”的研究范式在人文社科的渗透，展示了如何利用技术工具提升团队研究效率。
- 核心场景与用户分析：适用于研究小组对特定文本进行协同分析。用户需要共同处理数据、交换分析脚本、统一可视化标准。该作品虽为个人项目，但其完整的数据分析流水线（数据-清洗-分析-可视化）正是团队协作中需要标准化和共享的核心资产。
- 功能架构与特色分析：其特色在于项目结构的清晰性和可复现性。这启示我们，一个优秀的协作平台必须能够良好地管理代码、数据和文档，确保团队每个成员都能在统一的基准上工作。
启发性总结：优秀作品共同揭示了成功协作工具的要素：1）精准切合某一垂直场景的协作痛点；2）建立清晰的权限与数据归属规则；3）提供标准化、结构化的内容管理方式；4）技术方案确保系统的稳定性和可扩展性。这为我们规划一个通用的团队协作平台指明了方向。
三、 创作背景与作品规划
1. 创作背景与核心价值
在完成课程项目及参与竞赛的过程中，我们深切体会到工具链割裂带来的效率损耗：讨论在微信、文档在金山/腾讯文档、代码在GitHub、最终报告在Word，知识资产散落各处，难以沉淀和检索。市场上虽有Notion、飞书等成熟产品，但其云端托管、定制性弱的特点，有时无法满足对数据私有化、功能个性化有更高要求的团队。
因此，本项目旨在开发一个可自主部署、功能聚合、注重数据私有化的团队协作解决方案。它既提供开箱即用的博客、wiki、讨论功能，又能通过集成OpenList统一管理各类文件资产。其核心价值是：“为中小型团队及技术爱好者提供一个功能聚合、数据自控、可深度定制的‘私有化协作空间’，降低协作成本，提升知识流转与沉淀的效率。”
2. 系统功能规划
平台将围绕“内容协同”、“知识库”、“团队管理”三个核心维度构建。
| 功能模块 | 核心功能点 | 详细描述（用户故事示例） |
|---|---|---|
| 团队与权限系统 | 多团队/空间创建 | 作为项目组长，我可以创建一个名为“AI大作业-16组”的私有团队空间，并邀请成员加入。 |
| 精细化角色权限 | 作为团队管理员，我可以为成员分配“作者”、“编辑”、“读者”等角色，控制其发布、修改内容的权限。 | |
| 内容创作与协同 | 多人博客与投稿 | 作为团队成员，我可以在团队空间内撰写项目周报或技术文章，并可选择“发布”或“投稿”至团队博客，由负责人审核。 |
| 瞬间（Micro-blog） | 作为成员，我可以快速发布一条“瞬间”来分享一个链接、一个想法或项目进展，与团队进行轻量级互动。 | |
| 评论与对话 | 作为读者，我可以对任何文章或瞬间进行评论，形成围绕具体内容的讨论线程。 | |
| 结构化知识库 | OpenList文档中心 | 作为团队成员，我可以将项目相关的设计文档、数据集、参考论文等文件上传至团队OpenList目录，生成一个可在线预览、分享、带权限管理的文档库页面。 |
| 文章与文档关联 | 在一篇技术文章中，我可以直接嵌入或链接到OpenList中存放的算法流程图（PDF）或演示视频，实现内容深度融合。 | |
| 发现与连接 | 全局搜索 | 我可以在平台内跨团队、跨内容类型（文章、瞬间、文档）搜索关键词，快速找到所需信息。 |
| 公开门户与展示 | 团队可以选择将部分非敏感内容（如技术博客、项目介绍）公开发布，形成对外展示的门户，吸引同道交流。 |
3. 技术实现方案
我们将采用微服务化思想，将核心内容管理与文档服务解耦，通过链接与嵌入的方式进行集成，保持系统间的低耦合与高内聚。
-
系统架构图：
[用户浏览器] | [Nginx反向代理与负载均衡] | ----------------------------------------- | | [Halo核心服务] [OpenList文档服务] (Docker容器， Java) (Docker容器/独立部署) | | [MySQL数据库] [本地存储/云存储驱动] (存储用户、文章、评论等) (存储团队文件) -
技术栈与部署方案：
- 核心平台（Halo）：作为项目的主引擎，负责用户系统、权限管理、博客、瞬间、评论等所有动态内容的生成与管理。其强大的插件化体系和API为未来扩展奠定基础。
- 文档服务（OpenList）：作为项目的核心组件，以独立服务形式部署。它专门负责团队文件的目录列表生成、在线预览（支持图片、视频、PDF、Office等）、基础权限控制和外链分享。Halo与OpenList的关系是协作而非从属：在Halo的文章中，通过Markdown链接或iframe嵌入OpenList生成的特定目录页面；反之，在OpenList的文件描述中也可链接回Halo的相关文章。
- 集成关键点：
- 用户同步：初期采用简易模式，在Halo和OpenList中配置相同的访问密钥或基础HTTP认证，实现团队级别的权限统一。远期可开发中间件同步用户信息。
- 导航整合：在Halo的导航菜单中，为每个团队空间添加一个“团队文档库”项，直接链接到该团队对应的OpenList专属地址。
- 部署与运维：全部服务使用Docker Compose进行编排，实现一键启动、统一管理。数据库采用MySQL。整个平台可部署于一台云服务器上，通过Nginx配置不同子域名（如
blog.team.com和docs.team.com）或路径来分别访问Halo和OpenList服务。
四、 作品特色、创新性与实用性
- 功能定位创新：本项目不是简单的博客系统，而是一个以“团队”和“项目”为中心的知识协作枢纽。它创造性地区分了“结构化文档”（OpenList管理）与“非结构化创作”（Halo管理），并通过链接将其有机融合，更贴近真实团队的知识生产流程。
- 技术架构特色：采用 “核心+组件”的松耦合架构。Halo与OpenList均可独立运行、独立升级。这种设计赋予了平台极大的灵活性：未来可以替换或增加其他组件（如替换OpenList为Nextcloud），而不会动摇核心的协作功能。
- 数据私有化与定制化：相较于SaaS产品，本项目强调私有化部署与数据自主掌控。团队对所有文章、评论、上传的文件拥有完全所有权，并能根据自身需求对Halo主题和OpenList界面进行深度定制，这是商业软件难以提供的。
- 强大的实用性与可拓展性：
- 实用性：可直接应用于本课程及后续的各类小组作业、大学生创新创业项目、实验室课题组管理、技术兴趣小组等场景，有效管理项目全生命周期的知识资产。
- 可拓展性：Halo丰富的插件生态允许我们未来便捷地增加图床、社交媒体分享、站内搜索引擎（如接入Elasticsearch）等功能。OpenList支持多种存储后端，可轻松扩展至阿里云OSS、腾讯云COS等，满足海量文件存储需求。
五、 实施计划与团队分工
1. 整体进度安排
- 第13周（至12月14日）：完成组队、技术可行性验证，提交本规划方案。
- 第13-14周：完成服务器环境搭建，使用Docker Compose分别部署Halo（连MySQL）和OpenList服务，并完成基础配置，实现两个服务独立可访问。
- 第15周：实现核心协作功能。包括：在Halo中配置多用户及测试权限，创建示例团队空间；配置OpenList的访问权限；实现两者间的导航链接与内容嵌入测试；发布平台使用指南。
- 第16周：内容填充与体验优化。以“本大作业项目”为用例，在平台上模拟真实协作：发布项目日志、上传设计文档、进行过程讨论。同步制作演示视频和答辩PPT。
- 第17周：最终测试、性能优化、文档整理，完成作品展示与全部材料提交。
2. 团队分工（4人示例）
- 架构与后端开发（1人）：负责服务器环境、Docker Compose编排、Halo与OpenList核心服务的部署、网络配置及基础集成。
- 前端与用户体验（1人）：负责Halo主题的定制与美化，调整界面以更契合“协作平台”定位，优化OpenList的界面集成体验。
- 功能配置与安全（1人）：深入研究Halo的用户-角色-权限系统及OpenList的访问控制配置，设计并实施团队空间的安全策略，编写平台管理手册。
- 内容运营与测试（1人）：负责模拟真实用户场景，进行全流程功能测试，撰写示例协作内容，并负责最终的项目报告整合、演示视频录制与PPT制作。
六、 总结
本规划方案详细阐述了一个以“团队协作与知识共享”为核心目标的综合性平台建设项目。我们精准定位了中小型团队在数字化协作中的痛点，创新性地提出了以Halo为交互核心、以OpenList为文档基石的松耦合技术架构。该项目不仅具有立即投入使用的实用价值，其模块化设计更保证了长期的演进潜力。通过完成从系统设计、服务部署、功能配置到场景测试的全过程，我们将把《人工智能与计算机概论》课程中关于系统思维、工程实践与团队合作的知识转化为一个实实在在、可运行、可复用的成果，完美达成课程大作业的各项培养目标。
（完）
注：本方案基于项目从零开始的规划视角撰写。若您已初步完成Halo的部署，可将其视为项目“第一阶段——核心引擎搭建”的顺利完成。在最终报告中，可将现有博客作为平台“公开知识分享”功能的雏形进行展示，并着重阐述后续集成OpenList、构建团队空间的规划与可行性分析，使报告更具层次感和说服力。