@dawnswwwww/zhihu-cli 0.1.1

package/README.md

@@ -0,0 +1,102 @@
+# zhihu-cli
+
+CLI for the [Zhihu Open Platform API](https://developer.zhihu.com).
+
+Supports authentication, Zhihu search, global web search, and the Zhida chat completion API.
+
+## Installation
+
+### From npm (recommended for Agent environments)
+
+```bash
+npm install -g @dawnswwwww/zhihu-cli
+zhihu --help
+```
+
+### From Homebrew
+
+```bash
+brew tap dawnswwwww/tap
+brew install zhihu-cli
+```
+
+### From crates.io
+
+```bash
+cargo install zhihu-cli
+```
+
+### From GitHub Releases
+
+Download the prebuilt archive for your platform from the [Releases](https://github.com/dawnswwwww/zhihu-cli/releases) page, extract it, and place the `zhihu` binary in your `PATH`.
+
+## Quick start
+
+```bash
+# Authenticate with your Access Secret
+zhihu auth login
+
+# Or set it directly
+zhihu auth set-secret <YOUR_ACCESS_SECRET>
+
+# Search Zhihu
+zhihu search zhihu "Rust 入门" --count 5
+
+# Search the whole web
+zhihu search global "Rust 入门" --count 5
+
+# Ask Zhida
+zhihu ask "Rust 和 Go 怎么选？" --model thinking
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `zhihu auth login` | Interactive login (reads secret from stdin). |
+| `zhihu auth set-secret <SECRET>` | Save Access Secret directly. |
+| `zhihu auth status` | Show authentication status. |
+| `zhihu search zhihu <QUERY>` | Search within Zhihu. |
+| `zhihu search global <QUERY>` | Search the whole web. |
+| `zhihu ask <QUERY>` | Ask Zhida. Use `--model fast/thinking/agent` and `--stream`. |
+
+Run `zhihu --help` or `zhihu <command> --help` for details.
+
+## Configuration
+
+The CLI stores configuration (including the Access Secret) under the user's config directory, typically:
+
+- macOS/Linux: `~/.config/zhihu-cli/config.toml`
+- Windows: `%APPDATA%\zhihu-cli\config.toml`
+
+You can also override the secret at runtime with the `ZHIHU_ACCESS_SECRET` environment variable.
+
+## Development
+
+```bash
+# Run tests
+make test
+
+# Lint
+make lint
+
+# Full local CI check
+make check
+```
+
+See [docs/development.md](docs/development.md) for the full workflow.
+
+## Release
+
+Pushing a SemVer tag triggers the release workflow:
+
+```bash
+git tag -a v0.1.1 -m "Release 0.1.1"
+git push origin v0.1.1
+```
+
+This builds cross-platform binaries, creates a GitHub Release, publishes `zhihu-cli` to npm, and updates the Homebrew tap.
+
+## License
+
+[MIT](LICENSE)

package/bin/zhihu.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process');
+
+const platform = process.platform;
+const arch = process.arch;
+const packageName = `@dawnswwwww/zhihu-cli-${platform}-${arch}`;
+
+let binaryPath;
+try {
+  binaryPath = require.resolve(`${packageName}/bin/zhihu${platform === 'win32' ? '.exe' : ''}`);
+} catch (e) {
+  console.error(`zhihu-cli: unsupported platform ${platform}-${arch}`);
+  console.error('Supported platforms: darwin-x64, darwin-arm64, linux-x64, linux-arm64, win32-x64');
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), { stdio: 'inherit' });
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 0);
+  }
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@dawnswwwww/zhihu-cli",
+  "version": "0.1.1",
+  "description": "CLI for the Zhihu Open Platform API",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dawnswwwww/zhihu-cli.git"
+  },
+  "bin": {
+    "zhihu": "bin/zhihu.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@dawnswwwww/zhihu-cli-darwin-x64": "0.1.1",
+    "@dawnswwwww/zhihu-cli-darwin-arm64": "0.1.1",
+    "@dawnswwwww/zhihu-cli-linux-x64": "0.1.1",
+    "@dawnswwwww/zhihu-cli-linux-arm64": "0.1.1",
+    "@dawnswwwww/zhihu-cli-win32-x64": "0.1.1"
+  },
+  "os": ["darwin", "linux", "win32"],
+  "cpu": ["x64", "arm64"]
+}