@9000ai/cli 0.4.0 → 0.5.1

package/skills/9000AI-hub/references/usage-guidelines.md

@@ -0,0 +1,75 @@
+# 9000AI 使用规范详细参考
+
+## 性能准则
+
+### 数据精简
+
+所有查询命令都支持 `--fields` 和 `--compact` 参数。**默认必须用 `--fields` 只取需要的字段，禁止全量读取。**
+
+```bash
+# 错误 — 返回 83KB 全量数据，浪费上下文
+9000ai task results --task-id <id>
+
+# 正确 — 只取需要的字段
+9000ai task results --task-id <id> --fields desc,video_url,likes,author_name
+
+# 更紧凑 — 每条一行，适合批量处理
+9000ai task results --task-id <id> --fields desc,video_url,likes --compact
+```
+
+常用字段组合：
+- 搜索结果概览：`--fields desc,author_name,likes,duration`
+- 提取转写链接：`--fields video_url,download_url,play_url,desc`
+- 监控结果摘要：`--fields desc,author_name,likes,comments,create_time`
+- 主页视频列表：`--fields description,likes,comments,plays,publish_time`
+
+### 并行执行
+
+独立的操作必须并行，不要串行等待。用 subagent 或并行工具调用。
+
+可以并行的场景：
+- 写 inbox 文件 + 提交转写任务
+- 多个关键词的搜索结果查询
+- 查多个 task_id 的状态
+- 热榜 + 关键词搜索同时拉
+
+不能并行的场景：
+- 搜索 → 等结果 → 筛选（有依赖关系）
+- 创建监控对象 → 提交监控任务（需要 creator_id）
+
+### 减少中间文件
+
+CLI 支持 `--json-file` 也支持直接传参。简单请求直接传参，不要写中间 JSON 文件。
+
+### 不暴露中间过程
+
+用户要的是结果，不是过程。拿到数据后直接输出摘要或执行下一步，不要把原始 JSON 展示给用户。
+
+## 串联规则
+
+只有在用户明确要求多步串联时，才跨模块：
+- 先搜索，再转写
+- 先监控，再分析结果
+
+串联步骤：
+1. 先进入第一个模块完成提交
+2. 拿到任务结果或结果引用
+3. 再进入下一个模块继续执行
+
+## 统一使用规范
+
+1. 不把大结果直接塞进上下文
+2. 优先使用 `task_id`、`batch_id`、`row_no` 继续操作
+3. 如果用户问"该用哪个模块"，中台负责判断
+4. 如果用户已经明确说了模块名，直接进入对应 skill
+5. 接口报错、任务失败、用户不满时，主动提议 `9000ai feedback submit` 提交反馈
+
+## PowerShell 编码
+
+Windows PowerShell 中文容易乱码，先设 UTF-8：
+
+```powershell
+$env:PYTHONIOENCODING = 'utf-8'
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+```

package/skills/douyin-monitor/SKILL.md

@@ -24,13 +24,23 @@ output-format: task-oriented
 
 用于：
 - 查看当前 key 和能力
+- **直接获取某个用户的主页视频**（同步，不入队列）
 - 新建监控对象
 - 查看监控对象列表
 - 修改、启停、重置、删除监控对象
-- 提交主页监控任务
+- 提交主页监控任务（异步，加入队列定期监控）
 - 查看运行历史和单次运行详情
 - 查看任务状态和任务结果
 
+## 两种获取模式
+
+| 模式 | 命令 | 场景 |
+|------|------|------|
+| **直接获取** | `9000ai monitor fetch --sec-user <id>` | 临时看某人主页、一次性分析 |
+| **加入监控** | `9000ai monitor submit --json-file ...` | 持续跟踪、定期检查更新 |
+
+判断标准：用户说"看一下xxx的主页/视频" → 直接获取；用户说"监控xxx/跟踪xxx" → 加入队列。
+
 ## 工作方式
 
 主页监控的"提交运行"是异步任务，标准动作是：
@@ -89,6 +99,7 @@ output-format: task-oriented
 9000ai config set --base-url http://127.0.0.1:8025 --api-key <key>
 9000ai auth whoami
 9000ai auth capabilities
+9000ai monitor fetch --sec-user <sec_user_id> --fields description,likes,comments,plays
 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

package/skills/9000AI-hub/configure.py

@@ -1,56 +0,0 @@
-"""9000AI 中台初始化脚本（旧版，保留兼容）。
-
-推荐使用新的 CLI 工具：
-    9000ai config set --base-url http://192.168.1.100:8025 --api-key sk-xxx
-
-查看当前配置：
-    9000ai config show
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-HUB_ROOT = Path(__file__).resolve().parent
-if str(HUB_ROOT) not in sys.path:
-    sys.path.insert(0, str(HUB_ROOT))
-
-from shared.runner import _HUB_CONFIG_PATH, load_hub_config, save_hub_config  # noqa: E402
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(description="9000AI 中台连接配置（首次使用前必须运行一次）")
-    parser.add_argument("--base-url", help="中台服务地址，例如 http://192.168.1.100:8025")
-    parser.add_argument("--api-key", help="你的 API Key，找管理员要")
-    parser.add_argument("--show", action="store_true", help="查看当前已保存的配置")
-    args = parser.parse_args()
-
-    if args.show:
-        cfg = load_hub_config()
-        if cfg:
-            print("当前 9000AI 中台配置：")
-            print(json.dumps(cfg, ensure_ascii=False, indent=2))
-        else:
-            print(f"还没有初始化过。请先运行：")
-            print(f"  9000ai config set --base-url <中台地址> --api-key <你的key>")
-        return
-
-    if not args.base_url or not args.api_key:
-        parser.error("--base-url 和 --api-key 都是必填项。\n"
-                      "  推荐使用: 9000ai config set "
-                      "--base-url http://192.168.1.100:8025 --api-key sk-xxx")
-
-    save_hub_config(base_url=args.base_url, api_key=args.api_key)
-    print(f"初始化完成！配置已保存。")
-    print(f"  中台地址: {args.base_url.rstrip('/')}")
-    print(f"  API Key:  {args.api_key[:8]}...")
-    print(f"  配置文件: {_HUB_CONFIG_PATH}")
-    print()
-    print("现在可以使用所有 9000AI skill 了。")
-
-
-if __name__ == "__main__":
-    main()

package/skills/9000AI-hub/init/SKILL.md

@@ -1,130 +0,0 @@
----
-name: content-init
-description: 内容创作者工作空间初始化。创建完整的目录结构、agent 人格、主张库、用户画像模板，配置中台连接，并生成使用指南。只需运行一次。
-triggers:
-  - /content-init
-  - /初始化工作空间
-  - 初始化内容工作空间
-  - 初始化
-  - 第一次用
-role: initializer
-scope: workspace-setup
-output-format: file-creation
----
-
-# 内容工作空间初始化
-
-你负责帮内容创作者完成工作空间的一次性初始化。完成后，用户就拥有了完整的内容创作文件系统和使用指南。
-
----
-
-## 前置条件：中台连接配置
-
-在创建文件之前，先确认中台已连上。
-
-**检查方式**：
-
-```bash
-9000ai config show
-```
-
-- 输出了 `base_url` 和 `api_key` → 继续下一步
-- 提示未配置 → 问用户要中台地址和 API Key，然后运行：
-
-```bash
-9000ai config set --base-url <地址> --api-key <key>
-```
-
-> **不知道地址和 key？**
-> - `base-url`：找中台管理员要，或查看你收到的 9000AI 服务开通通知。
-> - `api-key`：找中台管理员要，每个用户的 key 独立分配。
-
----
-
-## 幂等性规则
-
-这个初始化可以安全地多次运行，不会破坏已有数据。
-
-| 情况 | 处理 |
-|------|------|
-| 目录已存在 | 跳过，不重建 |
-| `profile/` 下的文件已存在 | **一律跳过**（用户可能已开始填写） |
-| `claims/README.md` 是旧版（含"每个主张是一个文件夹"） | 备份为 `.bak`，替换为新版 |
-| `claims/` 数据文件已存在（json/jsonl） | 跳过 |
-| `agents/`、`CLAUDE.md`、`guide.md` 不存在 | 创建 |
-| `agents/`、`CLAUDE.md`、`guide.md` 已存在 | 跳过 |
-
-核心原则：只创建不存在的东西，绝不覆盖用户已编辑的内容。
-
----
-
-## 模板来源
-
-所有模板文件位于本 skill 的 `templates/` 子目录中，初始化时直接复制到用户项目根目录。
-
-模板根路径（相对于本 SKILL.md）：`init/templates/`
-
----
-
-## 创建清单
-
-按以下顺序在**用户当前项目根目录**下创建文件和目录。每一步先检查是否已存在。
-
-| # | 目标路径 | 模板来源 | 跳过条件 |
-|---|---------|---------|---------|
-| 1 | `agents/` | — | 目录已存在 |
-| 2 | `agents/content-agent.md` | `templates/agents/content-agent.md` | 文件已存在 |
-| 3 | `agents/README.md` | `templates/agents/README.md` | 文件已存在 |
-| 4 | `profile/` | — | 目录已存在 |
-| 5 | `profile/identity.md` | `templates/profile/identity.md` | 文件已存在 |
-| 6 | `profile/voice.md` | `templates/profile/voice.md` | 文件已存在 |
-| 7 | `profile/topics.md` | `templates/profile/topics.md` | 文件已存在 |
-| 8 | `profile/product.md` | `templates/profile/product.md` | 文件已存在 |
-| 9 | `inbox/` | — | 目录已存在 |
-| 10 | `inbox/README.md` | `templates/inbox/README.md` | 文件已存在 |
-| 11 | `claims/` | — | 目录已存在 |
-| 12 | `claims/README.md` | `templates/claims/README.md` | 已存在且**不含**"每个主张是一个文件夹" |
-| 13 | `claims/claims.json` | `templates/claims/claims.json` | 文件已存在 |
-| 14 | `claims/angles.jsonl` | 空文件 | 文件已存在 |
-| 15 | `claims/cases.jsonl` | 空文件 | 文件已存在 |
-| 16 | `claims/outputs.jsonl` | 空文件 | 文件已存在 |
-| 17 | `projects/` | — | 目录已存在 |
-| 18 | `projects/README.md` | `templates/projects/README.md` | 文件已存在 |
-| 19 | `CLAUDE.md` | `templates/CLAUDE.md` | 文件已存在 |
-| 20 | `guide.md` | `templates/guide.md` | 文件已存在 |
-
-对于第 12 项：如果 `claims/README.md` 已存在且内容含"每个主张是一个文件夹"，先备份为 `claims/README.md.bak`，再用模板覆盖。
-
----
-
-## 初始化完成后汇报
-
-所有文件创建完毕后，输出以下格式的汇报：
-
-```
-## 工作空间初始化完成
-
-### 已创建
-- [文件路径] — [一句话说明]
-- ...
-
-### 已跳过（已存在）
-- [文件路径]
-- ...
-
-### 下一步
-
-1. **填写画像** → 打开 profile/ 下的文件，把"待填写"替换成真实信息
-2. **建立主张** → 编辑 claims/claims.json
-3. **开始使用** → 查看 guide.md 了解全部用法
-
-如果目录中有散落的素材文件（如会议转写），可以移入 inbox/，我会帮你处理。
-```
-
----
-
-## 注意事项
-
-- 不要在初始化过程中自动移动任何已有用户文件
-- 初始化只负责搭骨架，不填内容
-- 如果 `claims/` 中已有按主张命名的子目录（旧结构），不要删除，在汇报中告知用户新结构的差异

package/skills/9000AI-hub/init/templates/CLAUDE.md

@@ -1,24 +0,0 @@
-请载入 agents/content-agent.md 作为你的角色设定。
-
-## 工作空间概览
-
-| 目录 | 用途 |
-|------|------|
-| profile/ | 用户画像（只读） |
-| inbox/ | 素材投喂入口 |
-| claims/ | 主张库（核心资产） |
-| projects/ | 选题项目 |
-
-详细使用指南见 guide.md。
-
-## 平台能力映射
-
-| 能力 | CLI 命令 |
-|------|---------|
-| 配置中台连接 | `9000ai config set --base-url <url> --api-key <key>` |
-| 热点榜获取 | `9000ai search hot` |
-| 关键词搜索 | `9000ai search keyword` |
-| 对标账号监控 | `9000ai monitor` |
-| 视频转文字 | `9000ai transcribe` |
-| 查看任务状态 | `9000ai task status --task-id <id>` |
-| 身份验证 | `9000ai auth whoami` |

package/skills/9000AI-hub/shared/__init__.py

@@ -1 +0,0 @@
-"""Shared execution helpers shipped with 9000AI hub."""

package/skills/9000AI-hub/shared/runner.py

@@ -1,135 +0,0 @@
-from __future__ import annotations
-
-import json
-import os
-import sys
-from dataclasses import dataclass
-from pathlib import Path
-from typing import Any
-
-import requests
-
-
-DEFAULT_BASE_URL = "http://127.0.0.1:8025"
-DEFAULT_TIMEOUT_SECONDS = 300
-DEFAULT_API_KEY_HEADER = "X-API-Key"
-HUB_BASE_URL_ENV = "9000AI_BASE_URL"
-HUB_API_KEY_ENV = "9000AI_API_KEY"
-
-# hub 自身的全局配置文件，位于 9000AI-hub-9000AI/local/config.json
-_HUB_CONFIG_PATH = Path(__file__).resolve().parents[1] / "local" / "config.json"
-
-
-@dataclass(frozen=True)
-class ModuleSpec:
-    module: str
-    skill_root: Path
-    default_base_url: str = DEFAULT_BASE_URL
-    api_key_header: str = DEFAULT_API_KEY_HEADER
-    timeout_seconds: int = DEFAULT_TIMEOUT_SECONDS
-
-    @property
-    def config_path(self) -> Path:
-        return self.skill_root / "local" / "config.json"
-
-    @property
-    def output_dir(self) -> Path:
-        return self.skill_root / "output"
-
-
-def configure_stdout_encoding() -> None:
-    encoding = (sys.stdout.encoding or "").lower()
-    if encoding != "utf-8" and hasattr(sys.stdout, "reconfigure"):
-        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
-
-
-def load_local_config(spec: ModuleSpec) -> dict[str, Any]:
-    if not spec.config_path.exists():
-        return {}
-    return json.loads(spec.config_path.read_text(encoding="utf-8"))
-
-
-def load_hub_config() -> dict[str, Any]:
-    if not _HUB_CONFIG_PATH.exists():
-        return {}
-    return json.loads(_HUB_CONFIG_PATH.read_text(encoding="utf-8"))
-
-
-def save_local_config(spec: ModuleSpec, *, base_url: str, api_key: str) -> None:
-    spec.config_path.parent.mkdir(parents=True, exist_ok=True)
-    spec.config_path.write_text(
-        json.dumps({"base_url": base_url.rstrip("/"), "api_key": api_key}, ensure_ascii=False, indent=2),
-        encoding="utf-8",
-    )
-
-
-def save_hub_config(*, base_url: str, api_key: str) -> None:
-    """保存 hub 全局配置，所有 skill 共享。"""
-    _HUB_CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
-    _HUB_CONFIG_PATH.write_text(
-        json.dumps({"base_url": base_url.rstrip("/"), "api_key": api_key}, ensure_ascii=False, indent=2),
-        encoding="utf-8",
-    )
-
-
-def resolve_base_url(spec: ModuleSpec, override: str | None) -> str:
-    hub_config = load_hub_config()
-    skill_config = load_local_config(spec)
-    value = (
-        override
-        or os.getenv(HUB_BASE_URL_ENV)
-        or hub_config.get("base_url")
-        or skill_config.get("base_url")
-        or spec.default_base_url
-    )
-    return str(value).rstrip("/")
-
-
-def resolve_api_key(spec: ModuleSpec, override: str | None) -> str:
-    hub_config = load_hub_config()
-    skill_config = load_local_config(spec)
-    value = override or os.getenv(HUB_API_KEY_ENV) or hub_config.get("api_key") or skill_config.get("api_key")
-    if not value:
-        raise SystemExit(
-            "还没连上 9000AI 中台。请先初始化：\n"
-            "  9000ai config set --base-url <中台地址> --api-key <你的key>\n"
-            "\n"
-            "不知道地址和 key？找中台管理员要。"
-        )
-    return str(value)
-
-
-def load_json_file(path: str) -> Any:
-    return json.loads(Path(path).read_text(encoding="utf-8"))
-
-
-def request_json(
-    spec: ModuleSpec,
-    *,
-    method: str,
-    base_url: str,
-    api_key: str,
-    path: str,
-    payload: Any | None = None,
-    timeout_seconds: int | None = None,
-) -> Any:
-    response = requests.request(
-        method=method,
-        url=f"{base_url}{path}",
-        headers={spec.api_key_header: api_key, "Content-Type": "application/json"},
-        json=payload,
-        timeout=timeout_seconds or spec.timeout_seconds,
-    )
-    data = response.json()
-    if response.status_code >= 400:
-        raise SystemExit(json.dumps(data, ensure_ascii=False, indent=2))
-    return data
-
-
-def ensure_output_dir(spec: ModuleSpec) -> Path:
-    spec.output_dir.mkdir(parents=True, exist_ok=True)
-    return spec.output_dir
-
-
-def print_json(payload: Any) -> None:
-    print(json.dumps(payload, ensure_ascii=False, indent=2))

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

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