Commit Graph

51 Commits

Author SHA1 Message Date
liyizhouAI 3bdaeaf5e7 docs: v0.3.3 - PRD rewrite + Graphiti deprecation record + deploy guide
PRD.md:
- Version bumped to v0.3.3
- Architecture diagram: Graphiti → CustomGraphBuilder
- v0.3.3 changelog: CustomGraphBuilder, deploy.sh, CDN SPA fix, COS deploy
- Infrastructure decisions table updated
- Decision log: 4 new entries for 2026-04-16
- Appendix C: Full Graphiti deprecation record (10 patch attempts, why self-built)
- Appendix D: Complete deployment workflow (backend/frontend/CDN/COS)

README.md / README-ZH.md:
- Step 1 description updated: Graphiti → custom builder with 10x concurrency
2026-04-16 13:00:13 +08:00
liyizhouAI 1fef01d979 feat: v0.3 - Manus replay + token tracking + SIGTERM fix + accelerate button
This is the v0.3 milestone commit before the v0.4 big version push.
Major themes: process replay, runtime stability, cost observability.

## New Features

- **Manus-style process replay** (frontend + backend)
  - `GET /api/simulation/<id>/replay` returns full workflow + agents + rounds + aggregate
  - `frontend/src/views/SimulationReplayView.vue` 3-column layout (workflow / actions / stats)
  - bottom scrubber with play/pause/step + 5 speed levels (0.5x-10x)
  - filters out stale actions from previous runs via latest simulation_start timestamp

- **Token usage tracking** (`backend/app/utils/token_tracker.py`)
  - process-wide stage→model→tokens counter
  - LLMClient auto-records prompt/completion tokens after each call
  - stages tagged at API entry: step1_ontology, step2_graph_build, step3_prepare, step5_report
  - `GET /api/usage/summary` for live stats + CNY cost estimate
  - `GET /api/usage/estimate-simulation` for OASIS subprocess estimation
  - pricing table for GLM/SiliconFlow/MiniMax/OpenAI/Anthropic models
  - documented as internal-use, removed from customer-facing builds

- **Step 2 "Skip & Continue" button**
  - lets user stop profile generation early and proceed with what's already generated
  - `simulation_manager.request_accelerate()` + cancel_check in oasis_profile_generator
  - new endpoint `POST /api/simulation/prepare/accelerate`

## Critical Bug Fix

- **SIGTERM no longer kills running simulation subprocess**
  - root cause: `SimulationRunner.register_cleanup()` registered SIGTERM/SIGINT/SIGHUP handlers
    that called `os.killpg` on every tracked sim child, even though spawn already used
    `start_new_session=True` to give children isolated sessions
  - fix: neutered `register_cleanup` to a no-op; `cleanup_all_simulations` itself preserved
    for explicit stop_simulation paths
  - validated: killed Flask backend twice, simulation subprocess kept running
  - impact: hot-reload backend code without interrupting in-flight simulations

## Performance & Tuning

- semaphore 30 → 100 (twitter + reddit) for higher LLM concurrency
- discovered 200 agents as memory/cost/statistical sweet spot for 8G server
  (503 agents OOMs both platforms; 200 agents fits cleanly with 95% confidence margin)

## Documentation

- **PRD.md** rewritten as v0.3 baseline (10 chapters + 2 appendices, 639 lines)
  - product positioning across 3 usage modes (one-shot / model-reuse / SaaS)
  - v0.4 roadmap: domestic platforms (douyin/wechat/xiaohongshu/weibo), fork sim, multi-tenant
  - operational lessons: HF mirror, Tencent PyPI mirror, GLM-4-Flash choice, agent count
  - decision log with dates
  - per-stage token/cost breakdown for typical 200-agent run
- **README.md / README-ZH.md** updated with replay step + Graphiti+Neo4j

## Files Touched

19 files changed, 1105 insertions(+), 246 deletions(-)
2026-04-15 09:37:22 +08:00
liyizhouAI ded715feb2 feat: merge upstream i18n + rebrand MiroFish → Foresight 先见之明
- Merge 41 upstream commits (i18n for 7 languages, security fixes, new features)
- Rebrand all MiroFish references to Foresight/先见之明 across 37 files
- Re-apply dark theme CSS overhaul (pure black/gray, no blue tints)
- Re-apply Teleport-based theme toggle (inline with brand, 20px gap)
- Restore Foresight logo and favicon
- Update GitHub links to liyizhouAI/foresight
- Update locale files, README, package.json

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-04-11 16:40:13 +08:00
666ghj fa0f6519b1 docs: rename README-EN.md to README.md as default English documentation 2026-04-02 16:52:29 +08:00
666ghj 0e9420e0f8 docs: rename README.md to README-ZH.md for Chinese documentation 2026-04-02 16:52:29 +08:00
666ghj 1536a79334 fix(readme): update Discord link to valid invite URL 2026-03-20 10:50:39 +08:00
666ghj a1ff79c0ef Update README 2026-03-05 23:22:26 +08:00
666ghj 85b03d4f0f Update README 2026-02-27 17:29:41 +08:00
666ghj c6cea12774 docs(readme): add live demo section with link to online prediction simulation for both English and Chinese README files 2026-02-27 17:27:49 +08:00
666ghj d30a0a23ef Update README 2026-02-25 16:16:24 +08:00
666ghj 040c745c86 feat(readme): add Trendshift badge to README files for repository visibility 2026-02-22 23:07:28 +08:00
666ghj 93e1a592df feat(README): add Docker badge to README files for enhanced visibility of Docker support 2026-01-22 19:03:44 +08:00
666ghj 0efd9352a0 feat(docker): add Docker support with Dockerfile, docker-compose.yml, and .dockerignore; update README for Docker deployment instructions 2026-01-22 14:35:41 +08:00
666ghj 94633e1330 refactor(README): update demo video section titles and clarify LLM API configuration instructions 2026-01-20 18:02:33 +08:00
666ghj b0e065ed20 refactor(README): update demo video section to include new financial and political prediction examples 2026-01-20 11:25:24 +08:00
666ghj 824e81e1a4 refactor(README): update demo video section titles for clarity and consistency 2026-01-20 11:21:45 +08:00
666ghj fa19242477 fix(README): update image asset for Dream of the Red Chamber demo video section 2026-01-20 11:18:35 +08:00
666ghj be2acf663d feat(README): add demo video sections for Wuhan University Public Opinion and Dream of the Red Chamber simulations; include new image asset 2026-01-20 11:17:11 +08:00
666ghj 57e72250a9 chore(README): remove note about Windows compatibility from prerequisites section. 2026-01-18 22:37:02 +08:00
BaiFu 9668ab487b
Update README.md 2026-01-09 18:18:09 +08:00
666ghj 11d39286f1 Update README 2026-01-09 18:09:01 +08:00
666ghj 08b2e78571 Update README 2026-01-09 17:46:36 +08:00
666ghj 416eb6c105 Update README 2026-01-09 17:42:04 +08:00
666ghj cf4b358ded docs(README): update Python version requirements and enhance contact section
- Changed Python version specification to indicate compatibility with versions ≥3.11 and ≤3.12.
- Renamed "Contact Us" section to "Join the Conversation" for improved engagement.
- Added a centered image of the QQ group to the contact section for better visibility.
2026-01-09 17:13:18 +08:00
666ghj b4fe7f2f03 feat(HistoryDatabase): add project detail modal for enhanced user interaction
- Implemented a modal to display detailed information about selected projects, including simulation requirements and associated files.
- Added navigation buttons within the modal for quick access to project, simulation, and report pages.
- Enhanced user experience by allowing users to view project details without leaving the main interface.
2026-01-09 15:41:35 +08:00
666ghj 9d5fad8854 Update README. 2026-01-07 16:55:59 +08:00
666ghj 8b80603325 Update README. 2025-12-30 22:40:04 +08:00
666ghj fa7ab33bc9 Add Ask DeepWiki badge to README files for enhanced visibility and user engagement. 2025-12-30 22:38:27 +08:00
666ghj abf2ba68af Update README 2025-12-24 11:05:01 +08:00
666ghj 4d242365e3 Add Shanda Group logo and acknowledgment in README files for strategic support 2025-12-24 11:03:27 +08:00
BaiFu 84f9fb73c5
Update video link description in README.md 2025-12-23 16:58:25 +08:00
BaiFu 9b231d32c9
Enhance README with project statistics section
Added project statistics section with star history chart.
2025-12-23 16:33:00 +08:00
666ghj 84113ce2f1 Update README files to open demo video link in a new tab for improved user experience. 2025-12-23 16:16:26 +08:00
666ghj e3b6a79b09 Add note about MiroFish's development environment in README files for clarity on Windows compatibility. 2025-12-23 10:58:08 +08:00
666ghj 29a95b0ae6 Add GitHub badges and version information to README files for better visibility and project tracking. 2025-12-22 19:36:08 +08:00
666ghj b669184d85 Update README files to replace demo video link with a direct URL for improved accessibility. 2025-12-22 19:25:11 +08:00
666ghj 61f1ee7ad7 Update README files to include demo video links and enhance content presentation, along with adding a new demo video image. 2025-12-22 18:48:30 +08:00
666ghj fb9a3e50f8 Update README. 2025-12-22 16:00:02 +08:00
666ghj e749931475 Enhance README files by correcting phrasing in the vision section and adding a detailed workflow section outlining the steps for graph building, environment setup, simulation, report generation, and deep interaction. 2025-12-19 16:33:19 +08:00
666ghj 593f7050f2 Update README files to clarify the description of the Python package manager by removing the reference to pip as an alternative. 2025-12-19 16:03:44 +08:00
666ghj f342eaf697 Update README files to enhance vision section and add acknowledgments for OASIS framework 2025-12-19 15:53:53 +08:00
666ghj fb3b41253f Update README 2025-12-19 14:22:11 +08:00
666ghj 4ddbb9dfd4 Update README files to remove strong tag and add line break for improved formatting 2025-12-19 14:18:10 +08:00
666ghj d787ebc649 Add English README file for MiroFish project
- Introduced a new README-EN.md file to provide English documentation for the MiroFish project.
- Included an overview of the project, vision, demo videos, quick start guide, and environment variable configuration.
- Updated the existing README.md to link to the new English documentation.
2025-12-19 14:16:42 +08:00
BaiFu 43d80c5ae1
Increase logo width in README 2025-12-19 14:01:15 +08:00
BaiFu 2c398569ef
Resize logo image to 70% width in README 2025-12-19 14:00:34 +08:00
666ghj 5a67cd3ced Update README.md to adjust logo display size for improved responsiveness 2025-12-19 13:59:36 +08:00
666ghj a47eb1eaef Refactor project structure by removing Docker support and updating environment configuration
- Deleted docker-compose.yml, backend Dockerfile, frontend Dockerfile, and nginx configuration to streamline project setup.
- Updated .env.example to reorganize LLM and ZEP API configurations for clarity and ease of use.
- Enhanced README.md to reflect changes in project structure and provide clearer setup instructions.
2025-12-19 13:58:35 +08:00
666ghj 97a64947d4 Update project license to Apache-2.0 in package.json, README.md, and pyproject.toml 2025-12-17 18:33:01 +08:00
666ghj 08688a892d Update project setup scripts and enhance README for clarity
- Modified the backend setup script to clear the virtual environment before installation.
- Improved README.md by restructuring the prerequisites section into a table for better readability.
- Added installation instructions for the `uv` package and clarified terminal requirements post-installation.
2025-12-17 18:26:09 +08:00