MarsCode脚本提示词按平台改写使用指南

你是否曾经遇到这样的场景？在 MarsCode 中精心编写好一份脚本提示词，切换到其他平台后立刻报错——要么提示变量未定义，要么提示文件无法读取。问题并不出在提示词本身，而是不同平台在上下文感知能力、变量注入机制以及文件访问权限上，完全遵循着三套截然不同的逻辑。

因此，针对 VS Code 插件版、Web 在线版、CLI 命令行版这三种环境，必须分别对提示词进行针对性适配，绝不能一套方案通吃所有平台。下面详细说明各类平台的具体调整方法。

确认当前运行平台

启动 MarsCode 后，首先观察右下角的状态栏图标：VS Code 图标代表插件版，地球图标代表 Web 在线版，终端图标代表 CLI 命令行版。这一步切勿跳过——不同平台的变量注入机制和文件访问权限差异巨大，如果直接复用同一段提示词，极容易触发“变量未定义”或“无法读取 workspace”等错误。

VS Code 插件版提示词改写要点

方法一：启用工作区上下文
在提示词开头添加一句：「当前运行在 VS Code 中，已打开的工作区路径为 {{workspaceFolder}}，当前编辑的文件为 {{fileName}}。请基于此上下文生成代码。」这样一来，插件就能将文件系统信息传递给模型。

方法二：调用编辑器 API 变量
使用 {{selection}} 获取光标选中的内容，借助 {{lineNumber}} 定位当前行——这些变量是插件版独有的。Web 版和 CLI 版如果尝试使用这些变量，会直接忽略或返回空值错误，因此不要指望它们能识别。

Web 在线版提示词改写步骤

第一步：移除所有本地路径依赖
删掉诸如“读取 ./src/config.ts”“检查 node_modules 是否存在”这类指令。Web 版运行在沙箱环境中，根本无法访问真实文件系统，写了也毫无意义。

第二步：替换为可交互输入占位符
例如，原来写“根据 package.json 中的 dependencies 生成兼容版本列表”，应改为：“请用户提供当前项目的 dependencies 字段 JSON 内容，我将据此分析兼容性。”将硬编码的路径转换为需要用户手动输入的环节。

第三步：禁用实时文件操作指令
“保存修改后的文件”“自动格式化当前文档”这类操作在 Web 版中不可行——因为它不支持写入操作。保留这些指令只会让提示词的逻辑中断，建议直接删除。

CLI 命令行版提示词关键调整

方法一：显式声明输入源
开头必须注明：「本次执行通过 stdin 传入代码片段，或通过 --file 参数指定路径。若未提供，则返回使用示例。」这样 CLI 才能明确数据来源。

方法二：适配无 UI 反馈场景
CLI 没有颜色高亮，也没有界面弹窗。因此“请高亮显示冲突行”这类指令需要改为机器可读的输出格式，例如：「以 JSON 格式输出冲突行号数组：{ "conflictLines": [3, 17, 42] }」——格式清晰，后续也便于解析。

另外需要注意：CLI 版默认不会加载 Git 上下文，如果想使用 {{gitStatus}} 变量，必须额外加上 --git-status 参数，否则该变量始终为空字符串，不要指望它能自动生效。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：MarsCode脚本提示词按平台改写使用指南要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题