scriptoriumadmin/ReMe
1
0
Fork 0
mirror of https://github.com/agentscope-ai/ReMe.git synced 2026-08-28 05:25:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11
ReMe/github-pages
History
jinliyl 87187c1d25
ci: organize GitHub automation (#466)
2026-08-20 15:56:30 +08:00
..
public docs: add standalone GitHub Pages site (#448) 2026-08-12 11:55:35 +08:00
scripts feat: add DSH memory integration and organize extensions (#461) 2026-08-20 15:31:51 +08:00
src fix: harden the 0.4.1.7 release configuration (#456) 2026-08-13 17:22:00 +08:00
tests fix: harden the 0.4.1.7 release configuration (#456) 2026-08-13 17:22:00 +08:00
.gitignore docs: add standalone GitHub Pages site (#448) 2026-08-12 11:55:35 +08:00
index.html docs: add standalone GitHub Pages site (#448) 2026-08-12 11:55:35 +08:00
package-lock.json fix(docs): use public npm registry for Pages (#449) 2026-08-12 12:03:19 +08:00
package.json fix: harden the 0.4.1.7 release configuration (#456) 2026-08-13 17:22:00 +08:00
README.md ci: organize GitHub automation (#466) 2026-08-20 15:56:30 +08:00
vite.config.js docs: add standalone GitHub Pages site (#448) 2026-08-12 11:55:35 +08:00

README.md

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 website/.

Requirements

  • Node.js 22.13 or newer
  • npm

Local development

From the repository root:

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:

npm ci

Preview the production build

Build and start the preview server:

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
  • website/README.md and website/README_ZH.md: ReMe Studio guide
  • plugins/*/README*.md: plugin and research workflow guides
  • benchmark/{beam,longmemeval,pibench,toolmemory}/README*.md: benchmark guides and results
  • skills/reme_memory/SKILL.md: ReMe Memory skill guide
  • AGENTS.md: repository development guide

To add or reorganize a document in the site navigation, update scripts/generate-content.mjs. Presentation and interaction code lives in src/.

Project structure

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: