mirror of
https://github.com/agentscope-ai/ReMe.git
synced 2026-08-28 05:25:04 +00:00
ef3f99f019
* refactor(packaging): reorganize published packages * fix(packaging): install AgentScope extra in wheel smoke * docs: align package guides and documentation site * ci(workflow): add core dependency verification step in Python package build - Add a workflow step to verify released core dependencies by installing the wheel with core extras - Assert the presence of the static index.html file to ensure proper package contents - Create and use a temporary virtual environment for isolation during verification - Keep existing artifacts upload step intact and conditional on inputs.upload_artifacts flag * fix(ci): update package installation dependencies in Windows workflow - Change pip install from editable reme_studio and core to only dev and as extras - Remove installation of reme_studio and core to streamline dependency setup - Ensure Windows CI uses the correct extras for testing environment * fix(tests): add missing commas in toml file reads in package version tests - Added trailing commas in the tomllib.loads calls for auto-fin and daily_paper configs - Ensured consistent syntax to prevent potential tuple misinterpretation - Improved readability and correctness of the test setup code * fix(packaging): protect qwenpaw releases and test Studio health
89 lines
2.9 KiB
Markdown
89 lines
2.9 KiB
Markdown
# ReMe GitHub Pages
|
|
|
|
This directory contains the standalone Vite documentation site published at <https://reme.agentscope.io>. The
|
|
GitHub Pages fallback is <https://agentscope-ai.github.io/ReMe/>. It does not depend on the ReMe Studio application in
|
|
`reme_studio/`.
|
|
|
|
## Requirements
|
|
|
|
- Node.js 22.13 or newer
|
|
- npm
|
|
|
|
## Local development
|
|
|
|
From the repository root:
|
|
|
|
```bash
|
|
cd github-pages
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
Open the URL printed by Vite, normally <http://localhost:5173/>. The development server watches the frontend source.
|
|
When a repository Markdown file changes, restart the development command to regenerate the documentation content.
|
|
|
|
For subsequent installs or CI-compatible dependency installation, use:
|
|
|
|
```bash
|
|
npm ci
|
|
```
|
|
|
|
## Preview the production build
|
|
|
|
Build and start the preview server:
|
|
|
|
```bash
|
|
npm run build
|
|
npm run preview
|
|
```
|
|
|
|
Open the URL printed by Vite, normally <http://localhost:4173/>. Production assets use relative paths so the same build
|
|
works on both the custom domain and the GitHub Pages project path.
|
|
|
|
The generated `dist/` and `.generated/` directories are disposable build output and are excluded from Git.
|
|
|
|
## Documentation sources
|
|
|
|
The build script reads the canonical repository files directly. Do not edit generated copies under `.generated/` or
|
|
`dist/`.
|
|
|
|
- `README.md` and `README_ZH.md`: project introductions
|
|
- `docs/en/` and `docs/zh/`: English and Chinese guides
|
|
- `docs/figure/`: documentation images
|
|
- `reme_studio/README.md` and `reme_studio/README_ZH.md`: ReMe Studio guide
|
|
- `typescript/README.md` and `typescript/README_ZH.md`: TypeScript client, DeepSeek Harness, and OpenClaw integration guide
|
|
- `plugins/*/README*.md`: plugin guides
|
|
- `benchmark/{beam,longmemeval,pibench,toolmemory}/README*.md`: benchmark guides and results
|
|
- `AGENTS.md`: repository development guide
|
|
|
|
To add or reorganize a document in the site navigation, update
|
|
[`scripts/generate-content.mjs`](./scripts/generate-content.mjs). Presentation and interaction code lives in `src/`.
|
|
|
|
## Project structure
|
|
|
|
```text
|
|
github-pages/
|
|
├── index.html
|
|
├── package.json
|
|
├── scripts/
|
|
│ └── generate-content.mjs
|
|
├── src/
|
|
│ ├── main.js
|
|
│ └── styles.css
|
|
└── vite.config.js
|
|
```
|
|
|
|
## Deployment
|
|
|
|
The repository workflow `.github/workflows/deploy-docs.yml` builds this directory and publishes `dist/` to GitHub Pages.
|
|
It runs after relevant documentation or site files change on `main`, and it can also be started manually from the
|
|
GitHub Actions page.
|
|
|
|
The repository's **Settings → Pages → Build and deployment → Source** must be set to **GitHub Actions**. Its custom
|
|
domain must be set to `reme.agentscope.io`; `public/CNAME` preserves that domain in the published artifact.
|
|
|
|
Useful links:
|
|
|
|
- ReMe documentation: <https://reme.agentscope.io>
|
|
- GitHub Pages fallback: <https://agentscope-ai.github.io/ReMe/>
|
|
- ReMe repository: <https://github.com/agentscope-ai/ReMe>
|