用途:这是 Velt Rewriter 的实现指南。Velt Rewriter 是一个 AI 文本改写原语,允许用户选中文本后应用 AI 生成的改写,或将 AI 辅助评论锚定到所选文本范围。
主要能力与流程:覆盖完整客户端管线 enableRewriter → on('textSelected') → askAi → replaceText / addComment,以及默认工具栏开关、AI 模型类型标注和基于线框原语的自定义 UI。
适用场景:为 React、Next.js 或 Web 应用添加 AI 文本改写;接入标准 Rewriter 管线;调用 askAi 并选择模型(Velt 依据模型前缀自动路由提供商,自定义 LLM 密钥在 Velt Console 配置);用 replaceText 原地替换 DOM 文本;用 addComment 把 AI 建议锚定为 Velt 评论;通过 enableDefaultUI / disableDefaultUI 控制内置选择工具栏是否显示;基于 componentConfig.* 绑定构建自定义 Rewriter UI;以及针对 RewriterAskAiRequest、RewriterReplaceTextRequest、RewriterAddCommentRequest、AiModel 做类型标注。
规则分类:API 方法(api-,高优先级)、模式(patterns-,高优先级)、类型(types-,中优先级)、线框变量(wireframe-variables-,中优先级)。具体规则文件包括 api-enable-rewriter、api-on-text-selected、api-ask-ai、api-replace-text、api-add-comment、api-default-ui-toggle、patterns-end-to-end-flow、types-ai-model、wireframe-variables-rewriter。每个规则文件含说明、正确代码示例、常见陷阱与验证清单。
限制:服务端 AI 生成(Velt Python SDK 的 sdk.api.rewriter.askAi)不在本技能内,另见 velt-self-hosting-data-best-practices。资料未提供具体安装命令、价格与平台支持细节。