@9000ai/cli 0.1.0

package/skills/douyin-monitor/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: douyin-monitor-9000AI
+description: 当用户要管理抖音主页监控对象、提交主页监控任务、查看运行历史或回看结果时使用。这个 skill 只负责主页监控这一项业务能力。
+triggers:
+  - 抖音主页监控
+  - 主页监控
+  - 对标账号监控
+  - 监控抖音主页
+  - 查看主页监控结果
+  - /douyin 监控
+  - /douyin 主页监控
+  - /douyin-monitor-9000AI
+  - /douyin 监控 9000AI
+role: operator
+scope: execution
+output-format: task-oriented
+---
+
+# 抖音主页监控 Skill
+
+这个 skill 对应一整套主页监控能力，不只是提交异步任务。
+
+## 适用范围
+
+用于：
+- 查看当前 key 和能力
+- 新建监控对象
+- 查看监控对象列表
+- 修改、启停、重置、删除监控对象
+- 提交主页监控任务
+- 查看运行历史和单次运行详情
+- 查看任务状态和任务结果
+
+## 工作方式
+
+主页监控的"提交运行"是异步任务，标准动作是：
+1. 先确认或创建监控对象
+2. 提交后台任务
+3. 拿到 `task_id` 和 `run_id`
+4. 告诉用户任务已在后台运行
+5. 稍后回查运行详情、任务状态或任务结果
+
+如果用户只是管理监控对象或查看历史，不需要走异步等待。
+
+推荐话术：
+- "我已经帮你提交了主页监控任务，任务号是 `<task_id>`，运行号是 `<run_id>`。这条任务会在后台跑，我们先继续别的事情，稍后我再回来查结果。"
+
+## 配置
+
+通过 CLI 统一管理：
+
+```bash
+9000ai config set --base-url http://127.0.0.1:8025 --api-key <key>
+9000ai config show
+```
+
+也支持环境变量：
+
+```text
+9000AI_BASE_URL
+9000AI_API_KEY
+```
+
+## 中文输入约束
+
+如果要提交中文名称、关注方向、备注，优先使用 UTF-8 编码的 JSON 文件。
+
+推荐方式：
+- 把请求体写进 `creator.json`、`creator_update.json`、`run_request.json`
+- 确保文件保存为 UTF-8
+- 再用 `--json-file` 提交
+
+不推荐方式：
+- 在终端里直接内联一大段中文 JSON
+
+后端会拦截明显疑似乱码的内容，要求重新用 UTF-8 提交。
+
+## 命令
+
+查看帮助：
+
+```bash
+9000ai monitor --help
+```
+
+常用命令：
+
+```bash
+9000ai config set --base-url http://127.0.0.1:8025 --api-key <key>
+9000ai auth whoami
+9000ai auth capabilities
+9000ai monitor list-creators
+9000ai monitor create-creator --json-file creator.json
+9000ai monitor update-creator --creator-id <creator_id> --json-file creator_update.json
+9000ai monitor enable-creator --creator-id <creator_id>
+9000ai monitor disable-creator --creator-id <creator_id>
+9000ai monitor reset-creator --creator-id <creator_id>
+9000ai monitor delete-creator --creator-id <creator_id>
+9000ai monitor submit --json-file run_request.json
+9000ai monitor list-runs
+9000ai monitor run-detail --run-id <run_id>
+9000ai task status --task-id <task_id>
+9000ai task results --task-id <task_id>
+```
+
+## 参考
+
+接口和请求体示例见：
+
+```text
+douyin-monitor-9000AI/references/endpoints.md
+```

package/skills/douyin-monitor/agents/openai.yaml

@@ -0,0 +1,3 @@
+display_name: douyin-monitor-9000AI
+short_description: 通过 /douyin-monitor-9000AI 提交主页监控任务并回查结果
+default_prompt: 帮我通过 /douyin-monitor-9000AI 提交抖音主页监控任务，拿到 task_id 后稍后回查结果。

package/skills/douyin-monitor/references/endpoints.md

@@ -0,0 +1,104 @@
+# 抖音主页监控接口
+
+基础地址默认：
+
+```text
+http://127.0.0.1:8025
+```
+
+所有接口都需要：
+
+```text
+X-API-Key: <你的 key>
+```
+
+本地固定配置文件：
+
+```text
+douyin-monitor-9000AI/local/config.json
+```
+
+## 鉴权与能力
+
+```text
+GET /api/v1/auth/me
+GET /api/v1/auth/capability-permissions
+```
+
+## 监控对象管理
+
+```text
+GET    /api/v1/douyin/monitor/creators
+POST   /api/v1/douyin/monitor/creators
+GET    /api/v1/douyin/monitor/creators/{creator_id}
+PATCH  /api/v1/douyin/monitor/creators/{creator_id}
+DELETE /api/v1/douyin/monitor/creators/{creator_id}
+POST   /api/v1/douyin/monitor/creators/{creator_id}/enable
+POST   /api/v1/douyin/monitor/creators/{creator_id}/disable
+POST   /api/v1/douyin/monitor/creators/{creator_id}/reset
+```
+
+新增监控对象请求体示例：
+
+```json
+{
+  "name": "李一般",
+  "sec_user_id": "MS4wLjABAAAA1wMuf3tRz1UJFVViYSmD7J9Y8M8zCEs4Clv9STQdjjU",
+  "focus": "热点对标账号",
+  "notes": "AI 热点与话题表达",
+  "enabled": true
+}
+```
+
+更新监控对象请求体示例：
+
+```json
+{
+  "notes": "已更新备注",
+  "enabled": true
+}
+```
+
+## 运行任务
+
+```text
+POST /api/v1/douyin/monitor/run
+GET  /api/v1/douyin/monitor/runs
+GET  /api/v1/douyin/monitor/runs/{run_id}
+GET  /api/v1/tasks/{task_id}
+GET  /api/v1/tasks/{task_id}/results
+```
+
+提交监控任务示例：
+
+```json
+{
+  "creator_ids": [
+    "b2d7bc00-26fa-4b78-9029-6ace9f85fc8f"
+  ],
+  "count": 12,
+  "sort_type": 0,
+  "top": 20,
+  "force_fresh": false
+}
+```
+
+也可以直接传 creators：
+
+```json
+{
+  "creators": [
+    {
+      "name": "李一般",
+      "sec_user_id": "MS4wLjABAAAA1wMuf3tRz1UJFVViYSmD7J9Y8M8zCEs4Clv9STQdjjU",
+      "focus": "热点对标账号",
+      "notes": "AI 热点与话题表达",
+      "enabled": true
+    }
+  ],
+  "count": 12,
+  "sort_type": 0,
+  "top": 20,
+  "force_fresh": false
+}
+```

package/skills/douyin-monitor/scripts/douyin_monitor_api.py

@@ -0,0 +1,273 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+HUB_ROOT = REPO_ROOT / "9000AI-hub-9000AI"
+if str(HUB_ROOT) not in sys.path:
+    sys.path.insert(0, str(HUB_ROOT))
+
+from shared.runner import (  # noqa: E402
+    ModuleSpec,
+    configure_stdout_encoding,
+    load_json_file,
+    print_json,
+    request_json,
+    resolve_api_key,
+    resolve_base_url,
+    save_local_config,
+)
+
+SKILL_ROOT = Path(__file__).resolve().parents[1]
+MODULE_SPEC = ModuleSpec(
+    module="douyin-monitor",
+    skill_root=SKILL_ROOT,
+)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="Douyin monitor API client")
+    parser.add_argument("--base-url", default=None)
+    parser.add_argument("--api-key", default=None)
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    subparsers.add_parser("configure", help="写入本地配置文件")
+    subparsers.add_parser("whoami", help="查看当前 key 对应的调用方")
+    subparsers.add_parser("capabilities", help="查看当前 key 开通的能力")
+    subparsers.add_parser("list-creators", help="查看监控对象列表")
+
+    create_creator = subparsers.add_parser("create-creator", help="新增监控对象")
+    create_creator.add_argument("--json-file", required=True)
+
+    get_creator = subparsers.add_parser("get-creator", help="查看单个监控对象")
+    get_creator.add_argument("--creator-id", required=True)
+
+    update_creator = subparsers.add_parser("update-creator", help="修改监控对象")
+    update_creator.add_argument("--creator-id", required=True)
+    update_creator.add_argument("--json-file", required=True)
+
+    delete_creator = subparsers.add_parser("delete-creator", help="删除监控对象")
+    delete_creator.add_argument("--creator-id", required=True)
+
+    enable_creator = subparsers.add_parser("enable-creator", help="启用监控对象")
+    enable_creator.add_argument("--creator-id", required=True)
+
+    disable_creator = subparsers.add_parser("disable-creator", help="停用监控对象")
+    disable_creator.add_argument("--creator-id", required=True)
+
+    reset_creator = subparsers.add_parser("reset-creator", help="重置监控对象状态")
+    reset_creator.add_argument("--creator-id", required=True)
+
+    submit = subparsers.add_parser("submit", help="提交主页监控任务")
+    submit.add_argument("--json-file", required=True)
+
+    list_runs = subparsers.add_parser("list-runs", help="查看运行历史")
+    list_runs.add_argument("--page", type=int, default=1)
+    list_runs.add_argument("--page-size", type=int, default=20)
+    list_runs.add_argument("--status", default=None)
+
+    run_detail = subparsers.add_parser("run-detail", help="查看单次运行详情")
+    run_detail.add_argument("--run-id", required=True)
+
+    task = subparsers.add_parser("task", help="查看任务状态")
+    task.add_argument("--task-id", required=True)
+
+    results = subparsers.add_parser("results", help="查看任务结果")
+    results.add_argument("--task-id", required=True)
+    return parser
+
+
+def main() -> None:
+    configure_stdout_encoding()
+    parser = build_parser()
+    args = parser.parse_args()
+
+    if args.command == "configure":
+        if not args.base_url or not args.api_key:
+            raise SystemExit("configure 需要同时传 --base-url 和 --api-key")
+        save_local_config(MODULE_SPEC, base_url=args.base_url, api_key=args.api_key)
+        print_json({"message": "配置已写入", "config_path": str(MODULE_SPEC.config_path)})
+        return
+
+    base_url = resolve_base_url(MODULE_SPEC, args.base_url)
+    api_key = resolve_api_key(MODULE_SPEC, args.api_key)
+
+    if args.command == "whoami":
+        print_json(
+            request_json(MODULE_SPEC, method="GET", base_url=base_url, api_key=api_key, path="/api/v1/auth/me")
+        )
+        return
+
+    if args.command == "capabilities":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="GET",
+                base_url=base_url,
+                api_key=api_key,
+                path="/api/v1/auth/capability-permissions",
+            )
+        )
+        return
+
+    if args.command == "list-creators":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="GET",
+                base_url=base_url,
+                api_key=api_key,
+                path="/api/v1/douyin/monitor/creators",
+            )
+        )
+        return
+
+    if args.command == "create-creator":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="POST",
+                base_url=base_url,
+                api_key=api_key,
+                path="/api/v1/douyin/monitor/creators",
+                payload=load_json_file(args.json_file),
+            )
+        )
+        return
+
+    if args.command == "get-creator":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="GET",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/douyin/monitor/creators/{args.creator_id}",
+            )
+        )
+        return
+
+    if args.command == "update-creator":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="PATCH",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/douyin/monitor/creators/{args.creator_id}",
+                payload=load_json_file(args.json_file),
+            )
+        )
+        return
+
+    if args.command == "delete-creator":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="DELETE",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/douyin/monitor/creators/{args.creator_id}",
+            )
+        )
+        return
+
+    if args.command == "enable-creator":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="POST",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/douyin/monitor/creators/{args.creator_id}/enable",
+            )
+        )
+        return
+
+    if args.command == "disable-creator":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="POST",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/douyin/monitor/creators/{args.creator_id}/disable",
+            )
+        )
+        return
+
+    if args.command == "reset-creator":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="POST",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/douyin/monitor/creators/{args.creator_id}/reset",
+            )
+        )
+        return
+
+    if args.command == "submit":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="POST",
+                base_url=base_url,
+                api_key=api_key,
+                path="/api/v1/douyin/monitor/run",
+                payload=load_json_file(args.json_file),
+            )
+        )
+        return
+
+    if args.command == "list-runs":
+        query = f"/api/v1/douyin/monitor/runs?page={args.page}&page_size={args.page_size}"
+        if args.status:
+            query += f"&status={args.status}"
+        print_json(
+            request_json(MODULE_SPEC, method="GET", base_url=base_url, api_key=api_key, path=query)
+        )
+        return
+
+    if args.command == "run-detail":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="GET",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/douyin/monitor/runs/{args.run_id}",
+            )
+        )
+        return
+
+    if args.command == "task":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="GET",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/tasks/{args.task_id}",
+            )
+        )
+        return
+
+    if args.command == "results":
+        print_json(
+            request_json(
+                MODULE_SPEC,
+                method="GET",
+                base_url=base_url,
+                api_key=api_key,
+                path=f"/api/v1/tasks/{args.task_id}/results",
+            )
+        )
+        return
+
+
+if __name__ == "__main__":
+    main()

package/skills/douyin-topic-discovery/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: douyin-topic-discovery-9000AI
+description: 当用户要获取抖音热点榜、按关键词搜索抖音搜索流，或者把候选结果落到本地 output 文件供后续分析脚本继续消费时使用。这个 skill 只负责抖音选题发现，不负责业务判断。
+triggers:
+  - 抖音热点榜
+  - 抖音热榜
+  - 抖音搜索流
+  - 抖音关键词搜索
+  - 抖音选题发现
+  - /douyin 热榜
+  - /douyin 搜索
+  - /douyin 选题
+  - /douyin-topic-discovery-9000AI
+  - /douyin 搜索 9000AI
+role: operator
+scope: execution
+output-format: file-oriented
+---
+
+# 抖音选题发现 Skill
+
+这个 skill 对应一个能力：`douyin_topic_discovery`。
+
+## 先看变量名
+
+不要去别的文档里猜变量名。这个 skill 固定只认中台统一变量：
+
+```text
+9000AI_BASE_URL
+9000AI_API_KEY
+```
+
+请求头里的 key 名固定是：
+
+```text
+X-API-Key
+```
+
+读取优先级固定是：
+
+```text
+1. 命令行参数
+2. 9000AI_BASE_URL / 9000AI_API_KEY
+3. douyin-topic-discovery-9000AI/local/config.json
+```
+
+本地配置文件的字段名固定是：
+
+```json
+{
+  "base_url": "http://127.0.0.1:8025",
+  "api_key": "sk-xxx"
+}
+```
+
+## 批量选题调研
+
+当用户让你围绕某个主题批量调研、搜索选题素材时，请先阅读工作流文档（参考这个流程，跟用户说按照这个流程是否有问题？）：
+
+- `douyin-topic-discovery-9000AI/workflow/topic-research.md`
+
+按该文档的阶段逐步执行，不要跳步。
+
+## 当前范围
+
+用于：
+- 获取抖音热点榜
+- 按关键词搜索抖音搜索流
+- 把结果落到 `output/` 目录
+- 让后续脚本按文件继续消费
+- 批量选题调研（按工作流文档执行）
+
+不负责：
+- 自动生成推荐结论
+
+## 工作方式
+
+标准动作是：
+1. 调热榜或搜索流 API
+2. 把结果写到 `douyin-topic-discovery-9000AI/output/`
+3. 对话里只展示摘要和少量关键字段
+
+`search` 现在是真异步：
+1. 先提交 `batch`
+2. 立即返回 `batch_id`
+3. 需要结果时，再用 `batch-result` 查询
+4. 查询到结果后，再落 `latest_search.json/tsv`
+
+## 配置
+
+优先推荐直接配中台统一环境变量：
+
+```powershell
+$env:9000AI_BASE_URL = "http://127.0.0.1:8025"
+$env:9000AI_API_KEY = "sk-xxx"
+```
+
+或者通过 CLI 写入配置：
+
+```bash
+9000ai config set --base-url http://127.0.0.1:8025 --api-key <key>
+```
+
+## 输出目录
+
+固定输出到：
+
+```text
+output/
+```
+
+常用文件：
+- `latest_hot.json`
+- `latest_hot.tsv`
+- `latest_search.json`
+- `latest_search.tsv`
+
+## 命令
+
+查看帮助：
+
+```bash
+9000ai search --help
+```
+
+常用命令：
+
+```bash
+9000ai config set --base-url http://127.0.0.1:8025 --api-key <key>
+9000ai auth whoami
+9000ai auth capabilities
+9000ai search hot --type society --count 20
+9000ai search keyword "AI创业" "副业" --sort 0 --time 7 --content-type 1 --filter-duration 0 --min-likes 200 --min-comments 20
+9000ai search batch-result --batch-id <batch_id>
+9000ai search list-output
+9000ai search show-result --input latest_search --row 3
+9000ai search export-media --input latest_search --row 3
+```
+
+搜索结果数量规则：
+- `search` 每个关键词默认抓取 `30` 条
+- 后端会基于 `search_general_v3` 自动翻页聚合，不需要额外传分页参数
+
+## 一句话总结
+
+这是一个”热榜 + search_general_v3 搜索流”的抖音选题发现 skill。

package/skills/douyin-topic-discovery/agents/openai.yaml

@@ -0,0 +1,3 @@
+display_name: douyin-topic-discovery-9000AI
+short_description: 通过 /douyin-topic-discovery-9000AI 获取热点榜和搜索流结果，并落到本地 output 文件
+default_prompt: 帮我通过 /douyin-topic-discovery-9000AI 查抖音热点榜或搜索流，把结果落到 output 文件里，再给我一个简短摘要。