cann-workbench 0.0.0-stage → 0.0.1-alpha

package/README.md

@@ -1,3 +1,158 @@
-# Temporary Holding Version
+# CANN Workbench
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+CANN Workbench is a DeepSeek Harness plugin for operator development, performance tuning, and fault diagnosis, with session-linked tasks, live visual results, skills, knowledge bases, and execution environments.
+
+Package: `cann-workbench`. Internal package and panel identifiers remain stable.
+
+## Current scope
+
+The primary panel groups seven available entries: CANN exploration, operator development, operator tuning, and fault diagnosis under Tasks, Knowledge bases and Skills under Resources, and Environments under Extensions. Home contains navigation only, with no sample runtime cards. Operator tasks load from the Workspace task store and open their JSON-rendered details in the DSH right sidebar. Operator tuning is contributed by the sibling `plugins/ops-tune-workbench` plugin: its「算子调优」page lists and creates `performance-optimization` tasks (the `/cann-performance` command still works), its tool bridges (`ops_collect` / `ops_import` / `verdict_judge` / `baseline_set` / `tuning_skill`) run in the session, and its right-sidebar「算子调优工作台」panel visualizes results. See [the design document](docs/design.md).
+
+Main-page components, layout and copy follow the [approved frontend design](../../docs/design/frontend-refresh-review.md). The [offline demo](../../docs/design/frontend-refresh-demo.html) remains available for comparison. Task sidebars retain their existing presentation.
+
+### 技能目录
+
+技能按来源保存在 `skills/` 下，根目录 `skills/catalog.json` 管理来源、归档及展示文案。
+技能页通过 Host RPC 扫描真实 `SKILL.md`，不再维护前端静态列表。页面仅展示性能调优集合；算子工作流和精度检查仍保留供任务按需安装。
+Matt Pocock 文件作为内部任务流程扩展保留，不进入展示 JSON 和技能页。
+两类任务的系统提示词与共享数据契约归档于 `skills/task-agents/`，随插件发布，当前尚未接入运行时。
+目录约定见 [技能目录设计](../../docs/design/skills-catalog.md)。主页面已统一移除面包屑。
+
+## Development
+
+Run install and check with pnpm in this package directory.
+
+### JSON 自动渲染的性能优化任务
+
+### JSON 自动渲染的性能优化任务
+
+性能优化任务保留自己的任务 ID、主 Session 和 Workspace 关联。2026-11-10
+起主面板「算子调优」页展示其任务列表与创建入口；`/cann-performance <任务名称>`
+命令继续可用。在工作区中打开一个未关联任务的主会话，运行该命令
+即可创建并关联性能优化任务，自动打开 sidebar；切换回该会话也会打开对应任务。
+一个主会话最多关联一个任务，已有算子开发任务的会话不能再创建性能优化任务。
+
+完整输入、调优工作流、指标、流水时间线、检查结果、判定书和基线对照由
+`src/shared/definitions/performance-optimization.json` 自动渲染。
+`sidebar.sections` 控制任务区块；性能区块的 `options` 控制内部区块顺序、标题、
+指标绑定、比较行、管线配色、判定标签、数据源、刷新周期和状态文案。
+
+数据取自性能优化任务会话工作区的 `.cann-workbench/state.json`，显示最新报告并通过
+`baseline_id` 关联基线。可见时按 JSON 中的 `refreshMs` 刷新，隐藏或关闭时取消
+读取。缺失报告显示空态，失败显示错误，正式流程不使用示例数据。
+
+旧性能侧栏、独立预览入口和示例报告已归档至
+[archive/static-pages](archive/static-pages/README.md)，仅用于参考，不参与运行时构建。
+目录说明列出了每个旧元素与 JSON 配置及自动渲染器的对应关系。
+
+当前支持报告状态契约的前端展示；OpsTune 原始产物到该契约的转换及实际 NPU
+采集由数据生产端负责。来源与许可见
+[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+
+### 创建任务与任务详情
+
+在「算子开发」点击「创建任务」，填写任务名称、工作区、需求说明和验证环境；知识库与技能可选、多选，选项与资源页面一致。任务创建时为待开始，自动创建并关联主会话；原生对话启动后由宿主同步为进行中。所选资源由任务 Agent 的系统上下文静默承载，聊天启动消息只包含任务名称和需求说明。
+工作区默认选择当前会话所属工作区；只有一个工作区时自动选择。允许同名任务，
+每次创建分配独立 ID。保存中禁止重复提交，失败后保留表单内容供重试。
+
+任务保存在所选工作区：
+
+```text
+.cann-workbench/tasks/<task-id>/
+  task.json
+  inputs.json
+  workflow.json
+```
+
+任务列表和右侧详情共用一份状态。刷新后从已注册工作区恢复任务；点击列表中的
+任务名称，在当前会话的右侧栏查看由 TaskDefinition JSON 定义的详情。
+侧栏按工作区 ID 和任务 ID 定位，避免不同工作区的任务串数据。点击任务时通过
+DSH 导航打开或复用该工作区的空白会话，待会话侧栏挂载后展示详情。任务使用
+稳定资源地址定位，刷新后不依赖临时导航参数；不会提交
+模型请求。详情目前提供只读的摘要、输入、工作流和配置条目展示，
+创建入口会自动启动对话，阶段进展由模型结构化回复更新。
+
+Host 使用 `ctx.fs` 和 `workspaceRegistry` 读写，由 Typert Gateway 暴露
+`cannWorkbench/createTask` 与 `cannWorkbench/listTasks`。前后端共用请求和返回值
+schema，客户端通过公开的 Remote mount 与 sidebar slot 接入，不改 DSH 源码。
+
+文件创建采用仅在不存在时写入，最后写入 `task.json` 作为创建完成标志。
+多文件写入不是事务；失败时可能留下不完整目录，列表会忽略它，且不会覆盖它。
+损坏的完整任务会单独报错，其他有效任务仍可加载；任务页支持重新加载。
+
+### 侧栏分析与原生聊天
+
+工作流阶段、性能耗时、检查、判定和基线对比支持“分析”；时间轴可依次选择开始和结束阶段，再点击“分析”。选择会出现在目标主会话输入框上方，确认“发送分析”后才通过 DSH 原生 API 排队发送。Chat 展示自然语言，模型在同一次请求中另收到经过 Host 校验的结构化选择。刷新或选择本身不发送消息。
+
+任务版本、报告 digest 与主会话关联由 Host 核验。准备状态通过工作区 `.cann-workbench/sidebar-interactions/` 原子保存；重试复用 requestId。模型接纳后，完整输入进入原生 session log。实现未修改 DSH loop 或 composer，也未接入同一个原生输入按钮的结构化草稿贡献。方案见 [DSH 协作设计](../../docs/design/dsh-task-chat-integration-research.md)。
+
+可在存在同目录 DSH 源码及构建产物时，从仓库根目录运行无密钥原生 loop 验证：
+
+```sh
+../deepseek-harness/node_modules/.bin/tsx plugins/ascend-workbench/scripts/check-native-sidebar-loop.mjs ../deepseek-harness
+```
+
+验证使用确定性模型适配器和临时工作区，不请求在线模型。
+
+### 任务回答中的侧栏数据
+
+关联算子开发或性能优化任务的主会话会通过 system section 接收 `skills/task-agents/response-protocol.md` 与阶段 Schema。每次完整回答在自然语言之后附上唯一的 `cann-task-state` JSON 块（`cann.task.response/1`），由已提交回复 hook 校验任务归属、快照和字段后更新现有任务侧栏。没有新数据时使用空 nodeUpdates。已移除工具结果触发的阶段提醒；常规更新无需另调进度工具。
+
+当前不修改 DSH 的原始回复或 renderer，因此结构块仍会显示在聊天中。隐藏业务块的通用展示接口、崩溃窗口的自动补投影和完整 Agent/技能静默加载属于后续工作。
+
+### 五类可视化组件
+
+任务侧栏的“任务视图”按任务 JSON 选择代码变化、编译运行、耗时分布、指令流水和内存。模型在现有回复块中提供 `components` 或 `componentUpdates`，校验后与阶段状态一起落入 task.json；没有数据时等待采集，不使用内置 sample。
+
+字段与事件契约位于 `skills/task-agents/visuals/`。修改契约后执行 `node scripts/build-visual-validators.mjs` 生成 CSP 安全的验证函数，并运行 check。图表与输出只读，用户选择经过既有原生发送通道，不会重复执行命令。
+
+### 统一算子开发
+
+创建入口直接打开算子开发表单，不再选择 Kernel / Triton / Tensor。统一进展为需求分析、技术设计、开发实现、测试验证、问题诊断、性能优化、评审交付；技术路线在对话中决定，调试按需进入。
+
+任务规则和阶段字段在 `skills/task-agents/operator-development/`。当前阶段的 Matt 指导经 system section 静默加载，显式调用技能不会自动执行。已移除 cannbot skill 和旧任务解析；部署这一版本前须清空旧 workspace/session/task，不执行数据迁移。
+
+侧栏结果由任务 JSON 的 `options.resultViews` 选择关键字段和双语表头，不直接显示 JSON。模型回复 hook 保存结构化结果后，经原生 `followTasks` 流推送到统一任务状态；不使用任务或报告定时轮询。当前与异常阶段默认展开，其余阶段可主动展开。见 [侧栏结果与实时更新设计](../../docs/design/sidebar-results-and-live-updates.md)。
+
+
+## 故障诊断（内置 CANN Doctor）
+
+“任务 → 故障诊断”与“算子开发”并列。选择工作区、填写真实日志路径或故障描述后，点击“开始诊断”，使用 DSH 原生会话和当前模型执行。
+
+宿主 DSH 需要 `0.2.2-rc.1` 或更高的 `0.2.2` 版本。`0.2.2-alpha.2` 的 Agent preset 组合存在宿主缺陷，会在创建任何新会话时返回 `agent-preset/invalid: Cannot read properties of undefined (reading 'parent')`；插件会通过 `engines.dsh` 拒绝在该版本加载。
+
+内置原 `cann-doctor` 0.1.1 的完整核心能力：
+
+- 从官方 `https://gitcode.com/cann/oam-tools.git` 的 `skills/tool-fault-diagnosis` 安装 `orchestrator-skill`、`collect-skill`、`eval-skill`、`trace-skill`、`metric-skill`，保留其脚本、模板、参考资料和许可证。
+- 启动时与每 6 小时自动检查；也可在页面手动安装/更新。快照校验通过才切换，更新失败继续使用旧版，历史报告保留 Skill revision。
+- 保留 `cann_doctor`、`cann_doctor_publish_report` 工具、`/cann-doctor` 命令与认证 `/api/cann-doctor` 接口。模型将最终 Markdown/HTML 报告发布到当前会话，前台会话的右侧报告自动打开。
+- 主页面和右侧面板复用报告缓存；支持多报告切换、自动刷新、持久反馈与更正。HTML 使用 sandbox/CSP 禁止脚本执行。
+- 默认沿用 `$DSH_HOME/cann-doctor`（未设置时 `~/.dsh/cann-doctor`），已有技能、报告和反馈可直接读取，不必迁移。
+
+安装 Workbench 后，停用独立的 `cann-doctor` 插件行，以免相同工具、API 和 Skill provider 重复注册。仅保留 Workbench 即可；不再依赖相邻 `../plugin` 目录。
+
+可选 Host 配置：
+
+```yaml
+diagnosis:
+  # dataDir: /absolute/path/to/cann-doctor
+  autoUpdate: true
+  updateIntervalMinutes: 360
+  # repoUrl: https://gitcode.com/cann/oam-tools.git
+  # branch: master
+```
+
+首次安装需要 Git 和官方源网络访问；日志采集需要目标 Ascend 环境。准确性反馈只由用户操作，在本机保存。
+
+验证命令（在本插件目录执行）：
+
+```sh
+pnpm install --frozen-lockfile
+pnpm check                       # 类型检查、全部单元/集成/原 Doctor 回归和构建
+pnpm test:diagnosis:native        # 构建产物 + 真实 DSH 注册表
+pnpm test:diagnosis:upstream      # 另验证官方五个 Skill 在线安装
+pnpm test:diagnosis:package       # 打包并脱离源码目录验证
+pnpm test:e2e                    # 构建 + Chrome 浏览器端到端测试
+```
+
+浏览器测试默认使用本机 Chrome；也可在 `playwright.config.ts` 去掉 `channel: 'chrome'` 后执行 `pnpm exec playwright install chromium`。测试使用隔离临时数据和明确标记的合成报告，不改正在使用的 DSH profile。完整能力对照与测试边界见 [集成验证报告](../../docs/verification/cann-doctor-integration.md)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,85 @@
+# Imported performance sidebar
+
+Source: https://gitcode.com/jinyingqi/cann-workbench
+
+Revision: `d2587123bd72e8125d28081f23038247e3097e9c` (main).
+
+Imported from `cann-workbench-plugin/src/client/`: `panel.tsx`, `types.ts`,
+`styles.css`; sidebar registration, state loading and polling adapted from
+`index.tsx` and `state.ts`. The upstream package declares the MIT license.
+Attribution: jinyingqi/cann-workbench contributors.
+
+Local adaptations: independent right-sidebar provider, scoped CSS embedding,
+missing instrument-stack styles, paged and validated workspace reads, cancellable
+non-overlapping polling, error/empty/loading states, verdict status labels,
+time units, per-metric comparison scaling, and removal of hard-coded KEEP text.
+Host tools are not imported.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Imported ASC Tools skills
+
+Source: https://gitcode.com/cann/asc-tools
+
+Revision: `77cba0b6930e859b0cd18bc9e3ca300d83e86834` (master).
+
+`skills/asc-tools/tool-ops-tune/` and `skills/asc-tools/tool-precision-debug/` preserve the upstream
+source structure, scripts, references, templates and installation instructions.
+Attribution: Huawei Technologies Co., Ltd. and ASC Tools contributors.
+These files are licensed under the CANN Open Software License Agreement
+Version 2.0; a copy is included in each imported directory as `LICENSE`.
+They are not covered by the performance sidebar's MIT license above.
+
+The former performance page and preview are retained under
+`archive/static-pages/performance-sidebar/` as reference only. Production chart
+primitives in `src/client/renderers/performance/` are adapted from the same
+MIT-licensed source; composition, metric bindings, labels and styles are now
+configured by the task JSON. The old workflow page is archived alongside it.
+
+## Imported Matt Pocock skills
+
+Source: https://github.com/mattpocock/skills
+
+Revision: `4ae2317ddb22b046e26455e4f9c9b3aaaf62212d`.
+
+`skills/mattpocock/skills/` preserves all 39 upstream Skill definitions, supporting
+files, and internal directory hierarchy. The source README, documentation, scripts,
+and MIT license are included under `skills/mattpocock/`. Copyright (c) 2026 Matt Pocock.
+Experimental and deprecated content is retained and archived from the visible
+catalog through `skills/catalog.json`. Imported instructions are not executed by
+the catalog scanner.
+
+## Sidebar visual engines
+
+- Apache ECharts 6.1.0 — Apache-2.0, https://github.com/apache/echarts
+- d3-flame-graph 5.0.0 — Apache-2.0, https://github.com/spiermar/d3-flame-graph
+- D3 selection and graph dependencies — ISC, https://github.com/d3
+- diff 8.0.2 — BSD-3-Clause, https://github.com/kpdecker/jsdiff
+- Ajv 8.17.1 and ajv-formats 3.0.1 — MIT, https://github.com/ajv-validator
+
+# Integrated CANN Doctor
+
+Source: https://gitcode.com/cann-platform/plugin.git (local 0.1.1 source).
+Copyright 2026 CANN Doctor contributors. Licensed under Apache-2.0; see
+`doctor/LICENSE` and `doctor/NOTICE`. Host, report storage, skill version manager
+and report views are integrated, with native Workbench navigation and controls.
+Downloaded official diagnosis skills retain their own licenses in their immutable
+version snapshots; source: https://gitcode.com/cann/oam-tools/tree/master/skills/tool-fault-diagnosis.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: ascend-workbench
+      name: '@cann-workbench/ascend-workbench-plugin'

package/doctor/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/doctor/NOTICE

@@ -0,0 +1,12 @@
+CANN Doctor
+Copyright 2026 CANN Doctor contributors.
+
+The plugin downloads CANN fault diagnosis skills from:
+https://gitcode.com/cann/oam-tools/tree/master/skills/tool-fault-diagnosis
+Those upstream files retain their original copyright notices and licenses.
+Upstream skill and script notices identify Huawei Technologies Co., Ltd.
+Upstream versions are preserved separately and identified by Git commit.
+
+The CANN Doctor SVG icon is original artwork supplied with this plugin.
+DeepSeek Harness and CANN names identify the compatible host and diagnosis
+environment; no endorsement or official marketplace listing is asserted.

package/doctor/README.md

@@ -0,0 +1,18 @@
+# Integrated CANN Doctor
+
+Imported from `cann-platform/plugin`, package version 0.1.1, source commit
+`1ca0c9bb17266c6b5a37657e88f41cf67b3eb7fb`.
+
+`src/` retains the original Doctor, SkillManager and ReportStore implementation.
+`index.js` adapts the entry Skill path for Workbench packaging. `views.js` adapts
+the original client to a shared ESM view factory, native buttons, live main-page
+polling and host theme defaults inside sandboxed HTML previews.
+
+The Host and views are bundled into Workbench's `lib/index.js` and `lib/client.js`;
+this directory is an internal source module, not a second installed DSH plugin.
+`tests/` runs the original behavioral regression suite against these modules.
+The former standalone npm release checks are replaced by
+`scripts/verify-doctor-package.mjs` for the integrated package.
+
+See `LICENSE` and `NOTICE` for attribution, and the repository's
+`docs/verification/cann-doctor-integration.md` for capability and verification details.