deepSea

DeepSeek Harness (DSH) 插件生态聚合站——发现、安装、管理、互联，一站式入口。

deepc.cn 聚合全 GitHub 的 DSH 插件生态，提供搜索、精选、安装指引、 社区讨论，以及 deepc-link 多端互联能力（WebRTC 加密通道远程控制本地 DSH host）。

• 官方库：https://github.com/deepseek-ai/deepseek-harness ("Everything is a Plugin")
• 互联插件：https://www.npmjs.com/package/deepc-link (Cloudflare Tunnel + 2FA 安全共享)

核心功能

功能	说明
插件生态搜索	全 GitHub 按 topics / 关键词搜索，汇聚 dsh-plugin 周边生态
插件精选	热门 / 最新精选画廊，封面流呈现生态亮点，直达插件详情
Discussions 社区	蓝鲸酒馆双社区：官方只读直连 + 自家可互动，分区清晰
安装与互助	统一生成检索安装指引，直连插件 Github issues 发起提问
多端互联	deepc-link 插件经 Tunnel+TOTP 加密通道远程控制本地 DSH 节点

技术栈

领域	选型
前端	Vite + React 19 + TypeScript + shadcn/ui (Radix + Tailwind CSS v4)
动效	animejs（展示 / 落地页）
数据	octokit 直连 GitHub API（REST + GraphQL）
后端	Cloudflare Worker（OAuth + 设备授权 + 信令 DO + 配置同步 + 审计）
互联	deepc-link（Cloudflare Tunnel + local Proxy + TOTP）
包管理	pnpm workspace monorepo

项目结构

deepSea/
├── apps/
│   ├── web/          # 主站点（Vite + React + shadcn/ui）
│   └── worker/       # Cloudflare Worker（auth 最小边界 + ASSETS）
├── packages/
│   └── deepc-link/   # 多端互联插件（node + browser 双端，npm 已发布）
├── scripts/          # 生态数据采集脚本（GitHub 搜索 / Discussions 同步）
├── docs/             # 设计文档（互联方案 / OAuth / 配置同步等）
└── .github/          # Copilot 指令 + skills

快速开始

环境要求

• Node.js ≥ 20.19.0
• pnpm ≥ 11（通过 corepack 或全局安装）

本地开发

pnpm install          # 安装依赖
pnpm dev:all          # 同时启动 worker (8787) + web (5174)
pnpm plugin:pack      # 构建 deepc-link 插件(tgz)

pnpm dev 单起前端（需 worker 已运行），pnpm dev:worker 单起 worker。 vite 会将 /auth/* 代理到 worker，OAuth 本地闭环。

本地 OAuth 配置

• apps/web/.env：VITE_GITHUB_OAUTH_CLIENT_ID + VITE_DEEPSEA_BASE=http://127.0.0.1:5174
• apps/worker/.dev.vars：GITHUB_CLIENT_ID + GITHUB_CLIENT_SECRET + TOKEN_ENC_KEY

构建与部署

pnpm build            # 全量构建（web + worker）
pnpm typecheck        # 全量类型检查
pnpm deploy           # typegen → build → 发布 Worker 到 Cloudflare
pnpm plugin:release   # 发布 deepc-link 到 npm（需 NPM_TOKEN）

Secret 管理（wrangler secret，交互式输入）：

pnpm secret:list                            # 列出已配置的 secret
pnpm secret:put -- GITHUB_CLIENT_ID         # 新增/更新
pnpm secret:del -- GITHUB_CLIENT_SECRET     # 删除

前置条件：

1. wrangler kv namespace create DEEPSEA_KV（id 填入 wrangler.toml）
2. pnpm secret:put -- GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET / TOKEN_ENC_KEY
3. 修改 apps/worker/wrangler.toml 后需 pnpm typegen

详见 docs/deepsea-oauth-worker.md。

deepc-link 互联插件

deepc-link 是 DSH 的多端互联插件，通过 Cloudflare Tunnel 实现安全的远程控制和数据同步，插件端对原生 3080 端口做鉴权代理，增加 2FA 连接码登陆后安全共享。实现真正的本地域内分享，以及安全可靠匿名的公网映射互联的丝滑体验。

一键安装：

dsh plugin --profile web add deepc-link@latest

本地联调：

pnpm plugin:pack      # 构建 + 打 tgz
dsh plugin --profile web add ./packages/deepc-link/deepc-link-<version>.tgz
# 安装后在插件 Sheet 打开底部「开发模式」→ 自动连本地 http://127.0.0.1:5174

详见 packages/deepc-link/README.md。

开发命令

pnpm dev              # 启动 web 开发服务器
pnpm dev:all          # 同时启动 worker + web
pnpm build            # 全量构建
pnpm typecheck        # 类型检查
pnpm lint             # oxlint 代码检查
pnpm format           # oxfmt 格式化
pnpm plugin:build     # 构建 deepc-link 插件
pnpm plugin:release   # 发布 deepc-link 到 npm（需 NPM_TOKEN）

UI 组件由 shadcn CLI 管理：pnpm --filter @deepsea/web dlx shadcn add <name>