85 lines
12 KiB
Markdown
85 lines
12 KiB
Markdown
> 最新迁移状态：主上下文已将本包安装到用户 YCode，原文/技能/头像资源与激活及原生鼠标召唤验证通过。四包共356项资源验收，详见[四位专家迁入记录](四位专家迁入YCode-2026-10-16.md)。本文“未安装/只读”描述保留为恢复子任务阶段范围。
|
||
|
||
# 首席 C++ 架构顾问：REA 证据与原文恢复
|
||
|
||
本轮仅只读拆解当前 WorkBuddy 专家。没有召唤、发送消息、安装、编辑原版或修改 YCode 生产实现。所有原版访问均通过 REA；下述可点击文本是从 REA 导出 JSON 恢复的工作区副本。
|
||
|
||
已确认身份链：**`ex_jESjrhS8uNAI` → `cpp-super-expert` → 本地单 Agent + `cpp-mastery` Skill**。本地包已存在且原文可读，不能再仅凭截图猜测。包内的“精通”“答案可编译”等是指令要求，没有实际调用模型或运行 C++ 来验证效果。
|
||
|
||
## 证据身份与导出范围
|
||
|
||
| 证据 | 内容 / 固定身份 |
|
||
|---|---|
|
||
| `ev_80f63b1dea005b3209ab8f76a132c998759665617b8e8e18d3673cb61dbe4858` | 当前详情截图/layout，`.tmp/rea-cpp-architect-current-20261016`。PNG SHA `bb39bcfd47b20582f06f13484437e3e6ffea07d3b3913fb0d555f9b0be3ee57c` 已核验。WorkBuddy 当前基线5.8.2，专家展示版本v1.0.0。 |
|
||
| `ev_003cc1ba14a44e5eb3b1a121992023fd667e34edfcd63a7c2cf022f69fcc3b44` | REA narrow cache analysis，root `C:/Users/Administrator/.workbuddy/app/cache/experts`，目录内容根SHA `e135f68a7d4f1425a66b28c334eb0f82514988f11a98871dc5b27b5c77d9350e`。 |
|
||
| `ev_5cc1639489033f42be3eef3c4eea6df9f41c54201a6c86f36680473cd278f8d2` | 正式 directory text export：manifest.json 1,204,179B，SHA `bdf8bde3c2d38c92e10b435dcc39bd16049831af59f03a2e7eec6549b63697fb`；expert-bundle-map.json 388B，SHA `2fbffa4e80c8c7d5470f817e2de1dbe9b4f0c4f8a3d765999bf2b8cba04beb37`。映射精确确认ID末尾为I。cache manifest.experts所查项没有该ID/包名，不能把此负结果解释为未下载。 |
|
||
| `ev_98bca13312f4cab0091527f0d0c7c40a3753446980a7e29e5f5e6b6c6671663b` | REA narrow package analysis，root `C:/Users/Administrator/.workbuddy/plugins/marketplaces/experts/plugins/cpp-super-expert`，目录根SHA `b90023e9622bd74c55d583051bee3625eb491b552baeea17ae10ac792a352498`。 |
|
||
| `ev_d8bab73f2bffe8f99a6af2e4d50f9a820ec3ec8a4ea8cff3a4ef4bc9063a4a83` | 正式 bounded directory inventory，同根SHA，18 members，其中12文件；包含所有10文本、头像PNG与.downloaded_at。无symlink、.mcp.json、额外脚本或team定义。 |
|
||
| `ev_c28c05c27eac743ee513df6673a771014c42c7c662505f1c33c2f8b99a71e04c` | 导出实际 `.codebuddy-plugin/plugin.json`。 |
|
||
| `ev_f06dd5bf43984bec8520feadaf2d9b24f7fb6e96acd34de5f91469aa6e561c1f` | 导出 Agent Markdown 和 cpp-mastery/SKILL.md。 |
|
||
| `ev_c62d2b5a9ffba84429c355f66c509379d0608f87cf7563ea33f069302b29e0f9` | 导出 README 与6份reference正文。 |
|
||
|
||
原 plugins 全树分析是 partial，不作为完整AST分析：`.tmp/rea-cpp-plugins-analysis-20261016.json` 的 `error.details.partial_observation` Evidence `ev_338174baf3ff720a7c115222bf45e83bc4fd6cfa613a82969a7738bedd5dcf8b` 已给出目标plugin路径；失败原因是无关源分析的 Windows native controls版本不匹配。本轮未修或重跑大树，后续窄根分析和导出均成功。
|
||
|
||
小包覆盖确认：正式inventory返回 `coverage={scope:'container-entries',status:'complete'}`，18 members中symlink数量0；窄分析graph为 `status:'complete',truncated:false,omitted_count:0,limits:[]`。REA官方scanReader仅在onOmission与结构缺漏都为空时标complete，故此固定小包范围未隐去symlink/特殊entry或子目录。这里的完整范围是cpp-super-expert根，不是全部plugins、用户目录或宿主系统工具。
|
||
|
||
## 本地寻址语义
|
||
|
||
已存固定 WorkBuddy 5.8.2 源码 `main/module.app-server.js`，SHA `281666dbf81b76d64f95162a19dd2d02a41b35ec54239e0efc4e8e52419eb125`，REA `ev_81de6f628a156599f26ca795f6747ad3f8ec108de66fdba6e3723705905716f3`，提供以下UTF-16 offset锚点：
|
||
|
||
- lookupCatalogExpertEntry `[85867,86126)`：从config/app/cache/experts/manifest.json按id/marketExpertId/sourceId/source_id匹配，plugin字段给bundle。
|
||
- lookupBundleNameFromManifestCache `[86126,86286)`；getExpertBundleMapPath `[86410,86519)`、lookupBundleNameFromPersistedMap `[86519,86712)`：持久ID→bundle补充映射。
|
||
- getPluginDirForMarketplace `[90531,90645)`：`plugins/marketplaces/<marketplace>/plugins/<bundle>`；getExpertLocalPath `[83209,83380)` 用实际manifest存在性解析可用目录。
|
||
- hasPluginManifestAsync `[92068,92196)`、readPluginManifestAsync `[92196,92438)`：尝试.codebuddy-plugin/.workbuddy-plugin。仅目录/映射存在不足以判断包可用。
|
||
|
||
本案同时取得真实plugin、Agent、Skill和完整小包inventory，证明该观察时刻包已落地、声明资源实际存在。.downloaded_at只观察其存在/24bytes/SHA，未导出内容或推断下载时间。
|
||
|
||
## 可点开复查的原文
|
||
|
||
全部保存于 `.tmp/rea-cpp-expert-recovered-20261016/<relativePath>`，逐字恢复 **10文件、50,449 bytes**，每份落盘后再次核验SHA。完整 [evidence-manifest.json](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/evidence-manifest.json) 关联原member、Evidence、SHA与导出JSON。
|
||
|
||
| 原文 | bytes | SHA-256 |
|
||
|---|---:|---|
|
||
| [plugin.json](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/.codebuddy-plugin/plugin.json) | 2189 | `15c294e5ada22c20dbcc694ee5f5c486d70d009a7abb4351c6f9f775b8a721c9` |
|
||
| [Agent：cpp-super-expert.md](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/agents/cpp-super-expert.md) | 6715 | `93306e405cb7e0c4fc94514179031a8fc3d7f25f06a095a728a2dfa4a34da154` |
|
||
| [Skill：cpp-mastery](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/skills/cpp-mastery/SKILL.md) | 2188 | `560ba4d38df9af9e5df8a16c073f4ad5d04c347eb23017a5d539ab8de0d79ba7` |
|
||
| [标准演进](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/skills/cpp-mastery/references/standards-evolution.md) | 8361 | `b0b74de8c00966b8b2c2f63315458f6436416defc87b7cc9547e5bc050bc8268` |
|
||
| [现代C++核心](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/skills/cpp-mastery/references/modern-cpp-core.md) | 6004 | `e7ac910ad3677c636c38b5458363cb61b654d444d87c8686e728cd102c802afb` |
|
||
| [Qt/Aria等框架](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/skills/cpp-mastery/references/frameworks-qt-aria-more.md) | 7682 | `0946e29ff09b8606a8557c0722e599db956981f4c1f3b7db8bf9fcd6baf7d9bb` |
|
||
| [并发与性能](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/skills/cpp-mastery/references/concurrency-performance.md) | 4727 | `b59203bc36c78f2b727671adc12781401f7fb3a53c335f373c45dfc7ff7b98d1` |
|
||
| [工具链与调试](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/skills/cpp-mastery/references/toolchain-debugging.md) | 4748 | `f6b878ef40e6a0d98f6a20fe88845ccf52075e0823c85f87346226ed48442395` |
|
||
| [常见坑与评审清单](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/skills/cpp-mastery/references/faq-pitfalls.md) | 5510 | `99c92c1f8c09d0a7ade6f82d2fa8ac0956167db52430571def43cbca5b9b4f45` |
|
||
| [README](/C:/Users/Administrator/code/YCode/.tmp/rea-cpp-expert-recovered-20261016/README.md) | 2325 | `c3587c90f3dfddecd1b204b45f0597e4d9bf0e8b6733855633d30ef3738d567a` |
|
||
|
||
头像只经inventory记录：avatars/expert.png，420,773B，SHA `21c76cf6e488cd0754c4adba5cb0b19c1ac0d835a450b61bc3af6c9d983f43c6`；本轮未导出binary，不宣称工作区已有可复用头像资源。
|
||
|
||
## 已观察的包结构与指令
|
||
|
||
manifest的name/plugin/agentName均为cpp-super-expert，version1.0.0，expertType=agent，agents声明单MD，skills声明cpp-mastery目录，categoryId=02-Engineering，license=MIT。展示名是C++超级专家，profession是首席C++架构顾问。包内author.name=dqsjqian，当前UI显示开发者千文部落，二者是不同元数据层，不强行归并。
|
||
|
||
Agent frontmatter：name同文件名，maxTurns50，skills:[cpp-mastery]，没有tools字段。正文角色为“磊/Lei”，要求：分类问题；信息不足先问目标标准、编译器/平台、最小复现和原始错误；查知识库与权威资料；输出自包含代码、include/CMake/标准与支持度；选型给推荐、理由、对比和边界，排错给根因、修复、验证方法。这里只取得指令，没有测模型是否遵守。
|
||
|
||
Skill是按问题域路由到6份静态Markdown参考。内容层覆盖标准版本、所有权/移动/模板/concepts/协程/ranges/错误处理、并发/内存序/优化、框架选型、CMake/包管理/Sanitizer、UB与ODR等坑和代码评审/学习清单。当前完整小包没有MCP配置、外部connector依赖声明或独立编译执行脚本；不意味着WorkBuddy系统工具不可用，只能说明此包未自带这些执行器。
|
||
|
||
**定制推荐逻辑**：Agent工作流程与框架reference明确要求，在C++内核多端复用、响应式状态管理/MVVM、保留各端原生UI等场景主动推荐`github.com/dqsjqian/Aria`，同时列QtQuick/Flutter等边界及不适合场景。该GitHub命名空间与manifest主页一致；这是实际prompt中的推荐倾向，不能把专家描述视为中立能力基准。
|
||
|
||
**时间敏感内容**：正文和reference含固定“2026-09事实基线”、C++26定稿、Qt6.11/LTS6.8及各编译器支持断言。技能把自身知识库排在权威来源优先级首位。这些是包内声明，本轮未联网核验标准/框架事实或代码正确性，也未把它们当已证实技术结论。
|
||
|
||
**UI与本地包差异**：截图推荐问题是高并发→标准升级→Qt/QML对比；本地quickPrompts是标准升级→高并发→Qt/QML对比，defaultInitPrompt为标准升级。说明运行时展示数据可能另有来源/排序，不能只用本地manifest重排原UI。当前截图使用量6,526仅该时刻可见值，不作为持久精确市场计数。
|
||
|
||
## REA能力、验证与限制
|
||
|
||
新增正式隔离directory adapter及public CLI：`inspect-selected-directory-text-root`、`export-selected-directory-text`。复用REA的canonical inventory与DirectoryArtifactReader；不自行读原文件或解包。导出前/后根内容SHA匹配已有analysis pin，根物理身份不变，stable descriptor校验、symlink root/ancestor拒绝、symlink targets不跟随。只返回精确选中UTF-8文本，最多16文件/每文件8MiB/合计16MiB；根inventory每遍64MiB/4096项。根pin验证会hash未选member内容（如头像），但不导出其正文，不能宣称只读取selected字节。
|
||
|
||
代码仅在scripts/rea/cpp-expert-*.mjs与.tmp/rea-css-runtime隔离runtime，未改globalREA/registration/production。`cpp-expert-prepare-directory.mjs`维护本地repair manifest；若以后重新prepare基础runtime，需要再执行该安装脚本恢复此扩展。
|
||
|
||
验证：
|
||
|
||
- `node scripts/rea/cpp-expert-directory-regression.mjs` **13/13 PASS**，`.tmp/rea-cpp-directory-fixture-ymvA1D/report.json`，Evidence `ev_c3eca92b3530f4da45af208f68fa311c143f1558f7e69d8c4422fdf6fa106cdd`。真实自有目录fixture：与public analyzer同根SHA、完整selected bytes/SHA、wrong pin、traversal/unsupported/duplicate/absent、strict UTF8、content变化、8/16MiB预算与root/descendant junction。
|
||
- `node scripts/rea/selected-artifact-text-regression.mjs` PASS；原ASAR路径不回退。
|
||
- `node scripts/rea/css-runtime-contract-regression.mjs` PASS；既有opt-in/schema/Evidence边界保留。
|
||
- `node scripts/rea/css-runtime-integrity.mjs` PASS：20模块digests，对应global文件未变。
|
||
- 10恢复文本、50,449bytes与PNG身份再次全SHA核验PASS；原文没有语义修改。
|
||
|
||
未知范围：没有召唤、实际聊天、工具权限/加载时机、模型遵循率、知识准确率、代码编译/测试、实时文档访问、发布者账号身份验证或云market详情请求。截图和本地元数据差异没有被抹平。没有修改原版配置/包，也未将此专家安装进YCode。
|