user ============================ 收起课程详情 的关闭按钮左边 增加眼睛睁开、关闭图标,用于隐藏下面快捷标签。标签展开时,图标为关闭,点击后隐藏快捷图标,反之 睁 开,点击后显示快捷标签。左上角资源座机左边 增加齿轮按钮,弹窗设置AI 模型配置,配置写入 backend/.env文件。AI模型配置 支持设置 openAI complete responses 和anthripic 模型,支持设置baseurl 或者全路径,填入baseUrl apikey 可以测试获取模型列表,并下拉选择模型。保存密钥配置接口通过公私钥处理,打开设置按钮时,后端根据 时 间戳生成私钥+公钥,公钥返回给前端用于对api key加密,加密内容增加时间戳,请求校验时间戳,有效期5min。后端通过私钥解析保存的api key 保证key的安全,.env中保存密钥密文,避免被拿到后进行破解,解析后的apikey放在内存中,全程不展示 密 钥明文。增加了AI 模型配置后,再为课程列表的播放清单,文件夹添加'AI'图标按钮,按钮内置提示词,可以解析该目录下所 有 课程,并为课程自动添加课程详情附件,包括课本、练习册、闪卡、音频等。具体功能后续由提示词控制。 提 示词支持配置。这个AI按钮点击后,弹出对话框,标题展示按钮id编号。弹窗内显示2个按钮:自动识别课 程 附件;修改提示词。 提示词也保存在后端对应工作目录下,/prompt/{按钮ID}.md 存储提示词。后续可以修改提示词以实现课程的自动检索。这里暂时空出 agent功能,标记todo,先通过后端调用本地已安装的agent 对nginx html目录的文件进行检索分析,读取上面的提示词,优先按照已有课程的资料规则提取课程附件。 Agent============== 动手前有几处需要你拍板。这几处决定了密钥怎么保存,以及 AI 按钮这次要做到哪一步。 先说我查到的情况: - backend/.env 已经存在,被根目录的 .gitignore 忽略,后端目前没有读取它。 - 后端虚拟环境里没有 cryptography 库。 - 本机装了这几个 agent:claude、kiro-cli、hermes。 1. .env 里的密文用什么密钥加密? 每次打开设置时生成的那对公私钥只用来传输,5 分钟后就作废。后端重启后要能把 .env 里的密文解开,还需要一把长期保存的密钥。 - 默认方案:在 Windows 上用系统自带的 DPAPI 加密,密文和当前 Windows 用户绑定,.env 拷到别的电脑或别的账号上都解不开,也不需要额外保存密钥文件。在 Linux 上改用 backend/data/ 下的一个主密钥文件。 - 另一种方案:所有平台都用主密钥文件,文件放在 backend/data/(已被 git 忽略)。 2. 浏览器端加密 浏览器自带的 Web Crypto 只能在 https、localhost 或 127.0.0.1 下使用。如果课程设置页是通过 http://192.168.x.x 打开的,就没有加密能力。 - 默认方案:能用 Web Crypto 就用;用不了时,改用我自己写的一小段 RSA-OAEP 加密代码,放在本地,不依赖 CDN。后端要在 requirements.txt 里新增 cryptography 依赖。 - 你平时是用哪个地址打开课程设置页的? 3. AI 按钮的 ID - 默认方案:这个功能用一个固定编号,比如 ai-001,所有文件夹共用同一份提示词 backend/prompt/ai-001.md。弹窗标题显示「AI · ai-001 · 文件夹名」。 - 另一种方案:每个文件夹一个 ID,用文件夹的节点 id,每个文件夹各有一份提示词。 4. agent 这次做到哪一步? 你的描述里,前面说「暂时空出,标记 todo」,后面又说「先通过后端调用本地已安装的 agent」。 - 默认方案:这次只做弹窗、提示词的查看和修改,以及后端接口。点「自动识别课程附件」时,后端把文件 夹、课程清单、nginx 目录和提示词整理好,返回「agent 未接入(TODO)」;代码里标好以后接入的位置。 - 另一种方案:现在就接一个本地 agent,比如 claude -p 或 kiro-cli 的非交互模式,让它真的去检索并添加附件。如果选这种,要告诉我用哪个 agent。 下面这些我直接按这个做,有不同意见再告诉我: - 眼睛按钮:放在课程详情关闭按钮的左边。标签显示时图标是闭眼,点一下隐藏快捷标签;隐藏时图标是睁 眼,点一下显示。这个状态会记住。 - 测试获取模型列表: - OpenAI 的 Chat Completions 和 Responses 都请求 GET {baseUrl}/models。 - Anthropic 请求 GET {baseUrl}/v1/models,请求头带 x-api-key 和 anthropic-version。 - 如果填的是完整路径,比如 …/v1/chat/completions,就自动截掉末尾的接口段,得到 baseUrl。 - apiKey:点「测试」时 apiKey 也会先加密再发给后端。页面上和接口返回里都不会出现明文,只显示「已保存」和末 4 位。末 4 位要不要显示,你也可以说不要。 你回复「按默认」也可以,或者逐条告诉我选哪个。 user ================ 1. env里密钥先不加密吧,暂时已经ignore了 2. 只在本地使用,ipad只作为客户端,不作为ai功能端。如果当前地址不是 127 localhost 则AI设置按钮不展示。 3. 暂时固定id ai-001,后续做id列表+职能标题,方便管理按钮+提示词(skill) 4. agent先通过本地claude code 或者其它命令行工具 执行命令,最终通过mcp将课程附件数据同步到当前应用中(需提前配置mcp) ,apikey不展示,可以直接填进行覆盖,不支持查看。 user ================ 现在项目开始进入规模化了,先重构下目录结构,按api agent service 等结构,整理下现有的后端python文件再进行开发。 (上次会话中断后)已经提交。现在继续。先把样式问题改了提交了。再着手AI agent部分。 user ================ 课程文件夹上的 AI按钮 改为 点击选中后才展示,不始终展示 ## 后续任务步骤 1. 课程详情眼睛按钮:显示/隐藏快捷标签,状态记在本地,单独提交。 2. AI 模型配置:资源主机左边加齿轮按钮(仅 127.0.0.1 / localhost 显示),弹窗配置 provider、baseUrl、apiKey、模型;测试获取模型列表;保存写入 backend/.env。 3. 文件夹 AI 按钮 ai-001:弹窗标题显示按钮编号,两个按钮「自动识别课程附件」「修改提示词」;提示词存 backend/prompt/ai-001.md。 4. 后端调用本地 agent(默认 claude -p)读提示词,检索 nginx html 目录,通过 MCP 把课程附件写回应用。 5. 用户在 claude 里按 daily-lesson/README.md「AI」一节配好 MCP(--scope user),在一个小文件夹上真跑一次 ai-001,按结果调提示词。 6. 后续:AI 按钮做成 ID 列表 + 职能标题;应用内 agent 直接用 AI 模型配置调模型(runner.py 里的 TODO)。 ## 规划 - 后端目录已按 api / agent / service / core / model 分层(提交 0c48e6d、f5053c8)。 - apiKey 传输:打开设置时后端生成一次性 RSA 公私钥,前端用公钥加密 apiKey + 时间戳,后端校验 5 分钟有效期后解密。.env 里存明文(已被 .gitignore 忽略)。apiKey 只能覆盖,不回显。 - AI 接口后端也只接受本机请求,不只靠前端隐藏按钮。 - agent 命令写在 .env,页面不能改,避免页面执行任意命令。MCP 需要用户提前在 claude 里配置。 - 按钮 ID 暂时固定 ai-001,后续做 ID 列表 + 职能标题。 - 传输加密实际做法:AES-256-GCM 加密 {apiKey, ts},RSA-OAEP(SHA-256) 包 AES 密钥(RSA 直接加密有长度上限,长 key 装不下)。 - agent 运行:提示词 + 文件夹资料(课程、nodeId、视频本地路径、已有课件例子、标签)从 stdin 交给 claude;工作目录是网站根目录;同一时间只跑一个;stream-json 整理成进度行显示在弹窗里,原始输出在 backend/data/ai-runs/。 ## 说明 - 上次会话(Kiro IDE sess_2d2f3019)在重构验证阶段中断;重构已由用户提交。 - cryptography 已写进 requirements.txt(>=42,<47)。 - 提交:5706717 眼睛按钮;4c4e5ef AI 模型配置、文件夹 AI 按钮、本机 agent 运行。37 个测试通过。 - 已验证:浏览器 WebCrypto 加密的 apiKey 后端能解开并发给假模型接口;用假 agent 跑通了运行、进度、完成后刷新。没有用真的 claude 跑过(会消耗额度并写课件),也没验证 claude 的 http MCP 能连上本应用的 /mcp。 - d0942a8:文件夹 AI 按钮只在点选的那个文件夹上显示(和选中高亮同一个状态),再点一次取消选中就隐藏;编辑模式不显示。 - 仓库根 .gitignore 忽略 __init__.py,新加的 service/ai/__init__.py 没进 git,靠命名空间包照样能导入。 - `python -m app.service.ort.build` 报错是缺 E:\nginx-1.8.0\html\ORT\01.0童老师全集964+作业纸\课表md版.md,与重构无关。