@chtholly-fan/dsh-cpp-optimization
English | 中文
一个给 DeepSeek Harness（DSH）用的 bundle 插件包，装好后提供一个 skill：cpp-opt-audit，用于审查或编写「又快又安全」的底层 C++ 代码。
它的核心约束是先确认目标工程真实的 C++ 标准：探测不到就问用户，标准确认之前不推荐、不写入任何高于该标准的特性。结论全部带着「检查点 / 为什么 / 反例→正例 / 适用标准」四要素。
安装
用 dsh CLI 装到指定 profile：
dsh plugin --profile web add @chtholly-fan/dsh-cpp-optimization
--profile 填要装到的 profile（这里按 web 写，tui、desktop 等同理）；dsh plugin 之后的参数会原样交给 pnpm，所以从本地目录安装时把包名换成目录的绝对路径即可：
dsh plugin --profile web add <本仓库目录的绝对路径>
本包是 bundle 插件：安装时会写入该 profile 的包依赖，并选中本包的 cordis.patch.yml。不要手动改 profile 的 package.json 或 cordis.patch.yml，也不要在 profile 目录里跑 pnpm。
备选方式：在 DSH 会话里让智能体用 plugin_manager 工具的 install_bundle 动作安装，target 同样传包名或目录的绝对路径。
安装后无需重启即可在会话目录里看到 cpp-opt-audit；如果替换了已安装的同名包，需要重启以加载新的模块。
使用
- 模型自动触发：任务涉及 C++ 代码审查、优化、底层实现时，会话目录会提示模型先加载该 skill。
- 用户显式调用：直接输入
/cpp-opt-audit。
skill 的工作方式是两阶段：默认只读审查并输出带证据的报告，得到同意后才改代码。
内容结构
assets/cpp-opt-audit/
├── SKILL.md # 入口：硬规则、四阶段工作流、高频检查点速查表
└── references/
├── standard-detection.md # 标准探测步骤、__cplusplus 校验、17/20/23 降级映射
├── audit-report-template.md # 报告结构、P0/P1/P2 分级、单条问题写法
├── raii-ownership.md # 一、RAII 与所有权（15 条）
├── move-value-categories.md # 二、移动语义与值类别（12 条）
├── exception-safety.md # 三、异常安全（14 条）
├── performance-memory.md # 四、性能与内存（13 条）
├── containers-algorithms.md # 五、容器与算法（7 条）
├── concurrency.md # 六、并发安全（14 条）
├── templates-compile-time.md # 七、模板与编译期（9 条）
├── standard-boundary.md # 八、标准边界与 C++20/23 机制（24 + 11 条）
├── type-safety-abi.md # 九、类型安全与 ABI（13 条）
└── interface-design.md # 十、对象语义与接口设计（13 条）
检查点按九个维度逐条整理（类型安全、ABI 与接口设计合为一个维度，共十个参考文件），每条标注适用标准；各文件末尾单列了尚未覆盖的主题，避免把「没查到」当成「没问题」。
作为纯文件 skill 使用
不想装插件时，把 assets/cpp-opt-audit/ 整个目录复制到 skill 扫描根即可，例如：
- 用户级：
~/.dsh/skills/cpp-opt-audit/
- 项目级：
<工程根>/.dsh/skills/cpp-opt-audit/
目录名即 skill 名，SKILL.md 的 frontmatter 会被自动解析。
开发
本包是 Host-only bundle：零运行时依赖、无构建步骤，index.js 直接作为入口导出 apply/inject/name。
node --check index.js # 语法检查
node -e "import('./index.js').then(m => console.log(m.name, m.inject))"
插件在 apply(ctx) 里用 ctx.skills.registerProvider(...) 注册一个提供方，list() 解析 SKILL.md 的 frontmatter 生成目录条目，get() 每次重新读取正文（因此编辑 skill 内容无需重新安装）。
发布
npm publish --access public
package.json 中的 repository 字段请改成你自己的仓库地址。
许可
MIT
