Ageniti

发布检查清单

在发布 package 或公开更新文档站前，建议逐项检查以下内容。

Package 检查

  • 确认 npm 上的包名和所有权。
  • 确认 package.json 元数据、关键词、license 和 export map。
  • 确认包仍然保持 Node.js 20+ 与纯 ESM 的约束。
  • 确认根导出和 subpath export 与文档里的入口说明一致。
  • 在 package 目录运行 npm test。
  • 运行 npm pack --dry-run 并检查打包内容。
  • 检查生成的类型声明。

Contract 检查

  • 检查 README.md 和文档首页文案是否保持一致定位。
  • 确认文档仍把 Ageniti 描述为给 Agent 使用的应用基础设施，而不是 Agent 框架。
  • 确认 destructive 与 private action 的暴露规则仍写对。
  • 跑 demo CLI，并检查 actions、manifest、lint 和 mcp 输出。
  • 在交付 launcher 前运行 npx @ageniti/core doctor 或等价的项目检查。
  • 运行你生成的 app CLI，例如 task-app build，并检查生成的 cli.mjs、mcp-stdio.mjs 和 ageniti.mcp.json。
  • 确认本地 dev console 仍能成功启动。

网站检查

  • 构建文档网站。
  • 确认中英文文档都有真实标题和真实本地化内容。
  • 逐个点击站内文档链接。
  • 如果新增了公开导出或 runtime 语义，确认对应页面已经更新。

推荐命令

## package
cd ../ageniti
npm test
npm pack --dry-run
npm publish --dry-run --access public --registry=https://registry.npmjs.org
node examples/demo.cli.js search-tasks --status open
node examples/demo.cli.js create-task --title "Follow up with design review"
node examples/demo.cli.js lint
node examples/demo.cli.js manifest
node examples/demo.cli.js mcp
node examples/demo.cli.js dev --port 4321
 
## website
cd ../website
npm run build

发布

npm publish --access public

在确认包名、所有权和目标 registry 之前，不要真正发布。

如果本地 npm 配置指向镜像源，发布时使用：

npm publish --access public --registry=https://registry.npmjs.org
上一篇常见问题