@zhanngning/hecode 0.7.0 → 1.0.0

package/README.md

@@ -1,287 +1,30 @@
-# Hecode
+# HeCode
 
-Your AI Coding Assistant CLI with Financial Analysis.
+AI-powered coding agent with terminal UI, based on [opencode](https://github.com/anomalyco/opencode).
 
-## Features
-
-- **Multi-Model Support**: OpenAI, Anthropic, MiMo, Ollama, and any OpenAI-compatible API
-- **Tool System**: File read/write/edit, bash execution, glob/grep search
-- **Skill System**: Loadable domain skills (coding, testing, ppt, planning, finance, etc.)
-- **Memory System**: Session, project, and global memory with search
-- **Interactive REPL**: Streaming output, slash commands, tool status display
-- **Financial Analysis**: Stock analysis, technical indicators, research reports
-
-## Install
+## Installation
 
 ```bash
-npm install -g hecode
+npm i -g @zhanngning/hecode
 ```
 
-## Quick Start
+## Usage
 
 ```bash
-# Interactive mode
 hecode
-
-# Single-shot mode
-hecode "fix the bug in src/app.ts"
-
-# Use a specific model
-hecode --model claude:sonnet "explain this code"
-
-# Use a specific skill
-hecode --skill coding "implement a sorting algorithm"
-```
-
-## Configuration
-
-Edit `~/.hecode/config.json`:
-
-```json
-{
-  "defaultModel": "openai:gpt-4o",
-  "models": {
-    "openai": { "apiKey": "sk-...", "baseUrl": "https://api.openai.com/v1" },
-    "claude": { "apiKey": "sk-ant-..." },
-    "mimo": { "apiKey": "...", "baseUrl": "https://api.mimo.xiaomi.com" },
-    "ollama": { "baseUrl": "http://localhost:11434" }
-  }
-}
-```
-
-## Supported Models
-
-| Provider | Models | Config Key |
-|----------|--------|------------|
-| OpenAI | GPT-4o, GPT-4.1, o3, o4-mini | `openai` |
-| Anthropic | Claude Sonnet 4, Claude Opus 4 | `claude` / `anthropic` |
-| MiMo | MiMo series | `mimo` |
-| Ollama | Llama, Qwen, DeepSeek, etc. | `ollama` |
-| OpenAI Compatible | Any compatible API | `openai` + custom `baseUrl` |
-
-## Built-in Tools
-
-| Tool | Description |
-|------|-------------|
-| `read_file` | Read file content with offset/limit |
-| `write_file` | Write/create files |
-| `edit_file` | Precise string replacement |
-| `bash` | Execute shell commands |
-| `glob` | File pattern matching |
-| `grep` | Content regex search |
-| `finance_analyze` | Financial analysis and research reports |
-
-## Financial Analysis
-
-Analyze stocks and generate research reports using free data sources.
-
-### Usage
-
-```bash
-# Interactive mode with finance skill
-hecode --skill finance "分析贵州茅台"
-
-# Direct tool call
-hecode "分析股票 600519"
 ```
 
-### Features
-
-- **Price Analysis**: Current price, change percentage, volume
-- **Technical Indicators**: MA5, MA10, MA20, RSI(14)
-- **Trend Detection**: Uptrend, downtrend, or neutral
-- **Research Reports**: Comprehensive Markdown reports
-
-### Supported Markets
-
-- **A-Shares**: Shanghai and Shenzhen stock exchanges
-- **HK Stocks**: Hong Kong stock exchange
-
-### Prerequisites
-
-Install Python and akshare:
-
-```bash
-pip install akshare pandas
-```
-
-### Example Output
-
-```
-# 贵州茅台 (600519) 研究报告
-
-## 价格信息
-- 当前价格: ¥1168.63
-- 涨跌幅: -1.3%
-
-## 技术分析
-- 5日均线: ¥1180.25
-- RSI(14): 45.32
-- 趋势信号: 中性
-```
-
-## REPL Commands
-
-| Command | Description |
-|---------|-------------|
-| `/help` | Show help |
-| `/clear` | Clear conversation |
-| `/history` | Show message count |
-| `/save` | Save session |
-| `/session` | Show session ID |
-| `/exit` | Exit Hecode |
-
-## Skill System
-
-Hecode uses a skill-based architecture to handle different tasks. Each skill provides specialized instructions for specific domains.
-
-### Built-in Skills
-
-| Skill | Trigger Words | Description |
-|-------|---------------|-------------|
-| `coding` | code, fix, debug, refactor, implement, write, create, build | Write clean, minimal code following best practices |
-| `testing` | test, testing, unit test, integration test, e2e, TDD, BDD | Write tests, test-driven development |
-| `code-review` | review, code review, 审查, 代码审查, check code | Review code for quality, bugs, and improvements |
-| `docs` | docs, documentation, 文档, readme, api doc, 注释 | Generate documentation and comments |
-| `git` | git, commit, pr, pull request, merge, branch | Git workflow assistance |
-| `explain` | explain, 解释, 说明, understand, what does | Explain complex code in simple terms |
-| `refactor` | refactor, 重构, optimize, 优化, improve, clean | Improve code quality while preserving behavior |
-| `security` | security, 安全, vulnerability, 漏洞, audit | Identify and fix security vulnerabilities |
-| `perf` | performance, 性能, optimize, speed, slow, benchmark | Performance optimization |
-| `content` | content, 内容, 文章, article, blog, 博客, 公众号 | Content creation for various platforms |
-| `data-analysis` | data, 数据, analysis, 分析, chart, 图表, visualization | Data analysis and visualization |
-| `translate` | translate, 翻译, 英文, 中文, english, chinese | Translation between languages |
-| `ppt` | ppt, presentation, slides, 演示, 幻灯片, 汇报 | Create professional presentations |
-| `planning` | plan, planning, project, roadmap, 项目, 计划, 规划 | Create project plans and roadmaps |
-| `finance` | finance, 股票, 金融, 研究报告, stock | Financial analysis and research reports |
-
-### Skill Details
-
-#### Coding Skill
-Write production-ready code with:
-- Clean, minimal implementations
-- Follow existing project conventions
-- Proper error handling
-- Type safety
-
-```bash
-hecode --skill coding "implement user authentication with JWT"
-hecode --skill coding "refactor the database connection module"
-hecode --skill coding "fix the memory leak in the event handler"
-```
-
-#### Testing Skill
-Comprehensive testing support:
-- Unit tests, integration tests, E2E tests
-- TDD workflow (Red-Green-Refactor)
-- Mocking and test fixtures
-- Coverage analysis
-
-```bash
-hecode --skill testing "write unit tests for the payment service"
-hecode --skill testing "create integration tests for the API"
-hecode --skill testing "help me practice TDD for a sorting algorithm"
-```
-
-#### PPT Skill
-Create professional presentations:
-- Title slides, content slides, data slides
-- Consistent design and formatting
-- Charts and visualizations
-- Speaker notes
-
-```bash
-hecode --skill ppt "create a product demo presentation"
-hecode --skill ppt "make a quarterly business review deck"
-hecode --skill ppt "设计一个技术分享PPT"
-```
-
-#### Planning Skill
-Project planning and management:
-- Project scope and objectives
-- Timeline and milestones
-- Task breakdown and dependencies
-- Risk assessment
-
-```bash
-hecode --skill planning "create a project plan for the new feature"
-hecode --skill planning "制定Q3季度开发计划"
-hecode --skill planning "create a roadmap for the next 6 months"
-```
-
-#### Financial Analysis Skill
-Stock analysis and research reports:
-- Real-time price data (A-shares, HK stocks)
-- Technical indicators (MA, RSI, MACD)
-- Trend analysis and signals
-- Comprehensive research reports
-
-```bash
-hecode --skill finance "分析贵州茅台"
-hecode --skill finance "analyze stock 600519"
-hecode --skill finance "生成腾讯研究报告"
-```
-
-### Custom Skills
-
-Create your own skills by adding a `SKILL.md` file in `skills/<name>/`:
-
-```markdown
-# My Custom Skill
-
-trigger: keyword1, keyword2, 关键词
-
-## Instructions
-
-You are an expert in [domain]. When helping users:
-
-1. First understand the requirement
-2. Provide step-by-step guidance
-3. Use relevant tools
-4. Verify the result
-
-## Example
-
-User: "help me with X"
-Assistant: [detailed response following the skill instructions]
-```
-
-### Skill Selection
-
-Skills are automatically matched based on:
-- User input keywords
-- Context analysis
-- Explicit `--skill` flag
-
-If no skill matches, the default coding behavior is used.
-
-## Development
+## Features
 
-```bash
-git clone <repo-url>
-cd hecode
-npm install
-npm run dev      # Run in dev mode
-npm test         # Run tests
-npm run build    # Build for production
-npm run lint     # Type check
-```
+- Terminal UI (TUI) for interactive coding sessions
+- Multi-provider AI support (Anthropic, OpenAI, Google, etc.)
+- Tool use (file editing, bash commands, web search, etc.)
+- Session management with persistent history
+- Plugin system for extensibility
 
-## Project Structure
+## Based On
 
-```
-hecode/
-├── src/
-│   ├── core/          # Core engine (orchestrator, types)
-│   ├── tools/         # Built-in tools
-│   ├── models/        # Multi-model providers
-│   ├── memory/        # Session/project/global memory
-│   ├── skills/        # Skill loader
-│   └── cli/           # CLI entry, REPL, commands
-├── skills/            # Built-in skill definitions
-├── tests/             # Unit tests
-└── dist/              # Build output
-```
+This project is based on [opencode](https://github.com/anomalyco/opencode) with custom modifications.
 
 ## License
 

package/bin/hecode

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require("../dist/index.js")