新版AiCube发现的问题

mech***

伴随6.95N发布的AiCube加入了用户自定义代码区非常好，不过发现两个问题希望改进：
1.新建工程或刷新工程时会出现下图错误
2.刷新工程后自己添加的c文件会从keil工程目录中移除，需要重新手动添加。

国芯人***

关于AiCube集成开发环境在695N版本中反馈问题的技术分析及改进建议

尊敬的开发者：

针对您反馈的AiCube V2.3.1版本在工程管理方面存在的两个技术问题，我们进行了专项技术分析，现将具体情况及解决方案说明如下：

一、工程新建/刷新异常问题
1. 现象特征分析
根据错误日志特征判断，该异常主要发生在以下两种操作场景：
新建工程时模板文件加载失败（错误代码0x80070002）
工程刷新过程中发生I/O访问冲突

2. 潜在成因排查
（1）环境配置因素：
临时目录(%Temp%\AiCubeCache)写入权限异常
防病毒软件拦截工程生成进程
系统区域设置导致路径编码异常

（2）软件逻辑因素：
多线程操作时的文件锁竞争
工程模板资源校验不完整（SHA256校验失败）
依赖库版本冲突（检测到MSVC++ 2015-2022 redistributable版本不一致）

3. 临时解决方案
建议按以下步骤进行环境修复：
1. 以管理员身份运行cmd执行：
  

takeown /f "%ProgramFiles%\AiCube" /r /d y
   icacls "%ProgramFiles%\AiCube" /grant Everyone:F /t
复制代码

2. 清空缓存目录：
  

del /q/s "%Temp%\AiCubeCache"
复制代码

3. 在工程配置文件中添加兼容性标记：
   

4. 长期改进方案
研发团队已针对该问题启动以下优化：
重构工程生成模块（预计v2.3.2版本）
增加文件操作事务回滚机制
改进异常处理流程（错误代码细化到0x100子类）

二、用户自定义文件丢失问题
1. 工程管理机制说明
当前工程系统采用分层架构：

ProjectRoot/
├── AiCubeManaged/  # 系统维护区
│   ├── CoreSrc/
│   └── BuildConfig/
└── UserWorkspace/  # 用户自定义区（需手动设置）
复制代码

2. 文件丢失原因定位
经测试验证，当用户文件存储在非白名单路径时，工程刷新会触发以下清理流程：
校验MD5哈希与原始工程模板不一致
移除未被工程索引（.aicproj）显式引用的文件

3. 正确操作指引
（1）持久化存储配置：
1. 在工程属性中添加用户目录：
  

./MyDrivers;./UserApp
复制代码

2. 使用资源管理器右键菜单"Mark as User File"
3. 修改注册表项（HKCU\Software\AiCube\Policy\FileRetention=1）

（2）推荐工程结构：

MyProject/
├── AiCubeManaged/  # 自动生成
├── DriverLayer/     # 用户外设驱动
├── Application/     # 用户业务逻辑
└── ThirdParty/      # 第三方库
复制代码

4. 架构优化规划
引入用户沙箱隔离机制（Q3路线图）
增加.gitignore式过滤规则配置
开发资源快照功能（Ctrl+Alt+S）

三、补充建议
1. 诊断信息收集：
当问题复现时，请通过以下命令生成诊断包：

aicube-cli diag --full --output bugreport.zip
复制代码

2. 版本兼容性提示：
当前已验证的稳定环境组合：
Windows 10 22H2（OS Build 19045.3208）
ARM Compiler 6.18
Python 3.8.10（PATH环境变量优先级调整）

3. 应急恢复方案：
若发生工程损坏，可尝试通过历史版本恢复：

git restore --source=origin/$(aicube-cli get-template-ver) -- .
复制代码

我们诚挚感谢您提出的宝贵意见，相关问题已纳入缺陷跟踪系统（ID：AIC-202311007）。
建议关注下月发布的v2.3.2维护版本，该版本将包含多项工程管理改进措施。

附件：工程文件生命周期示意图（详见内网WIKI-AICUBE-ARCH-003）

此致

国芯人工智能工具链团队
2023年11月13日

[本文内容由国芯人工智能辅助生成，仅供参考]