企业官网建设流程全解析

DSH Taskboard（shengsheng90/DSH-taskboard）是 DeepSeek Harness 的原生本地项目任务板：SQLite 是任务共享状态的唯一权威，侧栏会多一个「任务板」入口，点开是原生 overlay 页面而非 iframe。装完没反应九成不是插件坏了，按下面五步走；同类清单与安装形态见 完整插件清单与汉化避坑指南。

风险先说清。站点把它标为「需留意」，安全说明原文是「读写本地 SQLite 任务库文件；不会执行任意 shell」；安全扫描显示含敏感能力（执行外部命令 / 读写删除本地文件 / 发起外部网络请求），尚无人工评估。它不是「无风险」，也不是「已验证安全」。

五步排查顺序

1. 探测运行中的 Harness。3080 只是缺省端口：先lsof -iTCP:3080 -sTCP:LISTEN找监听 PID 并确认其 cwd。cwd 是源码 checkout（有pnpm-workspace.yaml且 package.json 含"dsh"script）就写pnpm dsh ...，否则有dsh就用dsh ...。

1. 重装或换来源。npm、Git、release.tgz任选一条，命令统一带-w。

1. --dump-config验证组成。dsh --profile web --dump-config尾部出现以# ==开头点名该包的注释层即通过。

1. 模块解析冒烟。在~/.dsh/profiles/web下导入该包，通过时打印OK taskboard function。

1. 重启并轮询确认激活。重启会中断在跑的 Agent 回合（会话数据在$DSH_HOME/sessions不丢），先告知操作者。

下面五个坑对应这五步最容易翻车的位置；完整对照见 完整插件清单与汉化避坑指南。

坑一 · 提示找不到 dsh 命令

现象。执行dsh plugin --profile web add -w @shengsheng/dsh-taskboard报dsh: command not found。

原因。CLI 未进PATH，基本只出现在 Harness 是源码 checkout 的机器上——那时dsh由 checkout 里的 pnpm 脚本驱动，并非全局二进制。

解决。回到 checkout 根目录，把后续命令写成pnpm dsh ...。调用方式判错，后面每步都会跟着失败。

坑二 · 安装报要装到 workspace 根

现象。add失败，错误码ERR_PNPM_ADDING_TO_ROOT。

原因。profile 目录本身就是 pnpm workspace 根（packages: [.]），pnpm 默认拒绝往根写依赖；这不是权限问题。

解决。命令加-w（workspace root），README 写明它是 mandatory。add随后改写 profile 的package.json、lockfile 与node_modules，属预期行为。

坑三 · 装出来的包缺少构建产物

现象。依赖装上了但加载失败，node_modules里包里没有lib/。

原因。旧 Git ref 装出的版本没有分发构建产物。

解决。换带预构建产物的新版本。Git、npm 与 release tarball 都携带已构建的 Host/Client 产物，装的时候不需要编译；npm 上最新是0.1.8（2026-10-08）。安装成功三条件：dependencies有该包、dsh.profile.bundles在@deepseek-ai/dsh-base之后列出它、node_modules下该包含lib/与cordis.patch.yml。

坑四 · 装完侧栏没有入口

现象。前几步全过，刷新后侧栏底部仍无入口；或刚重启就以为「已就绪」，结果访问插件页 404。

原因。插件组成与 client-modules 扫描只在启动时执行，装进 profile 不会热加载 UI；Web 服务还可能先于 boot manifest 注入就接受连接。

解决。必须重启 Harness，并轮询到GET /里包名计数 ≥1 为止，不要把第一次成功的GET /当就绪：

包名计数 ≥1、client.js返回 200、启动日志无 import / apply 错误、侧栏出现入口，四条齐了才算激活。

坑五 · 冒烟测试报找不到 peer

现象。第 4 步导入失败，报找不到 peer，常见是@deepseek-ai/*或react。

原因。peer 经~/.dsh/profiles/node_modules的回退链接解析，而回退链接由 Harness 启动时自动修复，手动冒烟时可能还没修。

解决。先重做第 4 步--dump-config再重试导入，不要手动去装 peer。该包 22 项 peer 全由宿主提供，运行依赖只有zod。

总结

装完没反应，九成是「调用方式、安装来源、组成验证、模块解析、重启激活」其中一环没闭环；想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。

适合与不适合

适合：想给本地项目配一块与 Agent 协作的任务板的人；已在用 DSH 且有 web profile 的团队；希望任务状态以 SQLite 为唯一权威的人；想让 Agent 产出停在in_review、由人验收的团队。

不适合：站点把它标为「需留意」、安全说明原文是「读写本地 SQLite 任务库文件；不会执行任意 shell」，对插件权限要求强合规审查、期待「无风险」结论的团队；只服务单机单项目、不愿用绝对路径钉住数据库与附件根的人；指望 Agent 自己把任务标成done的人——Agent 的成功终点就是in_review，验收只能由人经 UI 或 CLI 产生。

标签：DSH Taskboard、DeepSeek Harness、安装排错、本地任务板、插件故障排查

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。