qianshou 3.1.3

package/README_EN.md

@@ -0,0 +1,396 @@
+<h1 align="center">Qianshou</h1>
+
+<p align="center">
+  <strong>AI Agent Application for Office Professionals.</strong><br>
+  Understand project documentation and codebases. Plan complex tasks. Execute autonomously.<br>
+  Your terminal AI teammate.
+</p>
+
+<p align="center">
+  <a href="https://zyinfo.pro/qianshou/">📖 Official Documentation</a> •
+  <a href="#installation">🚀 Quick Start</a> •
+  <a href="#configuration">⚙️ Configuration Guide</a>
+</p>
+
+---
+
+## Table of Contents
+
+- [What is Qianshou](#what-is-qianshou)
+- [Core Features](#core-features)
+- [Installation](#installation)
+- [Configuration](#configuration)
+- [Quick Start](#quick-start)
+- [Usage](#usage)
+- [Experimental Features](#experimental-features)
+
+---
+
+## What is Qianshou
+
+Qianshou is an **agent-based coding tool** that runs in your terminal. Unlike traditional code completion tools, Qianshou can understand your entire codebase, plan complex multi-step tasks, and execute them autonomously.
+
+Think of it as an AI teammate that can:
+- Read and understand large-scale projects
+- Break down complex requirements into executable steps
+- Write, modify, and refactor code across multiple files
+- Run terminal commands and manage Git workflows
+- Explain code logic and generate documentation
+
+**Learn more:** [https://zyinfo.pro/qianshou/](https://zyinfo.pro/qianshou/)
+
+---
+
+## Core Features
+
+### 🧠 Agent-Based Coding
+
+Qianshou runs as an **autonomous agent**, not just a passive assistant. When you give it a high-level goal like "add OAuth user authentication," it will:
+
+1. **Understand Intent** - Analyze your natural language request
+2. **Scan Context** - Read relevant files and understand project structure
+3. **Create Plan** - Break down the task into clear, actionable steps
+4. **Execute** - Implement each step with your approval
+5. **Iterate** - Report progress and seek clarification when needed
+
+### 📚 Codebase-Level Understanding
+
+With support for **200K+ token context windows**, Qianshou can analyze entire projects at once. It understands:
+- Project structure and module dependencies
+- Coding patterns and design conventions
+- Cross-file relationships and architectural decisions
+
+### 🔧 Deep Code Analysis
+
+- **Explain Complex Code** - Get detailed explanations of functions, algorithms, and logic flows
+- **Trace Function Calls** - Follow execution paths through the codebase
+- **Identify Issues** - Detect performance bottlenecks, security vulnerabilities, and potential bugs
+- **Smart Refactoring** - Execute large-scale, cross-file code transformations
+
+### ⚡ Workflow Automation
+
+Qianshou seamlessly integrates with your development workflow:
+
+- **Run Terminal Commands** - Execute `npm install`, run tests, build Docker images
+- **Git Integration** - Search commit history, resolve merge conflicts, generate commit messages
+- **Test Generation** - Automatically create comprehensive unit and integration tests
+- **Documentation Generation** - Generate API docs, code comments, and README files
+
+### 🔌 Extensible Architecture
+
+- **MCP Protocol** - Connect external tools and APIs via Model Context Protocol
+- **Custom Skills** - Write your own commands and workflows
+- **Plugin System** - Extend functionality with community plugins
+- **IDE Agnostic** - Works with any editor (VS Code, JetBrains, Vim, etc.)
+
+### 🌐 Browser Automation
+
+Qianshou supports browser automation with deep Chrome integration:
+
+- **Web Interaction** - Auto-click elements, fill forms, capture screenshots
+- **Tab Management** - Read and control browser tabs
+- **Console Logs** - Read browser console logs and network requests
+- **OAuth Auth** - Support for sites requiring login state
+
+**Enable with:**
+```bash
+# Start with --chrome flag
+qianshou --chrome
+
+# Or set environment variable
+export QS_ENABLE_CFC=1
+qianshou
+```
+
+**Prerequisites:**
+- Requires [Qianshou Chrome Extension](https://clau.de/chrome)
+- Supports Chrome, Brave, Edge, and other Chromium browsers
+
+---
+
+## Installation
+
+> **Detailed Installation Guide:** [https://zyinfo.pro/qianshou/](https://zyinfo.pro/qianshou/)
+
+### Windows Installation
+
+Open PowerShell terminal in Windows Terminal (right-click Windows button, click "Terminal"), then execute:
+
+```powershell
+# Install Git (or visit https://git-scm.com/install/windows for alternative methods)
+winget install --exact --source winget --id Git.Git
+
+# Install Node.js (or visit https://nodejs.org/en/download for alternative methods)
+winget install --exact --source winget --id OpenJS.NodeJS
+
+# Set script execution policy
+Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
+
+# Close terminal window, open a new terminal window, then install Qianshou
+npm install -g qianshou --registry=https://registry.npmmirror.com
+
+# Initialize configuration
+node --eval "
+const homeDir = os.homedir();
+const filePath = path.join(homeDir, '.claude.json');
+if (fs.existsSync(filePath)) {
+  const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+  fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8');
+} else {
+  fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }), 'utf-8');
+}"
+```
+
+### macOS/Linux Installation
+
+```bash
+npm install -g qianshou
+```
+
+### System Requirements
+
+- **Runtime**: [Node.js](https://nodejs.org/) or [Bun](https://bun.sh) >= 1.3.11
+- **Operating System**: macOS, Linux, or Windows (WSL recommended)
+- **Authentication**: API keys for your chosen provider
+
+---
+
+## Configuration
+
+> **More Configuration Examples:** [https://zyinfo.pro/qianshou/](https://zyinfo.pro/qianshou/)
+
+Qianshou natively supports multiple AI providers. Simply set the appropriate environment variables to switch providers.
+
+### Zhipu GLM (Recommended)
+
+```bash
+export QS_AUTH_TOKEN="your-zhipu-api-key"
+export QS_BASE_URL=https://open.bigmodel.cn/api/anthropic
+export API_TIMEOUT_MS="3000000"
+export QS_DISABLE_NONESSENTIAL_TRAFFIC=1
+export QS_SMALL_MODEL="glm-4.5-air"
+export QS_MIDDLE_MODEL="glm-4.7"
+export QS_BIG_MODEL="glm-5.1"
+export QS_MODEL="glm-5.1"
+export ENABLE_TOOL_SEARCH=false
+
+# Enter your working directory
+cd your-work-directory
+
+# Start Qianshou (bypassPermissions mode auto-approves all actions)
+qianshou --permission-mode bypassPermissions
+```
+
+### Alibaba Cloud Tongyi Qianwen
+
+```bash
+export QS_AUTH_TOKEN="your-aliyun-api-key"
+export QS_BASE_URL="https://coding.dashscope.aliyuncs.com/apps/anthropic"
+export API_TIMEOUT_MS=600000
+export QS_MODEL="qwen-max"
+export QS_BIG_MODEL="qwen-max"
+export QS_MIDDLE_MODEL="qwen-plus"
+export QS_SMALL_MODEL="qwen-turbo"
+
+qianshou --permission-mode bypassPermissions
+```
+
+### DeepSeek
+
+```bash
+export QS_BASE_URL=https://api.deepseek.com/anthropic
+export QS_AUTH_TOKEN=sk-your-deepseek-key
+export API_TIMEOUT_MS=600000
+export QS_MODEL=deepseek-chat
+export QS_SMALL_FAST_MODEL=deepseek-chat
+export QS_DISABLE_NONESSENTIAL_TRAFFIC=1
+
+qianshou --permission-mode bypassPermissions
+```
+
+### Desktop Office Edition
+
+To handle Word, Excel, PDF and other office documents, add the following configuration:
+
+```bash
+export QS_OFFICE=1
+qianshou --permission-mode bypassPermissions
+```
+
+### Create Startup Script
+
+It's recommended to save as a startup script (Linux/macOS: `.sh`, Windows: `.bat`) for convenience:
+
+**Linux/macOS (qianshou.sh):**
+```bash
+#!/bin/bash
+export QS_AUTH_TOKEN="your-api-key"
+export QS_BASE_URL="https://open.bigmodel.cn/api/anthropic"
+export QS_MODEL="glm-5.1"
+export QS_BIG_MODEL="glm-5.1"
+export QS_MIDDLE_MODEL="glm-4.7"
+export QS_SMALL_MODEL="glm-4.7"
+cd "$1"
+qianshou --permission-mode bypassPermissions
+```
+
+**Windows (qianshou.bat):**
+```batch
+@echo off
+set QS_AUTH_TOKEN=your-api-key
+set QS_BASE_URL=https://open.bigmodel.cn/api/anthropic
+set QS_MODEL=glm-5.1
+set QS_BIG_MODEL=glm-5.1
+set QS_MIDDLE_MODEL=glm-4.7
+set QS_SMALL_MODEL=glm-4.7
+cd /d %1
+qianshou --permission-mode bypassPermissions
+```
+
+### AGENTS.md Configuration
+
+You can create an `AGENTS.md` file in your project root to help AI better understand your project.
+
+---
+
+## Quick Start
+
+### Three Steps to Get Started
+
+**Step 1: Install Qianshou** (see [Installation](#installation) section above)
+
+**Step 2: Configure Authentication** (see [Configuration](#configuration) section above)
+
+**Step 3: Start Using**
+
+```bash
+# Enter your working directory
+cd your-work-directory
+
+# Start Qianshou
+qianshou --permission-mode bypassPermissions
+
+# Or use auto-confirmation mode
+qianshou --permission-mode bypassPermissions
+```
+
+### Common Startup Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `--permission-mode bypassPermissions` | Auto-approve all actions (suitable for daily use) |
+| `--auto-run` | Auto-run mode, no confirmation needed for each command |
+| `--chrome` | Enable browser automation mode |
+| `-p "prompt"` | One-shot execution mode, run command directly |
+
+### Usage Tips
+
+**Paste multi-line content:**
+- Press `Ctrl+G` to open text box, paste content and save/close
+- Or write content to a file and reference with `@filename`
+
+**Reference:** [https://zyinfo.pro/qianshou/](https://zyinfo.pro/qianshou/)
+
+---
+
+## Usage
+
+### Interactive REPL
+
+```bash
+qianshou --permission-mode bypassPermissions
+```
+
+### Conversation Examples
+
+**Implementing a new feature:**
+```
+You: Add a REST API endpoint for user registration
+
+Qianshou: I'll help you add a user registration endpoint. Let me first check your project structure...
+
+[Reading files, analyzing codebase]
+
+I'll create the following:
+1. POST /api/users/register endpoint
+2. User validation schema
+3. Database model for users
+4. Unit tests for the endpoint
+
+Shall I proceed?
+```
+
+**Debugging an issue:**
+```
+You: I'm getting a 500 error when uploading files. Here's the stack trace...
+
+Qianshou: Looking at the error and your code, the issue appears to be in the file upload handler.
+The problem is on line 42, where the buffer size is not handled properly. Let me fix this...
+```
+
+**Refactoring code:**
+```
+You: Refactor the authentication module to use JWT tokens
+
+Qianshou: I'll refactor your authentication module to use JWT. This will involve:
+1. Installing the jsonwebtoken package
+2. Creating JWT utility functions
+3. Updating login/logout handlers
+4. Adding token verification middleware
+
+[Proceeding with refactor]
+```
+
+---
+
+## Experimental Features
+
+The `build:dev:full` build enables 54 experimental feature flags. Highlights include:
+
+### Interaction & UI
+- **ULTRAPLAN** - Remote multi-agent planning
+- **ULTRATHINK** - Deep thinking mode for complex reasoning
+- **VOICE_MODE** - Push-to-talk voice input
+- **TOKEN_BUDGET** - Usage tracking and warnings
+- **HISTORY_PICKER** - Interactive prompt history
+- **QUICK_SEARCH** - Quick prompt search
+
+### Agents, Memory & Planning
+- **BUILTIN_EXPLORE_PLAN_AGENTS** - Built-in agent presets
+- **VERIFICATION_AGENT** - Task verification
+- **AGENT_TRIGGERS** - Background automation
+- **EXTRACT_MEMORIES** - Automatic memory extraction
+- **TEAMMEM** - Team memory files
+
+### Tools & Infrastructure
+- **BRIDGE_MODE** - IDE remote control bridge
+- **BASH_CLASSIFIER** - Intelligent permission decisions
+- **MCP_RICH_OUTPUT** - Enhanced MCP output
+
+### Browser Integration
+- **Claude in Chrome** - Chrome browser automation
+  - Support for auto-clicking, form filling, screenshots, and more
+  - Read console logs and network requests
+  - Works with sites requiring login state
+  - Requires [Chrome extension](https://clau.de/chrome)
+
+**Enable browser mode:**
+```bash
+# Method 1: Use --chrome flag
+qianshou --chrome
+
+# Method 2: Set environment variable
+export QS_ENABLE_CFC=1
+qianshou
+```
+
+---
+
+## Related Links
+
+- **Official Documentation:** [https://zyinfo.pro/qianshou/](https://zyinfo.pro/qianshou/)
+- **GitHub Repository:** [https://github.com/yourusername/qianshou](https://github.com/yourusername/qianshou)
+
+---
+
+**Built with ❤️ for developers who want more from their AI tools.**

package/package.json

@@ -0,0 +1,125 @@
+{
+  "name": "qianshou",
+  "version": "3.1.3",
+  "description": "Qianshou - AI 助手 /Chinese",
+  "type": "module",
+  "packageManager": "bun@1.3.11",
+  "bin": {
+    "qianshou": "./qianshou.js"
+  },
+  "files": [
+    "qianshou.js",
+    "vendor",
+    "README.md",
+    "README_en.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "bun": ">=1.3.11"
+  },
+  "scripts": {
+    "build": "bun run ./scripts/build.ts",
+    "build:dev": "bun run ./scripts/build.ts --dev",
+    "build:dev:full": "bun run ./scripts/build.ts --dev --feature-set=dev-full",
+    "compile": "bun run ./scripts/build.ts --compile",
+    "dev": "bun run ./src/entrypoints/cli.tsx"
+  },
+  "devDependencies": {
+    "@alcalzone/ansi-tokenize": "^0.3.0",
+    "@anthropic-ai/bedrock-sdk": "^0.26.4",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.87",
+    "@anthropic-ai/foundry-sdk": "^0.2.3",
+    "@anthropic-ai/mcpb": "^2.1.2",
+    "@anthropic-ai/sandbox-runtime": "^0.0.44",
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@anthropic-ai/vertex-sdk": "^0.14.4",
+    "@aws-sdk/client-bedrock": "^3.1020.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.1020.0",
+    "@aws-sdk/client-sts": "^3.1020.0",
+    "@aws-sdk/credential-provider-node": "^3.972.28",
+    "@aws-sdk/credential-providers": "^3.1020.0",
+    "@azure/identity": "^4.13.1",
+    "@commander-js/extra-typings": "^14.0.0",
+    "@growthbook/growthbook": "^1.6.5",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/api-logs": "^0.214.0",
+    "@opentelemetry/core": "^2.6.1",
+    "@opentelemetry/exporter-logs-otlp-grpc": "^0.214.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.214.0",
+    "@opentelemetry/exporter-logs-otlp-proto": "^0.214.0",
+    "@opentelemetry/exporter-metrics-otlp-grpc": "^0.214.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.214.0",
+    "@opentelemetry/exporter-metrics-otlp-proto": "^0.214.0",
+    "@opentelemetry/exporter-prometheus": "^0.214.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.214.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.214.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.214.0",
+    "@opentelemetry/resources": "^2.6.1",
+    "@opentelemetry/sdk-logs": "^0.214.0",
+    "@opentelemetry/sdk-metrics": "^2.6.1",
+    "@opentelemetry/sdk-trace-base": "^2.6.1",
+    "@opentelemetry/semantic-conventions": "^1.40.0",
+    "@smithy/core": "^3.23.13",
+    "@smithy/node-http-handler": "^4.5.1",
+    "@types/bun": "^1.3.11",
+    "ajv": "^8.18.0",
+    "asciichart": "^1.5.25",
+    "auto-bind": "^5.0.1",
+    "axios": "^1.14.0",
+    "bidi-js": "^1.0.3",
+    "cacache": "^20.0.4",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "cli-boxes": "^4.0.1",
+    "cli-highlight": "^2.1.11",
+    "code-excerpt": "^4.0.0",
+    "diff": "^8.0.4",
+    "emoji-regex": "^10.6.0",
+    "env-paths": "^4.0.0",
+    "execa": "^9.6.1",
+    "fflate": "^0.8.2",
+    "figures": "^6.1.0",
+    "fuse.js": "^7.1.0",
+    "get-east-asian-width": "^1.5.0",
+    "google-auth-library": "^10.6.2",
+    "highlight.js": "^11.11.1",
+    "https-proxy-agent": "^8.0.0",
+    "ignore": "^7.0.5",
+    "indent-string": "^5.0.0",
+    "ink": "^6.8.0",
+    "jsonc-parser": "^3.3.1",
+    "lodash-es": "^4.17.24",
+    "lru-cache": "^11.2.7",
+    "marked": "^17.0.5",
+    "p-map": "^7.0.4",
+    "picomatch": "^4.0.4",
+    "plist": "^3.1.0",
+    "proper-lockfile": "^4.1.2",
+    "qrcode": "^1.5.4",
+    "react": "^19.2.4",
+    "react-reconciler": "^0.33.0",
+    "semver": "^7.7.4",
+    "sharp": "^0.34.5",
+    "shell-quote": "^1.8.3",
+    "signal-exit": "^4.1.0",
+    "stack-utils": "^2.0.6",
+    "strip-ansi": "^7.2.0",
+    "supports-hyperlinks": "^4.4.0",
+    "tree-kill": "^1.2.2",
+    "turndown": "^7.2.2",
+    "type-fest": "^5.5.0",
+    "typescript": "^6.0.2",
+    "undici": "^7.24.6",
+    "usehooks-ts": "^3.1.1",
+    "vscode-jsonrpc": "^8.2.1",
+    "vscode-languageserver-protocol": "^3.17.5",
+    "vscode-languageserver-types": "^3.17.5",
+    "wrap-ansi": "^10.0.0",
+    "ws": "^8.20.0",
+    "xss": "^1.0.15",
+    "xxhash-wasm": "^1.1.0",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  }
+}