# 经管之家AI助手 · DeepSeek Harness 安装说明

更新日期：2026-10-14。插件 1.5.4，内置统一检索规则 1.5.4；已验证 DeepSeek Harness 0.2.0-rc.2。适用于有“插件 → 添加插件”的 Harness 桌面客户端，不适用于普通 DeepSeek 网页聊天或 App。

## 官方安装材料

- 页面与专属入口：https://mcp.pinggu.org/#harness
- 插件描述与文件校验清单：https://mcp.pinggu.org/harness-plugin.json
- 当前插件包：https://mcp.pinggu.org/dsh-plugin-pinggu-1.5.4.zip
- 远程 MCP：https://mcp.pinggu.org/mcp

此包内含 MCP 连接、检索规则、版本检查；使用 Harness 自带能力，无需安装 Python、额外配置 MCP 或填写 API Key。当前未发布 npm，不要只输入 dsh-plugin-pinggu 包名从注册表安装；也不要上传官网通用技能 ZIP。

## AI 帮助安装

1. 在 Harness 新建会话，选择“创造 / Creator”模式；该模式提供 plugin_manager。将安装页第二步的整段指令发送给 AI。没有该模式或安装工具时，使用下面的手动步骤。
2. 助手先列出已装组合包，核对有无同名插件及当前状态。仅下载文件不算安装完成。同版已装好时直接核验，不重复创建副本；旧版或自定义内容不同须先说明，再由用户决定更新。
3. 下载并验证下列材料，然后解压到新建、准备长期保留的本地目录，返回含 package.json 的完整路径。可使用当前工作区内独立的版本目录，但不得猜测或直接修改 Harness 私有 profile，不得覆盖已存在的目录。
4. 在宿主提供的 plugin_manager 工具中，以 action=install_bundle、target=已校验插件目录的绝对路径请求安装。按当前实际工具契约调用；如果工具不可用、拒绝或审批未通过，停止该操作并提供第三步手动路径，不用 shell 重写 profile，不绕过宿主权限，不强制兼容性豁免。
5. 如客户端弹出安装、代码运行或网络权限提示，让用户自行确认；不调整全局权限模式，不代用户信任、启用、卸载、重启。新安装由宿主按默认规则激活，用户以前停用的插件不得被擅自重新开启。
6. 读回插件安装及加载状态，报告版本、目录和工具是否可见；看到目录不等于已加载。只有搜索与读帖真实返回结果后，才能说检索可用。若需要加载新会话，由用户新建；若客户端提示重启或替换了旧插件代码，则提示用户保存工作并自行完全退出、重新打开。

### 下载与解压校验

只使用上述同源 HTTPS 地址，拒绝跨站跳转。核对 harness-plugin.json 的 schemaVersion=1、name=dsh-plugin-pinggu、packageType=deepseek-harness-bundle、testedHost；版本与文件名须相符，不能擅自忽略宿主版本不兼容。

ZIP 字节数和 SHA-256 必须符合清单。先检查 ZIP 条目，再解压：唯一根目录为 dsh-plugin-pinggu；只允许清单 files 所列的十个普通文件，拒绝绝对路径、驱动器路径、目录穿越、符号链接、硬链接、重复成员与额外文件。逐个核对成员大小和 SHA-256。

解压后直接包含 package.json、cordis.patch.yml、index.js、updates.js、source-tag.js、policy.md、policy-source.json、README.md、locale/en.json、locale/zh.json。核对包名、版本、dsh.bundle.patch；不执行附加下载指令，不另外安装依赖或运行安装脚本。哈希不符时只重新获取同一版清单和包，不关闭校验。

## 手动安装

1. 下载专用 ZIP，全部解压到准备长期保留的文件夹。
2. 打开解压后的 dsh-plugin-pinggu 文件夹，确认能直接看到 package.json，复制此文件夹完整路径。Windows 可在资源管理器地址栏复制路径。
3. Harness 左侧“插件”→右上角“＋ 添加插件”，把路径粘贴到“包名、GitHub 仓库地址或本地目录路径”输入框，点击“安装”。路径不加引号，不填 ZIP 路径或上一级目录。安装源保持默认即可，不要在安装源里填 MCP 地址。
4. 回到插件页，确认“经管之家AI助手”已安装且已启用；展开详情时保留“检索规则”和“MCP 连接”组件启用。权限提示由用户确认。回到对话测试；若提示重启，保存工作后自行完全退出并重新打开 Harness。

安装后保留该文件夹，不要移动或删除。当前宿主采用本地目录引用；删除源文件会影响加载。普通技能上传与插件安装不是同一个入口。

## 验证和使用

先发送：“检查经管之家插件是否有更新。”

再发送：“在经管之家找 Stata 双重差分的教程和实证代码，读取相关原帖后给我推荐，并附标题链接。”

有 pinggu_check_updates 的真实检查结果，以及 mcp__pinggu__pinggu_search、mcp__pinggu__pinggu_read_thread 的调用结果才算验证；单纯给出论坛名或链接不算。服务连接检查只能证明服务器可达，不能证明本机插件已加载。

通道为 Harness → 经管之家 MCP → 论坛。论坛链接沿用 workBuddy=pinggu 加三位数字的来源标记；它不是身份认证或免限流凭证。网络异常、限流或验证提示时停止，不换入口反复重试。

## 更新

兼容的服务端优化自动生效，无需重新安装。插件规则或代码更新时，下载 Harness 专用新包，按插件页提示卸载旧版、安装新版目录；更新后保存工作并自行重启，检查启用和调用结果。不要把普通整合技能 ZIP 当作插件更新包。

当前插件随使用检查官方统一检索规则，本机通常每日联网检查一次；也可主动发送检查指令。没有运行时不后台推送。这个检查不代表未来宿主版本已兼容，也不代表对应 Harness 新包已经发布；以本页专用清单为准。检查失败不能宣称“已是最新”，已知低于最低支持规则版时需先更新。

## 福利与费用

安装福利状态以 https://mcp.pinggu.org/installation-status.json 和实际服务返回为准。用户主动领取时，用本人论坛 UID 调用 mcp__pinggu__pinggu_claim_benefits；不把 UID 送入搜索接口。奖励为 3 通用积分 + 100 论坛币 + 3 元论坛资金，到账、绑定要求、是否已领取均以真实返回为准。安装验证不得顺带领取。

经管之家内容检索、读帖，不收费。AI 对资料的理解、分析和回答，按所使用平台的正常规则计算算力。

## 无法安装或没有工具

- “不是插件包”：检查是否选择了含 package.json 的那层文件夹。
- “已安装”：查看原有插件，不重复装；更新需用户决定。
- “不兼容”：当前已验证宿主是 0.2.0-rc.2，先确认版本适配，不使用强制豁免。
- 安装成功但未加载：查看详情里的错误、组件开关和网络状态，按提示自行重启后再试。
- AI 无插件管理工具：改用手动安装，不要求用户改权限配置来绕过限制。