开发流程（development）

dsh-web-ui 是 DeepSeek Harness Web GUI 的插件与皮肤 monorepo。本文定义贡献者日常流程；仓库规则见根 AGENTS.md，包级规则见 packages/AGENTS.md，文档标准见 AGENTS.md。

环境准备

Node.js >= 22 与 pnpm 11；
依赖解析官方 NPM SDK（registry.npmjs.org）。仍使用私有 scope 认证时需 NPM_TOKEN 环境变量（真实令牌只放环境变量，勿提交）；token 配置放用户级 ~/.npmrc，项目 .npmrc 只留 scope 映射（见 plugins.md）。

日常循环

pnpm install
pnpm -r build          # 全仓构建
pnpm typecheck        # 全仓类型检查
pnpm test             # 全仓单测
pnpm docs:check       # 文档一致性（链接 / README / i18n 配对）

改动提交前至少跑 pnpm typecheck && pnpm test && pnpm docs:check；CI 会全量跑所有门禁（typecheck / build / test / aggregate / gallery / skin-center / docs / emoji）。

常见任务

审核远程 PR

维护者可用 node scripts/pr-review.mjs 本地批量审核外部 PR（一次多个，如 --open 审核全部 open PR）：先做静态硬性检查（规模上限新增/删除各 1 万行直接拒绝、禁止提交依赖缓存与密钥、emoji 扫描、PR 模板必填项、密钥扫描、CI 文件保护），再在工作区 worktree 上按 CI 门禁序列构建验证（install/typecheck/gallery/skin-center/community/build/test/ test:scripts/aggregate/docs）。worktree 与 e2e 验证统一放在 ~/remote-e2e（同 head 复用，跑完保留便于排查），定期用 pnpm pr:review --cleanup 或手动 rm -rf ~/remote-e2e 清理。

皮肤 PR 额外自动做视觉验证：生成亮/暗预览与画廊页截图（ ~/remote-e2e/e2e-<pr>/previews/），像素指标分析自动判定过曝（太闪）与对比度不足（看不清），截图供视觉模型复核；同时提醒作者声明贡献者版权（模板「贡献者版权声明」节），并检查新皮肤是否适配画廊（gallery/bundles.js/gallery/manifest.js 注册与 docs/screenshots/ 截图）。用法与 verdict 语义见脚本头部注释；pnpm pr:review --help 查看全部选项。

修改 shared 运行时模块

shared/ 是 settings 卡片、轮询护栏、DSH_HOME 解析等跨包模块的唯一事实源；各包内的同名文件是 scripts/sync-shared.mjs 生成的同步副本。改 shared 源后运行 node scripts/sync-shared.mjs 并把副本一并提交；pnpm test:scripts 的 drift 门禁防止副本漂移。

新增插件包

node scripts/dsh-plugin-new <name>   # 生成 packages/<name>/ 骨架

然后按 plugins.md 把包注册进聚合包（aggregate.yml 的 patchFrom 与 deps），跑 node scripts/aggregate.mjs 重新生成聚合包。新包必须自带 README 三件套（README.md + README.zh.md + README.i18n.yaml）与测试。

新增皮肤

node scripts/dsh-skin-new          # 生成 packages/skins/<id>/ 骨架
pnpm --filter @linxin666/dsh-skins build   # 皮肤资产并入 dsh-skins
pnpm gallery:build                # 画廊产物

皮肤启用互斥由 dsh-skin use 管理（~/.dsh/cordis.patch.yml managed 区段）；皮肤资产全部内置在 dsh-skins 一个包里，不单独发 npm 包。

本地验证（挂载进 dsh web）

node scripts/link-profile.mjs      # 把全家桶链接进 web profile
dsh plugin --profile web add link:<仓库绝对路径>/packages/dsh-web-ui-all
dsh web                            # 重启后侧边栏出现插件入口

发布

发布流程见 publish-prep.md 与 .github/workflows/ release.yml：推送 vX.Y.Z tag 触发发布，tag 是版本唯一来源， scripts/verify-version.mjs 在发布前校验每个包版本与 tag 一致。

文档纪律

任何改动触及 README / AGENTS.md / docs/ 描述的行为时，同 PR 更新文档；
改包 README 任一侧后，同步另一侧并 pnpm docs:write-pair <包名>；
一次性记录（任务交接、验证快照）放 docs/archive/，不进长期文档目录。

FilesExpand file tree

development.md

Latest commit

History