Specivo 0.12.0 把项目追踪器和代码所在的地方连了起来。GitHub、GitLab、Gitea 和 Forgejo 上的仓库现在可以把提交、分支和拉取请求关联到工作项,出站 Webhook 则把变更通知给其他系统。单点登录新增了真正能切断访问的离职下线能力,以及 SCIM 自动开通。维基页面和工作项可以渲染 Mermaid 图表,计时器终于有了界面,用户指南也有了简体中文版。

仓库集成

每个项目都可以在 设置 → 仓库 中连接自己的仓库。Specivo 为每个集成单独分配 Webhook URL 和密钥,旧的全局推送钩子已经移除。仓库集成指南逐一介绍了各代码托管平台的配置步骤。

  • 提交、分支和拉取请求。提交信息、分支名或拉取请求中只要提到 ACME-12,就会关联到该工作项。工作项会收到一条来自 Git 账户的备注,拉取请求和分支也会写入它的元数据。
  • 开发面板。工作项页面显示已关联的提交、分支和拉取请求,并实时展示其状态。同一份列表也可以通过 GET /api/v1/issues/{ref}/development/ 获取,MCP 的 specivo_show_issue 输出中同样包含。
  • 复制分支名称。工作项页面上的一个按钮可以复制现成的分支名,例如 feat/ACME-12-export-to-csv。每个项目可以自定义格式,推送该分支后会自动关联回工作项。
  • 提交命令。默认分支上的 Fixes ACME-12 会把工作项改为对应的修复状态,ACME-12 @1h30m 则记录工时。两者都以提交所用已验证邮箱对应的用户身份执行,并受该用户的权限和工作流约束。管理员通过这种方式匹配时,只拥有其项目角色,不会获得管理员权限。提交命令默认关闭。
  • 合并自动化。当写有 Fixes ACME-12 的拉取请求被合并时,工作项按正常工作流流转。只有合并本身算数:之后再编辑拉取请求无法关闭任何工作项。此功能同样默认关闭,并且通过一个专用的 Automation 角色执行,可用的状态转换由你决定。
  • 来自外部人员的拉取请求。在公开仓库上,任何人都可以提交提到工作项的拉取请求。新增选项(默认开启)会忽略来自 fork 和非协作者的拉取请求。
  • 重命名的标识。引用旧的项目标识,或引用已移到其他项目的工作项,仍然能正确解析。

Gitea 和 Forgejo 还可以把它们自己的工作项链接发送给 Specivo。工作项链接指南给出了两者的外部追踪器设置。

出站 Webhook

出站 Webhook 现在真正可用了。工作项和维基的变更会在同一个事务中写入发件箱,然后带重试和退避地投递,因此既不会丢失,也不会为已回滚的变更发送任何内容。每个项目都有一个 Webhook 设置标签页,附带投递日志;载荷使用 X-Specivo-Signature 签名,已完成的投递记录在 30 天后清理。私有工作项和私有备注只有在管理员为该 Webhook 明确开启后才会发送。Webhook 指南给出了载荷格式以及 Python 和 Node.js 的签名校验示例。

单点登录:离职下线与 SCIM

此前,一个人在身份提供商处被停用后,其 Specivo 会话会一直保留到过期,API 密钥也仍然有效。本次发布补上了这个缺口。

  • 在身份提供商处检查会话。会话续期时,Specivo 会向身份提供商确认此人是否仍可登录。在那边被停用、删除或已注销的用户,几分钟内就会失去 Specivo 会话。只要 OpenID Connect 提供商签发刷新令牌即可,无需后端通道注销。如果无法连接提供商,由每个提供商各自的设置决定是放行还是结束会话。
  • 后端通道注销动作。每个提供商可以选择在提供商处注销后的动作:结束当前这一个会话,结束此人的全部会话,或同时停用其 API 密钥(包括 MCP 密钥)。拥有 Specivo 密码的账户和服务账户不会以这种方式被注销下线。
  • SCIM 2.0。Microsoft Entra ID、Okta 或 authentik 等身份提供商现在可以创建、更新和停用 Specivo 账户与用户组。每个提供商拥有自己的 SCIM 令牌。在那边停用某人后,其会话会立即结束,API 密钥也随即停用。现有账户只通过已验证的邮箱关联,并且仅当提供商设为关联现有账户时才会执行。SCIM 指南涵盖了各提供商的配置方法。

单点登录指南中的离职下线章节为每种身份提供商提供了操作手册。

Mermaid 图表

维基页面、工作项描述或评论中的 ```mermaid 代码块现在会渲染成图表:流程图、时序图、状态机、实体关系图、甘特图等等。Mermaid 随 Specivo 一起打包,因此在离线部署中也能使用;它以严格模式运行,存储的图表无法执行脚本。图表源码仍保留在文本里,搜索、导出和 MCP 读取都能看到。在手机上,过宽的图表可以横向滚动。

AI 智能体连接时就会了解这一点:MCP 服务器的说明和 specivo_setup_guide 现在会告诉它们用 Mermaid 画图,而不是用 ASCII 字符画。

真正能用的计时器

以前计时器只能通过 REST API 使用。现在你可以在工作项页面启动它,在页头看到它计时,然后带上活动类型和备注停止,或者直接放弃。在另一个计时器运行时启动新的计时器会先询问,之后再告诉你旧计时器的处理结果。智能体可以通过新的 MCP 工具 specivo_timer 获得同样的能力。参见工时记录。

MCP 改进

  • 父工作项。specivo_create_issue 和 specivo_update_issue 接受 parent_ref,specivo_list_issues 可以按它筛选,specivo_show_issue 会列出读者可见的父工作项和子工作项。
  • 创建时打标签。specivo_create_issue 和 specivo_create_wiki 接受 tags,并在同一个事务中应用。
  • 完整的设置指南。现在列出了全部工具,解释了标签工作流,并告诉智能体不要把标签或状态写进页面正文。

通知邮件自动归入会话

关于同一个工作项的所有邮件现在共用一个主题 [ACME-12] Subject 和会话线程头,Gmail、Thunderbird 等客户端会把它们归入同一个会话。事件类型移到了正文第一行。邮件带有正规的纯文本部分,并通过自动回复抑制头避免收到外出自动回复。新的可选设置 SMTP_MESSAGE_ID_DOMAIN 用于指定消息 ID 的域名。

中文支持

用户指南已有简体中文版,逐页对应,代码仓库中也有了中文 README。中文、俄语、法语、西班牙语和泰语界面翻译中原有的缺漏已全部补齐。部分网络无法访问 Docker Hub,因此每个版本现在也同时发布到 GitHub Container Registry,镜像名为 ghcr.io/specivo/specivo,标签和镜像摘要完全相同。在 .env 中设置 SPECIVO_IMAGE=ghcr.io/specivo/specivo 即可从那里拉取。

访问控制修复

  • 私有工作项上的工时。读者看不到的工作项上的工时记录,之前会出现在列表中,并被计入合计、报表和账单。现在它们在所有地方都被隐藏,而记录工时的人仍能看到自己的条目。
  • 通知。已无法查看某个工作项的关注者和负责人,不再收到关于它的通知和邮件。
  • 未找到的响应。通过旧引用访问一个被隐藏的工作项时,现在的响应与访问不存在的工作项完全一致。

其他修复

  • 内置的 nginx 可能无法启动,原因是 API 占用了它在代理网络上的固定地址。自动分配的地址现在来自一个独立的地址段 SPECIVO_PROXY_IP_RANGE。
  • 把带有子工作项的工作项移到新的父工作项下时,如果其子树会超出深度限制,操作会被拒绝。
  • 页头的计时器按钮现在会向屏幕阅读器播报已用时长。

升级时要做什么

先备份数据库:本次发布会执行数据库迁移 0044 到 0051。

  • Git 推送钩子。全局的 /hooks/github 和 /hooks/gitlab 端点已移除。请在项目的“仓库”标签页中重新连接每个仓库,并勾选拉取请求或合并请求事件。
  • nginx 固定地址。如果你为了绕过 nginx 启动问题设置了 SPECIVO_NGINX_IP,请删除它,或者把它移到自动分配地址段之外。
  • 计时器 API。POST /api/v1/timer/start/ 现在还会返回 replaced,描述它停止的那个计时器。

如何获取

用 docker pull specivo/specivo:0.12.0 拉取 Docker 镜像;无法访问 Docker Hub 时,改用 docker pull ghcr.io/specivo/specivo:0.12.0。没有互联网访问的服务器可以使用 GitHub Release 中附带的离线包。源码在 github.com/specivo/specivo。安装和升级步骤请参见用户指南。

GitHub、GitLab、Gitea、Forgejo、Microsoft Entra ID、Okta 和 authentik 是其各自所有者的商标。Specivo 与它们无关联,也未获得其背书。