rulebase
RuleBase：全局+项目两级 md 规则文件，注入 dsh 系统提示词，并在设置面板提供规则管理界面。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:mycodesite/dsh-rules#12bee363f7331fcd444d6c7dd7483b1e566426b8Rulebase 以 rulebase 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness (dsh) 插件：全局 + 项目两级 Markdown 规则注入
以「全局 + 项目」两级 Markdown 规则文件为源，在每次对话开始 / 每次系统提示词组装时把规则注入给 AI，并在 dsh 设置面板提供可视化规则管理界面。
它能为你做什么：
~/.dsh/rules/）管所有项目共用的规矩；项目规则（<cwd>/.dsh/rules/）跟着 agent.session.header.cwd 走，切到哪个项目就套用哪个项目的规则，跨项目切换自动跟随。一句话：RuleBase 让 AI 助手成为「懂你项目规矩的协作者」，把重复的口头交代固化成一劳永逸、随项目自动启用的规则库。
规则仅以 .md 文件持久化，不注册 dsh settings 命名空间、不写入 settings.yaml。
agent.session.header.cwd 扫描项目规则；全局 + 项目全量组装、全量替换，注入系统提示词。session.header.cwd」作为当前项目路径（currentCwd），dsh 切换项目后自动跟随；无活跃 agent 或无有效 cwd 时视为「未选定项目」。agent.inject()；保存规则后下一次模型请求自动采用。--dsw-alias-* 主题 token）；项目 tab 在未选定项目时提示「请先开启一个项目对话」，保存项目规则时无项目会弹窗提示。| 级别 | 目录 |
|---|---|
| 全局 | ~/.dsh/rules/*.md |
| 项目 | <cwd>/.dsh/rules/*.md |
每个 .md 文件即一条规则；文件名（去扩展名）作为规则 id。
⚠️ 不要在插件市场更新本插件。插件市场中升级的不是本插件，而是与之同名的其他项目。本插件未打包至 npm，但 npm 上有重名项目；下载安装该重名包会使 DeepSeek Harness 无法启动。请始终通过下文的 GitHub 源或本地 tarball 安装本插件。
# 最新版（git 源安装，仓库含预构建产物，安装即用）
dsh plugin add github:mycodesite/dsh-rules
# 指定版本
dsh plugin add github:mycodesite/dsh-rules#v0.1.3
# 指定 profile（web / tui 等）
dsh plugin --profile web add github:mycodesite/dsh-rules
dsh plugin --profile dsh-tui add github:mycodesite/dsh-rules
注意：
dsh plugin是 pnpm 转发器。发布包已含预构建产物（lib/），git 源安装即装即用，无需在 profile 的pnpm-workspace.yaml中放行构建脚本（allowBuilds）。
dsh 版本支持线（v0.1.4 起）：dsh ≥0.1.5-rc.1。0.1.5 起 client-connection 的
rpc.handle两参化、connection服务先于webServer可用，本插件已按新范式适配（规则端点经/api共享通道精确路由/api/rulebase/<op>承载、per-channelauthority选项废弃、鉴权由传输层 BrowserAuth + Host/Origin fence 统一接管）。面板操作失败不再静默挂起：任何失败均以错误文本或弹窗可见呈现。 旧版 dsh（≤0.1.1-rc.2）不在支持范围。
也可以下载 GitHub Releases 中的最小化 tarball（仅含构建产物与 patch），本地安装：
dsh plugin add /path/to/rulebase-<版本>.tgz
# 指定 profile 安装本地包
dsh plugin --profile <模式> add /path/to/rulebase-<版本>.tgz
| 安装方式 | 命令 | 需构建 | 需该目录有 node_modules | 新环境 |
|---|---|---|---|---|
| tarball（推荐分发） | dsh plugin add /abs/rulebase-<v>.tgz | 否 | 否 | ✅ |
| GitHub（推荐分发） | dsh plugin add github:mycodesite/dsh-rules#v<tag> | 否（lib/ 已入库） | 否 | ✅ |
| link:（开发态）· 源码树已构建 | cd <checkout> && dsh plugin add . | 是（先 npm run build） | 否（v0.1.2 起） | ⚠️ 需先构建 |
| link:（开发态）· 源码树未构建 | 同上 | — | — | ❌ 无 lib/ 即失败（与依赖无关） |
| 开发态 overlay | 见下节（直接挂 src/） | 否 | 否（v0.1.2 起） | ⚠️ |
运行时零依赖带来的改变（v0.1.2 起）：已构建的源码树以
link:安装时，不再需要该目录下有node_modules。构建本身仍需 devDependencies（tsdown/esbuild）——这是开发期依赖，正常且不可避免。
# web profile
dsh plugin --profile web remove rulebase
# tui profile
dsh plugin --profile dsh-tui remove rulebase
注意：
remove的参数必须用注册名（包名）rulebase，不能用安装源写法（如mycodesite/dsh-rules、github:mycodesite/dsh-rules、dsh-rules）。dsh plugin是 pnpm 转发器，remove按 profilepackage.json中依赖的 key 匹配——该 key 是 pnpm 安装时解析出的包名rulebase，与安装时使用的源写法无关；用源写法会报ERR_PNPM_CANNOT_REMOVE_MISSING_DEPS: no such dependency found（web 与 tui 行为一致）。卸载后dsh.profile.bundles层也会自动移除该插件。
npm install
node scripts/make-dev-patch.mjs # 生成 cordis.local.yml（git 忽略，不提交）
dsh web --patch ./cordis.local.yml # web 模式
dsh --profile dsh-tui --patch ./cordis.local.yml # tui 模式
.npmrc中已配置legacy-peer-deps=true，开发态安装无需手动传--legacy-peer-deps标志。
cordis.local.yml 由脚本按仓库绝对路径生成，仓库内不写死本机路径，克隆后可移植。
| 命令 | 说明 |
|---|---|
npm run build | 构建 host 半（tsdown → lib/index.mjs）+ client 半（esbuild → lib/client.js）+ 产物守卫（check:artifact） |
npm run typecheck | 类型检查（host + client 两个 project） |
npm test | 运行单测（tests/*.test.ts：smoke 端到端护栏 + contract 契约护栏） |
npm pack | 产出最小发布 tarball（files 白名单） |
node scripts/release.mjs | typecheck + test + build + pack 一键发布准备 |
node scripts/make-dev-patch.mjs | 生成开发态补丁 cordis.local.yml |
npm run sync-dsh | 同步 devDependencies 到 DSH 最新预发布版（next 通道） |
npm run update-dsh | 同步 + 安装 |
npm run check-deps | 严格模式验证依赖兼容性（CI 用） |
src/
├─ host/
│ ├─ index.ts # 装配入口（apply）：store / injector / service
│ ├─ paths.ts # 规则级别与目录解析
│ ├─ store.ts # RuleStore：md 文件读写
│ ├─ injector.ts # RuleInjector：注入与刷新（异步读盘 + 同步读缓存）
│ └─ service.ts # RulesService：Connection RPC 桥（UI↔host）
├─ client/
│ ├─ index.ts # 注册 settings.section
│ ├─ types.ts # 最小类型（Rule / RpcResult）
│ ├─ controller.ts # RuleController：列表状态机 + rpc 客户端
│ └─ RuleSection.tsx# 设置面板「规则」区 UI
scripts/
├─ build-client.mjs # client 半 esbuild 构建
├─ make-dev-patch.mjs # 生成开发态补丁
├─ release.mjs # 发布准备（typecheck+test+build+pack）
└─ sync-dsh-deps.mjs # 自动跟随 DSH next 通道同步 devDeps
tests/
└─ smoke.test.ts # RuleStore 全量读写 / 路径解析
docs/
├─ API文档.md # 模块 API 总览
└─ api/ # 分模块文档
.github/workflows/ci.yml # CI：typecheck + test + build + pack（tag 自动发 Release）
>= 22.5@deepseek-ai/dsh-* 与 @deepseek-ai/cordis 仅有编译期类型依赖（import type，转译后擦除）；宿主契约函数（createUserMessage / transportError）已在 src/host/contract.ts 本地逐字实现。因此任意安装形态、任意新环境（包括无 node_modules 的目录）均可直接运行，不依赖宿主依赖闭包。npm run build 内置产物检查（check:artifact），产物含任何 @deepseek-ai/* 运行时导入即构建失败——这是本插件的核心安全不变量，由 CI 与 npm pack（prepack → build）双重覆盖。MIT © mycodesite