命令行用法

三步上手

1. 装好打开终端，Windows 用户执行 irm https://gobi-starweaver.cn/dist/install.ps1 | iex；macOS 用户执行 curl -fsSL https://gobi-starweaver.cn/dist/install.sh | bash。一行命令自带运行环境，不用另外装 Node.js。详见下载
2. 登录终端输入 ws 回车，在望舒里输入 /login（中文 /登录 也行），首次启动会引你到浏览器登录北辰账户、确认授权（点「允许」），随后自动回到终端
3. 开问直接用白话提问，譬如「替我查查《通典》里关于某制的记载」

日常使用

写作时，把草稿交给它审读；读书时，把疑义交给它查检；遇到史料图像，交给它转写。你的体例偏好和常引版本它会记住，不必每次重提

诊断模式

默认界面只说白话。需要排查问题时，在对话里输入 /诊断 开，界面恢复技术读数（工具参数、函数名、模型名），并在本机 ~/.ws/logs/ 下写诊断日志；输入 /诊断 复制 可取一份自动脱敏的诊断包（不含凭据、卡密与材料正文），反馈问题时发给我们；输入 /诊断 关 回到语义界面。诊断模式默认关闭。

环境变量（一般用不到）

下列环境变量可调客户端行为。多数用户无需设置；仅在客服指引或确有需要时使用。

• WS_DIAGNOSTIC —— 设为 1 时启动即进入诊断模式（/诊断 开关优先于此变量）
• WS_MAX_COMPLETION_TOKENS —— 正整数，限制单次回复的输出 token 上限；不设置表示不加额外上限
• WS_MAX_ITERATIONS —— 正整数，限制单任务的内部工作轮数（默认 200，硬上限 10000）
• NODE_USE_ENV_PROXY —— 精确设为 1 时启用标准代理环境变量（见下节代理指引）

代理指引

默认直连。若你的网络必须走代理：先设标准代理变量 HTTP_PROXY / HTTPS_PROXY（例外名单用 NO_PROXY），再把 NODE_USE_ENV_PROXY 精确设为 1（只认这个字面），登录、对话与下载即统一走环境代理。校园网或公司网拦 HTTPS 时，可先换手机热点试试。