OrionLaw

概述

OrionLaw AI 法务工作台，覆盖合同审查、合同起草、法律咨询三条能力线。按用户意图进入对应模块。

模块路由表

Credential Check

![ -n "$ORIONLAW_API_KEY" ] && echo "✅ Credentials configured (env)" || { f="${ORIONLAW_HOME:-$HOME/.orionlaw}/credentials.json"; grep -Eq '"api_key"[[:space:]]*:[[:space:]]*"[^"]+"' "$f" 2>/dev/null && echo "✅ Credentials configured" || echo "⚠️ NO CREDENTIALS — setup required before any API call"; }

执行环境不展开该命令时，等价检查是 node orionlaw.cjs auth.check（输出 exists / apiKeyValid / baseUrl）。

If ⚠️ NO CREDENTIALS: 先引导用户完成设置，再调用任何接口：

1. 在 OrionLaw 控制台创建 API Key（形如 al_sk_live_…）
2. 二选一写入（平台基址取技能内置值）：

• 环境变量 ORIONLAW_API_KEY：优先级更高，适合容器与 CI
• 凭证文件：

node orionlaw.cjs auth.set --key '<API Key>'

1. 复核：node orionlaw.cjs auth.check（会显示 Key 来源）

凭证文件位置、换票流程与失败分支见 [references/auth.md](./references/auth.md)。

强制规则（MANDATORY RULES）

1. 调用链固定：doctor 预检 → 模块命令 → 解读 stdout 输出；结论与文本一律取自脚本返回的 data 与 delta。
2. 不虚构：风险结论、条款文本、法条引用都以脚本返回为准；取不到就如实说明并附原始错误。
3. 敏感内容不外传：合同正文与咨询内容属用户隐私，只在本轮对话内使用；群聊或多人群场景只给标题、摘要与结论，不粘贴全文。
4. 计费前告知：review.start、draft.generate 会扣额度；consult.ask 只在新会话首轮扣额度（带上 roundId / parentChatId 的继续提问不扣）。触发计费前说明本次将消耗额度，结束后用返回的 quota 快照报剩余额度。单次扣减的单位随订阅套餐不同，不要向用户报具体数字。
5. 失败即停：上传 → 启动 → 观看 → 取结果这类链路中任一步失败就停下，把 error.message 与 hint 原样转述；计费命令不自动重发，先 doctor 确认额度与用量再决定。
6. 先确认再动：批量删除、批量撤销、删除审查记录/会话/规则，以及 review.revise 这类改写用户原件的动作，先说明目标再执行。
7. 交付 .docx：给用户的成品是 .docx（Office 可打开），由本地渲染 doc.draft 基于 draft.generate 落盘的正文生成并落在 ORIONLAW_WORK_DIR，把脚本返回的路径交给用户；对话里不把 Markdown / JSON 当成品交付。返回 mode: "outline" 说明任务还没有正文，那是大纲稿、不是成品，先 draft.generate。本地渲染不可用（依赖装不上、离线、报错）或用户要平台原版件时，用 draft.export 兜底。
8. 会话复用：继续同一个咨询会话时，由你显式带上标识——consult.ask --session <roundId> --parent <chatId>（标识取自上一轮 data.session）；不带标识即新会话（首轮计费）。
9. 更新提示：命令成功信封出现 update 或 stderr 出现 [update] 时，在完成本轮任务后用一句话告知用户新版本、changelog 首句、downloadUrl 与 manifestUrl；需要更新时按 hash 校验后替换包内文件，最后只跑 node orionlaw.cjs version 复核。替换完成后不再执行测试、doctor 或业务命令；完整边界见 [references/conventions.md](./references/conventions.md) §8.1。
10. 渲染前校验：调用 doc.review / doc.draft 生成最终 .docx 前，先核对候选内容的基础错误——条款编号连续且无重号、段落不重复、原文与修订文不是同一内容、同一段没有冲突的多条修订、未匹配项已处理。发现问题先向用户说明或修正方案，再执行最终渲染；渲染器只负责机械替换，内容正确性由你负责。

执行方式

每个任务都由脚本完成（在 skill 包根目录执行）：

node orionlaw.cjs <命令> [选项]

• 调用契约、命令清单、输出格式、退出码：见 [references/cli.md](./references/cli.md)
• 命令清单的机器可读版本：node orionlaw.cjs --list（含 charge / stream 标记）
• 流式命令（review.watch、draft.generate、consult.ask）默认在脚本内读完整条流再返回全文，直接转述即可；--stream 才输出逐条事件
• 流程上下文（上传结果、reviewId、contractId、会话标识）由脚本写在 ORIONLAW_WORK_DIR/cache/state.json，下一条命令缺省自动沿用；审查/起草/会话进度快照也由脚本自动写入
• 版本检查：node orionlaw.cjs update.check [--force]（读分发清单 dist/latest.json，不需要 API Key）
• 平台接口字段、枚举与错误码：见 references/