写作助手: AI写作工具、风格模仿与智能润色插件

风格化写作助手 (Writing Agent) 是一款深度集成于 VS Code 的 AI 写作插件。它能自动学习您的写作风格，沉淀灵感素材，并基于风格档案生成高度一致的文章、提纲或进行智能润色。

功能特性

1. 深度风格学习与模仿

• 多维分析：基于 14 个核心维度（词汇偏好、句式结构、叙述节奏、修辞习惯等）对样本进行深度分析。
• 风格档案：为不同场景（公文、小说、技术博客、社交媒体）建立独立的风格档案，支持风格自定义。
• 风格切换：支持在不同风格档案之间快速切换，适应多样化的写作场景需求。

2. 智能化素材管理系统

• 自动沉淀：一键保存选中文本为素材，支持自动提取标签与摘要。
• 高效检索：支持按风格隔离、按分组筛选，快速在创作中复用灵感片段。
• 标签管理：为素材添加多维度标签，支持标签编辑与智能推荐。
• 素材导出：支持将素材库导出为多种格式，便于备份与迁移。

3. 素材工作台

• 可视化编辑：提供直观的素材编辑界面，支持富文本格式。
• 快速录入：支持快捷键快速保存当前选中文本到素材库。
• 智能分类：根据内容自动推荐分类，支持自定义分组管理。
• 素材预览：在应用素材前可预览完整内容，确保引用准确。

4. 文集管理系统

• 文章组织：自动将生成的文章归类到文集，支持自定义文集结构。
• 分组管理：支持创建文章分组，按项目或主题组织文档。
• 文章移动：支持在不同分组之间拖拽移动文章。
• 历史记录：自动保存文章修改历史，支持撤销/重做操作。
• 最近文章：快速访问最近编辑的文章列表。

5. 多视图模式

• 月视图模式：以月历形式展示文章创作记录，直观查看写作频率与进度。
• 年视图模式：年度写作概览，统计全年创作数据与趋势分析。
• 列表视图：传统的列表展示方式，支持按时间、名称排序。
• 切换展示：支持在不同视图模式之间一键切换。

6. 多样化 AI 生成能力

• 一键生成：根据主题自动生成完整文章或两套以上不同侧重的写作提纲。
• 智能改写：提供优化表达、扩写细节、帮写重构等多种润色模式，保持文风统一。
• 指定风格改写：支持在改写时临时选择任意已存在风格，按目标风格重写选中文本。
• 内联改写确认：改写结果直接插入选区下方并高亮展示，按钮组在行尾提供“替换 / 插入 / 取消”操作。
• 失败可决策预览：改写失败时仍保留最后一次结果内联预览（红色背景），原文选区为蓝色背景，用户仍可继续执行“替换 / 插入 / 取消”。
• 风格保持：生成内容严格遵循已学习的风格档案，确保输出一致性。
• 批量生成：支持基于同一主题生成多个版本供选择对比。

7. 灵活的 AI 模型配置

• 多通道支持：支持统一 API（OpenAI 兼容）与 IDE 原生 Chat（Cursor/CodeArts/VS Code）双通道。
• 高可用链路：支持多提供商、多模型自动回退（Fallback）与拖拽排序。
• 主流模型：兼容小米 Mimo、DeepSeek、Kimi、Qwen、OpenRouter 等主流 AI 模型。
• 智能切换：当某个模型不可用时，自动切换到备用模型，确保服务连续性。

8. 智能辅助功能

• 自动补全：根据上下文智能预测并提示后续内容。
• 剪贴板集成：支持将剪贴板内容智能粘贴到当前文稿。
• 图片插入：支持在文章中插入图片，自动处理图片路径。
• 快捷操作：丰富的快捷键支持，提升写作效率。

9. 插件市场搜索优化（SEO）

• 市场标题策略：主标题强调 AI 写作生成 + 文风模仿 + 素材文集管理，让用户在搜索结果中快速理解插件核心价值。
• 市场描述策略：描述聚焦“中文写作”“选区改写”“风格学习”“素材检索”“写作日历”，并明确支持 Mimo/DeepSeek/Kimi/Qwen/OpenRouter。
• 核心检索词（中文）：写作助手、AI写作助手、文章生成、文章改写、文本润色、文风模仿、素材管理、文集管理。
• 核心检索词（英文）：writing assistant、ai writing、style mimic、rewrite、content generation、vscode extension。
• 长尾检索词：中文写作插件、markdown写作、VS Code写作、写作日历、collection management、style transfer。
• 模型适配词：Mimo、DeepSeek、Kimi、Qwen、OpenRouter（提高模型相关搜索命中率）。

常见问题

Q1: 如何开始使用风格学习功能？

1. 在左侧面板选择"风格档案"视图。
2. 点击"导入样本"按钮（快捷键 Cmd/Ctrl + Shift + I），选择您的代表作。
3. 系统将自动分析并生成对应的风格档案，之后生成的内容将参考该档案。

Q2: 插件支持哪些 AI 模型？

插件支持所有兼容 OpenAI 格式的 API（如 Mimo、DeepSeek、Kimi、Qwen、OpenRouter 等）。您可以在设置中配置多个 API 提供商，系统会按顺序自动尝试。

Q3: 生成的内容会保存在哪里？

生成的结果会自动写入文稿，并同步记录在"文集管理"视图中。您可以在设置中自定义存储根目录（writingAgent.storage.path）。

Q4: 如何使用素材工作台？

1. 在编辑器中选中想要保存的文本片段。
2. 使用快捷键 Cmd/Ctrl + Shift + M 或右键菜单选择"保存为素材"。
3. 在弹出的工作台中为素材添加标签和描述。
4. 保存后可在素材库中检索和复用。

Q5: 如何切换文集的视图模式？

在文集管理视图中，点击视图切换按钮可在月视图、年视图和列表视图之间切换。月视图和年视图可以帮助您直观地了解写作频率和进度。

快速开始

1. 配置 API：执行命令 写作助手: 配置 API，输入您的 API Key。
2. 导入风格：使用 Cmd/Ctrl + Shift + I 导入样本文章。
3. 开始写作：使用 Cmd/Ctrl + Shift + G 输入主题，享受风格化生成的便利。

配置项

在 VS Code 设置中搜索 写作助手，或直接修改 settings.json。

说明：

• writingAgent.api.providerConfigs 由命令自动维护，不建议手工编辑。

主要命令

• writingAgent.showAssistantViews：显示写作助手
• writingAgent.generateArticle：根据主题生成文章/提纲
• writingAgent.rewriteSelectionWithIFlow：AI 编辑选中文本
• writingAgent.importArticle：导入样本数据
• writingAgent.searchMaterial：搜索素材
• writingAgent.analyzeStyle：分析当前文档风格
• writingAgent.configureApi：配置 API
• writingAgent.testApiConnection：测试 API 配置
• writingAgent.reorderApiProviders：拖拽调整 API 提供商顺序
• writingAgent.reorderApiModels：拖拽调整 API 模型顺序
• writingAgent.applyClipboardToDraft：将剪贴板内容写入当前文稿
• writingAgent.createArticleGroup：创建文章分组
• writingAgent.moveArticleToGroup：移动文章到分组
• writingAgent.openWritingCalendar：打开写作日历（月视图）
• writingAgent.switchCollectionDisplayMode：切换文集展示模式
• writingAgent.pasteImageToArticle：粘贴图片到文章

快捷键

• Cmd/Ctrl + Shift + G：生成文章
• Cmd/Ctrl + Shift + I：导入样本
• Cmd/Ctrl + Shift + S：搜索素材
• Cmd/Ctrl + Shift + A：分析当前文档
• Cmd/Ctrl + Shift + M：保存选中文本为素材

典型流程

1. 导入样本文章，建立风格档案。
2. 配置 API（可配置多个提供商与多模型顺序）。
3. 输入主题生成文章，结果自动追加到文稿并自动打开文集。
4. 在文稿中选中段落执行 AI 改写，通过浮层预览后决定替换或插入。
5. 使用素材库检索与复用高质量片段。
6. 通过月视图/年视图查看写作进度和统计。

贡献

项目地址：https://github.com/wangjianghu/Stylized-Writing-Assistant 欢迎提交 Issue 或 PR。