Java 数据分析引擎foggy-projects/foggy-deepseek-harness-plugin

Foggy for DeepSeek Harness (Beta)

本软件包是 Foggy 的 Java 数据分析引擎的轻量级 DeepSeek Harness Bundle。安装该 Bundle 后，会在 Settings → Plugins 下添加一个原生的 Foggy 标签页。私有 Python 运行时、Launcher 和隔离的 CLI 环境仅在用户选择 Initialize and start（或等效的组件操作）时才会下载。升级插件包时，现有安装不会被静默更改。

DeepSeek Harness 使用系统 Node.js（^22.19.0 || >=24.0.0），Foggy 的 Java Launcher 使用系统 Java 17+。Foggy 在每用户组件目录内管理自己固定版本的 Python 3.12 运行时；它不需要系统 Python，不会修改 PATH，也不会全局注册 Python。高级用户可以将 FOGGY_PYTHON 显式设置为兼容的 Python 3.11+ 可执行文件。

本地 Beta 安装

dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-rc.3.tgz

重启 dsh web，使用它打开的浏览器（或完整的打印 URL，包括 ?token=...），打开 Settings → Plugins → Foggy Data Analysis，并在此处初始化组件。请勿分享启动令牌 URL。

在 npm Beta 发布后，对应的一行安装命令为：

dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@beta

更新插件包后，打开 Settings → Plugins → Foggy Data Analysis，并使用 Update components（或 Update and start）下载固定版本的 CLI、Launcher 和 Skills。设置页面会显示当前版本和目标版本。Runtime 运行期间会阻止更新，以避免活动 Java 进程与下一个启动器状态出现分歧。特定组件的修复操作仍可在 Advanced repair 下使用。

DeepSeek Harness 0.1.2-rc.1 对其 profile lockfile 应用 pnpm 的最低发布年龄策略。因此，在发布后不久执行升级可能会失败，并同时指出新插件或之前安装的 Beta。这是 DSH profile 策略失败，而不是 Foggy 包损坏。使用错误中打印的确切 profile 目录并重建其 lockfile，然后重新运行相同的 dsh plugin add 命令：

Set-Location ""
npx --yes pnpm@11.7.0 clean --lockfile

失败的 add 通常会在返回前将请求的确切版本记录到 minimumReleaseAgeExclude 下。如果错误重复出现，请确认错误中提到的已安装和请求的确切 Foggy 版本都出现在 profile 的 pnpm-workspace.yaml 中该键下；不要全局禁用该策略。

对于开发，FOGGY_ASSET_CACHE_DIRS 可以包含以平台分隔的已验证资产缓存目录。正常安装不需要它。

捆绑的入门 Skill 有意以开发为先。用户可以在对话中提供本地数据源密码、用户管理的
连接文件、Agent 环境变量或兼容的 Runtime
Console。直接密码会提交到已在运行的 Runtime，而不会被复制到 onboarding 状态或证据中。随后，该 Skill 会驱动 schema 发现、语义草拟、本地 Bundle 注册以及有界查询验证，而无需重启 Runtime。

原生 Skill 与工作区契约

该 Bundle 通过 DeepSeek Harness 的原生 Skill provider API 注册 foggy-deepseek-onboarding 以及下载的
foggy-ai-analysis。Skills
在每个 DSH 工作区中都可用，无需复制或符号链接 .agents。
当前会话的 cwd 仍然是语义草稿和
证据的工作区边界。

不透明 CLI 配置文件仍可供偏好使用它们的用户使用，并默认指向私有的持久化 /cli-profiles 目录，但它们不是普通开发的前提条件。复合 onboarding 命令是幂等的：未更改的已完成阶段会被恢复，而不是重新添加
数据源或重新注册本地 Bundle。恢复的数据源检查点
还会与实时 Runtime 进行对账；如果数据源在包装器之外被移除，则只会恢复数据源配置、验证和 schema 发现。Settings 会检测旧版临时
配置文件，并提供显式、经过验证的迁移到持久化存储。

私有 Python、CLI、Launcher、分析 Skill、安装状态和 Runtime
状态位于用户级 Foggy 组件目录中。受管理的 CLI 有意隔离，
不需要位于 PATH 上。重新下载 / 修复 会验证全局
分析 Skill，备份已修改或过时的受管理内容，恢复它，并使 DSH 的 Skill 目录失效。onboarding Skill 随插件捆绑，
并通过重新安装或升级插件包来恢复。

Foggy 设置选项卡显示持久化的数据库/语义 onboarding 阶段，
提供针对 CLI、Launcher 和受管理分析
Skill、私有 Python 的固定检查和修复，并导出私有脱敏诊断报告。该报告
包含 Runtime 日志的有界、已清理尾部，同时拒绝读取受管理 Runtime 目录之外的路径。Runtime 启动会在
wait-ready 期间监控 Launcher PID，如果 Java 退出则立即失败，并保持幂等：已记录的
进程会通过 wait-ready 和 capabilities 进行验证，而不是被视为
失败的第二次启动。

同一设置选项卡拥有一个持久化的本地 Runtime 端口。新安装默认
为 18166；用户可以在 Runtime 停止时选择另一个端口。启动时会检查
Java 服务器使用的同一通配符绑定，因此冲突的应用程序或 Windows
端口代理会产生立即、高可见性的错误，而不是就绪超时。
CLI 和 Skills 会从受管理状态解析出由此得到的稳定 Runtime URL。

此 beta 仍是本地开发/测试集成。它不会自动扩展
本地凭据或审批进入正式环境。生产模型发布应使用单独的手动或专用部署工作流，并具有明确的目标、模型 Git 提交/标签、凭据、验证和回滚计划。

有关经过测试的公开 Beta 范围、发布门禁和稳定版发布阻碍项，请参阅 docs/PUBLIC-BETA-READINESS.md。原生 Windows 验收说明位于 docs/WINDOWS-BETA-ACCEPTANCE.md；数据库凭据有意保留在公共仓库之外。

社区发现

DeepSeek Harness 目前不发布第一方插件市场。为了提高可发现性，本仓库旨在携带 GitHub dsh-plugin 主题。独立的社区目录及其提交规则记录在 docs/COMMUNITY-MARKETPLACES.md 中；被任何目录收录均属于社区筛选，并不代表 DeepSeek 或 Foggy 的认可。

Linux 和 WSL2 体验

Ubuntu 和 WSL2 用户可以使用 experience/linux 下已检入的预检安装程序。它将 DSH、其配置文件、项目工作区和 Foggy 数据保留在 Linux 原生文件系统上。