# Contributing · 参与贡献

感谢你愿意改进 **dsh-beginner-hub（DSH 新手台）**！
这是一个面向 DeepSeek Harness 新手的引导插件，核心定位是**需求路由**（把大白话需求路由成可直接用的方案）。

## 快速开发环境

```powershell
# 1) 指向你的 DSH 数据目录
$env:DSH_HOME = 'D:\deepseek_harness_qwen\dsh_data'   # 换成你自己的

# 2) 目录链接安装（改代码即时生效；移动目录后需重装）
dsh plugin --profile web add link:<本仓库绝对路径>

# 3) 重启 dsh web，浏览器 Ctrl+F5
dsh web --no-open --port 3080
```

## 自检（提交前必跑）

```powershell
node --check lib\index.js
node --check lib\frontend\hub.js
node --check lib\frontend\external.js
node tests\smoke.mjs          # 离线冒烟：内容完整性 + frontmatter 解析 + 容错
```

## 改动指引

- **加/改路由意图**：只改 `lib/content/router-data.js`（意图/词表/方案卡数据表）。
  识别算法在 `lib/frontend/hub.js` 的 `classifyNeed()`（本地关键词打分，零网络）；
  若将来接模型理解，替换这一个函数即可，数据结构不变。
- **加生态推荐**：改 `lib/content/skills-catalog.js`，**必须**带真实来源链接与如实安装方式，禁止编造。
- **前端面板**：`lib/frontend/hub.js`（交互）+ `hub.css`（样式，类名前缀 `dshbh-`）。
  新增外部请求一律放 `lib/frontend/external.js`，并做失败降级。
- **服务端**：`lib/index.js` 只注册**只读**端点（data.json / skills.json / managers.json / status.json），
  不要引入写操作或外部依赖（`link:` 安装下插件必须零运行时依赖）。

## 提交规范

- 提交信息用中文，格式：`vX.Y.Z：一句话说清改了什么（可附影响）`；
- 一个提交聚焦一件事；先跑自检，再提交；
- 用户反馈类修复请在提交信息里注明来源（如“用户实测反馈”）。

## 代码风格

- 全部中文注释，说明“为什么”而非“做了什么”；
- 保持零依赖、本地优先（不发多余网络请求；只发用户当前输入原文做搜索）；
- 任何可能失败的操作都要有降级路径与用户可读文案。

## 行为准则

友善、聚焦、对事不对人；隐私第一（绝不提交凭据、日志或用户数据）。