平台管理

应用变更日志

/changelog 的应用变更日志是面向买家的公开发布说明表面。作者位于 /admin/changelog（仅限 super_admin）。

格式

每个条目由不可变的版本（semver：v1.4.0）键入一行。条目遵循 Keep a Changelog 约定 — markdown，在 ## Added / ## Changed / ## Fixed / ## Removed / ## Security 下有章节。公共渲染器支持标题、项目符号列表、 **bold** 和 `code` 跨度；其他所有内容作为纯文本传递。

状态生命周期

状态	它做什么
`draft`	创建时默认。对买家不可见；公共 `/changelog` 页面过滤掉草稿。
`published`	对买家可见。条目的 `version` 变为不可变 — 买家可能已链接到 `/changelog#v1.4.0`，静默更改该锚点引用的内容将重写历史。要重新编号，请先归档条目并创建一个新条目。
`archived`	从公共列表中隐藏但保留在表中，以便旧的买家链接仍然解析。使用此选项而不是硬删除。

JSON feed

/changelog.json 提供相同的已发布条目作为机器可读的 JSON，限制为最新的 100 个。买家可以抓取它以在他们自己的仪表板中嵌入“what's new” 小部件，或通过 Make/Zapier 轮询触发器订阅。

{
  "brand": "互客鱼",
  "entries": [
    {
      "version": "v1.4.0",
      "released_at": "2026-05-09T00:00:00+00:00",
      "title": "Workflow visual editor + Phase 2 step types",
      "body": "## Added\n- React Flow canvas\n…"
    }
  ]
}

What's-new 横幅

经过身份验证的工作区成员会在管理 shell 顶部看到一个细长的 “What's new in vX.Y.Z”横幅，只要发布的条目比用户的 users.last_changelog_seen_at 时间戳新。关闭横幅 POST 到 /changelog/seen 并盖章时间戳；横幅保持隐藏直到下一个条目落地。Super-admins 看不到横幅 — 他们自己编写条目。

CLI

php artisan changelog:add 从终端放下一个条目 — 对于与运送它们的代码一起提交发布说明很有用。

php artisan changelog:add v1.4.0 \
  --title="Workflow visual editor" \
  --status=published \
  --body="$(cat <<'EOT'
## Added
- React Flow canvas at /app/workflows/{id}/canvas
- Branch / tag_lead / webhook step types

## Fixed
- Mobile homepage hero overflow on viewports under 480px
EOT
)"

在 version 上幂等 — 使用相同的 semver 重新运行会使现有行保持不变。要编辑已发布的条目，请使用 /admin/changelog/{id}/edit 的管理表单。

持久化

变更日志条目作为单个 JSON 文件存在于 storage/app/private/changelog-entries.json — 与内部 Kanban 板相同的模式。存储故意不是数据库表，因此开发期间的 php artisan migrate:fresh 永远不会擦除发布说明。

在每次读取时，存储从 database/changelog-entries/v*.md 的源 markdown 文件自动播种自身。磁盘上的新版本被插入；现有条目永远不会被覆盖（UI 中的管理编辑是引导后的事实来源）。这提供了“在 git 中运送源，在第一次请求时同步到磁盘”的工作流程，零手动步骤 — 部署新代码，访问 /changelog 一次，条目出现。

源 markdown 形状

---
version: v1.1.0
title: 可视化工作流编辑器、可自定义潜在客户表单和小部件抛光
released_at: 2026-05-09
---

## New features

**Visual workflow editor.** Build branching chat flows on a
drag-and-drop canvas...

## Improvements

...

## Fixes

...

三个 frontmatter 字段是必需的：version、title 和 released_at。正文是由公共变更日志页面渲染的纯 markdown。

禁用引导

在您的配置或环境覆盖中将 changelog.bootstrap_dir 设置为空字符串。当您想要空的变更日志并希望从头开始通过管理 UI 编写条目时有用。