@telepat/ideon 0.1.14 → 0.1.15

package/README.md

@@ -1,16 +1,23 @@
-# Ideon
+<p align="center"><img src="./ideon-logo.webp" width="128" alt="Ideon"></p>
+<h1 align="center">Ideon</h1>
+<p align="center"><em>One idea. Endless formats.</em></p>
+
+<p align="center">
+  <a href="https://docs.telepat.io/ideon">📖 Docs</a>
+  · <a href="./README.md">🇺🇸 English</a>
+  · <a href="./README.zh-CN.md">🇨🇳 简体中文</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/telepat-io/ideon/actions/workflows/ci.yml"><img src="https://github.com/telepat-io/ideon/actions/workflows/ci.yml/badge.svg?branch=main" alt="Build"></a>
+  <a href="https://codecov.io/gh/telepat-io/ideon"><img src="https://codecov.io/gh/telepat-io/ideon/graph/badge.svg" alt="Codecov"></a>
+  <a href="https://www.npmjs.com/package/@telepat/ideon"><img src="https://img.shields.io/npm/v/@telepat/ideon" alt="npm"></a>
+  <a href="https://github.com/telepat-io/ideon/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow.svg" alt="License"></a>
+</p>
 
 Ideon is an AI content writer that turns one idea into publish-ready content across multiple formats, styles, and channels.
 
-[🇺🇸 English](./README.md) | [🇨🇳 简体中文](./README.zh-Hans.md)
-
-[![CI](https://github.com/telepat-io/ideon/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/telepat-io/ideon/actions/workflows/ci.yml)
-[![Coverage](https://codecov.io/gh/telepat-io/ideon/graph/badge.svg)](https://codecov.io/gh/telepat-io/ideon)
-[![npm version](https://img.shields.io/npm/v/%40telepat%2Fideon)](https://www.npmjs.com/package/@telepat/ideon)
-[![Docs](https://img.shields.io/badge/docs-live-1f6feb)](https://docs.telepat.io/ideon)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://github.com/telepat-io/ideon/blob/main/LICENSE)
-
-## Why Teams Use Ideon
+## What It Solves
 
 Ideon helps teams move from idea to publishable content faster, with less manual rewriting between channels.
 
@@ -48,15 +55,6 @@ Expected outcome:
 - OpenRouter API key
 - Replicate API token
 
-## Core Capabilities
-
-- Multi-format writing from one idea: article, blog, newsletter, Reddit, LinkedIn, X thread, X post, landing-page copy.
-- Style control per run: choose one voice and apply it consistently across all outputs.
-- Research and enrichment: generate planning briefs and add relevant links via link enrichment.
-- Image generation: render cover and inline visuals for article-focused runs.
-- Iteration workflows: rerun with different targets/styles, resume interrupted jobs, and use job files for repeatable execution.
-- Local review: preview generated outputs and assets in a browser before publishing.
-
 ## How It Works
 
 Ideon runs a staged writing pipeline: planning, drafting, image prompt expansion, image rendering, channel output generation, and optional link enrichment.
@@ -74,14 +72,18 @@ ideon write --job ./job.json
 ideon write resume
 ideon delete my-article-slug
 ideon preview --no-open
-ideon mcp serve
-ideon agent status --json
 ```
 
-Agent integration scope:
+## Using With AI Agents
+
+Ideon is built for agentic workflows:
 
-- Supported: CLI and MCP runtime workflows.
-- Not supported: Cursor and VS Code runtime integrations.
+- **MCP server** — `ideon mcp serve` exposes 5 tools over stdio for content generation, resume, deletion, and config management. Compatible with Claude Code, ChatGPT, Gemini, and any generic MCP host.
+- **Agent runtime registration** — `ideon agent install <runtime>` registers integration profiles for supported platforms. Check status with `ideon agent status --json`.
+- **Non-interactive mode** — `ideon write --no-interactive ...` removes all prompts for CI and automation.
+- **Machine-readable config** — `ideon config list --json` and `ideon config get <key> --json` for agent inspection.
+- **Skill package** — Install `ideon-cli-skill/` into your agent host for a full lifecycle skill covering install, setup, operations, and debugging.
+- **Agent docs** — [For Agents](https://docs.telepat.io/ideon/for-agents) covers MCP servers, skills, and maintenance.
 
 ## Security And Trust
 
@@ -94,18 +96,18 @@ To report a security issue, open a private report through the repository securit
 
 ## Documentation And Support
 
-- Documentation site: https://docs.telepat.io/ideon
-- Language support: English and Simplified Chinese (`README.md` / `README.zh-Hans.md`, plus docs locales)
-- Getting started: `docs/getting-started/quickstart.md`
-- CLI reference: `docs/reference/cli-reference.md`
-- Configuration guide: `docs/guides/configuration.md`
-- Troubleshooting guide: `docs/guides/troubleshooting.md`
-- Repository: https://github.com/telepat-io/ideon
-- npm package: https://www.npmjs.com/package/@telepat/ideon
+- [Documentation site](https://docs.telepat.io/ideon)
+- [Quickstart](https://docs.telepat.io/ideon/getting-started/quickstart)
+- [CLI reference](https://docs.telepat.io/ideon/reference/cli-reference)
+- [Configuration guide](https://docs.telepat.io/ideon/guides/configuration)
+- [Troubleshooting](https://docs.telepat.io/ideon/guides/troubleshooting)
+- [For Agents](https://docs.telepat.io/ideon/for-agents)
+- [Repository](https://github.com/telepat-io/ideon)
+- [npm package](https://www.npmjs.com/package/@telepat/ideon)
 
 ## Contributing
 
-Contributions are welcome. Start with `docs/contributing/development.md` for setup, workflow, and quality gates, then follow `docs/contributing/releasing-and-docs-deploy.md` for release and docs deployment details.
+Contributions are welcome. Start with [Development](https://docs.telepat.io/ideon/contributing/development) for setup, workflow, and quality gates, then follow [Releasing and Docs Deploy](https://docs.telepat.io/ideon/contributing/releasing-and-docs-deploy) for release and docs deployment details.
 
 For user-facing documentation changes, update both English and Simplified Chinese content in the same change.
 

package/README.zh-CN.md

@@ -0,0 +1,116 @@
+<p align="center"><img src="./ideon-logo.webp" width="128" alt="Ideon"></p>
+<h1 align="center">Ideon</h1>
+<p align="center"><em>一个想法，无限格式。</em></p>
+
+<p align="center">
+  <a href="https://docs.telepat.io/ideon">📖 文档</a>
+  · <a href="./README.md">🇺🇸 English</a>
+  · <a href="./README.zh-CN.md">🇨🇳 简体中文</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/telepat-io/ideon/actions/workflows/ci.yml"><img src="https://github.com/telepat-io/ideon/actions/workflows/ci.yml/badge.svg?branch=main" alt="Build"></a>
+  <a href="https://codecov.io/gh/telepat-io/ideon"><img src="https://codecov.io/gh/telepat-io/ideon/graph/badge.svg" alt="Codecov"></a>
+  <a href="https://www.npmjs.com/package/@telepat/ideon"><img src="https://img.shields.io/npm/v/@telepat/ideon" alt="npm"></a>
+  <a href="https://github.com/telepat-io/ideon/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow.svg" alt="License"></a>
+</p>
+
+Ideon 是一款 AI 内容写作工具，可将一个想法转化为多格式、多风格、可发布的内容。
+
+## 它能解决什么问题
+
+Ideon 帮助团队更快地从想法走到可发布内容，减少跨渠道重复改写的工作量。
+
+一次运行，Ideon 可以：
+
+- 基于同一核心想法生成多种输出类型：article、blog、newsletter、Reddit、LinkedIn、X thread、X post 等。
+- 在所有输出中统一应用写作风格（`professional`、`friendly`、`technical`、`academic`、`opinionated`、`storytelling`）。
+- 生成研究导向的内容 brief，补充相关链接，并在文章型任务中生成配图。
+- 通过作业文件、可配置参数与断点恢复能力支持持续迭代。
+
+这使 Ideon 适用于内容团队、开发者关系、产品营销、创始人以及需要按节奏进行多渠道写作的个人或团队。
+
+## 快速开始
+
+安装并完成第一次内容生成：
+
+```bash
+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 参数，并输出结构化产物，便于追踪与复用。
+
+核心命令：
+
+```bash
+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 包** — 将 `ideon-cli-skill/` 安装到智能体主机，获得覆盖安装、配置、操作与调试的完整生命周期 skill。
+- **Agent 文档** — [For Agents](https://docs.telepat.io/ideon/for-agents) 涵盖 MCP 服务器、skill 与维护指南。
+
+## 安全与信任
+
+- 默认通过 `ideon settings` 将密钥保存到系统钥匙串。
+- 在 CI 或容器环境中，请使用 `IDEON_OPENROUTER_API_KEY` 和 `IDEON_REPLICATE_API_TOKEN`。
+- 在无法访问钥匙串时设置 `IDEON_DISABLE_KEYTAR=true`。
+- 生成内容来自模型输出，发布前请进行人工审阅。
+
+如需报告安全问题，请通过仓库安全报告通道私下提交，或通过仓库 issue 渠道联系维护者并避免包含敏感细节。
+
+## 文档与支持
+
+- [文档站点](https://docs.telepat.io/ideon)
+- [快速上手](https://docs.telepat.io/ideon/getting-started/quickstart)
+- [CLI 参考](https://docs.telepat.io/ideon/reference/cli-reference)
+- [配置指南](https://docs.telepat.io/ideon/guides/configuration)
+- [故障排查](https://docs.telepat.io/ideon/guides/troubleshooting)
+- [For Agents](https://docs.telepat.io/ideon/for-agents)
+- [仓库](https://github.com/telepat-io/ideon)
+- [npm 包](https://www.npmjs.com/package/@telepat/ideon)
+
+## 贡献
+
+欢迎贡献。请先阅读 [Development](https://docs.telepat.io/ideon/contributing/development)（开发环境与质量门禁），再参考 [Releasing and Docs Deploy](https://docs.telepat.io/ideon/contributing/releasing-and-docs-deploy)（发布与文档部署流程）。
+
+如修改面向用户的文档内容，请在同一变更中同时更新 English 与 简体中文版本。
+
+## 许可证
+
+MIT。详见 [LICENSE](./LICENSE)。

package/dist/ideon.js

@@ -972,12 +972,18 @@ var writeToolInputSchema = {
   intent: z3.enum(contentIntentValues).optional(),
   length: z3.union([z3.enum(targetLengthValues), z3.coerce.number().int().positive()]).optional(),
   dryRun: z3.boolean().optional(),
-  enrichLinks: z3.boolean().optional()
+  enrichLinks: z3.boolean().optional(),
+  link: z3.array(z3.string()).optional(),
+  unlink: z3.array(z3.string()).optional(),
+  maxLinks: z3.coerce.number().int().positive().optional()
 };
 var writeToolInputZodSchema = z3.object(writeToolInputSchema);
 var writeResumeToolInputSchema = {
   dryRun: z3.boolean().optional(),
-  enrichLinks: z3.boolean().optional()
+  enrichLinks: z3.boolean().optional(),
+  link: z3.array(z3.string()).optional(),
+  unlink: z3.array(z3.string()).optional(),
+  maxLinks: z3.coerce.number().int().positive().optional()
 };
 var writeResumeToolInputZodSchema = z3.object(writeResumeToolInputSchema);
 var deleteToolInputSchema = {
@@ -993,6 +999,20 @@ var configSetToolInputSchema = {
   value: z3.string()
 };
 var configSetToolInputZodSchema = z3.object(configSetToolInputSchema);
+var linksToolInputSchema = {
+  slug: z3.string().min(1),
+  mode: z3.enum(["fresh", "append"]).optional(),
+  link: z3.array(z3.string()).optional(),
+  unlink: z3.array(z3.string()).optional(),
+  maxLinks: z3.coerce.number().int().positive().optional()
+};
+var linksToolInputZodSchema = z3.object(linksToolInputSchema);
+var configListToolInputSchema = {};
+var configListToolInputZodSchema = z3.object(configListToolInputSchema);
+var configUnsetToolInputSchema = {
+  key: z3.enum(configKeys)
+};
+var configUnsetToolInputZodSchema = z3.object(configUnsetToolInputSchema);
 var ideonToolContracts = [
   {
     name: "ideon_write",
@@ -1003,6 +1023,23 @@ var ideonToolContracts = [
       length: [...targetLengthValues]
     }
   },
+  {
+    name: "ideon_write_resume",
+    required: [],
+    enums: {}
+  },
+  {
+    name: "ideon_delete",
+    required: ["slug"],
+    enums: {}
+  },
+  {
+    name: "ideon_links",
+    required: ["slug"],
+    enums: {
+      mode: ["fresh", "append"]
+    }
+  },
   {
     name: "ideon_config_set",
     required: ["key", "value"],
@@ -1016,6 +1053,18 @@ var ideonToolContracts = [
     enums: {
       key: [...configKeys]
     }
+  },
+  {
+    name: "ideon_config_list",
+    required: [],
+    enums: {}
+  },
+  {
+    name: "ideon_config_unset",
+    required: ["key"],
+    enums: {
+      key: [...configKeys]
+    }
   }
 ];
 
@@ -1305,7 +1354,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.14",
+  version: "0.1.15",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -6005,79 +6054,341 @@ function parsePipelineCustomLinks(rawLinks, unlinks) {
   return Array.from(result.values());
 }
 
-// src/cli/commands/writeTargetSpecs.ts
-function parseTargetSpec(spec) {
-  const trimmed = spec.trim();
-  if (!trimmed) {
-    throw new ReportedError("Target spec cannot be empty. Use <content-type=count>.");
+// src/cli/commands/links.ts
+import { readFile as readFile6, stat as stat3 } from "fs/promises";
+import path9 from "path";
+async function runLinksCommand(options, dependencies = {}) {
+  const slug = normalizeSlug2(options.slug);
+  const mode = normalizeMode(options.mode);
+  const cwd2 = dependencies.cwd ?? process.cwd();
+  const log = dependencies.log ?? ((message) => console.log(message));
+  const resolved = await resolveRunInput({
+    idea: `Enrich links for ${slug}`
+  });
+  const markdownPath = await resolveMarkdownPathForSlug2(resolved.config.settings, slug, cwd2);
+  const frontmatter = await readFrontmatter(markdownPath);
+  const fileId = path9.parse(markdownPath).name;
+  const articleTitle = frontmatter.title ?? toTitleFromSlug(slug);
+  const articleDescription = frontmatter.description ?? "";
+  const openRouterApiKey = resolved.config.secrets.openRouterApiKey;
+  if (!openRouterApiKey) {
+    throw new ReportedError(
+      "Missing OpenRouter API key. Run `ideon settings` to configure credentials or set IDEON_OPENROUTER_API_KEY."
+    );
   }
-  const [rawType, rawCount] = trimmed.split("=");
-  if (!rawType || !rawCount) {
-    throw new ReportedError(`Invalid target "${spec}". Use format content-type=count, e.g. article=1 or x-thread=3.`);
+  const openRouter = new OpenRouterClient(openRouterApiKey);
+  const linksPath = resolveLinksPath(markdownPath);
+  const existing = await readExistingLinks(linksPath);
+  const updatedCustomLinks = resolveCustomLinks(existing?.customLinks ?? [], options.links ?? [], options.unlinks ?? []);
+  const effectiveMaxLinks = options.maxLinks;
+  const linksResult = await enrichLinks({
+    markdownFiles: [{ markdownPath, fileId, contentType: "article" }],
+    articleTitle,
+    articleDescription,
+    openRouter,
+    settings: resolved.config.settings,
+    dryRun: false,
+    customLinks: updatedCustomLinks,
+    maxLinks: effectiveMaxLinks,
+    onItemProgress(event) {
+      logProgress(event, log);
+    }
+  });
+  const generatedLinks = linksResult[0]?.links ?? [];
+  const mergedGeneratedLinks = mode === "append" ? mergeLinks(existing?.links ?? [], generatedLinks) : generatedLinks;
+  const appendedCount = Math.max(0, mergedGeneratedLinks.length - (existing?.links.length ?? 0));
+  await writeLinksFile(markdownPath, {
+    version: 2,
+    customLinks: updatedCustomLinks,
+    links: mergedGeneratedLinks
+  });
+  const relativeMarkdownPath = formatRelativePath2(cwd2, markdownPath);
+  const relativeLinksPath = formatRelativePath2(cwd2, linksPath);
+  if (mode === "fresh") {
+    const replaced = existing ? "Replaced existing links." : "Created links sidecar.";
+    log(`Enriched links for "${slug}".`);
+    log(`${replaced} Saved ${generatedLinks.length} generated + ${updatedCustomLinks.length} custom links to ${relativeLinksPath} (${relativeMarkdownPath}).`);
+    return;
   }
-  const contentType = rawType.trim();
-  if (!contentTypeValues.includes(contentType)) {
+  const baseCount = existing?.links.length ?? 0;
+  const verb = existing ? "Appended and deduplicated links." : "Created links sidecar.";
+  log(`Enriched links for "${slug}".`);
+  log(`${verb} Base ${baseCount}, added ${appendedCount}, total ${mergedGeneratedLinks.length} generated + ${updatedCustomLinks.length} custom in ${relativeLinksPath} (${relativeMarkdownPath}).`);
+}
+function normalizeMode(rawMode) {
+  const normalized = rawMode.trim().toLowerCase();
+  if (normalized === "fresh" || normalized === "append") {
+    return normalized;
+  }
+  throw new ReportedError(`Unsupported --mode value "${rawMode}". Use "fresh" or "append".`);
+}
+function normalizeSlug2(rawSlug) {
+  const slug = rawSlug.trim();
+  if (!slug) {
+    throw new ReportedError("Slug cannot be empty. Pass the generated article slug, for example `ideon links my-article-slug`.");
+  }
+  if (slug.toLowerCase().endsWith(".md")) {
+    throw new ReportedError(`Expected a slug, not a markdown filename: ${slug}. Pass the slug without .md.`);
+  }
+  if (slug === "." || slug === ".." || /[/\\]/.test(slug)) {
+    throw new ReportedError(`Invalid slug "${slug}". Pass the article slug only, without any path separators.`);
+  }
+  return slug;
+}
+async function resolveMarkdownPathForSlug2(settings, slug, cwd2) {
+  const outputPaths = resolveOutputPaths(settings, cwd2);
+  const directPath = path9.join(outputPaths.markdownOutputDir, `${slug}.md`);
+  if (await isReadableFile(directPath)) {
+    return directPath;
+  }
+  const markdownFiles = await listMarkdownFilesRecursively(outputPaths.markdownOutputDir);
+  const matches = [];
+  for (const candidate of markdownFiles) {
+    if (path9.basename(candidate) === `${slug}.md`) {
+      matches.push(candidate);
+      continue;
+    }
+    const frontmatter = await readFrontmatter(candidate);
+    if (frontmatter.slug === slug) {
+      matches.push(candidate);
+    }
+  }
+  if (matches.length === 0) {
     throw new ReportedError(
-      `Unsupported content type "${contentType}". Supported values: ${contentTypeValues.join(", ")}.`
+      `Could not find article "${slug}". Expected a markdown file in ${outputPaths.markdownOutputDir} with frontmatter slug "${slug}".`
     );
   }
-  const count = Number.parseInt(rawCount.trim(), 10);
-  if (!Number.isFinite(count) || count <= 0) {
-    throw new ReportedError(`Invalid count in target "${spec}". Count must be a positive integer.`);
+  return newestPath(matches);
+}
+async function newestPath(paths) {
+  let latestPath = paths[0];
+  let latestMtime = 0;
+  for (const candidate of paths) {
+    const candidateStat = await stat3(candidate);
+    if (candidateStat.mtimeMs >= latestMtime) {
+      latestMtime = candidateStat.mtimeMs;
+      latestPath = candidate;
+    }
+  }
+  return latestPath;
+}
+async function readFrontmatter(markdownPath) {
+  const markdown = await readFile6(markdownPath, "utf8");
+  return parseFrontmatter(markdown);
+}
+function parseFrontmatter(markdown) {
+  if (!markdown.startsWith("---\n")) {
+    return { slug: null, title: null, description: null };
+  }
+  const frontmatterEnd = markdown.indexOf("\n---\n", 4);
+  if (frontmatterEnd < 0) {
+    return { slug: null, title: null, description: null };
   }
+  const block = markdown.slice(4, frontmatterEnd);
   return {
-    contentType,
-    count
+    slug: parseFrontmatterValue(block, "slug"),
+    title: parseFrontmatterValue(block, "title"),
+    description: parseFrontmatterValue(block, "description")
   };
 }
-function parsePrimaryAndSecondarySpecs(options) {
-  const { primarySpec, secondarySpecs } = options;
-  if (!primarySpec && (!secondarySpecs || secondarySpecs.length === 0)) {
-    return void 0;
+function parseFrontmatterValue(block, key) {
+  const pattern = new RegExp(`^${key}:\\s*(.+)$`, "m");
+  const match = block.match(pattern);
+  if (!match || !match[1]) {
+    return null;
   }
-  if (!primarySpec) {
-    throw new ReportedError("Missing required --primary <content-type=count>.");
+  const rawValue = match[1].trim();
+  if (!rawValue) {
+    return null;
   }
-  const primary = parseTargetSpec(primarySpec);
-  if (primary.count !== 1) {
-    throw new ReportedError("Primary target count must be exactly 1. Use --primary <content-type=1>.");
+  if (rawValue.startsWith('"') && rawValue.endsWith('"') || rawValue.startsWith("'") && rawValue.endsWith("'")) {
+    return rawValue.slice(1, -1);
   }
-  const secondaryDedupedByType = /* @__PURE__ */ new Map();
-  for (const spec of secondarySpecs ?? []) {
-    const parsed = parseTargetSpec(spec);
-    if (parsed.contentType === primary.contentType) {
-      throw new ReportedError(
-        `Content type "${parsed.contentType}" cannot be both primary and secondary in the same run.`
-      );
+  return rawValue;
+}
+function toTitleFromSlug(slug) {
+  return slug.split("-").filter((part) => part.length > 0).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+}
+async function isReadableFile(filePath) {
+  try {
+    const fileStat = await stat3(filePath);
+    return fileStat.isFile();
+  } catch {
+    return false;
+  }
+}
+async function readExistingLinks(linksPath) {
+  try {
+    const raw = await readFile6(linksPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+      expression: entry.expression.trim(),
+      url: entry.url.trim(),
+      title: typeof entry.title === "string" ? entry.title : null
+    })) : null;
+    if (!links) {
+      throw new ReportedError(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
     }
-    const previous = secondaryDedupedByType.get(parsed.contentType);
-    if (previous) {
-      previous.count += parsed.count;
-      continue;
+    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+      expression: entry.expression.trim(),
+      url: entry.url.trim(),
+      title: typeof entry.title === "string" ? entry.title : null
+    })) : [];
+    return {
+      version: typeof parsed.version === "number" ? parsed.version : 1,
+      customLinks,
+      links
+    };
+  } catch (error) {
+    if (readErrorCode2(error) === "ENOENT") {
+      return null;
     }
-    secondaryDedupedByType.set(parsed.contentType, {
-      ...parsed,
-      role: "secondary"
-    });
+    if (error instanceof ReportedError) {
+      throw error;
+    }
+    const message = error instanceof Error ? error.message : "Unknown links sidecar read error.";
+    throw new ReportedError(`Failed to read existing links from ${linksPath}: ${message}`);
   }
-  return [
-    {
-      ...primary,
-      role: "primary"
-    },
-    ...secondaryDedupedByType.values()
-  ];
 }
-
-// src/integrations/mcp/server.ts
-async function startIdeonMcpServer() {
-  const server = new McpServer({
-    name: "ideon",
-    version: package_default.version
-  });
-  server.registerTool(
-    "ideon_write",
-    {
+function mergeLinks(existingLinks, generatedLinks) {
+  const merged = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of [...existingLinks, ...generatedLinks]) {
+    const key = `${entry.expression.trim().toLowerCase()}::${entry.url.trim().toLowerCase()}`;
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    merged.push(entry);
+  }
+  return merged;
+}
+function isValidLinkEntry(value2) {
+  if (typeof value2 !== "object" || value2 === null) {
+    return false;
+  }
+  const record = value2;
+  return typeof record.expression === "string" && typeof record.url === "string" && (typeof record.title === "string" || record.title === null || record.title === void 0);
+}
+function readErrorCode2(error) {
+  if (typeof error !== "object" || error === null || !("code" in error)) {
+    return null;
+  }
+  const code = error.code;
+  return typeof code === "string" ? code : null;
+}
+function formatRelativePath2(cwd2, targetPath) {
+  const relativePath = path9.relative(cwd2, targetPath);
+  return relativePath.length > 0 ? relativePath : targetPath;
+}
+function logProgress(event, log) {
+  if (event.phase === "resolving-expression" || event.phase === "selecting-expressions") {
+    return;
+  }
+  log(event.detail);
+}
+function parseCustomLinkFlag(raw) {
+  const separatorIndex = raw.indexOf("->");
+  if (separatorIndex < 0) {
+    throw new ReportedError(`Invalid --link value "${raw}". Expected format: "expression->url".`);
+  }
+  const expression = raw.slice(0, separatorIndex).trim();
+  const url = raw.slice(separatorIndex + 2).trim();
+  if (!expression) {
+    throw new ReportedError(`Invalid --link value "${raw}": expression (left side of ->) cannot be empty.`);
+  }
+  if (!url) {
+    throw new ReportedError(`Invalid --link value "${raw}": url (right side of ->) cannot be empty.`);
+  }
+  return { expression, url };
+}
+function resolveCustomLinks(existing, addRaw, removeExpressions) {
+  const result = new Map(
+    existing.map((entry) => [entry.expression.trim().toLowerCase(), entry])
+  );
+  for (const raw of addRaw) {
+    const { expression, url } = parseCustomLinkFlag(raw);
+    result.set(expression.toLowerCase(), { expression, url, title: null });
+  }
+  for (const expr of removeExpressions) {
+    result.delete(expr.trim().toLowerCase());
+  }
+  return Array.from(result.values());
+}
+
+// src/cli/commands/writeTargetSpecs.ts
+function parseTargetSpec(spec) {
+  const trimmed = spec.trim();
+  if (!trimmed) {
+    throw new ReportedError("Target spec cannot be empty. Use <content-type=count>.");
+  }
+  const [rawType, rawCount] = trimmed.split("=");
+  if (!rawType || !rawCount) {
+    throw new ReportedError(`Invalid target "${spec}". Use format content-type=count, e.g. article=1 or x-thread=3.`);
+  }
+  const contentType = rawType.trim();
+  if (!contentTypeValues.includes(contentType)) {
+    throw new ReportedError(
+      `Unsupported content type "${contentType}". Supported values: ${contentTypeValues.join(", ")}.`
+    );
+  }
+  const count = Number.parseInt(rawCount.trim(), 10);
+  if (!Number.isFinite(count) || count <= 0) {
+    throw new ReportedError(`Invalid count in target "${spec}". Count must be a positive integer.`);
+  }
+  return {
+    contentType,
+    count
+  };
+}
+function parsePrimaryAndSecondarySpecs(options) {
+  const { primarySpec, secondarySpecs } = options;
+  if (!primarySpec && (!secondarySpecs || secondarySpecs.length === 0)) {
+    return void 0;
+  }
+  if (!primarySpec) {
+    throw new ReportedError("Missing required --primary <content-type=count>.");
+  }
+  const primary = parseTargetSpec(primarySpec);
+  if (primary.count !== 1) {
+    throw new ReportedError("Primary target count must be exactly 1. Use --primary <content-type=1>.");
+  }
+  const secondaryDedupedByType = /* @__PURE__ */ new Map();
+  for (const spec of secondarySpecs ?? []) {
+    const parsed = parseTargetSpec(spec);
+    if (parsed.contentType === primary.contentType) {
+      throw new ReportedError(
+        `Content type "${parsed.contentType}" cannot be both primary and secondary in the same run.`
+      );
+    }
+    const previous = secondaryDedupedByType.get(parsed.contentType);
+    if (previous) {
+      previous.count += parsed.count;
+      continue;
+    }
+    secondaryDedupedByType.set(parsed.contentType, {
+      ...parsed,
+      role: "secondary"
+    });
+  }
+  return [
+    {
+      ...primary,
+      role: "primary"
+    },
+    ...secondaryDedupedByType.values()
+  ];
+}
+
+// src/integrations/mcp/server.ts
+async function startIdeonMcpServer() {
+  const server = new McpServer({
+    name: "ideon",
+    version: package_default.version
+  });
+  server.registerTool(
+    "ideon_write",
+    {
       title: "Ideon Write",
       description: "Generate content from an idea using the Ideon pipeline.",
       inputSchema: writeToolInputSchema
@@ -6093,6 +6404,7 @@ async function startIdeonMcpServer() {
           audience: input.audience,
           jobPath: input.jobPath,
           style: input.style,
+          intent: input.intent,
           targetLength: input.length,
           contentTargets: parsedTargets
         });
@@ -6100,7 +6412,10 @@ async function startIdeonMcpServer() {
           workingDir: cwd(),
           runMode: "fresh",
           dryRun: input.dryRun ?? false,
-          enrichLinks: input.enrichLinks ?? true
+          enrichLinks: input.enrichLinks ?? false,
+          customLinks: input.link,
+          unlinks: input.unlink,
+          maxLinks: input.maxLinks
         });
         return {
           content: [
@@ -6156,7 +6471,10 @@ async function startIdeonMcpServer() {
           workingDir: cwd(),
           runMode: "resume",
           dryRun: input.dryRun ?? false,
-          enrichLinks: input.enrichLinks ?? true
+          enrichLinks: input.enrichLinks ?? false,
+          customLinks: input.link,
+          unlinks: input.unlink,
+          maxLinks: input.maxLinks
         });
         return {
           content: [
@@ -6215,6 +6533,48 @@ async function startIdeonMcpServer() {
       }
     }
   );
+  server.registerTool(
+    "ideon_links",
+    {
+      title: "Ideon Links",
+      description: "Run link enrichment for a previously generated article by slug.",
+      inputSchema: linksToolInputSchema
+    },
+    async (input) => {
+      try {
+        const messages = [];
+        await runLinksCommand(
+          {
+            slug: input.slug,
+            mode: input.mode ?? "fresh",
+            links: input.link,
+            unlinks: input.unlink,
+            maxLinks: input.maxLinks
+          },
+          {
+            cwd: cwd(),
+            log: (message) => {
+              messages.push(message);
+            }
+          }
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: messages.length > 0 ? messages.join("\n") : `Enriched links for ${input.slug}.`
+            }
+          ],
+          structuredContent: {
+            slug: input.slug,
+            mode: input.mode ?? "fresh"
+          }
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
   server.registerTool(
     "ideon_config_get",
     {
@@ -6276,6 +6636,60 @@ async function startIdeonMcpServer() {
       }
     }
   );
+  server.registerTool(
+    "ideon_config_list",
+    {
+      title: "Ideon Config List",
+      description: "List current settings and secret availability flags.",
+      inputSchema: configListToolInputSchema
+    },
+    async (_input) => {
+      try {
+        const result = await configList();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2)
+            }
+          ],
+          structuredContent: result
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
+  server.registerTool(
+    "ideon_config_unset",
+    {
+      title: "Ideon Config Unset",
+      description: "Reset a setting to its default or delete a stored secret.",
+      inputSchema: configUnsetToolInputSchema
+    },
+    async (input) => {
+      try {
+        if (!isConfigKey(input.key)) {
+          throw new ReportedError(`Unsupported config key: ${input.key}`);
+        }
+        await configUnset(input.key);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Unset ${input.key}.`
+            }
+          ],
+          structuredContent: {
+            key: input.key,
+            updated: true
+          }
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
@@ -6292,268 +6706,6 @@ async function runMcpServeCommand() {
   await startIdeonMcpServer();
 }
 
-// src/cli/commands/links.ts
-import { readFile as readFile6, stat as stat3 } from "fs/promises";
-import path9 from "path";
-async function runLinksCommand(options, dependencies = {}) {
-  const slug = normalizeSlug2(options.slug);
-  const mode = normalizeMode(options.mode);
-  const cwd2 = dependencies.cwd ?? process.cwd();
-  const log = dependencies.log ?? ((message) => console.log(message));
-  const resolved = await resolveRunInput({
-    idea: `Enrich links for ${slug}`
-  });
-  const markdownPath = await resolveMarkdownPathForSlug2(resolved.config.settings, slug, cwd2);
-  const frontmatter = await readFrontmatter(markdownPath);
-  const fileId = path9.parse(markdownPath).name;
-  const articleTitle = frontmatter.title ?? toTitleFromSlug(slug);
-  const articleDescription = frontmatter.description ?? "";
-  const openRouterApiKey = resolved.config.secrets.openRouterApiKey;
-  if (!openRouterApiKey) {
-    throw new ReportedError(
-      "Missing OpenRouter API key. Run `ideon settings` to configure credentials or set IDEON_OPENROUTER_API_KEY."
-    );
-  }
-  const openRouter = new OpenRouterClient(openRouterApiKey);
-  const linksPath = resolveLinksPath(markdownPath);
-  const existing = await readExistingLinks(linksPath);
-  const updatedCustomLinks = resolveCustomLinks(existing?.customLinks ?? [], options.links ?? [], options.unlinks ?? []);
-  const effectiveMaxLinks = options.maxLinks;
-  const linksResult = await enrichLinks({
-    markdownFiles: [{ markdownPath, fileId, contentType: "article" }],
-    articleTitle,
-    articleDescription,
-    openRouter,
-    settings: resolved.config.settings,
-    dryRun: false,
-    customLinks: updatedCustomLinks,
-    maxLinks: effectiveMaxLinks,
-    onItemProgress(event) {
-      logProgress(event, log);
-    }
-  });
-  const generatedLinks = linksResult[0]?.links ?? [];
-  const mergedGeneratedLinks = mode === "append" ? mergeLinks(existing?.links ?? [], generatedLinks) : generatedLinks;
-  const appendedCount = Math.max(0, mergedGeneratedLinks.length - (existing?.links.length ?? 0));
-  await writeLinksFile(markdownPath, {
-    version: 2,
-    customLinks: updatedCustomLinks,
-    links: mergedGeneratedLinks
-  });
-  const relativeMarkdownPath = formatRelativePath2(cwd2, markdownPath);
-  const relativeLinksPath = formatRelativePath2(cwd2, linksPath);
-  if (mode === "fresh") {
-    const replaced = existing ? "Replaced existing links." : "Created links sidecar.";
-    log(`Enriched links for "${slug}".`);
-    log(`${replaced} Saved ${generatedLinks.length} generated + ${updatedCustomLinks.length} custom links to ${relativeLinksPath} (${relativeMarkdownPath}).`);
-    return;
-  }
-  const baseCount = existing?.links.length ?? 0;
-  const verb = existing ? "Appended and deduplicated links." : "Created links sidecar.";
-  log(`Enriched links for "${slug}".`);
-  log(`${verb} Base ${baseCount}, added ${appendedCount}, total ${mergedGeneratedLinks.length} generated + ${updatedCustomLinks.length} custom in ${relativeLinksPath} (${relativeMarkdownPath}).`);
-}
-function normalizeMode(rawMode) {
-  const normalized = rawMode.trim().toLowerCase();
-  if (normalized === "fresh" || normalized === "append") {
-    return normalized;
-  }
-  throw new ReportedError(`Unsupported --mode value "${rawMode}". Use "fresh" or "append".`);
-}
-function normalizeSlug2(rawSlug) {
-  const slug = rawSlug.trim();
-  if (!slug) {
-    throw new ReportedError("Slug cannot be empty. Pass the generated article slug, for example `ideon links my-article-slug`.");
-  }
-  if (slug.toLowerCase().endsWith(".md")) {
-    throw new ReportedError(`Expected a slug, not a markdown filename: ${slug}. Pass the slug without .md.`);
-  }
-  if (slug === "." || slug === ".." || /[/\\]/.test(slug)) {
-    throw new ReportedError(`Invalid slug "${slug}". Pass the article slug only, without any path separators.`);
-  }
-  return slug;
-}
-async function resolveMarkdownPathForSlug2(settings, slug, cwd2) {
-  const outputPaths = resolveOutputPaths(settings, cwd2);
-  const directPath = path9.join(outputPaths.markdownOutputDir, `${slug}.md`);
-  if (await isReadableFile(directPath)) {
-    return directPath;
-  }
-  const markdownFiles = await listMarkdownFilesRecursively(outputPaths.markdownOutputDir);
-  const matches = [];
-  for (const candidate of markdownFiles) {
-    if (path9.basename(candidate) === `${slug}.md`) {
-      matches.push(candidate);
-      continue;
-    }
-    const frontmatter = await readFrontmatter(candidate);
-    if (frontmatter.slug === slug) {
-      matches.push(candidate);
-    }
-  }
-  if (matches.length === 0) {
-    throw new ReportedError(
-      `Could not find article "${slug}". Expected a markdown file in ${outputPaths.markdownOutputDir} with frontmatter slug "${slug}".`
-    );
-  }
-  return newestPath(matches);
-}
-async function newestPath(paths) {
-  let latestPath = paths[0];
-  let latestMtime = 0;
-  for (const candidate of paths) {
-    const candidateStat = await stat3(candidate);
-    if (candidateStat.mtimeMs >= latestMtime) {
-      latestMtime = candidateStat.mtimeMs;
-      latestPath = candidate;
-    }
-  }
-  return latestPath;
-}
-async function readFrontmatter(markdownPath) {
-  const markdown = await readFile6(markdownPath, "utf8");
-  return parseFrontmatter(markdown);
-}
-function parseFrontmatter(markdown) {
-  if (!markdown.startsWith("---\n")) {
-    return { slug: null, title: null, description: null };
-  }
-  const frontmatterEnd = markdown.indexOf("\n---\n", 4);
-  if (frontmatterEnd < 0) {
-    return { slug: null, title: null, description: null };
-  }
-  const block = markdown.slice(4, frontmatterEnd);
-  return {
-    slug: parseFrontmatterValue(block, "slug"),
-    title: parseFrontmatterValue(block, "title"),
-    description: parseFrontmatterValue(block, "description")
-  };
-}
-function parseFrontmatterValue(block, key) {
-  const pattern = new RegExp(`^${key}:\\s*(.+)$`, "m");
-  const match = block.match(pattern);
-  if (!match || !match[1]) {
-    return null;
-  }
-  const rawValue = match[1].trim();
-  if (!rawValue) {
-    return null;
-  }
-  if (rawValue.startsWith('"') && rawValue.endsWith('"') || rawValue.startsWith("'") && rawValue.endsWith("'")) {
-    return rawValue.slice(1, -1);
-  }
-  return rawValue;
-}
-function toTitleFromSlug(slug) {
-  return slug.split("-").filter((part) => part.length > 0).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
-}
-async function isReadableFile(filePath) {
-  try {
-    const fileStat = await stat3(filePath);
-    return fileStat.isFile();
-  } catch {
-    return false;
-  }
-}
-async function readExistingLinks(linksPath) {
-  try {
-    const raw = await readFile6(linksPath, "utf8");
-    const parsed = JSON.parse(raw);
-    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
-      expression: entry.expression.trim(),
-      url: entry.url.trim(),
-      title: typeof entry.title === "string" ? entry.title : null
-    })) : null;
-    if (!links) {
-      throw new ReportedError(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
-    }
-    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
-      expression: entry.expression.trim(),
-      url: entry.url.trim(),
-      title: typeof entry.title === "string" ? entry.title : null
-    })) : [];
-    return {
-      version: typeof parsed.version === "number" ? parsed.version : 1,
-      customLinks,
-      links
-    };
-  } catch (error) {
-    if (readErrorCode2(error) === "ENOENT") {
-      return null;
-    }
-    if (error instanceof ReportedError) {
-      throw error;
-    }
-    const message = error instanceof Error ? error.message : "Unknown links sidecar read error.";
-    throw new ReportedError(`Failed to read existing links from ${linksPath}: ${message}`);
-  }
-}
-function mergeLinks(existingLinks, generatedLinks) {
-  const merged = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const entry of [...existingLinks, ...generatedLinks]) {
-    const key = `${entry.expression.trim().toLowerCase()}::${entry.url.trim().toLowerCase()}`;
-    if (seen.has(key)) {
-      continue;
-    }
-    seen.add(key);
-    merged.push(entry);
-  }
-  return merged;
-}
-function isValidLinkEntry(value2) {
-  if (typeof value2 !== "object" || value2 === null) {
-    return false;
-  }
-  const record = value2;
-  return typeof record.expression === "string" && typeof record.url === "string" && (typeof record.title === "string" || record.title === null || record.title === void 0);
-}
-function readErrorCode2(error) {
-  if (typeof error !== "object" || error === null || !("code" in error)) {
-    return null;
-  }
-  const code = error.code;
-  return typeof code === "string" ? code : null;
-}
-function formatRelativePath2(cwd2, targetPath) {
-  const relativePath = path9.relative(cwd2, targetPath);
-  return relativePath.length > 0 ? relativePath : targetPath;
-}
-function logProgress(event, log) {
-  if (event.phase === "resolving-expression" || event.phase === "selecting-expressions") {
-    return;
-  }
-  log(event.detail);
-}
-function parseCustomLinkFlag(raw) {
-  const separatorIndex = raw.indexOf("->");
-  if (separatorIndex < 0) {
-    throw new ReportedError(`Invalid --link value "${raw}". Expected format: "expression->url".`);
-  }
-  const expression = raw.slice(0, separatorIndex).trim();
-  const url = raw.slice(separatorIndex + 2).trim();
-  if (!expression) {
-    throw new ReportedError(`Invalid --link value "${raw}": expression (left side of ->) cannot be empty.`);
-  }
-  if (!url) {
-    throw new ReportedError(`Invalid --link value "${raw}": url (right side of ->) cannot be empty.`);
-  }
-  return { expression, url };
-}
-function resolveCustomLinks(existing, addRaw, removeExpressions) {
-  const result = new Map(
-    existing.map((entry) => [entry.expression.trim().toLowerCase(), entry])
-  );
-  for (const raw of addRaw) {
-    const { expression, url } = parseCustomLinkFlag(raw);
-    result.set(expression.toLowerCase(), { expression, url, title: null });
-  }
-  for (const expr of removeExpressions) {
-    result.delete(expr.trim().toLowerCase());
-  }
-  return Array.from(result.values());
-}
-
 // src/cli/commands/settings.tsx
 import { render } from "ink";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telepat/ideon",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "CLI for generating rich articles and images from ideas.",
   "type": "module",
   "repository": {

package/README.zh-Hans.md

@@ -1,114 +0,0 @@
-# Ideon
-
-Ideon 是一款 AI 内容写作工具，可将一个想法转化为多格式、多风格、可发布的内容。
-
-[🇺🇸 English](./README.md) | [🇨🇳 简体中文](./README.zh-Hans.md)
-
-[![CI](https://github.com/telepat-io/ideon/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/telepat-io/ideon/actions/workflows/ci.yml)
-[![Coverage](https://codecov.io/gh/telepat-io/ideon/graph/badge.svg)](https://codecov.io/gh/telepat-io/ideon)
-[![npm version](https://img.shields.io/npm/v/%40telepat%2Fideon)](https://www.npmjs.com/package/@telepat/ideon)
-[![Docs](https://img.shields.io/badge/docs-live-1f6feb)](https://docs.telepat.io/ideon)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://github.com/telepat-io/ideon/blob/main/LICENSE)
-
-## 为什么团队使用 Ideon
-
-Ideon 帮助团队更快地从想法走到可发布内容，减少跨渠道重复改写的工作量。
-
-一次运行，Ideon 可以：
-
-- 基于同一核心想法生成多种输出类型：article、blog、newsletter、Reddit、LinkedIn、X thread、X post 等。
-- 在所有输出中统一应用写作风格（`professional`、`friendly`、`technical`、`academic`、`opinionated`、`storytelling`）。
-- 生成研究导向的内容 brief，补充相关链接，并在文章型任务中生成配图。
-- 通过作业文件、可配置参数与断点恢复能力支持持续迭代。
-
-这使 Ideon 适用于内容团队、开发者关系、产品营销、创始人以及需要按节奏进行多渠道写作的个人或团队。
-
-## 快速开始
-
-安装并完成第一次内容生成：
-
-```bash
-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
-
-## 核心能力
-
-- 一次想法，多格式写作：article、blog、newsletter、Reddit、LinkedIn、X thread、X post、landing-page copy。
-- 风格控制：按运行设置统一写作语气与表达风格。
-- 研究与链接增强：生成规划 brief，并为内容补充相关链接。
-- 图像生成：为文章型任务生成封面图与文内配图。
-- 迭代能力：可通过不同目标/风格重复生成，支持中断恢复和作业文件复用。
-- 本地审阅：在发布前通过浏览器预览内容与资源。
-
-## 工作原理
-
-Ideon 采用分阶段写作流水线：内容规划、正文生成、图像提示扩展、图像渲染、渠道内容生成，以及可选的链接增强。
-
-运行时会合并 settings、环境变量、job 文件与 CLI 参数，并输出结构化产物，便于追踪与复用。
-
-核心命令：
-
-```bash
-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
-ideon mcp serve
-ideon agent status --json
-```
-
-Agent 集成范围：
-
-- 支持：CLI 与 MCP runtime 工作流。
-- 不支持：Cursor 与 VS Code runtime 集成。
-
-## 安全与信任
-
-- 默认通过 `ideon settings` 将密钥保存到系统钥匙串。
-- 在 CI 或容器环境中，请使用 `IDEON_OPENROUTER_API_KEY` 和 `IDEON_REPLICATE_API_TOKEN`。
-- 在无法访问钥匙串时设置 `IDEON_DISABLE_KEYTAR=true`。
-- 生成内容来自模型输出，发布前请进行人工审阅。
-
-如需报告安全问题，请通过仓库安全报告通道私下提交，或通过仓库 issue 渠道联系维护者并避免包含敏感细节。
-
-## 文档与支持
-
-- 文档站点：https://docs.telepat.io/ideon
-- 语言支持：English 与 简体中文（`README.md` / `README.zh-Hans.md`，以及双语文档）
-- 快速上手：`docs/getting-started/quickstart.md`
-- CLI 参考：`docs/reference/cli-reference.md`
-- 配置指南：`docs/guides/configuration.md`
-- 故障排查：`docs/guides/troubleshooting.md`
-- 仓库：https://github.com/telepat-io/ideon
-- npm 包：https://www.npmjs.com/package/@telepat/ideon
-
-## 贡献
-
-欢迎贡献。请先阅读 `docs/contributing/development.md`（开发环境与质量门禁），再参考 `docs/contributing/releasing-and-docs-deploy.md`（发布与文档部署流程）。
-
-如修改面向用户的文档内容，请在同一变更中同时更新 English 与 简体中文版本。
-
-## 许可证
-
-MIT。详见 [LICENSE](./LICENSE).