web.md

Web 界面

Web 模块提供受密码保护的浏览器界面，用于管理多个项目目录以及每个目录中的会话。

运行

./gradlew :web:bootRun

或构建可执行包：

./gradlew :web:bootJar
java -jar web/build/libs/web-<version>-all.jar

请使用 Gradle 生成的 bootJar。不要使用 IDE 的 “fat jar”/“包含依赖项的 jar” 功能：它会将依赖直接合并，覆盖 Spring Boot 的自动配置元数据，导致 Web 服务器无法初始化。

默认访问地址为 http://127.0.0.1:8080。

首次登录

首次启动会在 ~/.simpleCode/web-users.json 创建 admin 账户，并在启动日志中输出一次随机密码。密码仅保存为 BCrypt 哈希。

登录后，如果尚未配置 Provider 和模型，Web 会先显示初始化页面。管理员可在“管理”页面创建、重置、启用或禁用用户，并修改下次启动生效的监听端口。

配置文件

~/.simpleCode/web.json 保存 Web 监听地址、端口与共享项目目录列表：

{
  "host": "127.0.0.1",
  "port": 8080,
  "directories": []
}

项目目录、会话和用户对所有已认证用户共享。项目目录可在主页添加、下载或移除；下载会以 zip 文件导出目录内容。移除目录只移除 Web 列表项，不会删除磁盘上的项目文件或会话数据。