Ideon 是一款 AI 内容写作工具，可将一个想法转化为多格式、多风格、可发布的内容。只需描述一次主题，Ideon 就为您生成文章，以及 X 话题串、LinkedIn 帖子、Reddit 帖子、新闻通讯和博客文章——共享同一种声音和策略。

专为营销人员、创始人和精简团队打造，帮助他们大规模发布高质量内容，而无需为每个渠道手动重写同一创意。

功能特性

• 写一次，处处发布 — 一次运行将一个创意转化为文章、博客、新闻通讯、X、LinkedIn 和 Reddit 帖子。文章是核心，其余均为推广内容。
• 风格与意图控制 — 13 种风格 × 13 种意图。所有输出共享同一种一致的声音。
• 研究支撑的链接 — Ideon 浏览网络并像人类作者一样插入与上下文相关的外部链接。无需手动研究。
• 通过 OpenRouter 接入任何模型 — 接入 Claude、GPT-4 或任何支持的模型。无需更改工作流程即可切换。
• 写作指南驱动 — 提示词组合基于经过实践检验的写作原则汇编而成。没有通用 AI 套话。
• 代码驱动的高效率 — 确定性流水线代码处理编排。您只需在起草正文时支付 token 费用。
• 视觉叙事 — 通过 Replicate 为文章型运行自动生成封面和内嵌图片。
• Agent 与 CI 就绪 — MCP 服务器、非交互模式、机器可读配置、可恢复的运行。

快速开始

安装并完成第一次内容生成：

npm i -g @telepat/ideon
ideon settings
ideon write "How small editorial teams can productionize AI writing" --primary article=1 --secondary x-post=1
ideon preview

预期结果：

• 在 output/<timestamp>-<slug>/ 下生成一个运行目录。
• 产出一个或多个可发布的 Markdown 输出。
• 保存 analytics 与元数据，便于复现与回溯。
• 本地预览自动打开，便于检查内容、链接与资源。

环境要求

• Node.js 20+
• npm 10+
• OpenRouter API key
• Replicate API token

工作原理

Ideon 采用分阶段写作流水线：内容规划、正文生成、图像提示扩展、图像渲染、渠道内容生成，以及可选的链接增强。

运行时会合并 settings、环境变量、job 文件与 CLI 参数，并输出结构化产物，便于追踪与复用。

核心命令：

ideon settings
ideon config list --json
ideon write "An article idea" --primary article=1
ideon write --no-interactive --idea "An article idea" --primary article=1 --style technical --length medium
ideon write --job ./job.json
ideon write resume
ideon delete my-article-slug
ideon preview --no-open

与 AI Agent 一起使用

Ideon 专为智能体工作流打造：

• MCP 服务器 — ideon mcp serve 通过 stdio 暴露 5 个工具，覆盖内容生成、恢复、删除和配置管理。兼容 Claude Code、ChatGPT、Gemini 及任何通用 MCP 主机。
• Agent 运行时注册 — ideon agent install <runtime> 为支持的平台注册集成配置文件。使用 ideon agent status --json 查看状态。
• 非交互模式 — ideon write --no-interactive ... 移除所有提示，适用于 CI 和自动化场景。
• 机器可读配置 — ideon config list --json 与 ideon config get <key> --json 供智能体 inspection。
• Skill 包 — 将 skill/ideon-cli/ 安装到智能体主机，获得覆盖安装、配置、操作与调试的完整生命周期 skill。
• Agent 文档 — For Agents 涵盖 MCP 服务器、skill 与维护指南。

安全与信任

• 默认通过 ideon settings 将密钥保存到系统钥匙串。
• 在 CI 或容器环境中，请使用 IDEON_OPENROUTER_API_KEY 和 IDEON_REPLICATE_API_TOKEN。
• 在无法访问钥匙串时设置 IDEON_DISABLE_KEYTAR=true。
• 生成内容来自模型输出，发布前请进行人工审阅。

如需报告安全问题，请通过仓库安全报告通道私下提交，或通过仓库 issue 渠道联系维护者并避免包含敏感细节。

文档与支持

• 文档站点
• 快速上手
• CLI 参考
• 配置指南
• 故障排查
• For Agents
• 仓库
• npm 包

贡献

欢迎贡献。请先阅读 Development（开发环境与质量门禁），再参考 Releasing and Docs Deploy（发布与文档部署流程）。

如修改面向用户的文档内容，请在同一变更中同时更新 English 与 简体中文版本。

许可证

MIT。详见 LICENSE。