deepseek-harness-101

个人 DeepSeek Harness (DSH) 插件开发集。每个插件是独立仓库，以 git submodule 形式挂载到 plugins/ 下。

插件目录

插件	路径	作用
@momojie-s/dsh-workspace-mcp	plugins/dsh-workspace-mcp	按 workspace（session cwd）自动加载/卸载 MCP server，工具注册到 agent scope
@momojie-s/dsh-workspace-env	plugins/dsh-workspace-env	pwsh 命令自动注入 workspace .env 环境变量，实现 workspace 级环境变量隔离
@momojie-s/dsh-subagent-model	plugins/dsh-subagent-model	subagent_model 工具：委派子代理时可按次指定模型路由（provider/model/max_tokens），fork 自官方 tool-subagent

使用心得笔记

开发指南（docs/usage/，活文档——指导当前开发，随实践保持最新）：

• docs/usage/dsh-plugin-development.md — DSH 插件开发指南（形态、依赖注入、HMR 缓存、patch 限制、踩坑速查）
• docs/usage/mcp.md — 怎么在 DSH 添加 MCP server（插件 + patch + 踩坑）

调研笔记（docs/research/，版本快照——开头留版本基准，结论被新版本取代时归档，不追更）：

• docs/research/tool-description-channels.md — 工具使用说明如何暴露给模型：两条通道与三字段白名单（rc.6 源码调研）
• docs/research/agent-instructions.md — AGENTS.md/CLAUDE.md 及 .local 变体的发现、去重、预算与动态注入机制（agent-instructions 插件源码调研）
• docs/research/skill-catalog-shadowing.md — skill 目录注入失效调查：host/preset 双 tool-skill 互相剥目录（rc.6）

版本观察（自动）

计划任务 \dsh-version-check（每天 01:00）对比 npm 官方 @deepseek-ai/dsh 最新版与本机运行版：无新版则零成本退出；有新版则自动跑一次 headless 调查任务，总结新旧版本差异并逐个评估本仓插件是否需要改动/废弃，中文报告存 docs/version/（文件名 = 新版本号）。

• 触发脚本：scripts/check-dsh-version.ps1；调查指令模板（改它即改未来调查行为）：scripts/dsh-version-prompt.md
• 手动演练：powershell -NoProfile -ExecutionPolicy Bypass -File scripts/check-dsh-version.ps1 -CurrentVersion <旧版> -TargetVersion <新版>

使用

git clone --recurse-submodules https://github.com/Momojie-S/deepseek-harness-101.git
# 或 clone 后补拉子模块
git submodule update --init --recursive

新增插件

1. 在 GitHub (Momojie-S 账号) 建独立插件仓。
2. 在本仓执行：

   git submodule add https://github.com/Momojie-S/<plugin-name>.git plugins/<plugin-name>
   

3. 更新本 README 的插件目录表。