ContextStellar Setup 是一个配置命令,用于把 ContextStellar 插件从默认的本地模式升级为云端模式。
用途 该命令面向希望启用 RLM 自适应权重学习、团队仪表盘和跨会话分析的用户。插件在本地模式下即可开箱即用,评分在本地通过内置的 scorer.js 完成,零配置、无网络调用、无需注册。本命令的作用是引导用户完成云端模式的配置。
主要能力与两种模式 本地模式(当前默认):评分在用户机器上通过内置 scorer.js 运行,零网络调用,无需注册。 云端模式(可选):通过 API 并使用学习到的权重进行评分,可启用 RLM 飞轮、/contextstellar:stats、/contextstellar:optimize 以及 Web 仪表盘。
使用方式
- 检查当前模式:如果已设置 CONTEXTSTELLAR_API_KEY,则说明已处于云端模式,此时测试连通性;如果未设置,则说明本地模式处于活动状态且正常工作,然后提供云端升级选项。
- 向用户解释上述两种模式。
- 如果用户希望使用云端模式,引导其操作:前往 https://contextstellar.com/connect;创建项目(如果尚无项目);生成 API 密钥(以 cs_live_ 开头);复制 Project ID;设置环境变量,将其加入 shell 配置文件或 .env:
export CONTEXTSTELLAR_API_KEY="cs_live_your_key_here" export CONTEXTSTELLAR_PROJECT_ID="your_project_id_here"
可选:自定义实例 URL(默认为 https://contextstellar.com)
export CONTEXTSTELLAR_BASE_URL="https://your-instance.contextstellar.com"
- 验证连通性:
curl -s "${CONTEXTSTELLAR_BASE_URL:-https://contextstellar.com}/api/v1/hooks/shell-stats"
-H "Authorization: ${CONTEXTSTELLAR_API_KEY}"
如果得到包含 score、grade 等字段的 JSON 响应,则云端模式已激活。
设置完成后的效果 完成设置后,用户可获得:自动 RLM 权重学习(约 100 个事件后开始改善);/contextstellar:stats——终端内的评分仪表盘;/contextstellar:optimize——基于模式的建议;位于 contextstellar.com/dashboard/mission-control 的 Web 仪表盘。
适用场景 适合希望从零配置的本地评分升级到云端能力、获得自适应权重学习、团队协作仪表盘和跨会话分析的 ContextStellar 插件用户。
限制 本地模式无网络调用、无需注册;云端模式为可选升级,需要 API 密钥与 Project ID。其他关于定价、配额或平台支持的细节,资料中暂未提供。