诉讼律师全能助手(专业版·不限国内)
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-y1eh5fyg--cue-litigation-lawyer-assistant.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-y1eh5fyg/cue-litigation-lawyer-assistant。专为从事民商事及刑事诉讼的执业律师、法务打造的 AI 案头助手。将繁琐的“查、核、算、写”工作交由 AI 处理——支持合同审查、疑难案件的类案检索与裁判规则提取、复杂赔偿金/诉讼费的自动理算、诉讼及非诉文书的高质量起草与仿写;更提供深度的文书审校功能,自动核验法条效力与案号真伪。直连国内外权威法律数据库,每个结论均附原始链接,助力法律人大幅节省案头时间,提升办案人效。
关键词: [诉讼律师, 律师助手, 法理分析,类案检索, 文书起草, 证据校对, 法规核验, 案头工具, legal assistant]
阅读全文 (展开查看完整说明)
概述
诉讼律师案头助手 (Litigation Assistant)
🚀 30 秒了解:
专为执业律师打造的 AI 全能律师助理。办案精力有限?把案头的“脏活累活”交给它。
它不仅能秒查最新法规,还能迅速帮你审查合同、提取类案裁判规则、自动理算复杂赔偿金、按指定风格起草诉讼文书,并逐条穿透核对长文书中的法条效力。
🟢 能做:法规秒查、类案规则检索、文书起草/仿写、法条案号审校、法理研判、合同审查。
🔴 不能做:出具最终法律意见、代替律师人工签字及担责。
🛡️ 专业承诺:产出结论均附带权威来源链接与现行有效法条,从根源拒绝 AI 幻觉。
和传统「法律检索库」有何不同?
市面上的法律工具大多是检索库或模板库——输入关键词,返回海量未清洗的判决书或空白模板,最终仍需律师逐篇阅读、手动拼凑、自行套公式算金额。
但真正耗费律师“计费时间 (Billable Hours)”的,是跨源整合与计算核对:
- 在一堆判决中,总结某种特定情形下的裁判倾向。
- 核对一份 20 页上诉状里的 30 个法条是否已被废止。
- 计算跨越 5 年、本金不断变动的阶梯式违约金。
这正是本助手的强项:从“提供海量资料”升级为“交付可用工作成果”。
核心能力:为什么选它作为案头搭档
| 核心能力 | 解决律师什么痛点 |
|---|---|
| ⚡️ 法规秒级直达 | 单纯查询法条原文或最新法规时,调用轻量 MCP 工具,无需等待,秒级直出原文与时效。 |
| ⚖️ 疑难类案研判 | 针对新型/边缘案件,精准提取各地法院裁判规则与争议焦点,直接输出法理分析报告。 |
| 🧮 智能理算工具 | 诉讼费、人身损害赔偿、阶梯式利息违约金、工伤(N/2N)——无需人工列 Excel,AI 自动理算并附推导明细。 |
| 📑 卷宗证据解析 | 上传聊天记录、卷宗扫描件或录音笔录,精准提取案件时间线 (Timeline) 与关键事实要素。 |
| ✍️ 文书起草与仿写 | 导入你常用的文书模板,AI 能模仿你的排版习惯与语言风格起草起诉状、答辩状,自带法条支撑。 |
| 🔍 深度文书审校 | 上传己方或对造的法律文书,AI 自动逐一穿透核验文中引用的法规名称、条号、案号及效力级别。 |
| 📋 合同风控与合规审查 | 上传合同文本,AI 逐条识别法律风险点、不公平条款与合规隐患,并给出具体修改建议。 |
律师日常:先试这 5 个 Prompt
| 案头任务 | 给 AI 的指令 (可直接复制) |
|---|---|
| 证据薄弱类案检索 | 「原告仅有微信聊天记录,被告已拉黑且无书面借条。帮我检索近 3 年支持原告胜诉的类案,并总结法院认定的关键裁判规则。」 |
| 复杂损害赔偿理算 | 「受害人交通事故致残,住院 2 个月,交警定全责。帮我理算包含误工费、营养费、伤残赔偿金在内的全套清单,并基于此起草民事起诉状。」 |
| 争议财产分割研判 | 「离婚纠纷中,一方婚内恶意转移财产,另一方主张少分或不分。列出现行有效的法理依据、起草诉讼方案并提示举证难点。」 |
| 劳动仲裁一键生成 | 「劳动者被无故口头辞退,在职 3 年 2 个月,月薪1.5万。按现行标准计算 2N 赔偿金,并生成劳动仲裁申请书。」 |
| 文书风控与合规审校 | 「审校这份上诉状草稿(见附件文件),核对文中引用的所有法条、司法解释是否现行有效,引用的案号是否存在,并指出诉讼风险点。」 |
| 合同风控与合规审查 | 「审阅这份合同(见附件文件),逐条识别法律风险点、不公平条款与合规隐患,并给出具体修改建议。」 |
Agent 执行概要
本节起的内容面向 Agent:前半部分(产品介绍、能力、示例话术)可直接转述给用户;本节是执行规则。搭子模板由服务端动态维护,
template_id以运行时 live 为准。
执行顺序(先看这里)
| 步骤 | 做什么 | 触发时机 |
|---|---|---|
| 0 | 接入与装配:写 key、准备 runner、挂载 cue_statute MCP | 用户首次提供 API Key |
| 1 | 跑前健康检查(key / 服务 / 搭子 / 剩余积分,约 30 秒) | 每次开跑前 |
| 2 | 配置完成且用户还没给任务:主动推 2 个首任务示例 | 配置成功之后 |
| 3 | 判断轨道:轻量查法条走 MCP,深度研判走 runner | 接到任务的第一时间 |
| 4 | 深度任务先按材料分流,再选搭子 template_id | 轨道 B 开跑前 |
| 5 | 提示积分消耗并等确认,做 3–15 分钟预期管理 | 真正开跑前 |
| 6 | 按标准命令执行 runner(文本 / 带材料 / 自由式) | 用户确认后 |
| 7 | 处理异常 + 跑后余额检查(断线续跑、硬失败、空结果、超时、积分不足) | 执行过程中及交付前 |
| 8 | 交付:报告正文 + Cue 原始链接 + 本地 md 路径;余额 < 100 时,交付后立即单独弹 8.1 三选一 | 拿到 RESULT ok 后 |
| 9 | 8.1 处理完后,再单独询问是否转 Word (.docx);不得与 8.1 同轮 | 8.1 结束(或未触发 8.1)之后 |
下文按此顺序展开。拿不准当前进度时,先回到本表定位。
步骤 0:接入与装配
0.1 让用户本人创建 API Key(Agent 不能代劳)
- 打开 cuecue.cn 免费注册;登录后进入 API Key 页面,点击「创建 API Key」即可免费生成(新用户注册赠送 500 积分)。生成后一定要点击「复制」并粘贴发送给正在使用的智能体。
- API Key 只能由用户本人创建:Agent 既不能代生成、也无权查看用户的 Key。检测到未配置或失效时,按以下话术告知用户:「点击『创建 API Key』,生成 API Key 后一定要点击『复制』并粘贴发送给我。」 然后等待用户提供,禁止声称"我去生成/查看"。
- 用户把 Key 发来后,直接用该 Key 完成 0.2–0.4 的装配,再按步骤 1 做一次自检。
0.2 写入配置:如果 ~/.cue/config.json 不存在,使用用户的 key 自动生成并写入。
0.3 准备 Runner(深度研判所需):若无 runner 脚本,自动克隆开源仓(含全套依赖):
if [ -d ~/.cue/cue-skills/.git ]; then
git -C ~/.cue/cue-skills pull --ff-only
else
git clone https://github.com/sensedeal/cue-skills ~/.cue/cue-skills
|| git clone https://gitee.com/sensedeal/cue-skills ~/.cue/cue-skills
fi0.4 挂载 cue_statute MCP(轨道 A「秒级查法条」的前提,极其重要)
必须帮助用户自动将 cue_statute MCP 写入客户端的配置文件。找到当前客户端的 MCP 配置文件(如 Claude Desktop 的 ~/Library/Application Support/Claude/claude_desktop_config.json,或 Workbuddy/Claude Code 对应的配置文件)。解析原 JSON,将以下节点安全地追加到 mcpServers 中,并将 <your-key> 替换为用户的真实 API Key:
"cue_statute": {
"type": "streamable-http",
"url": "https://mcp.cuecue.cn/api/statute/mcp/",
"headers": {
"Authorization": "Bearer <your-key>"
}
}写入完成后,必须提示用户:“MCP 秒级查法条工具已配置完成,请重启当前 AI 客户端以使配置生效。”
0.5 积分口径(向用户说明时使用)
- 积分赠送:新注册送 500 积分;每邀请 1 位新用户再送 500 积分——打开 https://cuecue.cn/?open_reward=true,复制「专属邀请链接」分享给好友注册,当好友激活使用后积分即到账。
- 积分不足:两个办法——积分赠送(同上)或 9.9 加油包(限购 1 次,9.9 元得 900 积分):https://cuecue.cn/pay/topup。
步骤 1:跑前健康检查(每次开跑前必做,约 30 秒)
深度任务一次就是积分消耗,配置错必须拦在开跑之前,不要等跑挂了才发现(挂了的信号是那一次积分已经花了)。
ROOT=$(python3 ~/.cue/cue-skills/cue-research/scripts/cue_api.py root)
K=$(python3 -c "import json;print(json.load(open('$HOME/.cue/config.json'))['api_key'])" 2>/dev/null || echo "$CUE_API_KEY")
echo "=== 1/4 API Key ==="; [ -n "$K" ] && echo "已配置(${#K} 位)" || echo "未配置!"
echo "=== 2/4 Cue 服务 ==="; curl -sS --max-time 10 "https://cuecue.cn/api/health" | python3 -c "import sys,json;print('status =',json.load(sys.stdin).get('status'))" 2>/dev/null || echo "服务不可达(网络/代理/沙箱出站)"
echo "=== 3/4 搭子在线情况 ==="; curl -sS --max-time 15 "https://cuecue.cn/api/playbook" -H "Authorization: Bearer $K" | python3 -c "
import sys,json
want={'template_M3loak':'法律文书审校','template_BFSwVa':'合同风控与合规审查','template_LwdgVW':'疑难法律实操案例库','template_c84pmj':'诉讼文书起草','template_sRdpsI':'法律实务问题研判','template_uJKQlK':'国内法规调研','template_UsZH8W':'法规逐条深度解读','template_jbjaEU':'中外法律对比'}
sc=json.load(sys.stdin).get('data',{}).get('scenes',[])
live={b.get('template_id') for s in sc for b in s.get('buddies',[])}
for t,n in want.items(): print((' ✅ ' if t in live else ' ⚠️ '),n,t,'' if t in live else '(playbook 未列出)')
"
echo "=== 4/4 剩余积分 ==="; curl -sS --max-time 10 "https://cuecue.cn/api/v1/billing/subscriptions/current" -H "Authorization: Bearer $K" | python3 -c "
import sys,json
d=json.load(sys.stdin) or {}
d=d.get('data',d) or {}
a=d.get('available_credits') or 0; p=d.get('permanent_credits_balance') or 0
print('剩余积分 =', round(a+p,2), '(可用', a, '+ 永久', p, ')')
" 2>/dev/null || echo "积分查询失败(不阻断,继续)"
echo "=== root ==="; echo "$ROOT"剩余积分口径:available_credits + permanent_credits_balance(前者只含每日剩余 + 周期剩余,不含永久赠送额度,必须相加)。接口无订阅时返回 null,首次调用会自动创建免费订阅,不要高频轮询。查询失败不阻断任务、不向用户抛错。
| 检查 | 预期 | 不通过怎么办 |
|---|---|---|
| API Key | 已配置 | 由用户本人去 cuecue.cn 注册并创建 API Key 后发来;Agent 不能代创建、也无权查看 |
| 服务 | status = healthy | 等 5 分钟重试;持续不可达 → 查网络 / 代理 / VPN / 沙箱出站(见步骤 7 的硬失败分支) |
| 搭子 | 目标搭子 ✅ | 显示 ⚠️ (playbook 未列出) 的搭子先别直接选——playbook 只反映当前账号可见的搭子,未列出 ≠ 一定不可用,但若真不可用会 404 硬失败且无 replay 可救;不确定时改用「深度研究通用版(留空不传)」 |
| 剩余积分 | 剩余积分 > 0(建议 ≥ 100) | 已不足(≤ 0)→ 立即停止、不要开跑,按 7.8 给出两个办法;0 < 余额 < 100 → 提醒「余额偏低,可能不够本次深度任务」但可继续;查询失败不阻断 |
⚠️不等于不能用,是不确定:本助手实测template_UsZH8W(法规逐条深度解读)在常查账号的 playbook 里不出现,但网页端https://cuecue.cn/?s=template_UsZH8W确实可用——说明 playbook 的可见范围可能窄于实际可用范围。别只凭 playbook 就判定某搭子已下线,先按 URL 核实或直接试跑一次。
如果用户提供了本地文件(如 docx、pdf 等),不要尝试自己在本地读取文本,请直接使用 runner 脚本原生的 --material <文件路径> 参数将文件传给平台处理。
步骤 2:配置成功后的首任务引导(必须执行)
装配完成并跑过步骤 1 的健康检查(四项全绿)后,这是配置流程的终点,不是任务的终点。若用户还没给出具体任务,必须主动把用户推向第一次真实调用,不要停在"环境已就绪":
环境已就绪 ✅ 下面这些都可以直接跑,比如:
- "原告仅有微信聊天记录,被告已拉黑且无书面借条。帮我检索近 3 年支持原告胜诉的类案,并总结法院认定的关键裁判规则。"
- "受害人交通事故致残,住院 2 个月,交警定全责。帮我理算包含误工费、营养费、伤残赔偿金在内的全套清单,并基于此起草民事起诉状。"
挑一个发给我,或直接把你手头的需求告诉我,我现在就跑。
规则:
- 主动、可复制——示例问题原句取自上文「律师日常:先试这 5 个 Prompt」,别只写"你可以问我任何问题"。
- 不要等用户自己想——用户没开口时也要主动给;否则用户会停在"验证通过"就散场(实测这是新用户流失最集中的一步)。
步骤 3:判断轨道(接到任务第一时间)
在接到用户指令后,必须首先判断任务的复杂度,决定走“轻量 MCP”还是“深度 Runner”:
- 🟢 轨道 A(轻量查询):如果用户只是查询或核查验证某部法律法规原文、某条法条的内容与效力——含"这条还有效吗""有没有被修订/废止""现行版本是什么"这类单条法规的事实核查。
👉 动作:直接调用你环境中挂载的 cue_statute MCP 工具输出结果(search_cn_statutes 中国法 / search_us_law_fulltext 美国法 / search_eu_law 欧盟法,均返回效力状态、公布施行日期与官方全文链接)。无需跑 runner 脚本,无需让用户等待,无需提示消耗 credits。👉 查不到才降级:仅当 MCP 返回空或不相关时,才改用自由式深研(跑 runner 脚本但不带 --template-id)。此时已是深度任务,须按轨道 B 的正常流程走(照常提示积分、做 3-15 分钟预期管理)。不要因为 MCP 没结果就改选「法律实务问题研判」——那一行是给深度实务问题用的,不是查法规的备胎。
- 🔴 轨道 B(深度研判):如果用户涉及类案检索、文书起草、证据核验、文书审校、复杂法理研判等。
👉 动作:必须走步骤 4–9 的深度 Runner 工作流。
⚠️ 先退一步:单条法规的查询/核查根本不该走到轨道 B。 用户只要某部法规或某条法条的原文、内容、效力(是否有效、是否被修订废止),那是轨道 A——直接调
cue_statuteMCP,别去挑搭子。MCP 没查到,降级用自由式深研(不带--template-id),不要退而选「法律实务问题研判」。
步骤 4:深度任务的材料分流与搭子路由
先按「用户交的是什么材料」分流,再按语义匹配选搭子(禁止仅凭话题关键词盲配)。
用户递过来一份现成文本让你把关时,按「这份东西是什么」定搭子,不要按话题里的法律关键词定:
| 用户交来的东西 | 走去哪 |
|---|---|
| 诉讼文书(起诉状 / 答辩状 / 上诉状 / 律师函 / 仲裁申请书 / 代理词) | 法律文书审校 template_M3loak |
| 合同文本 | 合同风控与合规审查 template_BFSwVa |
| 普法文章 / 法律科普稿 / 公众号法律内容 / 培训讲稿 / 宣传文案 | 深度研究通用版(留空不传) |
| 其他执业文本(合规意见 / 法律研究草稿 / 答复文本) | 法律文书审校 template_M3loak |
| 只是提问("这事法律上怎么处理"),没交材料 | 按下方路由表语义匹配 |
⚠️ 普法文章的头号误配是「法律实务问题研判」:文章本身在讲法律问题,agent 一看到法律话题就抓那一行。但那一行的前提是用户在提问(入参是
[待研判_法律_问题]),不是用户交了一篇面向公众的成稿让你审。普法内容要核的是法条引用是否准确、表述有无越界、有没有误导性或承诺性说法——按材料类型走深度研究通用版(留空不传),不要套执业文书的审校模板。
搭子路由表(提取 template_id):
| 适用场景 | template_id | 适合的用户问题特征 |
|---|---|---|
| 疑难法律实操案例库 | template_LwdgVW | 需查同类案子判决、赔偿标准、争议焦点 |
| 诉讼文书起草 | template_c84pmj | 起草/撰写起诉状、答辩状、律师函、仲裁申请等 |
| 法律文书审校 | template_M3loak | 审的是诉讼文书或执业文本(诉状/律师函/合规意见/研究草稿),要求核验证据、条号效力、案号真伪 —— 普法文章、科普稿不选这行 |
| 合同风控与合规审查 | template_BFSwVa | 审查合同条款、识别法律风险点、合规性审查与修改建议 |
| 国内法规调研 | template_uJKQlK | 结合实务背景,深度调研国内法规原文、立法背景 |
| 法律实务问题研判 | template_sRdpsI | 用户在提问:一个具体实务问题怎么处理、怎么判 → 需现行法条 + 类案规则 + 操作要点 —— 用户交来成稿让审时不要选这行;只是查某条法规原文/效力也不要选这行(走轨道 A 的 cue_statute MCP) |
| 法规逐条深度解读 | template_UsZH8W | 对某部指定法规或某一条款做逐条深度解读 |
| 中外法律对比 | template_jbjaEU | 跨法域比较法分析(如中美规则异同、涉外调研) |
| 深度研究通用版 | (留空不传) | 泛化法律研究问题、基础问答;以及普法文章/法律科普稿/宣传文案的审核 |
步骤 5:积分确认与预期管理
- 积分确认:开跑前提示「将跑该问题,需耗 credits,是否继续?」,等用户确认后再跑,不静默扣费。
- 预期管理:执行前必须向用户发送「🚀 正在启动深度研判,需连接权威数据库,大约需要 3 到 15 分钟。我会后台为您执行,完成后立即向您汇报。」
步骤 6:执行命令
场景 A:仅文本查询(命中搭子)
python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py
--query "<用户问题原话>"
--template-id <对应的template_id>
--output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-litigation-lawyer.md场景 B:包含文件上传(命中搭子,如文书审校)
python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py
--query "<用户审校或研判指令>"
--material "<本地文件绝对路径>"
--template-id <对应的template_id>
--output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-litigation-lawyer.md场景 C:不带 template-id——未命中任何搭子(自由式兜底),或用户交的是普法文章/科普稿要审核(这类是指定走深度研究通用版,不是"没匹配上")
python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py
--query "<用户问题原话>"
[--material "<本地文件绝对路径>"]
--output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-litigation-lawyer.md输出:三种场景默认均产出 Markdown (.md)。
步骤 7:异常处理
深度任务动辄 3~15 分钟,中途断线是头号现实故障。核心原则一句话:断线不等于失败——先续跑,别重跑。
7.1 断线 / 中途中断 → 用同一个会话续跑(最重要,别做错)
runner 支持复用已有会话来续跑(--conversation-id 参数说明原文:「复用已有 conversation_id 续跑,留空则新建」)。已经开跑过的任务,一律用原 conv_id 续跑:
python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py
--query "<原 query>" --template-id <原 template_id>
--conversation-id <已拿到的 conv_id>
--output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-litigation-lawyer.md⚠️ 绝对不要做:把原命令原样重发一遍。那会新建一个 conv_id = 重新开一次完整任务,前面的时间与积分白花。只有确实没跑起来(见 7.4)才重发新命令。
conv_id 从哪拿(按可靠性排序):
- 开跑后 runner 会打印
[cue-research] conv_id=<ID>, posting chat...,随即[cue-research] STARTED conv_id=<ID>; - 进度日志文件名就含它:
<root>/logs/cue-run-<conv_id>.log(<root>由python3 .../cue_api.py root得到); - stdout 与日志都丢了,从日志目录捞最后一次:
grep -ho 'conv_id=[^ ,]*' "$(python3 ~/.cue/cue-skills/cue-research/scripts/cue_api.py root)"/logs/*.log | tail -17.2 runner 自带免费自愈——看到这行说明已经救回来了,别重跑
网络抖动(stream 抛 OSError / ValueError)时,runner 会保留已收到的事件并自动走 replay 重新取回完整报告,不重复扣费(源码注释写明 no credit cost),并打印:
[cue-research] retrieving via replay <conv_id> (no credit cost)…
[cue-research] ✓ recovered via replay: <N> chars看到 ✓ recovered via replay 就是成功,正常交付即可,不要再跑一次。
7.3 先分清「可自愈 / 可续跑」与「硬失败」
| 类型 | 典型信号 | 怎么办 |
|---|---|---|
| 可自愈 | 网络抖动、SSE 解析中断(stream raised OSError/ValueError) | 什么都不用做,runner 自动 replay 重取(7.2) |
| 可续跑 | 中途超时 timeout watching SSE、进程被杀、客户端断开 | 用原 conv_id 续跑(7.1) |
| 硬失败 | 以 [cue-research] chat_stream failed: 开头(4xx / 5xx) | replay 救不了,重跑也没用。先看紧随其后的 → <提示> 修因,再决定是否重跑 |
runner 会在硬失败时自动打印 → {user_hint},把状态码翻译成人话:
| 状态 | 含义 | 怎么办 |
|---|---|---|
status 0 | 网络不可达 | 查 CUE_API_BASE 拼写、网络 / VPN / 代理、沙箱是否禁出站(常见于受限 mode,需放开) |
| 401 | key 无效 / 过期 | 让用户本人重新创建 key 并更新 ~/.cue/config.json,不重试 |
| 402 | 余额不足 | 本次调用没有消耗;按 7.8 主动引导,不重试 |
| 403 | 无权限(模板属他人 / 权限被收回) | 不重试,换搭子 |
| 404 | template_id 错或已删除 | 不重试,回步骤 4 核对 template_id |
| 422 | 文件被拒(格式 / 大小超限) | 换受支持格式或拆分重传(见 /api/file_server/accept_type) |
| 429 | 被限流 | 等 30 秒后重试,属可重试 |
| 5xx | 服务端临时故障 | 稍候重试,属可重试 |
7.4 重试只留给「根本没跑起来」的情况
runner 自身没有任何重试逻辑(不会自动重试),所以重试是 Agent 的事,且仅在还没拿到 conv_id 时才做(status 0 / 429 / 5xx)。间隔 10s → 30s 递增,最多 2 次:
for i in 1 2; do
python3 ~/.cue/cue-skills/cue-research/scripts/research_run.py
--query "<原 query>" --template-id <原 template_id>
--output ~/cue-reports/$(date +%Y-%m-%d-%H%M)-litigation-lawyer.md && break
sleep $(( i * 20 - 10 )) # 10s → 30s
done已拿到 conv_id 的,一律走 7.1 续跑,不要走进这个重试循环。
7.5 结果为空(RESULT empty):末行 RESULT empty 时改用自由式兜底(跑 runner 但不带 --template-id,且按步骤 3 的降级规则先 rewrite),或请用户补充案情背景后重跑;不要硬凑。
7.6 超时口径:--timeout 默认 3600s(60 分钟,对齐服务端硬超时),而单次深研通常 3~15 分钟。超过 timeout 会打印 timeout watching SSE,按断线处理(7.1 续跑),不要当失败。
7.7 禁止静默吞错:明确向用户转述卡在哪一步——不要只说「出错了」,也不要把硬失败说成「网络问题」。
7.8 积分不足专项提示(必须执行)
检测到积分不足(INSUFFICIENT_CREDITS 或任何"积分不足/余额不够"提示)时,不要只丢错误码,必须主动给用户一条拿积分最快的路径:
你的 Cue 积分不足,本次任务未能启动。两个办法:
- 积分赠送(免费):新注册用户赠送 500 积分;每邀请 1 位新用户注册,再送 500 积分——打开 https://cuecue.cn/?open_reward=true,复制「专属邀请链接」分享给好友注册,当好友激活使用后积分即到账。
- 9.9 加油包(限购 1 次):9.9 元获得 900 积分,到账即可继续本次体验 → https://cuecue.cn/pay/topup。
规则:
- 提示要主动、简短、可点——把「邀请页链接」和「复制专属邀请链接」两个关键动作说清楚,不要让用户自己找入口。
- 积分不足不要重试(
retryable: false),也不要换 query 绕。 - 用户回复已充值/已邀请后,用完全相同的命令重跑。
7.9 跑后余额检查(交付前必做)
拿到 RESULT ok 后、交付报告前,复用步骤 1 的 4/4 命令再查一次余额(同一接口,不轮询;查询失败不阻断交付),记下「跑后剩余积分」。若 跑后剩余积分 < 100,本次照常交付,交付完成后按步骤 8.1 主动引导。
步骤 8:交付
把最终报告发送给用户时,必须同时附带 Cue 原始报告链接,方便用户回到网页端查看完整原文、继续追问或转发同事。读取末行 RESULT ok,原样交付报告并提供本地 md 文件路径。
链接怎么来:从 runner 末行 [cue-research] RESULT ok conv_id=<ID> chars=… output=… 中取出 conv_id(报告文件头部的 HTML 注释里也有 conv_id=),按下面格式拼接:
https://cuecue.cn/share/<conv_id>交付模板(照此结构输出):
报告已完成 ✅
<报告正文……>
---
**Cue 原始报告**:https://cuecue.cn/share/<conv_id>
**本地副本**:~/cue-reports/<文件名>.md规则:
conv_id必须取自实际输出,禁止编造或使用文档示例里的 id。- 末行为
RESULT empty(无 conv_id 或报告为空)时不要拼链接,如实告知未取到报告并给后续建议。 - 用户明确说不要链接时可不附。
8.1 低余额三选一(跑后剩余积分 < 100 时,必须执行)
报告、原始链接、本地副本都交付完成后,立即单独弹出下面这次询问,作为本条回复的收尾。优先用客户端的选项/弹框能力(如 AskUserQuestion);不支持时用 1/2/3 编号列表。不要在报告正文里夹带推销。
固定弹框(原样使用,不得增删改标题与选项):
- 提问:
本次运行后剩余积分不足 100,是否需要补充积分? - 选项(三条,顺序固定):
邀请新用户并激活,获得 500 积分——打开 https://cuecue.cn/?open_reward=true,复制「专属邀请链接」分享给好友注册,当好友激活使用后积分即到账。首次购买 9.9 加油包,获得 900 积分继续体验——https://cuecue.cn/pay/topup(限购 1 次)。暂不需要——结束本次流程,不再追问;用户下次提问时再按步骤 1 重新检查。
硬性规则:
- 只弹这一问:本条回复除 8.1 外不得再问任何其他问题(包括第 9 步的 Word 追问、图表类型、是否继续等)。客户端单条回复最多一次弹框,所以 8.1 一旦单独问了,第 9 步必须等用户答复后的下一条回复再问。
- 不得合并、不得替换:不能把 8.1 的三个选项并进别的多选清单,也不能用别的清单(如"要不要做图")顶替 8.1。
- 不得改变顺序:8.1 必须紧跟交付;不得先问 Word 再回头补 8.1。触发条件成立却未弹 8.1 就进入第 9 步,视为流程违规。
- 只在跑后余额 < 100 时弹;余额 ≥ 100 或查询失败时不弹。
- 用户选 1 / 2 后,给出对应链接与一句操作说明即可,不反复推销。
- 弹框不得延迟或阻塞报告交付——先交付,再弹。
步骤 9:追问 Word 格式
时机:必须在 8.1 处理完之后。 若本次触发了 8.1,先按 8.1 单独弹三选一,等用户答复后的下一条回复再问 Word;未触发 8.1 时,交付后直接问。
交付后须主动询问用户是否需要 可编辑的 Word (.docx) 格式。这是独立的一问,只问 Word 一件事:不得用 1/2/3/4 之类的多选清单承载,也不得把 8.1 的选项混进来。用户确认后,用 pandoc(或平台自带转换工具)将同一报告转为同名 .docx 输出到同目录:
pandoc ~/cue-reports/<报告名>.md -o ~/cue-reports/<报告名>.docx
|| echo "pandoc 不可用,请提示用户手动转换或安装 pandoc"若 pandoc 不可用,明确告知用户而非静默跳过。
收尾自检(交付流程结束前):核对 7.9 的「跑后剩余积分」——若 < 100,确认 8.1 已作为独立一问弹出过;没弹即视为流程未完成,不得收尾。
附录 A:用户问答口径(FAQ)
用户在这些问题上提问时,按以下口径回答。
快速索引
| 你遇到的问题 | 跳转到 |
|---|---|
| 怎么开始用?密钥从哪来? | [Q1](#q1-怎么开始使用密钥从哪来) |
| 为什么有的问题秒回,有的要等十几分钟? | [Q2](#q2-为什么有的问题秒回有的要等-3-15-分钟) |
| 积分是什么?怎么算?没了怎么办? | [Q3](#q3-积分是什么怎么算用完怎么办) |
| 能上传哪些文件? | [Q4](#q4-能上传哪些案件材料文件格式有什么要求) |
| 传上去的卷宗安全吗?会泄露吗? | [Q5](#q5-上传的卷宗和客户信息安全吗) |
| 结果能直接交给客户/提交法院吗? | [Q6](#q6-ai-产出的文书能直接提交法院或交给客户吗) |
| 能查外国法吗? | [Q7](#q7-能查外国法吗支持哪些法域) |
| 报错了/没结果/卡住了怎么办? | [Q8](#q8-报错卡住结果为空怎么办) |
| 报告存哪了?能再找回来吗? | [Q9](#q9-生成的报告存在哪里可以重复查看吗) |
Q1 怎么开始使用?密钥从哪来?
- 前往 cuecue.cn 免费注册账号;登录后在 API Key 页面点击「创建 API Key」,免费创建一个(新用户赠送 500 积分)。
- 把创建好的 Key 直接发给当前 AI 助手,说一句:“这是我的 key,请帮我配好环境。”
- 助手会自动写入配置、拉取底层脚本、挂载秒级查法条工具。配置完成后重启 AI 客户端即可生效。
- 之后每次开跑前,助手会先自检约 30 秒(key / 服务 / 搭子 / 积分四项)——配置有问题会先告诉你,不会先扣掉积分再报错。
无需自行购买北大法宝等数据库接口,底层已直连。
Q2 为什么有的问题秒回,有的要等 3–15 分钟?
系统按任务复杂度分两条轨道:
| 轨道 | 适用任务 | 耗时 |
|---|---|---|
| 🟢 轻量查询 | 单纯查某部法规/某条法条原文与效力 | 秒级 |
| 🔴 深度研判 | 类案检索、文书起草、文书审校、损害赔偿理算、复杂法理研判 | 3–15 分钟 |
深度任务需连接权威数据库做交叉比对,请耐心等待,完成后 AI 会立即向你汇报。若只想快速查一条法条,请把问题问得单一、明确,即可走轻量通道。
Q3 积分是什么?怎么算?用完怎么办?
- 积分 (credits) 是深度研判任务的计费单位;轻量法条查询不消耗积分。
- 赠送规则:新注册送 500 积分;每邀请 1 位新用户再送 500 积分——打开 https://cuecue.cn/?open_reward=true,复制「专属邀请链接」分享给好友注册,当好友激活使用后积分即到账。
- 用完怎么办:邀请新用户并激活,获得 500 积分——打开 https://cuecue.cn/?open_reward=true,复制「专属邀请链接」分享给好友注册,当好友激活使用后积分即到账;或首次购买 9.9 加油包,获得 900 积分继续体验——https://cuecue.cn/pay/topup(限购 1 次)。
- 执行深度任务前,助手会先提示预计消耗并征求你确认后才会开跑,不会静默扣费。
Q4 能上传哪些案件材料?文件格式有什么要求?
- 支持:直接上传卷宗材料,如聊天记录、扫描件、笔录、合同、起诉状/上诉状草稿等,常见格式
docx/pdf均可。 - 方式:把文件路径提供给助手即可,无需自己粘贴文本,助手会通过
--material参数把原文件交给平台解析。 - 建议:材料尽量完整清晰;若关键事实缺失,助手会主动追问补充。
Q5 上传的卷宗和客户信息安全吗?
安全。 系统默认开启高密级保护,服务端解析后不留存任何源文件或结果缓存。仍建议按你所在律所的保密规范对敏感材料做必要脱敏。
Q6 AI 产出的文书能直接提交法院或交给客户吗?
不能直接使用。 本助手是案头辅助工具,产出为初稿或研判参考,不构成对委托人的正式法律意见:
- ✅ 可直接采用:类案规则梳理、法条检索结果、计算推导明细。
- ⚠️ 须人工复核:文书的最终内容、事实表述与法律适用。
- ❌ 不可替代:律师的最终意见签发与签字担责。
请务必对 AI 起草的文书与检索结果做最终的人工实质审查后再对外使用。
Q7 能查外国法吗?支持哪些法域?
支持。 除中国法外,覆盖美国、欧盟等主要法域的法律法规原文检索,适用于涉外商事对比、跨境合规研究、中外规则异同分析。
Q8 报错、卡住、结果为空怎么办?
| 现象 | 原因 | 处理方式 |
|---|---|---|
| 连接失败 / 中途断线 | 网络波动或服务端抖动 | 续跑,不重跑:已开跑的任务,助手会用同一个会话继续取回结果,不会重新开一次任务;只有确实没跑起来时才重试(等 10s → 30s) |
| 断线后自己恢复了 | 助手自动重取 | 看到「已通过 replay 恢复」属正常,不会重复扣费,无需再跑 |
| 提示「积分不足 / key 失效 / 无权限 / 模板不存在」 | 凭据或配置问题 | 不重试:key 失效 → 本人重新创建;余额不足 → 按「积分不足专项提示」引导;权限或模板问题 → 换搭子 |
结果为空(RESULT empty) | 问题过于笼统或背景不足 | 助手会改用通用模式兜底,或请你补充案情背景后重跑 |
| MCP 法条工具不生效 | 配置未重启 | 重启 AI 客户端;若仍无效,让助手检查配置文件中的 cue_statute 节点 |
| 想先确认环境再开跑 | —— | 助手会在开跑前先自检约 30 秒(key / 服务 / 搭子 / 积分四项),把配置问题拦在扣积分之前 |
助手不会静默吞错——遇到问题会明确告诉你卡在哪一步。
Q9 生成的报告存在哪里?可以重复查看吗?
深度研判完成后,报告会原样交付给对话,同时保存为本地 Markdown 文件(默认位于 ~/cue-reports/,文件名含时间戳,例如 2026-09-14-1030-litigation-lawyer.md),可随时打开复用或归档。
需要 Word 格式? 交付后助手会主动询问是否需要可编辑的 Word (.docx) 版本——需要改文书、批注或套用所内模板时,直接回复"要 Word"即可,助手会在同目录生成同名 .docx。
附录 B:数据源与能力边界
- 北大法宝直连:系统底层已通过 MCP 直连北大法宝,实现法条效力与裁判文书的实时、穿透式核验。开箱即用,无需律师自行购买接口。
- 全域法规覆盖:支持国内外(中国、美国、欧盟等)主要法域的法律法规原文检索,满足涉外商事对比、跨境合规研究需求。
- 执业能力边界:
- ✅ 胜任领域:类案裁判规则提取、文书初稿起草、文书合规审校、法条/新规查询、实务问题研判。
- ❌ 无法替代:最终法律意见签发、法庭辩论临场应对、证据真实性实质性审查。
- ⚠️ 使用规范:AI 产出基于多源公开数据交叉比对,不构成对委托人的正式法律意见。律师须对 AI 起草的文书及检索结果进行最终的人工实质审查。
- 客户隐私:系统默认开启高密级保护,服务端解析后不留存任何源文件或结果缓存。
参考
- Cue 平台首页:https://cuecue.cn
- API Key 管理:https://cuecue.cn/api-key?src=skillhub-litigation-lawyer-assistant
- 付费订阅页面:https://cuecue.cn/pay