A one-click local interactive learning web app with topic memory, session-based guidance, local persistence, backup restore, and bilingual UI.
This repository now includes a local interactive learning app that can actually be launched and used, instead of only storing prompts or workflow ideas.
The current recommended app is under:
local-app/
- Windows:
local-app/start-interactive.bat - macOS:
local-app/start-interactive.command - Linux:
local-app/start-interactive.sh
local-app/src/server.one-click.backup-import.tslocal-app/public/index.i18n.htmllocal-app/public/app.i18n.js
- one-click local launch
- browser opens automatically
- topic creation and switching
- session-based interaction flow
- answer submission and session summary update
- topic profile sync
- local file persistence to
local-app/data/state.json - export backup JSON
- import backup JSON and restore state
- Chinese / English interface switch
- provider switch:
mock,openai-responses,oauth-backend
- Open the
local-app/folder. - Run one of the launchers:
start-interactive.batstart-interactive.commandstart-interactive.sh
- On first run, the launcher will:
- create
.envfrom.env.exampleif needed - install dependencies if needed
- start the local server
- open the browser automatically
- create
- Keep the provider on
mockfor your first test. - Create a topic.
- Click Start Session.
- Answer the generated questions.
- Submit the answer.
- Watch the session summary and topic profile update.
- Export a backup if you want to save a snapshot.
- Import a backup later if you want to restore the state.
No setup required. Use this first to verify that the interaction flow feels right.
Put the following into .env:
OPENAI_API_KEY=your_key
OPENAI_MODEL=gpt-5Optional:
OPENAI_BASE_URL=https://api.openai.com/v1Then restart the launcher and switch the provider in the UI to openai-responses.
Put the following into .env:
OAUTH_BACKEND_UPSTREAM=your_endpointThen restart the launcher and switch the provider in the UI to oauth-backend.
local-app/start-interactive.batlocal-app/start-interactive.commandlocal-app/start-interactive.shlocal-app/src/server.one-click.backup-import.tslocal-app/public/index.i18n.htmllocal-app/public/app.i18n.jslocal-app/README_EN.mdlocal-app/README_ZH.md
这个仓库现在已经不只是提示词或者流程设想,而是包含了一套可以直接启动使用的本地交互式学习应用。
当前推荐使用的目录是:
local-app/
- Windows:
local-app/start-interactive.bat - macOS:
local-app/start-interactive.command - Linux:
local-app/start-interactive.sh
local-app/src/server.one-click.backup-import.tslocal-app/public/index.i18n.htmllocal-app/public/app.i18n.js
- 一键本地启动
- 自动打开浏览器
- 新建主题与切换主题
- 按 session 组织的交互学习流程
- 提交回答并更新本轮沉淀
- 同步回主题档案
- 本地文件持久化到
local-app/data/state.json - 导出备份 JSON
- 导入备份 JSON 并恢复状态
- 中文 / English 界面切换
- provider 切换:
mock、openai-responses、oauth-backend
- 打开
local-app/目录。 - 运行下面任意一个启动器:
start-interactive.batstart-interactive.commandstart-interactive.sh
- 第一次启动时,脚本会自动:
- 在需要时从
.env.example生成.env - 在需要时安装依赖
- 启动本地服务
- 自动打开浏览器
- 在需要时从
- 第一次测试建议把 provider 保持为
mock。 - 新建一个学习主题。
- 点击“开始本轮学习”。
- 回答系统生成的问题。
- 提交回答。
- 观察本轮沉淀和主题档案如何更新。
- 需要时可以导出备份。
- 之后也可以通过导入备份恢复学习状态。
不需要额外配置。建议先用它确认交互流程是不是你真正想要的。
在 .env 中加入:
OPENAI_API_KEY=你的key
OPENAI_MODEL=gpt-5可选:
OPENAI_BASE_URL=https://api.openai.com/v1然后重新启动,再把页面里的 provider 切到 openai-responses。
在 .env 中加入:
OAUTH_BACKEND_UPSTREAM=你的接口地址然后重新启动,再把页面里的 provider 切到 oauth-backend。
local-app/start-interactive.batlocal-app/start-interactive.commandlocal-app/start-interactive.shlocal-app/src/server.one-click.backup-import.tslocal-app/public/index.i18n.htmllocal-app/public/app.i18n.jslocal-app/README_EN.mdlocal-app/README_ZH.md