aidee-pro 1.0.0__tar.gz

aidee_pro-1.0.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: aidee-pro
+Version: 1.0.0
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28

aidee_pro-1.0.0/README.md

@@ -0,0 +1,183 @@
+# AIDEE CLI
+
+AIDEE CLI 是一个面向 AIDEE 服务的命令行工具，适合客户或运维同学通过终端快速完成基础查询与常用操作，例如查看账号信息、查询录音、查看摘要、兑换权益等。
+
+本文档以日常使用为主，只保留基础说明和基础案例。
+
+更多中文说明可参考 [README.zh-CN.md](/Users/jeyyu/pyProject/aidee-cli/README.zh-CN.md)。
+
+## 适用场景
+
+- 查看当前账号信息
+- 查询录音列表与录音详情
+- 查看摘要结果
+- 使用兑换码查询权益信息
+- 查看自己的兑换记录
+
+## 认证方式
+
+支持以下两种认证方式，二选一即可：
+
+- `Token`：通过 `IM-TOKEN` 认证
+- `API Key`：通过 `X-Api-Key` 认证
+
+可使用以下任一方式配置：
+
+- `AIDEE_TOKEN`
+- `AIDEE_API_KEY`
+
+一般情况下，只需要提供其中一个，不需要同时配置。
+
+## 基础配置
+
+默认服务地址：
+
+```text
+https://api.aidee.me/aidee-server
+```
+
+首次使用前，建议先设置服务地址和认证信息。
+
+使用 Token：
+
+```bash
+cli-anything-aidee config set-base-url https://api.aidee.me/aidee-server
+cli-anything-aidee config set-token YOUR_IM_TOKEN
+```
+
+使用 API Key：
+
+```bash
+cli-anything-aidee config set-base-url https://api.aidee.me/aidee-server
+cli-anything-aidee config set-api-key YOUR_API_KEY
+```
+
+查看当前配置：
+
+```bash
+cli-anything-aidee config show
+cli-anything-aidee session status
+```
+
+## 基础使用案例
+
+### 1. 查看账号信息
+
+```bash
+cli-anything-aidee user info
+```
+
+### 2. 查看录音列表
+
+```bash
+cli-anything-aidee recording list
+```
+
+如果希望控制分页：
+
+```bash
+cli-anything-aidee recording list --page 1 --size 20
+```
+
+### 3. 查看某条录音详情
+
+```bash
+cli-anything-aidee recording get RECORDING_CODE
+```
+
+### 4. 创建一条录音记录
+
+```bash
+cli-anything-aidee recording create --title "客户沟通纪要"
+```
+
+### 5. 查看某条录音的摘要列表
+
+```bash
+cli-anything-aidee summary list RECORDING_CODE
+```
+
+### 6. 查看某条摘要详情
+
+```bash
+cli-anything-aidee summary get SUMMARY_ID
+```
+
+### 7. 查询兑换码可兑换内容
+
+```bash
+cli-anything-aidee redemption code-detail CODE_STRING
+```
+
+说明：这里是查询兑换码详情，不是创建兑换码。
+
+### 8. 查看当前账号的兑换记录
+
+```bash
+cli-anything-aidee redemption records
+```
+
+如果需要按来源筛选：
+
+```bash
+cli-anything-aidee redemption records --redeem-source aideeApp
+```
+
+## 常用命令
+
+```bash
+cli-anything-aidee --help
+cli-anything-aidee --version
+cli-anything-aidee config show
+cli-anything-aidee user info
+cli-anything-aidee recording list
+cli-anything-aidee summary list RECORDING_CODE
+cli-anything-aidee redemption code-detail CODE_STRING
+```
+
+## 交互模式
+
+可以直接进入交互模式：
+
+```bash
+cli-anything-aidee
+```
+
+或者：
+
+```bash
+cli-anything-aidee repl
+```
+
+如果参数中包含空格，请使用引号：
+
+```bash
+recording create --title "一对一客户回访"
+```
+
+## 环境变量方式
+
+如果不想把认证信息写入本地配置，也可以直接使用环境变量：
+
+使用 Token：
+
+```bash
+export AIDEE_BASE_URL="https://api.aidee.me/aidee-server"
+export AIDEE_TOKEN="YOUR_IM_TOKEN"
+cli-anything-aidee user info
+```
+
+使用 API Key：
+
+```bash
+export AIDEE_BASE_URL="https://api.aidee.me/aidee-server"
+export AIDEE_API_KEY="YOUR_API_KEY"
+cli-anything-aidee recording list
+```
+
+## 说明
+
+- 文档中的命令名为 `cli-anything-aidee`
+- 本工具支持 `Token` 和 `API Key` 两种认证方式，任选其一即可
+- 当前客户文档仅展示基础能力和常用案例
+- 如需查看全部命令，请执行 `cli-anything-aidee --help`

aidee_pro-1.0.0/__init__.py

@@ -0,0 +1,3 @@
+"""CLI-Anything harness for AIDEE — AI recording, transcription, and summarization API."""
+
+__version__ = "1.0.0"

aidee_pro-1.0.0/aidee_cli.py

@@ -0,0 +1,404 @@
+"""AIDEE CLI — Main entry point."""
+
+import os
+import click
+
+from __init__ import __version__
+
+from core.session import get_api_key, get_base_url, get_token
+from core.recording import (
+    create as recording_create,
+    update as recording_update,
+    list_recordings,
+    get_summary_templates,
+    update_summary_template,
+    merged_summary as recording_merged_summary,
+)
+from core.summary import (
+    list_by_recording as summary_list,
+    get as summary_get,
+)
+from core.group import (
+    create as group_create,
+    delete as group_delete,
+    list_all as group_list,
+)
+from utils.output import print_result as _print_result
+from utils.aidee_backend import upload_file as _upload_file
+
+
+def _ctx_base(ctx):
+    return ctx.obj.get("base_url") or get_base_url()
+
+
+def _ctx_token(ctx):
+    return ctx.obj.get("token") or get_token()
+
+
+def _output(result, json_mode: bool):
+    _print_result(result, json_mode)
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="aidee-pro")
+@click.option("--json", "json_mode", is_flag=True, help="Output as JSON")
+@click.option("--base-url", envvar="AIDEE_BASE_URL", help="AIDEE API base URL")
+@click.option("--token", envvar="AIDEE_TOKEN", help="Auth token")
+@click.option("--api-key", envvar="AIDEE_API_KEY", help="AIDEE API key (sent as X-Api-Key)")
+@click.pass_context
+def cli(ctx, json_mode, base_url, token, api_key):
+    """AIDEE CLI — AI recording, transcription, and summarization API client."""
+    ctx.ensure_object(dict)
+    ctx.obj["json_mode"] = json_mode
+    ctx.obj["base_url"] = base_url
+    ctx.obj["token"] = token
+    ctx.obj["api_key"] = api_key or get_api_key()
+    if ctx.obj["api_key"]:
+        os.environ["AIDEE_API_KEY"] = ctx.obj["api_key"]
+
+
+# --- recording ---
+@cli.group("recording")
+def recording_group():
+    """Recording management."""
+    pass
+
+
+@recording_group.command("create")
+@click.option("--title", required=True)
+@click.option("--description", required=True)
+@click.option("--file-url")
+@click.option("--file-name", required=True)
+@click.option("--content-type", required=True)
+@click.option("--file-created-at", required=True)
+@click.option("--duration", type=int)
+@click.option("--summary-template-id")
+@click.option("--group-code")
+@click.option("--device-id")
+@click.option("--speaker-count", type=int)
+@click.option("--latitude", type=float)
+@click.option("--longitude", type=float)
+@click.option("--address")
+@click.option("--address-brief")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def recording_create_cmd(ctx, title, description, file_url, file_name, duration,
+                         content_type, summary_template_id, group_code, device_id,
+                         speaker_count, file_created_at, latitude, longitude,
+                         address, address_brief, json_mode):
+    """创建录音记录。"""
+    base = _ctx_base(ctx)
+    tok = _ctx_token(ctx)
+    kwargs = {k: v for k, v in {
+        "description": description,
+        "fileUrl": file_url,
+        "fileName": file_name,
+        "duration": duration,
+        "recordingContentType": content_type,
+        "summaryTemplatesId": summary_template_id,
+        "recordingsGroupCode": group_code,
+        "deviceId": device_id,
+        "speakerCount": speaker_count,
+        "fileCreatedAt": file_created_at,
+        "latitude": latitude,
+        "longitude": longitude,
+        "address": address,
+        "addressBrief": address_brief,
+    }.items() if v is not None}
+    r = recording_create(base, tok, title=title, **kwargs)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@recording_group.command("update")
+@click.argument("code")
+@click.option("--title")
+@click.option("--description")
+@click.option("--file-url")
+@click.option("--file-name")
+@click.option("--duration", type=int, help="录音时长（毫秒）")
+@click.option("--content-type")
+@click.option("--group-code")
+@click.option("--ai-summary")
+@click.option("--status")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def recording_update_cmd(ctx, code, title, description, file_url, file_name, duration,
+                         content_type, group_code, ai_summary, status, json_mode):
+    """编辑录音记录。"""
+    kwargs = {k: v for k, v in {
+        "title": title,
+        "description": description,
+        "fileUrl": file_url,
+        "fileName": file_name,
+        "duration": duration,
+        "recordingContentType": content_type,
+        "recordingsGroupCode": group_code,
+        "aiSummary": ai_summary,
+        "status": status,
+    }.items() if v is not None}
+    r = recording_update(_ctx_base(ctx), _ctx_token(ctx), code, **kwargs)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@recording_group.command("list")
+@click.option("--page", default=1, type=int, help="页码，从 1 开始")
+@click.option("--limit", default=10, type=int, help="每页条数")
+@click.option("--title", help="录音标题，模糊匹配")
+@click.option("--keyword", help="关键词，匹配标题/简介/description")
+@click.option("--status", help="录音状态，如 COMPLETED")
+@click.option("--group-code", help="录音组 code")
+@click.option("--device-id", help="设备 ID")
+@click.option("--entry-type", help="条目类型：SINGLE / MERGED_SUMMARY")
+@click.option("--content-type", help="内容类型：ENVIRONMENT / IMPORTED / CALL / MERGED_SUMMARY")
+@click.option("--start-time", help="开始时间，如 2026-06-01T00:00:00")
+@click.option("--end-time", help="结束时间，如 2026-06-10T23:59:59")
+@click.option("--order-by", help="排序字段，默认 file_created_at")
+@click.option("--order-direction", help="排序方向：asc / desc")
+@click.option("--sort-type", help="RECORDING_TIME / UPDATED_TIME")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def recording_list_cmd(ctx, page, limit, title, keyword, status, group_code, device_id,
+                       entry_type, content_type, start_time, end_time,
+                       order_by, order_direction, sort_type, json_mode):
+    """录音列表查询。"""
+    kwargs = {k: v for k, v in {
+        "title": title,
+        "keyword": keyword,
+        "status": status,
+        "recordingsGroupCode": group_code,
+        "deviceId": device_id,
+        "recordingEntryType": entry_type,
+        "recordingContentType": content_type,
+        "startTime": start_time,
+        "endTime": end_time,
+        "orderBy": order_by,
+        "orderDirection": order_direction,
+        "sortType": sort_type,
+    }.items() if v is not None}
+    r = list_recordings(_ctx_base(ctx), _ctx_token(ctx), page=page, limit=limit, **kwargs)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@recording_group.command("summary-templates")
+@click.option("--sort-scheme", help="排序方案：DEFAULT / INDUSTRY")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def recording_templates_cmd(ctx, sort_scheme, json_mode):
+    """总结模板列表查询。"""
+    kwargs = {"sortScheme": sort_scheme} if sort_scheme else {}
+    r = get_summary_templates(_ctx_base(ctx), _ctx_token(ctx), **kwargs)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@recording_group.command("update-summary-template")
+@click.option("--recording-code", required=True, help="目标录音 code")
+@click.option("--summary-template-id", help="总结模板 ID，不传则默认 zhinengzongjie-neice")
+@click.option("--summary-no", type=int, help="指定则重新生成该次历史总结，不传则新建")
+@click.option("--template-selection-mode", help="MANUAL / AUTO_TEMPLATE")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def recording_update_summary_template_cmd(ctx, recording_code, summary_template_id,
+                                          summary_no, template_selection_mode, json_mode):
+    """开启 AI 总结，返回预估耗时。"""
+    params = {k: v for k, v in {
+        "recordingCode": recording_code,
+        "summaryTemplatesId": summary_template_id,
+        "summaryNo": summary_no,
+        "templateSelectionMode": template_selection_mode,
+    }.items() if v is not None}
+    r = update_summary_template(_ctx_base(ctx), _ctx_token(ctx), **params)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@recording_group.command("upload")
+@click.argument("file_path")
+@click.option("--recording-code", required=True, help="录音 code")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def recording_upload_cmd(ctx, file_path, recording_code, json_mode):
+    """上传音频文件到指定录音。"""
+    r = _upload_file(
+        path=file_path,
+        base_url=_ctx_base(ctx),
+        recording_code=recording_code,
+        token=_ctx_token(ctx),
+        api_key=ctx.obj.get("api_key"),
+    )
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@recording_group.command("merged-summary")
+@click.option("--recording-codes", required=True, help="来源录音 code，多个用逗号分隔，如 rec_a,rec_b")
+@click.option("--merged-recording-code", help="已有合并录音 code，传则追加来源，不传则新建")
+@click.option("--summary-template-id", help="总结模板 ID，新建时不传默认 smart")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def recording_merged_summary_cmd(ctx, recording_codes, merged_recording_code,
+                                 summary_template_id, json_mode):
+    """合并多条录音总结为一份汇总总结。"""
+    codes = [c.strip() for c in recording_codes.split(",")]
+    kwargs = {k: v for k, v in {
+        "recordingCodes": codes,
+        "mergedRecordingCode": merged_recording_code,
+        "summaryTemplatesId": summary_template_id,
+    }.items() if v is not None}
+    r = recording_merged_summary(_ctx_base(ctx), _ctx_token(ctx), **kwargs)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+# --- summary ---
+@cli.group("summary")
+def summary_group():
+    """Recording summary management."""
+    pass
+
+
+@summary_group.command("list")
+@click.argument("recording_code")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def summary_list_cmd(ctx, recording_code, json_mode):
+    """录音总结列表查询。"""
+    r = summary_list(_ctx_base(ctx), _ctx_token(ctx), recording_code)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@summary_group.command("get")
+@click.argument("id", type=int)
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def summary_get_cmd(ctx, id, json_mode):
+    """总结详情查询。"""
+    r = summary_get(_ctx_base(ctx), _ctx_token(ctx), id)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+# --- group ---
+@cli.group("group")
+def group_group():
+    """Recording group management."""
+    pass
+
+
+@group_group.command("list")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def group_list_cmd(ctx, json_mode):
+    """分组列表查询。"""
+    r = group_list(_ctx_base(ctx), _ctx_token(ctx))
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@group_group.command("create")
+@click.option("--name", "group_name", required=True, help="分组名称，同一用户下唯一，最长 64 字符")
+@click.option("--description", help="分组描述，最长 500 字符")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def group_create_cmd(ctx, group_name, description, json_mode):
+    """创建录音分组。"""
+    kwargs = {"description": description} if description else {}
+    r = group_create(_ctx_base(ctx), _ctx_token(ctx), group_name=group_name, **kwargs)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+@group_group.command("delete")
+@click.argument("code")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def group_delete_cmd(ctx, code, json_mode):
+    """删除录音分组。"""
+    r = group_delete(_ctx_base(ctx), _ctx_token(ctx), code)
+    _output(r, json_mode or ctx.obj.get("json_mode"))
+
+
+# --- transcribe ---
+@cli.command("transcribe")
+@click.option("--title", required=True, help="录音标题")
+@click.option("--description", required=True, help="录音描述")
+@click.option("--file", "file_path", default=None, help="本地音频文件路径")
+@click.option("--url", "file_url", default=None, help="录音网址链接")
+@click.option("--file-name", required=True, help="原始文件名")
+@click.option("--file-created-at", required=True, help="文件创建时间，格式 yyyy-MM-dd HH:mm:ss")
+@click.option("--content-type", default="IMPORTED", show_default=True,
+              help="内容类型：ENVIRONMENT / IMPORTED / CALL / MERGED_SUMMARY")
+@click.option("--template-id", required=True, help="AI 总结模板 ID（可通过 recording summary-templates 获取）")
+@click.option("--json", "json_mode", is_flag=True)
+@click.pass_context
+def transcribe_cmd(ctx, title, description, file_path, file_url, file_name,
+                   file_created_at, content_type, template_id, json_mode):
+    """一键完成：创建录音 → 上传/绑定文件 → 触发 AI 总结。
+
+    \b
+    两种模式：
+      --file  本地文件：上传后自动回写文件 URL
+      --url   网络链接：直接绑定到录音记录
+    """
+    if not file_path and not file_url:
+        raise click.UsageError("必须提供 --file（本地文件）或 --url（录音链接）之一")
+    if file_path and file_url:
+        raise click.UsageError("--file 和 --url 不能同时使用")
+
+    base = _ctx_base(ctx)
+    tok = _ctx_token(ctx)
+    api_key = ctx.obj.get("api_key")
+    jm = json_mode or ctx.obj.get("json_mode")
+
+    create_kwargs = {
+        "description": description,
+        "fileName": file_name,
+        "recordingContentType": content_type,
+        "fileCreatedAt": file_created_at,
+        "summaryTemplatesId": template_id,
+    }
+    if file_url:
+        create_kwargs["fileUrl"] = file_url
+
+    click.echo("▶ 创建录音记录...")
+    result = recording_create(base, tok, title=title, **create_kwargs)
+    code = (result.get("data") or {}).get("code")
+    if not code:
+        _output(result, jm)
+        return
+
+    click.echo(f"  录音 code: {code}")
+
+    if file_path:
+        click.echo(f"▶ 上传音频文件 {file_path}...")
+        upload_result = _upload_file(
+            path=file_path,
+            base_url=base,
+            recording_code=code,
+            token=tok,
+            api_key=api_key,
+        )
+        uploaded_url = (upload_result.get("data") or {}).get("url")
+        if not uploaded_url:
+            click.echo("✗ 上传失败", err=True)
+            _output(upload_result, jm)
+            return
+
+        click.echo(f"  文件 URL: {uploaded_url}")
+        click.echo("▶ 回写文件 URL...")
+        recording_update(base, tok, code, fileUrl=uploaded_url)
+
+    click.echo("▶ 触发 AI 总结...")
+    summary_result = update_summary_template(
+        base, tok,
+        recordingCode=code,
+        summaryTemplatesId=template_id,
+    )
+    estimated = (summary_result.get("data") or {}).get("totalEstimatedMinutes", "?")
+    click.echo(f"  预计耗时：{estimated} 分钟")
+    click.echo(f"✓ 完成！录音 code: {code}")
+    click.echo(f"  查询总结：aidee --json summary list {code}")
+
+    if jm:
+        _output({"recordingCode": code, "estimatedMinutes": estimated}, jm)
+
+
+def main():
+    cli()
+
+
+if __name__ == "__main__":
+    main()

aidee_pro-1.0.0/aidee_pro.egg-info/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: aidee-pro
+Version: 1.0.0
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28

aidee_pro-1.0.0/aidee_pro.egg-info/SOURCES.txt

@@ -0,0 +1,36 @@
+README.md
+__init__.py
+aidee_cli.py
+pyproject.toml
+aidee_pro.egg-info/PKG-INFO
+aidee_pro.egg-info/SOURCES.txt
+aidee_pro.egg-info/dependency_links.txt
+aidee_pro.egg-info/entry_points.txt
+aidee_pro.egg-info/requires.txt
+aidee_pro.egg-info/top_level.txt
+core/__init__.py
+core/config.py
+core/device.py
+core/expo.py
+core/feedback.py
+core/firmware.py
+core/group.py
+core/industry.py
+core/membership.py
+core/position.py
+core/recording.py
+core/redemption.py
+core/session.py
+core/summary.py
+core/template.py
+core/template_category.py
+core/thirdparty.py
+core/user.py
+core/websocket.py
+core/word_library.py
+tests/test_core.py
+tests/test_full_e2e.py
+utils/__init__.py
+utils/aidee_backend.py
+utils/output.py
+utils/repl_skin.py

aidee_pro-1.0.0/aidee_pro.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aidee_pro-1.0.0/aidee_pro.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aidee-pro = aidee_cli:main

aidee_pro-1.0.0/aidee_pro.egg-info/requires.txt

@@ -0,0 +1,2 @@
+click>=8.0
+requests>=2.28

aidee_pro-1.0.0/aidee_pro.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+__init__
+aidee_cli
+core
+utils

aidee_pro-1.0.0/core/__init__.py

@@ -0,0 +1 @@
+"""Core modules for AIDEE CLI."""