@youdao/baoku-cli 0.0.1

package/README.md

@@ -0,0 +1,108 @@
+# baoku-cli
+
+有道宝库命令行工具 -- 知识库管理、内容生成（PPT/播客/脑图/信息图/文档翻译）、知识库问答。主要面向 AI Agent 调用，也可人工使用。
+
+## 安装
+
+```bash
+npm install -g @youdao/baoku-cli
+```
+
+或从源码编译：
+
+```bash
+make build
+sudo cp baoku /usr/local/bin/
+```
+
+## 快速开始
+
+```bash
+# 授权（浏览器登录）
+baoku config init
+
+# 一步生成 PPT
+baoku generate ppt --file report.pdf
+
+# 知识库问答
+baoku chat --project-id <id> --message "核心观点是什么？"
+```
+
+## 命令一览
+
+| 命令 | 说明 |
+|------|------|
+| `baoku config init` | 浏览器授权，或 `--api-key` 手动配置 |
+| `baoku config show` | 查看当前配置 |
+| `baoku project create/list/get` | 知识库管理 |
+| `baoku source add/list/status/delete` | 来源管理（文件/URL/文本） |
+| `baoku generate ppt/podcast/mindmap/infographic/doctran` | 内容生成 |
+| `baoku generate options` | 查看可用生成选项（模板、音色等） |
+| `baoku task status` | 查询生成任务状态 |
+| `baoku chat` | 知识库问答 |
+
+输出格式：`--format json`（默认，Agent 友好）或 `--format pretty`（人类友好）。
+
+## 开发
+
+**依赖**: Go 1.22+
+
+```bash
+make build           # 编译
+make test            # 单元测试
+make integration-test # 集成测试
+make test-all        # 全部测试
+```
+
+### 项目结构
+
+```
+cmd/           Cobra 命令（每个命令一个文件）
+internal/
+  client/      HTTP 客户端（认证注入、重试、错误分类）
+  config/      配置管理（环境变量 → 密钥链 → 配置文件）
+  output/      JSON Envelope 输出、结构化错误、Pretty 格式
+scripts/       npm 分发与发布脚本
+skills/        Agent Skill 文档
+```
+
+### 测试
+
+集成测试使用 `httptest.Server` 模拟 Baoku API，通过 `RunContext` 注入 fake 依赖（stdout/stderr、sleep、clock、API client）。所有测试命令必须带 `-timeout 30s`，防止轮询循环挂起。
+
+```bash
+# 跑单个测试
+go test ./cmd -run TestIntegration_source_add -v -timeout 30s
+```
+
+## 发布
+
+### 1. 打 tag
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+### 2. 构建跨平台二进制
+
+```bash
+# 需要安装 goreleaser: brew install goreleaser/tap/goreleaser
+./scripts/release.sh
+```
+
+产物在 `dist/` 目录，支持 darwin/linux/windows x amd64/arm64。
+
+### 3. 发布到 npm
+
+```bash
+./scripts/publish.sh
+```
+
+自动完成：GoReleaser 编译 → 分平台 npm 包打包 → 发布 `@youdao/baoku-cli` 及 6 个平台包。
+
+### 测试构建（不发布）
+
+```bash
+./scripts/publish.sh --snapshot
+```

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@youdao/baoku-cli",
+  "version": "0.0.1",
+  "description": "Youdao Baoku CLI - knowledge base management and content generation",
+  "bin": {
+    "baoku": "scripts/run.js"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "license": "MIT",
+  "files": [
+    "scripts/run.js"
+  ],
+  "optionalDependencies": {
+    "@youdao/baoku-cli-darwin-arm64": "0.0.1",
+    "@youdao/baoku-cli-darwin-x64": "0.0.1",
+    "@youdao/baoku-cli-linux-arm64": "0.0.1",
+    "@youdao/baoku-cli-linux-x64": "0.0.1",
+    "@youdao/baoku-cli-win32-arm64": "0.0.1",
+    "@youdao/baoku-cli-win32-x64": "0.0.1"
+  }
+}

package/scripts/run.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+const { execFileSync } = require("child_process");
+const path = require("path");
+
+const PLATFORMS = {
+  "darwin-arm64": { pkg: "@youdao/baoku-cli-darwin-arm64", bin: "baoku" },
+  "darwin-x64": { pkg: "@youdao/baoku-cli-darwin-x64", bin: "baoku" },
+  "linux-arm64": { pkg: "@youdao/baoku-cli-linux-arm64", bin: "baoku" },
+  "linux-x64": { pkg: "@youdao/baoku-cli-linux-x64", bin: "baoku" },
+  "win32-arm64": { pkg: "@youdao/baoku-cli-win32-arm64", bin: "baoku.exe" },
+  "win32-x64": { pkg: "@youdao/baoku-cli-win32-x64", bin: "baoku.exe" },
+};
+
+const platformKey = `${process.platform}-${process.arch}`;
+const platform = PLATFORMS[platformKey];
+
+if (!platform) {
+  console.error(`Unsupported platform: ${platformKey}`);
+  process.exit(1);
+}
+
+let binPath;
+try {
+  const pkgDir = path.dirname(require.resolve(`${platform.pkg}/package.json`));
+  binPath = path.join(pkgDir, "bin", platform.bin);
+} catch {
+  console.error(
+    `Platform package ${platform.pkg} is not installed.\n` +
+      `Try reinstalling: npm install @youdao/baoku-cli`
+  );
+  process.exit(1);
+}
+
+try {
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (e) {
+  if (e.code === "ENOENT") {
+    console.error("baoku binary not found. Try reinstalling: npm install @youdao/baoku-cli");
+  }
+  process.exit(e.status || 1);
+}