Node.js AI 更新公告生成器:把变更记录转成可审核的 Markdown 发布说明
使用 Node.js 原生 fetch 和 uiuiAPI 兼容接口,将人工确认的功能变更、修复事项与兼容性提醒整理成 Markdown 更新公告。案例强调不编造版本事实、超时与重试控制、草稿落盘和发布前核验,适用于 SaaS、API 平台和独立开发团队的版本发布流程。
发布公告为什么值得做成自动化?
开发者写完代码后,常常还要把 commit、Issue、测试记录整理成用户看得懂的更新说明。直接把 Git 历史复制到公告里,会出现内部术语太多、重复条目、没有风险提示等问题。完全交给模型又可能出现更危险的情况:把“计划修复”写成“已经修复”,或者凭空添加性能提升数字。
本案例采用人工确认变更 → 模型组织语言 → 生成 Markdown 草稿 → 人工核验后发布的流程。它不会自动读取私有仓库,也不会直接向生产网站提交内容,适合需要严谨公告的 SaaS 产品、模型 API 平台和开发团队。
输入格式与适用场景
输入是普通 UTF-8 文本,每行写一项已经核实的变更。建议包括变更类型、功能名称、状态和用户影响,不要包含内部漏洞细节或凭据。模型负责改写结构和表达,不负责确认事实。若要从 Git 提取内容,先由工程师审核后再放进输入文件,避免泄露内部提交信息。
环境准备与项目结构
本案例使用 Node.js 20+ 的原生 fetch,不需要安装 npm 依赖。项目目录只有 release.mjs 和 changes.txt,运行后生成 release-draft.md。Windows PowerShell:$env:UIUI_API_KEY="你的令牌"; $env:MODEL="账户可用模型ID";macOS/Linux:export UIUI_API_KEY='你的令牌'、export MODEL='账户可用模型ID'。
将以下示例保存为 changes.txt:
新增:管理后台支持按日期筛选调用日志;状态:已测试
修复:特定条件下导出 CSV 列顺序不一致;状态:已测试
兼容性:旧版客户端仍可使用原接口;状态:待复核
待办:移动端筛选布局优化;状态:未发布
保存完整代码为 release.mjs:
import { readFileSync, writeFileSync } from 'node:fs';
const URL = 'https://api.uiuihao.com/v1/chat/completions';
const key = process.env.UIUI_API_KEY;
const model = process.env.MODEL;
const source = process.argv[2];
if (!key || !model || !source) {
console.error('用法: 设置 UIUI_API_KEY、MODEL 后运行 node release.mjs changes.txt');
process.exit(1);
}
const raw = readFileSync(source, 'utf8');
if (raw.length > 12000) {
console.error('输入过长,请先分批整理');
process.exit(1);
}
const prompt = `请把以下已确认的变更记录整理成中文发布说明。只能使用原文事实,
不得编造版本号、修复状态、性能提升百分比或发布日期。
分为:新增功能、问题修复、兼容性提醒、升级建议。
对信息不足的项目标注“待确认”,并保留原始条目便于核对。
${raw}`;
async function generate() {
for (let i = 0; i < 3; i++) {
try {
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), 45000);
let res;
try {
res = await fetch(URL, {
method: 'POST',
headers: { 'Authorization': `Bearer ${key}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ model, messages: [
{ role: 'system', content: '你是谨慎的技术发布编辑,绝不添加未经证实的功能。' },
{ role: 'user', content: prompt }
] }), signal: controller.signal
});
} finally { clearTimeout(timer); }
if ((res.status === 429 || res.status >= 500) && i < 2) {
await new Promise(r => setTimeout(r, 1000 * 2 ** i));
continue;
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
const content = data?.choices?.[0]?.message?.content;
if (typeof content !== 'string' || !content.trim()) throw new Error('响应格式异常');
writeFileSync('release-draft.md', content, 'utf8');
console.log('已生成 release-draft.md,请人工逐项核验');
return;
} catch (e) {
if (i === 2) throw e;
await new Promise(r => setTimeout(r, 1000 * 2 ** i));
}
}
}
generate().catch(e => { console.error(`失败: ${e.message}`); process.exitCode = 1; });
执行与预期输出
在项目目录执行 node release.mjs changes.txt。若接口成功返回符合预期的文本,脚本将生成 release-draft.md。其内容可能包含“新增功能:支持按日期筛选调用日志”“问题修复:修正 CSV 导出列顺序”等小节。由于兼容性仍待复核,草稿应提示“待确认”;未发布的移动端事项不应被描述为已上线。以上是预期内容示意,并非本轮真实 API 输出。
代码设计的几个关键点
首先,输入上限设为 12000 个字符,避免把异常大的文件直接发送到接口,降低不可控成本。其次,AbortController 将每次请求控制在约 45 秒内;对于 429 和服务端异常,最多重试三次。网络错误也会有限重试,但非幂等请求可能发生重复计费,生产环境应增加请求记录与预算监控。
最后,输出只写入 release-draft.md,不会修改网站或 Git 仓库。即使模型写得流畅,也必须人工比对输入条目,特别检查数字、版本号、发布时间、兼容性和安全声明。对于“已测试”还要确认对应的测试范围,不能推导出所有环境都通过。
进一步改进
可以给变更条目添加工单 ID、测试负责人和用户影响级别;生成后用程序检查每个 ID 是否被保留,并对公告中出现但输入没有的数字进行标红。还可以把 Markdown 转成 HTML 预览,或提供中英双语草稿。真正上线前,建议设置双人审核:开发负责人确认技术事实,运营编辑检查用户表达和 SEO 信息。
总结
AI 最适合帮助团队把事实写清楚,而不是替团队创造事实。这个零依赖 Node.js 小工具把写作效率与发布控制分开:代码生成草稿,人工决定是否发布。对版本更新频繁的服务来说,比完全自动发布更安全、更容易追责。
准备工作与接口说明
准备 Python 3.10+(Node.js 案例使用 Node.js 20+)、可以访问网络的终端,以及从 uiuiAPI 主站控制台申请的 API Key。uiuiAPI 是第三方模型聚合服务,并非模型厂商官方接口;支持哪些模型、请求参数、计费倍率及限额,应以主站模型广场、账户权限和实际渠道为准。本文使用 OpenAI 兼容的 Chat Completions 请求形态,不能据此推断所有模型均支持所有能力。
所有示例统一调用 https://api.uiuihao.com/v1/chat/completions,不在客户端代码里写死密钥。模型通过 MODEL 环境变量选择:请填入自己账户可用、支持文本聊天的实际模型 ID。示例输出仅展示可能的预期格式,并非真实模型回包;本轮没有发送付费请求。
常见故障、安全与成本
- 401:检查
UIUI_API_KEY是否设置、令牌是否过期或复制时带入空格;不要把完整令牌贴进日志。 - 403:核对账户权限、渠道分组、模型授权或平台策略;不要自动绕过限制。
- 429:表示限流或配额问题,使用指数退避并设置最大尝试次数;不要无限并发重试。
- 超时与 5xx:区分连接失败、读取超时和上游异常;请求是否已计费可能不明确,重试前考虑幂等性和重复成本。
- 400 或参数不兼容:先用最小请求(
model、messages)排查,再逐项增加参数;不同渠道对temperature、max_tokens、结构化输出等支持不同。
API 费用通常受输入、输出 token、模型与渠道倍率影响;同一文本多次重试会增加调用量。请先用少量脱敏数据测试,并在主站查看实际账单。生产部署还应设置单用户配额、总预算、超时、审计记录、数据保留策略和密钥轮换。对于包含客户、财务、业务机密的数据,先取得处理授权,必要时本地脱敏或不发送到第三方。
参考资料与验证边界
- JieAGI 代码示例栏目
- uiuiAPI 主站
- OpenAI Chat Completions API 参考(仅用于兼容协议结构说明,不代表聚合渠道完全等同官方)
- Python requests 文档 / Node.js 文档
暂无评论