前言¶
DeepSeek Harness (DSH) 的核心在于插件化架构。在智能体开发场景下，开发者需要实时掌握项目的 AOCI 认知索引与治理状态。dsh-aoci-panel 插件在会话视图标签栏增加了一个 AOCI 标签，提供索引概览、治理状态展示、条目浏览功能，并为尚未接入 AOCI 的项目提供引导式安装。
插件介绍¶
该插件由 donyue7 维护，基于 MIT 许可证。它通过在 DSH 中注册一个新的标签页，让用户能够以只读方式查看当前项目的 AOCI 资产，或在必要时执行初始化操作。
核心功能¶
插件主要包含以下区块：
- 索引概览：展示项目名、布局模式、索引条目数、各卷状态、
composite_identity、基线文件数与更新时间、最近一次 verify 结果、待处理报告以及最近操作。 - 治理状态：展示是否对齐、
check结果与下一步建议、待处理事务、Recovery 状态、预算水位、Scope 对齐与规则数、Code 漂移明细及 Findings。 - 条目浏览：支持按路径、标签或 F 描述进行搜索。点击条目可展开完整的 F/R/A/S 内容。标签会自动按元卷词典解译为中文含义。
- 安装向导：当项目尚未构建 AOCI 时，面板会引导用户进行环境预检（确认 aoci CLI 与 DSH home）、配置安装选项（Locale、Scope、Agent 等）、预览执行动作，并执行
aoci init/aoci scan，同时向 DSH 追加 MCP 行。 - 引导卡片：通过顶部“引导”按钮，提供 AOCI 概念、生命周期（安装→构建→使用→维护）、面板区块说明以及常用 CLI 命令速查。
- 顶部工具条：提供仓库切换（来自 DSH 已注册工作区）、aoci 二进制切换（自动探测并按 rc 版本降序）、数据时间戳、刷新、校验（执行
aoci verify）和引导入口。
安装与启用¶
通过 PowerShell 执行一键脚本即可完成安装：
pwsh -File scripts/install.ps1
该脚本会执行以下操作：
1. 将插件包拷贝到 $DSH_HOME/profiles/<profile>/node_modules/dsh-aoci-panel。
2. 在该 profile 的 package.json 的 dsh.profile.bundles 数组末尾追加 "dsh-aoci-panel"（安装前自动备份原文件）。
3. 打印生效方式提示。
安装完成后，需重启 DSH 宿主以使插件生效。
典型用法¶
- 查看状态：在会话视图标签栏打开
AOCI标签，查看当前项目的索引概览与治理状态。 - 引导安装：如果项目尚未构建 AOCI，直接在面板中点击“安装”，按向导完成
aoci init和aoci scan。 - 手动安装：如需手动安装，可使用上述脚本，或在手动操作后重启 DSH。
适用场景与注意¶
- 权限与读写：除安装向导外，面板处于只读状态。它不会修改业务代码、
aoci.txt或正式的.aoci资产。安装向导仅写入目标仓库的 AOCI 产物和可选的 DSH 组合补丁行。 - 生效机制：DSH 接入插件后需重启才能生效。向导写入的 DSH 补丁行也需重启宿主。
- 包类型：本插件为本地包，仅登记在
dsh.profile.bundles中，未写入dependencies，以避免pnpm install时产生冲突。 - 热重载限制：桌面版 DSH 宿主不支持
lib/index.js的模块热重载。修改宿主逻辑（lib/index.js）必须重启 DSH；但修改前端逻辑（lib/client.js）在桌面版下通过 HMR 原地更新，无需重启。 - 缓存机制：面板数据缓存存活在本进程内。切换标签、重开面板不会触发重新计算，只有点击“刷新”或“校验”才会触发重算。DSH 重启后首次打开会重新计算。
短结尾¶
dsh-aoci-panel 旨在为 DSH 用户提供一个直观的 AOCI 认知面板，解决索引与治理状态不可见的问题。通过引导式安装与丰富的展示功能，帮助开发者更好地维护智能体项目。完整信息请参考 GitHub。
