Skip to content

SoftJL Community v2.0.0 — 社区版首次发行

Choose a tag to compare

@guolola guolola released this 15 Oct 05:07

SoftJL Community 2.0:完整工程实践流程的社区版

SoftJL Community 面向软件类毕业设计、课程设计和软件工程教学,支持从需求规则到可行性分析、需求模型、设计模型、测试与工程说明书的完整流程。本次是社区仓库的首次正式发行,采用独立源码快照与全新提交历史,支持自带模型服务和自行部署。

项目介绍与部署 · 社区版与官网版对比 · 在线官网

主要能力

阶段 社区版支持 内容
需求规则 ✅ 需求提取、质量检查、修订、人工确认与验收条件
三项可行性分析 ✅ 系统环境图、业务与系统流程图、实现方案及成本收益与风险分析
完整需求模型 ✅ 功能结构、总体业务流程、用例、领域概念、原型界面关系、部署需求、需求分析模型
完整设计模型 ✅ 总体架构、用例实现、设计类、页面导航、数据库、组件关系、部署设计
测试与覆盖 ✅ 测试用例、正常/异常/边界场景、覆盖矩阵
三类工程说明书 ✅ 可行性研究报告、需求规格说明书、软件设计说明书;DOCX 下载与版本管理
图表与追踪 ✅ 图表编辑导出、产物来源、依赖关系与变更影响
项目工作区 ✅ 账号认证、项目与成员权限、生成任务、历史与重试
自带模型服务 ✅ OpenAI 兼容供应商、模型发现、连接测试与默认模型配置
说明书在线编辑 ✅ 自行配置 OnlyOffice 后使用

社区版范围

  • 保留完整工程实践流程,以及账号认证、项目角色权限、供应商密钥保护和生成调度。
  • 不包含官网的平台计费、支付、充值与生成次数系统、运营管理后台、MCP / Coding Agent 接入服务;相关入口、接口和实现已从社区副本裁剪。
  • 社区版无需购买平台生成次数,实际模型调用费用由所选模型供应商结算。
  • 中英文 README 延续原项目的 Logo、徽章与截图风格,新增 22 项社区版和官网版能力对照,支持项使用 ✅ 标记。

安装与部署

准备 Node.js 22、npm 10、Java 21 和 Graphviz;如需本地 OnlyOffice 在线编辑,可使用 Docker Desktop。

git clone --branch v2.0.0 https://github.com/guolola/SoftJL.git
cd SoftJL
npm ci
npm run build:packages
npm run dev

上述命令针对冻结的 v2.0.0 标签:共享包必须手动构建;该标签的默认 dev 会先检查本机 OnlyOffice,因此需先启动 Docker 引擎或提供可用的本机 OnlyOffice。未配置 DATABASE_URL 时,账号、项目、供应商配置与运行历史使用内存,服务重启后丢失;长期使用请先配置独立 PostgreSQL。当前 main 的启动流程与质量检查已有后续改进,使用 main 时以其 README 为准。

也可下载下方源码包,解压后安装依赖。启动后在账号模型设置中添加供应商、测试连接并选择默认模型。

请使用独立数据库部署社区版,不要直接将完整版数据库降级用于社区版。生产部署需配置持久化、密钥加密与文档服务,并关闭开发访客及旧明文配置入口。详细说明见 README 和 社区版维护说明。

验证与已知边界

  • 社区快照发布准备期间已完成共享包、API、渲染服务和 Web 构建,以及核心功能和社区范围回归检查;本次 README 文档检查通过,共 38 个 Markdown 文件。
  • 完整前端类型检查仍有历史测试样例类型不匹配,未列为通过;构建成功不代表完整类型检查通过。
  • 真实模型调用与 OnlyOffice 在线编辑需要使用部署者自己的服务配置验收。
  • 生成的模型和说明书需要人工评审;测试用例需要在实际系统中执行,覆盖统计不等同于实际测试通过。

下载文件(Assets)

本 Release 对应社区仓库提交 819031904c85c729878f5b1844a757ac57877f3f,包含已发布的中英文能力对照表。

文件 用途
softjl-community-v2.0.0-source.zip ZIP 格式社区源码包,对应本次发布提交
softjl-community-v2.0.0-source.tar.gz tar.gz 格式源码包,与 ZIP 包含相同源码
release.json 版本、提交、源码文件数量与压缩包 SHA-256 信息
SHA256SUMS 上述三个文件的 SHA-256 校验值

附件由社区仓库的已提交文件生成,包含 LICENSE、NOTICE 和使用说明,不含本机配置、依赖缓存或私有仓库历史。源码包需要自行安装依赖、配置环境、构建与部署。

下载全部附件后,可在支持该命令的环境中执行 sha256sum -c SHA256SUMS 核对完整性。项目自有代码采用 Apache-2.0,第三方组件遵循 NOTICE 中的声明。