@blynkai/cli 0.1.1

package/README.md

@@ -0,0 +1,295 @@
+# 灵睿本地助手雏形
+
+这是灵睿本地助手的第一版雏形，用于验证：
+
+- 本地 `127.0.0.1` 服务是否可用
+- 浏览器授权后，CLI/API 是否可用
+- CLI 退出登录后，CLI/API 是否立即失效
+
+## 启动本地服务
+
+开发环境需要手动启动本地服务：
+
+```bash
+node local-agent/src/server/index.mjs
+```
+
+或在完成 CLI 链接后启动：
+
+```bash
+blynkai agent start
+```
+
+后台启动日志默认写入：
+
+```text
+~/.lingrui-local-agent/agent.log
+```
+
+进程号默认写入：
+
+```text
+~/.lingrui-local-agent/agent.pid
+```
+
+服务默认监听：
+
+```text
+http://127.0.0.1:38100
+```
+
+## 后端地址配置
+
+本地助手转发业务接口时读取环境变量，不在业务代码里写死后端地址：
+
+```bash
+LINGRUI_UPSTREAM_BASE_URL=https://api.blynkai.com
+```
+
+优先级：
+
+1. `LINGRUI_UPSTREAM_BASE_URL`
+2. `VITE_API_BASE_URL`
+3. 项目根目录 `.env.local` / `.env.production.local` / `.env.production` / `.env.test` 中的 `VITE_API_BASE_URL`
+
+本地开发可以直接复用 Vite proxy 当前使用的正式环境地址，也就是 `.env.production` 里的：
+
+```text
+VITE_API_BASE_URL=https://api.blynkai.com
+```
+
+如果要临时切换测试环境，可这样启动：
+
+```bash
+LINGRUI_UPSTREAM_BASE_URL=https://app.test.blynkai.com node local-agent/src/server/index.mjs
+```
+
+## CLI 授权地址配置
+
+`blynkai login` 不再内置固定域名，必须通过环境变量指定授权页地址：
+
+1. `LINGRUI_CLI_AUTHORIZE_URL`（完整授权地址，优先级最高）
+2. `LINGRUI_WEB_BASE_URL`（自动拼接 `${LINGRUI_WEB_BASE_URL}/cli/authorize`）
+
+示例：
+
+```bash
+LINGRUI_WEB_BASE_URL=https://fushan.blynkai.com blynkai login
+```
+
+## TLS / 企业证书配置
+
+如果用户网络有企业 HTTPS 代理，Node 可能报：
+
+- `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`
+- `unable to get local issuer certificate`
+
+建议通过 `NODE_EXTRA_CA_CERTS` 注入企业根证书（PEM 文件）：
+
+```bash
+NODE_EXTRA_CA_CERTS=/path/to/corp-root.pem \
+LINGRUI_UPSTREAM_BASE_URL=https://api.blynkai.com \
+node local-agent/src/cli/index.mjs agent start
+```
+
+诊断命令：
+
+```bash
+blynkai doctor
+# 或
+node local-agent/src/cli/index.mjs doctor
+```
+
+## CLI 使用
+
+开发环境先把本地 CLI 链接成 `blynkai` 命令：
+
+```bash
+cd local-agent
+npm link
+```
+
+然后即可执行：
+
+```bash
+blynkai agent start
+blynkai agent status
+blynkai health
+blynkai doctor
+blynkai whoami
+blynkai list
+blynkai search q=ai time_s=2026-05-19T00:00:00 time_e=2026-05-20T00:00:00 risk=high,very_high field=title,content dry_run=true
+blynkai search center=warning q=public_opinion time_s=2026-05-19T00:00:00 time_e=2026-05-20T00:00:00 read=unread dry_run=true
+blynkai search center=data stats=website q=ai site=weibo,xinhua dry_run=true
+blynkai auth logout
+blynkai ask "我现在登录了吗"
+blynkai ask "调用技能"
+```
+
+如果暂时不 link，也可以直接使用 Node 执行：
+
+```bash
+node local-agent/src/cli/index.mjs health
+node local-agent/src/cli/index.mjs agent start
+node local-agent/src/cli/index.mjs agent status
+node local-agent/src/cli/index.mjs doctor
+node local-agent/src/cli/index.mjs whoami
+node local-agent/src/cli/index.mjs list
+node local-agent/src/cli/index.mjs search q=ai time_s=2026-05-19T00:00:00 time_e=2026-05-20T00:00:00 dry_run=true
+node local-agent/src/cli/index.mjs auth logout
+node local-agent/src/cli/index.mjs ask "我现在登录了吗"
+node local-agent/src/cli/index.mjs ask "调用技能"
+```
+
+退出登录后，再执行：
+
+```bash
+blynkai whoami
+```
+
+会返回 `session_revoked`。
+
+## 开发态演示链路
+
+1. 启动本地服务：`node local-agent/src/server/index.mjs` 或 `blynkai agent start`
+2. 启动前端：`pnpm run dev`
+3. 打开灵睿页面并登录
+4. 本地服务收到前端同步的登录态
+5. 执行：`blynkai ask "我现在登录了吗"`
+6. 执行：`blynkai list`
+7. 执行：`blynkai ask "调用技能"`
+8. 网页退出登录后，再执行 CLI 会返回 `session_revoked`
+
+## 正式客户态链路
+
+正式版本不依赖 `npm link`，需要安装包完成：
+
+- 启动本地 `127.0.0.1` 服务
+- 注册 `blynkai` 到系统 PATH
+- 设置登录后或开机自启动
+- 由前端在登录成功后自动同步登录态，退出登录时自动撤销本地会话
+- 安装包内置 Node 运行时与生产依赖，不要求客户机器安装 Node/npm
+
+浏览器不能静默安装或启动本地程序，因此客户首次使用时需要安装一次“灵睿本地助手”。
+
+## 生成 macOS 应用包
+
+开发机需要有 macOS 自带的 `hdiutil`。
+
+```bash
+pnpm --dir local-agent run package:mac
+```
+
+生成产物：
+
+```text
+dist-local-agent/macos-build/Lingrui Assistant.app
+dist-local-agent/macos/lingrui-assistant-macos.zip
+public/downloads/lingrui-local-agent/latest/macos.zip
+public/downloads/lingrui-cli/latest/lingrui-assistant-macos.zip (兼容旧链接)
+```
+
+本地验证：
+
+```bash
+open "dist-local-agent/macos-build/Lingrui Assistant.app"
+blynkai help
+blynkai status
+```
+
+当前 macOS 包会下载一个应用，双击后直接拉起 Terminal，在终端内完成本地 CLI 安装。
+
+## 当前接口
+
+- `GET /health`
+- `POST /auth/sync`
+- `GET /auth/whoami`
+- `POST /auth/logout`
+- `POST /auth/reconnect`
+- `GET /commands/list`
+- `POST /api/search`
+- `POST /skills/check`
+
+## 统一搜索 CLI
+
+统一入口：
+
+```bash
+blynkai search [query]
+```
+
+本地 API：
+
+```text
+POST /api/search
+```
+
+场景映射：
+
+- `center=data` -> `/v1/article/search`
+- `center=warning` -> `/v1/index`
+- `stats=website` -> `/v1/article/website`
+
+推荐使用英文短参数 `key=value`：
+
+```text
+q=ai
+center=data
+stats=website
+time_s=2026-05-19T00:00:00
+time_e=2026-05-20T00:00:00
+risk=high,very_high
+sentiment=negative
+field=title,content
+type=original,repost,comment
+site=weibo,xinhua
+category=tech,finance
+source=renmin,isite
+read=unread
+valid=yes
+page=1
+size=10
+sort=publish_time
+order=desc
+dry_run=true
+```
+
+说明：
+
+- 不传时间时，本地助手默认补近 24 小时。
+- `center=data` 默认使用发布时间，默认 `is_valid=Valid`。
+- `center=warning` 默认使用预警推送时间，默认 `review_status=pushed`。
+- 关键词搜索时默认 `sort_field=_score`；无关键词时数据中心默认 `publish_time`，预警中心默认 `push_time`。
+- `site=...` 是检索筛选参数，对应 `website_names`；`stats=website` 才表示返回媒体渠道统计。
+- 旧写法 `search data`、`search warning`、`search website` 暂时兼容，但产品口径统一推荐 `blynkai search center=... stats=...`。
+- 仍兼容 `--publish-start`、`--risk-levels` 等完整选项，便于开发和自动化脚本使用。
+- 未配置上游地址时，`/api/search` 会返回映射后的 `upstream_path` 和 `payload`，方便联调参数。
+- 配置 `LINGRUI_UPSTREAM_BASE_URL` 或 `VITE_API_BASE_URL` 且 CLI token 有效时，本地助手会真实转发到线上接口。
+
+## 响应协议
+
+成功：
+
+```json
+{
+  "code": 0,
+  "msg": "ok",
+  "data": {
+    "status": "online"
+  }
+}
+```
+
+失败：
+
+```json
+{
+  "code": 40010,
+  "msg": "auth_required",
+  "hint": "Please sign in to Lingrui in your browser first."
+}
+```
+
+## 说明
+
+当前版本只做本地助手基础链路，不包含安装包、业务接口和真实技能执行。

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@blynkai/cli",
+  "version": "0.1.1",
+  "type": "module",
+  "files": [
+    "README.md",
+    "src"
+  ],
+  "bin": {
+    "blynkai": "./src/cli/index.mjs"
+  },
+  "scripts": {
+    "server": "node src/server/index.mjs",
+    "cli": "node src/cli/index.mjs",
+    "health": "node src/cli/index.mjs health",
+    "whoami": "node src/cli/index.mjs whoami",
+    "package:mac": "node scripts/build-macos-pkg.mjs",
+    "bundle:web": "node scripts/build-web-bundle.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/cli/auth-login.mjs

@@ -0,0 +1,44 @@
+import { spawn } from 'node:child_process'
+import { platform } from 'node:os'
+
+function resolveAuthorizeUrl() {
+  const explicitAuthorizeUrl = process.env.LINGRUI_CLI_AUTHORIZE_URL?.trim()
+  if (explicitAuthorizeUrl) return explicitAuthorizeUrl
+
+  const webBaseUrl = process.env.LINGRUI_WEB_BASE_URL?.trim()
+  if (webBaseUrl) return `${webBaseUrl.replace(/\/+$/, '')}/cli/authorize`
+
+  return ''
+}
+
+function openBrowser(url) {
+  const currentPlatform = platform()
+  if (currentPlatform === 'darwin') return spawn('open', [url], { detached: true, stdio: 'ignore' })
+  if (currentPlatform === 'win32') {
+    return spawn('cmd', ['/c', 'start', '', url], { detached: true, stdio: 'ignore' })
+  }
+  return spawn('xdg-open', [url], { detached: true, stdio: 'ignore' })
+}
+
+export async function runBrowserLogin() {
+  const authorizeUrl = resolveAuthorizeUrl()
+  if (!authorizeUrl) {
+    console.log('\n❌ 未配置授权地址。')
+    console.log('请先设置 LINGRUI_WEB_BASE_URL 或 LINGRUI_CLI_AUTHORIZE_URL。')
+    console.log('示例：LINGRUI_WEB_BASE_URL=https://fushan.blynkai.com blynkai login\n')
+    return
+  }
+
+  const url = new URL(authorizeUrl)
+
+  console.log('\n请在浏览器完成灵睿 CLI 授权。')
+  console.log(`授权地址：${url.toString()}`)
+  console.log('如果浏览器已经登录灵睿系统，授权页会把当前登录态同步给本地助手。\n')
+
+  try {
+    const child = openBrowser(url.toString())
+    child.unref()
+  } catch {
+    // 用户仍可手动复制授权地址。
+  }
+}

package/src/cli/help.mjs

@@ -0,0 +1,53 @@
+export function printHelp() {
+  console.log(`
+==========================================
+         灵睿助手 CLI (命令行工具)
+==========================================
+
+用法:
+  blynkai help        # 查看帮助信息
+  blynkai login       # 在浏览器中完成 CLI 授权
+  blynkai status      # 查看本地助手的运行状态
+  blynkai doctor      # 一键诊断本地服务、登录态、上游连通性与 TLS
+  blynkai whoami      # 查看当前登录的用户信息
+  blynkai logout      # 退出当前登录
+  blynkai search                       # 统一检索，默认查数据中心近 24 小时
+
+常用示例:
+  blynkai login
+  blynkai whoami
+  blynkai doctor
+  blynkai search q=ai
+  blynkai search center=data q=ai time_s=2026-05-19T00:00:00 time_e=2026-05-20T00:00:00
+  blynkai search center=warning q=public_opinion time_s=2026-05-19T00:00:00 time_e=2026-05-20T00:00:00 read=unread
+  blynkai search center=data stats=website q=ai risk=high,very_high site=weibo,xinhua dry_run=true
+
+常用查询参数:
+  center=data                         检索中心：data 或 warning；默认 data
+  stats=website                       返回媒体渠道统计；不传则返回文章/预警列表
+  q=ai                              关键词，对应 keywords
+  time_s=2026-05-19T00:00:00       时间开始；data 映射发布时间，warning 映射预警时间
+  time_e=2026-05-20T00:00:00       时间结束；data 映射发布时间，warning 映射预警时间
+  risk=high,very_high               风险等级：normal,low,medium,high,very_high
+  sentiment=negative                情感：positive,neutral,negative
+  field=title,content               命中位置：title,content,author,ocr,asr
+  type=original,repost,comment      内容类型
+  site=weibo,xinhua                 具体媒体渠道
+  category=tech,finance             文章分类
+  source=renmin,isite               数据来源
+  read=unread                       阅读状态：read,unread,all
+  valid=yes                         是否相关：yes,no,uncertain,all
+  page=1 size=10                    分页
+  sort=publish_time order=desc      排序
+  dry_run=true                      只查看将要请求的参数，不真正查询线上接口
+
+高级参数:
+  仍兼容 --publish-start、--push-start、--risk-levels、--search-fields 等完整选项。
+
+提示:
+  1. 您无需在终端输入账号密码；请运行 blynkai login，并在浏览器中完成 CLI 授权。
+  2. search 只有一个入口，数据中心、预警中心、媒体渠道统计复用同一套筛选参数。
+  3. 推荐使用 key=value 形式；没有 key= 的普通文本会自动作为关键词。
+==========================================
+`)
+}