前言¶
DeepSeek Harness (DSH) 的核心设计理念之一是「一切皆插件」，通过组合原生能力与外部插件来扩展智能体行为。在处理全栈工程任务时，常见的痛点包括缺乏结构化的执行流程、敏感操作缺乏边界约束、以及完成状态缺乏证据支撑。adithya-hmt/fullstack-expert 旨在解决这些问题，它不是更聪明的模型，而是围绕 DSH 现有能力构建的一套严谨的工程循环与安全层。
插件定位¶
名称：adithya-hmt/fullstack-expert
核心价值：Cordis-native（基于 Cordis 框架）、证据驱动的全栈工程规范。
定位：它为 DeepSeek Harness 编码智能体提供了一套工作流与安全机制，将仓库检查、垂直切片规划、敏感操作边界和验证证据记录流程化。
核心功能¶
该插件提供了一套完整的工程化手段，主要包括以下方面：
- 作用域方法论提示：定义了从理解代码、检查现状、设计架构、制定计划、实现功能、测试、审核到最终验证的完整闭环。
- 关键操作：
fullstack_plan：用于处理实质性工作，进行有界仓库检查并制定垂直切片计划。fullstack_check：用于结构化检查、命令验证或 Supabase 检查，并记录非验证类的审核事实。
- 安全与治理：
- 敏感操作边界：明确区分敏感操作。
- 权限分类：对操作进行分类。
- 审批感知预执行门：在执行敏感操作前检查审批状态，若无法审批则拒绝执行。
- 复杂度治理决策：基于需求、复用情况、依赖关系和安全控制进行决策。
- 证据与验证：
- 验证证据记录：要求必须通过原生 Harness 的证据记录才能完成。
- 只读 Supabase 项目证据检测：在只读模式下检测 Supabase 项目状态。
- 会话/工具结果观察：利用 Harness 的
session/event和tools/result进行观察。
安装与启用¶
在安装前，请确保已安装 DeepSeek Harness CLI。可以通过以下命令将插件作为配置文件集安装：
dsh plugin --profile web add git+https://github.com/adithya-hmt/fullstack-expert.git#v0.1.1
安装完成后，可以通过 dsh --profile web --dump-config 确认配置已生效，随后启动 Harness。若需手动配置，需确保宿主编排包含原生 Harness 行（如 dsh-fs, dsh-shell, dsh-tools 等），并将插件提供的 cordis.patch.yml 叠加到配置中。
使用方法¶
使用该插件时，需遵循特定的操作流程以确保工程规范落地：
- 准备编排环境：启动一个包含插件和原生 Harness 文件系统/工具/技能行的编排环境。
- 提出任务：向智能体请求功能开发、Bug 修复、代码审查、重构或应用构建。
- 执行规划：对于实质性工作，智能体应调用
fullstack_plan进行仓库检查，并制定垂直切片计划。 - 结构检查：使用
fullstack_check进行结构、命令或 Supabase 的只读检查，并记录审核事实。 - 完成验证：只有当通过原生 Harness 的验证证据记录且无相关失败时，才能视为任务完成。
适用场景与注意事项¶
该插件适用于需要严格工程规范和审计痕迹的全栈开发场景。使用时需注意以下几点：
- 能力边界：插件本身不提供浏览器驱动、Shell 执行器、文件系统后端、Dev Server 注册表、Supabase SDK、数据库客户端、部署适配器或模型提供商。它复用宿主 Harness 的能力，浏览器验证目前仅限于指南加证据记录（直到稳定的浏览器工具组合形成）。
- Supabase 操作：目前 Supabase 操作仅为检测和建议，敏感操作（如迁移、登录、推送等）必须由用户显式执行。
- 模型配置：插件假定 GPT-5.6 Max 已在 Harness 模型路由中配置，且配置文件中不应包含凭证。
- 许可证：该插件为 MIT 许可证。
结语¶
Fullstack Expert 通过定义明确的操作节点（fullstack_plan, fullstack_check）和严格的验证证据要求，帮助 Harness 智能体从「猜测式」编码转向「证据驱动」的工程实践。对于追求代码质量和操作安全的团队，这是一个值得纳入工作流的插件。
