SoftJL Community v2.1.0 — 双模式建模与会话工作流

SoftJL Community v2.1.0

本次将官网版提交 6866919 的适用功能同步到社区版，保留独立部署、BYOK、私有项目入口和既有社区版边界。

本次改动

• 新增普通版项目：持续对话、需求澄清、结构化追问、项目约定、上下文压缩、流式回复与工具进度；可停止并恢复未完成任务。
• 新增八类普通版图表：功能结构、用例、业务流程、架构、概念 E-R、设计类图、时序及数据库表关系；支持单图修改与重新生成，按需生成测试和两类 DOCX 说明书。
• 专业版保留完整的需求、可研、需求模型、设计、追踪矩阵、测试与文档链路。需求规则改用版本化快照与稳定标识，替代旧版独立质量复核及自动修复交互；加强工作区版本守卫，防止旧任务覆盖新编辑。
• 统一模型选择、生成控件、文本及 Markdown 附件、视觉模型图片和推理开关；自动缓存公开模型容量与能力资料，显示供应商实际报告的 Token 用量。
• 更新图表导航、编辑、任务进度、错误信息、移动端布局及普通版 assistant-ui 内容区；保留来源与第三方许可说明。
• 相对已发布的 v2.0.0，同时包含后续 main 已有的可选只读 MCP、明确的项目授权、免 Docker 核心开发启动和可选 PostgreSQL/OnlyOffice。
• 将项目 Agent 迁移到维护命名空间的 Pi SDK 1.3.0，最低运行时为 Node.js 22.19.0；适配内存凭据/模型目录、系统消息和上下文编辑记录，保留受管项目工具隔离。此项迁移覆盖旧 Pi 包的安全公告。
• 更新中英文 README、架构与升级文档、构建/部署验证及社区版边界回归。

社区版边界

保留账号、成员权限、生成配额、限流、本地用量遥测、项目与工程成果。继续排除商业支付/积分、官网托管模型、运营管理 API/UI 及宣传首页。根地址进入项目列表，应用页禁止搜索索引。

MCP 默认关闭；启用后只读，并默认由用户显式选择授权项目。普通版提供需求、方案、模型和测试上下文；专业版继续提供完整实施资料与校验输入。外部 Coding Agent 的实际代码实现与验证由用户在自己的仓库完成。

升级与部署

1. 备份社区版数据库、文档目录和供应商凭据加密密钥；与官网版使用独立数据库。
2. 使用 Node.js 22.19.0 或更高版本，安装锁文件依赖并重新构建；启动时执行项目模式和遥测索引迁移，保留社区版 MCP 授权迁移。
3. 已有项目按专业版处理；新项目默认普通版，创建后不支持切换模式。模式与收费无关。
4. 持久使用应配置 PostgreSQL，保留文档和模型目录缓存；OnlyOffice 在线编辑按需配置。未知模型容量使用明确标注的当前运行预算，不代表供应商承诺容量。

验证与限制

GitHub CI 已全部通过：API 956 项、前端 1,377 项、Chromium 浏览器回归 67 项；同时通过契约、提示词、渲染、评估、开发/部署/CI 脚本测试、严格 lint、类型检查、文档规范和生产构建。CI 使用 PostgreSQL 完成数据库验证，API 测试无跳过项。

依赖审计无高危或中危项；数学排版传递依赖仍有 4 项低危报告。真实供应商工具调用、远端模型能力和 OnlyOffice 在线编辑仍需使用部署者自己的服务配置验收；模拟测试不能证明远端服务兼容。

下载与校验

附件提供本次社区提交的源码 ZIP、tar.gz、release.json 与 SHA256SUMS。不包含本机环境配置、密钥、依赖和运行数据。使用 SHA-256 校验下载文件后再部署。

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

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 中的声明。