☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
marscode参数文档需直击实效：每项必须说明不填/填错/填对的即时后果，禁用“请”“建议”等客服话术，绑定真实报错与业务场景，删除模板化空话。
你要让marscode生成的脚本参数文档一眼看懂每个参数实际作用，不能只写“--input：输入路径”，而要说明它在什么场景下必须填、不填会怎样、填错会报什么错。
删光模板化参数描述句式
打开MarsCode设置 →「自定义提示词」→ 找到当前生效的script-param-doc模板 → 删除所有含“参数含义如下”“请传入合法值”“建议使用绝对路径”字样的句子。
【漏删一句，生成的参数说明就会变成教科书式空话】。MarsCode看到“建议”“请”就自动套用客服语气，输出全是安全兜底废话，比如“--timeout：超时时间（单位：秒），默认30”，却不告诉你“设为0会导致重试无限循环”。
把“请为以下Python脚本生成参数说明”直接改成：“这是/cli/backup.py，运维每天凌晨执行，--src必须指向已挂载的NAS卷，--dst不能是/tmp；若--compress未指定，日志将不压缩直接写入磁盘。”
用真实调用失败案例反推参数边界
方法一：粘贴你刚遇到的真实报错
控制台显示：ValueError: --retention must be integer >= 1 —— 请据此写出参数说明，要求包含“最小值1”“小于1将触发ValueError”“典型值7或30”三要素。
方法二：复现一次错误输入
手动运行 backup.py --src /mnt/old --retention -2 → 复制终端完整报错 → 粘进提示词开头，后面接：“请据此写出--retention参数说明，不解释异常机制，只说‘你填-2会立刻退出并打印该错误’”。
【不带真实报错，MarsCode默认写‘合理范围：1–999’这种无效信息】。它无法感知你项目里实际校验逻辑是int()后比大小，还是正则匹配\d+，只有你给的报错才能锚定真实约束。
强制参数说明必须含动作后果
第一步：在提示词末尾加硬约束
每条参数说明必须包含且仅包含以下三类信息之一：① 不填时的默认行为（如“不填则跳过校验”）；② 填错时的即时反馈（如“填非数字将报ValueError”）；③ 填对后的具体效果（如“填30表示保留最近30天备份”）。
第二步：禁用三类无效表达
禁止出现：“该参数用于……”“可选参数”“推荐值为……”——这些全是模型幻觉产物，用户根本不知道“用于”什么、“推荐”依据在哪。
第三步：绑定参数与文件角色
在提示词开头写：“这是/db/migrate.py，DBA在发布前手动执行，--env prod必须传，否则拒绝连接生产库；--dry-run不填则直接执行SQL，填true只打印不执行。”
