Getting Started with Development

Development Environment Setup

Prerequisites

Node.js (v18 or later)
Python 3.12
Zotero 7.0 or later

Setting up the Development Environment

Clone the repository:

git clone https://github.com/etShaw-zh/RSSCopilot.git
cd RSSCopilot

Install dependencies:
```
npm install
```

Configure environment:

cp .env.example .env
# Edit .env with your settings

Project Structure

RSSCopilot/
├── src/              # Source code
├── addon/            # Plugin resources
├── typings/         # TypeScript type definitions
├── docs/            # Documentation

Development Workflow

Building the Plugin

npm run build

Development Mode

npm run start

Linting

npm run lint:check
npm run lint:fix

Debugging

Debug Tools

Zotero Debug Output
Browser Console
VS Code Debugger

Common Issues

Build errors
Runtime issues
Testing problems

Contributing

Code Style

ESLint configuration
Prettier settings
TypeScript guidelines

Pull Request Process

Fork the repository
Create a feature branch
Make changes
Submit PR