@9000ai/cli 0.1.0

package/skills/9000AI-hub/init/templates/claims/README.md

@@ -0,0 +1,91 @@
+# claims/ — 主张库
+
+这是你的核心资产。所有内容创作都围绕主张展开。
+
+## 文件结构
+
+| 文件 | 用途 |
+|------|------|
+| claims.json | 所有主张的定义（ID、名称、描述） |
+| angles.jsonl | 角度库——每个主张的具体切入角度，带匹配标签 |
+| cases.jsonl | 案例/素材库——事件、观点、故事，关联到主张 |
+| outputs.jsonl | 已产出记录——防止重复选题 |
+
+## 数据规范
+
+### claims.json
+
+```json
+[
+  {
+    "id": "cl001",
+    "name": "主张名称",
+    "description": "用一段话说清楚这个主张的核心论点"
+  }
+]
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| id | string | 是 | 格式 cl{NNN} |
+| name | string | 是 | 简短名称 |
+| description | string | 是 | 完整描述 |
+
+### angles.jsonl（每行一条 JSON）
+
+```json
+{"id":"ang001","claim_id":"cl001","angle":"角度描述","tags":["标签1","标签2"],"used_count":0,"last_used":null}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| id | string | 是 | 格式 ang{NNN} |
+| claim_id | string | 是 | 关联的主张 ID |
+| angle | string | 是 | 角度描述（一句话） |
+| tags | string[] | 是 | 匹配标签，用于关键词检索 |
+| used_count | int | 是 | 使用次数，初始 0 |
+| last_used | string\|null | 是 | 最后使用日期，初始 null |
+
+### cases.jsonl（每行一条 JSON）
+
+```json
+{"id":"c001","claim_id":"cl001","angle_id":null,"type":"event","title":"标题","summary":"摘要","source":"来源","direction":"negative","date":"2026-03-28"}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| id | string | 是 | 格式 c{NNN} |
+| claim_id | string | 是 | 关联的主张 ID |
+| angle_id | string\|null | 否 | 关联角度 ID，初期可为 null |
+| type | string | 是 | event / opinion / story |
+| title | string | 是 | 标题 |
+| summary | string | 是 | 摘要 |
+| source | string | 否 | 来源（平台@账号） |
+| direction | string | 是 | positive（证实）/ negative（证伪） |
+| date | string | 否 | 日期 |
+
+### outputs.jsonl（每行一条 JSON）
+
+```json
+{"id":"o001","claim_id":"cl001","angle_id":"ang001","platform":"抖音","title":"标题","date":"2026-03-25"}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| id | string | 是 | 格式 o{NNN} |
+| claim_id | string | 是 | 关联主张 |
+| angle_id | string\|null | 否 | 用了哪个角度 |
+| platform | string | 是 | 发布平台 |
+| title | string | 是 | 内容标题 |
+| date | string | 是 | 发布日期 |
+
+## 匹配流程
+
+```
+热点/案例进来
+  → AI 提取关键词
+  → 遍历 angles.jsonl，按 tags 匹配
+  → 命中 → 推荐该角度 + 历史案例
+  → 没命中 → 基于 claims.json 现推新角度
+  → 录完 → 新角度追加到 angles.jsonl，案例追加到 cases.jsonl
+```

package/skills/9000AI-hub/init/templates/claims/claims.json

@@ -0,0 +1,7 @@
+[
+  {
+    "id": "cl001",
+    "name": "（待填写：你的第一个主张）",
+    "description": "（待填写：用一段话说清楚这个主张的核心论点）"
+  }
+]

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

@@ -0,0 +1,185 @@
+# 9000AI 内容创作工作空间 — 使用指南
+
+## 你现在拥有什么
+
+```
+./
+├── agents/content-agent.md    # AI 助手的角色定义
+├── profile/                   # 你的画像（身份、风格、领域、产品）
+├── inbox/                     # 素材投喂入口
+├── claims/                    # 主张库（你的核心资产）
+├── projects/                  # 选题项目
+├── CLAUDE.md                  # Claude Code 自动载入文件
+└── guide.md                   # 就是这份指南
+```
+
+---
+
+## 全流程概览
+
+```
+发现热点 → 匹配主张 → 找角度 → 补素材 → 转写视频 → 产出内容
+   ↑            ↑          ↑         ↑          ↑
+ 热榜/搜索   claims.json  angles   cases     视频转文字
+```
+
+1. **发现**：用热榜或搜索找到值得追的热点
+2. **匹配**：看这个热点能挂到你的哪个主张上
+3. **切角度**：从角度库找已有角度，或基于主张推新角度
+4. **补素材**：从案例库拉历史素材，或搜索新素材
+5. **转写**：对标视频转成文字稿，分析学习
+6. **产出**：录制/撰写内容，记录到 outputs.jsonl
+
+---
+
+## 第一步：填写你的画像
+
+打开 `profile/` 下的文件，把"待填写"替换成真实信息：
+
+**identity.md — 你是谁**
+- 名字 / IP 名称、业务类型、目标受众、商业模式
+
+**voice.md — 你的表达风格**
+- 语气、常用句式、禁忌用语、参考博主
+
+**topics.md — 你关注什么**
+- 主攻方向、细分赛道、不碰的领域
+
+**product.md — 你卖什么**
+- 产品是什么、交付形式、定价、核心卖点、业务边界
+
+---
+
+## 第二步：建立你的主张
+
+打开 `claims/claims.json`，把占位内容替换成你的真实主张。
+
+主张是你内容的灵魂。每条内容都服务于至少一个主张。角度和案例会在日常使用中逐渐积累。
+
+**示例**：
+
+```json
+[
+  {
+    "id": "cl001",
+    "name": "知识不付费",
+    "description": "知识付费本质是贩卖焦虑。真正有价值的知识应该免费获取，付费的应该是服务和陪伴，不是知识本身。"
+  },
+  {
+    "id": "cl002",
+    "name": "工具不神话",
+    "description": "任何工具（包括 AI）都不值得神话。工具是手段不是目的，关键是用工具的人有没有把事情搞清楚。"
+  }
+]
+```
+
+---
+
+## 各能力快速入门
+
+### 热榜 — 看当前什么话题热
+
+```bash
+# 拉社会类热榜 top 20
+9000ai search hot --type society --count 20
+```
+
+常用榜单类型：`hot`（综合）、`society`（社会）、`entertainment`（娱乐）、`tech`（科技）
+
+### 搜索 — 按关键词找内容
+
+```bash
+# 搜索关键词，最近 7 天，综合排序
+9000ai search keyword "知识付费" --sort 0 --time 7
+```
+
+结果自动存到 `output/` 目录
+
+### 对标监控 — 盯住你的对标账号
+
+```bash
+# 查看已有监控目标
+9000ai monitor list-creators
+
+# 提交监控任务
+9000ai monitor submit --json-file <配置文件>
+
+# 查看执行历史
+9000ai monitor list-runs
+```
+
+### 视频转文字
+
+```bash
+# 提交转写任务
+9000ai transcribe submit --json-file <视频列表>
+
+# 查看任务状态
+9000ai task status --task-id <id>
+
+# 获取转写结果
+9000ai transcribe text --task-id <id>
+```
+
+### 查看任务状态
+
+```bash
+9000ai task status --task-id <id>
+9000ai task results --task-id <id>
+```
+
+---
+
+## 内容创作场景指南
+
+### 场景 A：热点来了，快速出内容
+
+1. `9000ai search hot` 拉热榜
+2. 看到热点，问 agent：「这个热点能挂到我的哪个主张上？」
+3. Agent 提取关键词 → 匹配 angles.jsonl 的 tags
+4. 命中角度 → 推荐角度 + 拉历史案例
+5. 没命中 → 基于主张推 2-3 个新角度，你选一个，写回 angles.jsonl
+6. 录制完成 → 记录到 outputs.jsonl
+
+### 场景 B：投喂素材，积累弹药
+
+1. 把会议记录、文章、视频链接丢进 `inbox/`
+2. 告诉 agent：「处理 inbox」
+3. Agent 自动提取案例和观点 → 写入 `claims/cases.jsonl`
+4. 原始文件归档到 `inbox/processed/`
+
+### 场景 C：围绕主题做批量选题调研
+
+1. `9000ai search keyword "关键词"` 搜索目标内容
+2. 结果落到 output 文件
+3. 挑出值得学的视频 → `9000ai transcribe submit` 转文字稿
+4. 分析文字稿 → 提取案例写入 cases.jsonl
+5. 基于积累的案例 → 规划一周选题
+
+### 场景 D：对标监控 + 持续素材积累
+
+1. `9000ai monitor create-creator` 添加对标账号
+2. 定期监控，获取最新内容
+3. 值得学的视频 → 转写 → 提取角度和案例
+4. 找对标做了但你没做的角度 → 新选题
+
+---
+
+## 常见问题
+
+**怎么重新初始化？**
+再跑一次 `/content-init`。已有文件不会被覆盖，只补全缺失的。
+
+**API 连不上？**
+1. 确认中台服务在运行
+2. `9000ai config show` 检查地址
+3. 地址有变动联系管理员，重新配置：`9000ai config set --base-url <新地址> --api-key <key>`
+
+**怎么添加新主张？**
+直接编辑 `claims/claims.json`，按格式追加，id 递增（cl002、cl003……）。
+
+**怎么看我产出了什么？**
+查看 `claims/outputs.jsonl`，每行是一条产出记录。
+
+**inbox 里的文件处理完去哪了？**
+归档到 `inbox/processed/`，不会被删除。

package/skills/9000AI-hub/init/templates/inbox/README.md

@@ -0,0 +1,26 @@
+# inbox/ — 暂存区
+
+这是你的素材投喂入口。把任何素材丢进来，agent 会自动处理。
+
+## 支持的格式
+
+| 格式 | 典型用途 |
+|------|---------|
+| .txt | 会议记录、语音转写稿、随笔 |
+| .md | 文案、文章、分析笔记 |
+| .json | 结构化数据 |
+| .url / 含链接的文本 | 视频链接（agent 会调用视频转文字） |
+
+## 处理流程
+
+1. 你丢文件进来
+2. Agent 自动识别类型，提取主张相关的案例、观点、事件
+3. 提取结果写入 claims/ 对应文件
+4. 原始文件归档到 inbox/processed/
+5. Agent 向你汇报处理结果
+
+## 注意
+
+- 一次可以丢多个文件，agent 会并行处理
+- 不用担心格式，agent 会自己判断
+- 处理后的原始文件不会被删除，会归档到 processed/ 子目录

package/skills/9000AI-hub/init/templates/profile/identity.md

@@ -0,0 +1,8 @@
+# 身份
+
+（待填写）
+
+- 你是谁
+- 做什么业务
+- 目标受众是谁
+- 你的商业模式

package/skills/9000AI-hub/init/templates/profile/product.md

@@ -0,0 +1,26 @@
+# 产品与业务
+
+（待填写）
+
+## 产品是什么
+
+- 解决什么问题
+- 目标用户是谁
+
+## 交付形式
+
+- 社群 / 咨询 / 工具 / 课程 / 其他
+
+## 定价结构
+
+- 主力产品及价格
+- 引流产品（低价或免费）
+
+## 核心卖点
+
+- 与竞品的差异化在哪
+- 用户买单的核心理由
+
+## 业务边界
+
+- 不做什么（明确拒绝的模式）

package/skills/9000AI-hub/init/templates/profile/topics.md

@@ -0,0 +1,7 @@
+# 关注领域
+
+（待填写）
+
+- 主攻方向
+- 细分赛道
+- 不碰的领域

package/skills/9000AI-hub/init/templates/profile/voice.md

@@ -0,0 +1,8 @@
+# 表达风格
+
+（待填写）
+
+- 语气：直接/温和/犀利
+- 常用句式
+- 禁忌用语
+- 参考博主风格

package/skills/9000AI-hub/init/templates/projects/README.md

@@ -0,0 +1,5 @@
+# projects/ — 选题项目
+
+每个子目录是一个选题项目。
+
+项目由 agent 在内容工作流中创建，也可以手动建。一个选题对应一个项目目录，里面存放该选题的素材、草稿、产出记录。

package/skills/9000AI-hub/references/env.example

@@ -0,0 +1,5 @@
+# 9000AI hub common env
+# 推荐用 CLI 初始化，环境变量作为备用覆盖手段：
+#   9000ai config set --base-url http://192.168.x.x:8025 --api-key sk-xxx
+9000AI_BASE_URL=http://127.0.0.1:8025
+9000AI_API_KEY=sk-xxx

package/skills/9000AI-hub/references/runner-spec-v1.md

@@ -0,0 +1,138 @@
+# 9000AI Runner Spec v1
+
+## 目标
+
+`runner spec v1` 用来统一 9000AI skill 的执行底座。
+这一版只解决最重复的执行问题：
+
+- 本地配置读取
+- 环境变量解析
+- `X-API-Key` 鉴权注入
+- HTTP 请求发送
+- 异步任务提交与查询
+- 结果文件落盘
+- 统一 JSON 输出
+
+这一版不解决：
+
+- 通用 DSL
+- 动态插件发现
+- MCP 协议抽象
+- 跨模块编排
+
+## 分层
+
+- `SKILL.md`
+  - 给 agent 看的说明书
+  - 负责模块目录、使用规则、主命令
+- `skill script`
+  - 负责命令行参数解析
+  - 负责把模块动作映射到 runner
+- `9000AI-hub-9000AI/shared/runner.py`
+  - 负责统一执行
+- `9000AIToolBox`
+  - 负责真正业务执行、任务状态、权限、结果
+
+## ModuleSpec 最小字段
+
+每个 skill 至少提供一份模块规范：
+
+```python
+ModuleSpec(
+    module="douyin-topic-discovery",
+    skill_root=Path(...),
+)
+```
+
+字段说明：
+
+- `module`
+- `skill_root`
+- `default_base_url`
+- `api_key_header`
+- `timeout_seconds`
+
+## 配置解析优先级
+
+统一优先级：
+
+1. 命令行参数
+2. `9000AI_BASE_URL` / `9000AI_API_KEY`
+3. `<skill>/local/config.json`
+4. 默认值
+
+本地配置格式统一为：
+
+```json
+{
+  "base_url": "http://127.0.0.1:8025",
+  "api_key": "sk-xxx"
+}
+```
+
+## 统一执行接口
+
+`9000AI-hub-9000AI/shared/runner.py` v1 提供：
+
+- `configure_stdout_encoding()`
+- `load_local_config(spec)`
+- `save_local_config(spec, base_url, api_key)`
+- `resolve_base_url(spec, override)`
+- `resolve_api_key(spec, override)`
+- `load_json_file(path)`
+- `request_json(spec, method, base_url, api_key, path, payload=None)`
+- `ensure_output_dir(spec)`
+- `print_json(payload)`
+
+## 统一输出协议
+
+runner 输出统一遵守：
+
+```json
+{
+  "status": "submitted|running|completed|failed|partial_success",
+  "message": "",
+  "task_id": null,
+  "batch_id": null,
+  "artifacts": [],
+  "data": {}
+}
+```
+
+## 异步任务规范
+
+- `submit`
+  - 立即返回 `submitted`
+  - 返回 `task_id` 或 `batch_id`
+- `result`
+  - 单独查询结果
+- 不在 `submit` 内部长时间等待
+
+## 结果落盘规范
+
+每个 skill 的本地结果统一放在：
+
+```text
+<skill-name>/output/
+```
+
+推荐文件名：
+
+- `latest_*.json`
+- `latest_*.tsv`
+
+必要时保留带时间戳快照：
+
+- `latest_*_YYYYMMDD_HHMMSS.json`
+- `latest_*_YYYYMMDD_HHMMSS.tsv`
+
+## 迁移顺序
+
+1. `douyin-topic-discovery-9000AI`
+2. `douyin-monitor-9000AI`
+3. `video-transcription`
+
+原因：
+
+- 选题发现同时覆盖同步请求、异步批次、结果落盘
+- 最适合作为共享 runner 的样板模块

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

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

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

@@ -0,0 +1,135 @@
+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))