社区 API 发布 Skill 时 changelog 字段未被写入数据库

[fyniujin]

Hi SkillHub 团队，

我在通过社区 API (POST /api/v1/community/skills/publish) 发布 Skill 时遇到问题：

问题：
payload 中的 changelog 字段在九月份之后不再被写入数据库。前台"发布历史"显示为空（或默认占位符"更新发布"），但 SKILL.md 里的更新日志是正确填写的。

背景：

• 九月份之前：正常显示 changelog
• 九月份之后：显示为空
• 使用的 token 类型：skh_xxx（个人社区版）
• 调用的 API：POST /api/v1/community/skills/publish
• payload 字段名：changelog（与之前相同）

验证：

• 我对比了 CLI (skills_store_cli.py) 和直接 API 调用，两者用的是完全相同的 multipart 结构
• Skill 详情 API (GET /api/v1/skills/{slug}) 的 latestVersion.changelog 字段在九月份后不再更新

想确认：

1. 发布 API 的 changelog 字段是否已改名（如 releaseNotes / release_notes）？
2. 是否需要通过单独的接口提交 changelog？
3. 还是服务端目前存在 bug？

谢谢！

---

handle: user_1a470ba8

[cocofhu]

好的 我们看看

[newexploreor]

你好，可以发一下完整的post请求嘛，我们刚刚看了日志，你现在显示的changelog并非兜底值，服务端是正常的

[fyniujin]

完整 POST 请求整理如下：

Endpoint

plaintext

POST https://api.skillhub.cn/api/v1/community/skills/publish
Headers

plaintext

Authorization: Bearer skh_30*********************a29e
Content-Type: multipart/form-data; boundary=----skillhubBoundary1726483200000
Accept: application/json
Body（multipart，两个 part）

Part 1 — payload（JSON，含 changelog 字段）：

json

{
"slug": "winskill",
"version": "3.3.0",
"displayName": "Windows 服务器运维工具箱",
"summary": "Windows 服务器运维工具箱 - 磁盘分析、临时文件清理、IIS 站点管理...",
"description": "Windows 服务器运维工具箱 - 磁盘分析、清理、IIS 管理、批量操作、服务监控、更新诊断、性能监控、安全审计、注册表审计、磁盘健康、网络监控、事件日志、程序管理、会话监控、计划任务、共享审计、DNS诊断、SSL证书、防火墙审计、服务崩溃记录、系统修复、存储池、备份检查、Docker容器管理、K8s监控、自动化修复向导、性能基线与趋势分析、等保合规检查清单、远程多服务器管理、日志轮转、模块索引、轻量常驻监控、趋势预测、告警推送。只读分析+安全确认，绝不误删文件，完全免费离线运行。",
"tags": ["windows","sysadmin","disk-cleanup","iis","monitoring","file-management","devops","performance","security","audit","registry","disk-health","network","event-log","software","session","scheduled-tasks","smb-share","dns","ssl-certificate","firewall","service-recovery"],
"license": "MIT",
"homepage": "",
"changelog": "增加：33个模块总览索引；新增轻量常驻监控模块（定时采样CPU/内存/磁盘，超阈值告警）；新增趋势预测与告警推送模块（基于历史基线预测资源耗尽时间，邮件/Webhook告警推送）"
}
Part 2 — files（重复字段名，每个文件一个 part）：

plaintext

Content-Disposition: form-data; name="files"; filename="SKILL.md"
Content-Type: text/markdown

<SKILL.md 文件内容>
plaintext

Content-Disposition: form-data; name="files"; filename="references/thresholds.yaml"
Content-Type: application/octet-stream

<thresholds.yaml 文件内容>
...（其余文件同理，filename 用相对路径）

关键确认点：

changelog 字段在 payload JSON 里，不是 multipart 的独立 part
payload 的 Content-Type 是 application/json
files 的 name 固定为 "files"，filename 用相对路径（如 references/modules/module-01-磁盘空间分析.md）
中文文件名已做 URL encode（如需要）

你好，上面是完整的 POST 请求结构。changelog 字段确实在 payload JSON 里（不是 multipart 独立 part），字段名和值都正确。

但发布后「发布历史」里 changelog 显示为空（或"更新发布"兜底值），我们这边 9 月份后多 skill 都复现，包括之前正常显示的 skill 现在也异常。

服务端日志显示 changelog 不是兜底值，那可能是写入 DB 后读取/展示层的问题？能否确认下服务端是否正确读取了该字段并写入 latestVersion.changelog？

[newexploreor]

看起来是有发布历史的，这个现在是会有审核的，审核过程中是没有的

[fyniujin]

那不能半个月都没审核完啊。。。。。

[cocofhu]

我这里测试用这个changelog可以正常显示呀

[fyniujin]

用 CLI（skillhub publish）发布一个测试版本，再看网页版本历史是否显示。另外：GET /api/v1/skills/{slug}/versions 返回的 changelog 是完整的，但网页版本历史弹窗调用的管理接口里是空的——问题在网页查询链路，不在发布链路。你抓一下版本历史弹窗打开时 Network 里那个 GET 请求的响应就能确认。

决定性证据
我直接调了 SkillHub 公开 API，查 winskill 的版本历史接口：

plaintext

GET https://api.skillhub.cn/api/v1/skills/winskill/versions
15 个版本的 changelog 全部有值，一条不缺：

版本 changelog 实际存储值
v3.3.0（9月 CLI 发布） “增加：33个模块总览索引；新增轻量常驻监控模块…” ✓
v3.2.0 / v3.1.0 / v3.0.0 完整更新说明 ✓
v1.8.0~1.6.0 “Updated via tongyifabu”（当时的占位符）✓
v1.5.0 ~ v1.0.0 全部有值 ✓
kingdoc v4.1.0、receipt-compliance v4.4.0 也同样能查到。服务端写入 100% 正常，公开 API 读取 100% 正常。​

那网页为什么不显示？
关键差异在官方测试员的测试方式：

你可能用的是网页 UI 发布（你第一张截图右侧 DevTools 就是浏览器的 publish 请求），测试的是「网页发布 → 网页展示」这条完整链路，当然正常
我的 skill 是 CLI 发布的。数据写进 DB 了（API 可查），但网页「版本历史」弹窗调用的不是上面这个公开 API，而是 skillhub.cn 登录态下的另一个管理接口（BFF），那条查询管道上 changelog 丢了，或前端没映射上
三个排除项（回答你的问题）
❌ 不是 SKILL.md 格式问题：changelog 是 CLI --changelog 参数传的，跟 SKILL.md 里的更新日志章节完全无关
❌ 不是字段格式改了：payload 里 changelog 字段名和位置网页/CLI 完全一致，且值已入库
❌ 不是兜底值问题：API 返回的是真实内容，不是“更新发布”兜底

我手动网页发布也是正常 ，但是通过 CLI 发布 9月份之后就不行，不能正确显示更新历史内容。

[fyniujin]

kingdoc 深查：用指定的接口查的 plaintext GET https://api.skillhub.cn/api/v1/skills/kingdoc/versions

返回 14 个版本，全部带 changelog 值，一条不空：
版本 changelog 实际存储值 发布方式
v4.1.0 v4.1.0 发布 CLI（9月）
v4.0.0 v4.0.0 发布 CLI（9月）
v3.9.0 ~ v3.2.0 完整更新说明 ✓ API（9月前）
v3.0.0 Updated via tongyifabu 旧占位
v2.3.0 更新发布 旧占位
三个假设逐一验证
❌ 1. changelog 字段格式没改 — 14 个版本的 changelog 都能在 DB 查到，字段名、位置、写入全部正常。
❌ 2. 你的 SKILL.md 格式没错 — changelog 是发布时通过 --changelog 参数传的，跟 SKILL.md 里的「更新日志」章节完全无关。证据：kingdoc v4.0.0/v4.1.0 存的是 v4.0.0 发布 这种短占位，这正是发布脚本里传进去的字串，不是从 SKILL.md 提取的。
❌ 3. CLI 上次没丢掉 changelog — CLI 确实传了，而且写进了 DB（v4.1.0 = v4.1.0 发布 就躺在库里）。CLI 没"不显示"，是被脚本传了个短占位。
真正的结论：问题在「网页版本历史」展示层，不在数据，不在格式，不在 CLI 1. 数据层 100% 正常：/versions 接口证明每个版本都有 changelog。 2. 和 winskill 完全一致：winskill 也是 API 查得到、网页不显示。两个 skill 模式一毛一样。 3. 官方测试员为什么测不出问题：他测的是「网页发布 → 网页查看」这条链路，用的是新建测试 skill。您验证的是写入+展示全链路一致时正常。但我的 skill 是 CLI 发布，网页「版本历史」弹窗走的不是上面的公开 API，而是 skillhub.cn 登录态下的另一个管理接口（BFF）​——那条查询管道对 CLI 发布的版本没把 changelog 带出来（或前端没映射）。

[newexploreor]

目前我们cli发布的话带参数-changelog就会正常加载，如果还有问题请把具体的操作流程发一下，我们复现一下

[fyniujin]

问题找到了， 显示 vX.X.X 发布 短占位，是因为当时这几个版本是手动调用 CLI 发布时把 changelog 硬编码成了占位字符串（--changelog "vX.X.X 发布"），没有从 SKILL.md 的更新日志表格行提取真实内容。平台如实存储了传入值——问题在发布方式（手动命令传了占位），不在平台、不在 SKILL.md 格式、不在字段改名。感谢帮忙。