CURRENT_TASKS.md 3.3 KB

当前任务与续作说明(给 Cursor / 新对话用)

新开对话或重启 Cursor 后:先 @ HANDOFF 了解总览,再 @ 本文件(或 @docs)按清单执行。

  • 工作区根为 ai-dop-platform@docs/PROJECT_HANDOFF.md,本页为 @docs/CURRENT_TASKS.md
  • 工作区根为 SourceCode@ai-dop-platform/docs/PROJECT_HANDOFF.md,本页为 @ai-dop-platform/docs/CURRENT_TASKS.md

本页侧重 操作备忘与勾选;叙事总览以 HANDOFF 为准。

环境备忘(本机已做过的事)

  • .NET 8 SDK 8.0.419 可能安装在用户目录:%LOCALAPPDATA%\Microsoft\dotnet
  • 若终端里 dotnet --version 仍是 6.x,在用户 PATH 中应把上述目录 排在 C:\Program Files\dotnet 之前,或新开终端 / 重启 Cursor 后再试。
  • 源码根目录D:\Projects\Ai-DOP\SourceCode
  • 解决方案路径(相对 ai-dop-platform/):../server/Admin.NET.sln(工作区为主库根时则为 server/Admin.NET.sln)。

编译注意(Admin.NET 多目标)

上游解决方案里多个项目为 net8.0;net10.0还原(restore)会同时解析两个 TFM,因此本机需要:

  • 已安装 .NET 8 SDK(例如 8.0.419),且
  • 已安装 .NET 10 SDK(例如 10.0.x)。

仅装 .NET 8 时,dotnet build / dotnet restore 会在 net10.0 上报 NETSDK1045。若用官方脚本安装 .NET 10 时出现 dotnet.exe 被占用,请先关掉 Cursor 内置终端里正在跑的 dotnet、Visual Studio、其它占用 dotnet 的进程,再执行:

$installDir = "$env:LOCALAPPDATA\Microsoft\dotnet"
& "$env:TEMP\dotnet-install.ps1" -Channel 10.0 -Quality ga -InstallDir $installDir

(若尚无脚本:Invoke-WebRequest https://dot.net/v1/dotnet-install.ps1 -OutFile "$env:TEMP\dotnet-install.ps1"

装好后 dotnet --list-sdks 应同时列出 8.0.x10.0.x

建议立刻验收的清单

  • dotnet --list-sdks8.0.x10.0.x(与 Admin.NET 多目标一致)。
  • dotnet build ../server/Admin.NET.sln -c Debug 无错误(在已配置 MySQL 的前提下;若仅测编译可先不关库;主库根下执行时改为 server/Admin.NET.sln)。
  • 启动 Admin.NET.Web.Entry,确认默认端口(一般为 5005)可访问。
  • 配置 Admin.NET 的 MySQL 连接后,Development 下插件应对 ado_*CodeFirst(见 GETTING_STARTED.md)。
  • Web/pnpm installpnpm devVITE_API_URL 指向 5005,登录后抽查 GET /api/Order 等与业务页。

待办(产品 / 安全)

  • 去掉或收紧 Demo API 的 [AllowAnonymous],改为与 Admin.NET 登录与权限一致。
  • [ ] 生产库 不要用 Development CodeFirst;改为迁移脚本或 DBA 流程。

    关键代码位置

内容 路径(主库根相对)
AiDOP 插件 server/Plugins/Admin.NET.Plugin.AiDOP/
MVC 兼容 API 插件内 Controllers/
官方 Web / Ai-DOP 页 Web/(如 Web/src/views/aidop/
团队 Cursor 规则 ai-dop-platform/.cursor/rules/

更新约定

完成一大步后,在本文件勾选或增删条目,便于下一位同事或下一次对话对齐进度。