本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-task-board

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-client-ui-task-board

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Web 终端：xterm.js 远程终端，实时输出，窗口大小自适应；
• 文件传输：SFTP 上传 / 下载，有进度条，能浏览远程目录；
• 端口转发：本地隧道直连远程内网服务（数据库、API、管理后台），只监听 127.0.0.1；
• 集群执行：一条命令并发跑多台主机，按别名 / 环境 / 标签过滤；
• Agent 直连：Agent 和面板共用同一份主机配置，对话里说一句「连一下 xxx 看看状态」，智能体就去执行远程命令。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

关闭浏览器后任务还会继续运行吗？

会。任务执行由 Host 进程负责，浏览器只是异步视图；关页面或断网都不会停止已在运行的会话或 cron 调度。

任务数据存在哪里？

权威账本写在 Host 端 $DSH_HOME/task-board/ledger-v2.json，POSIX 文件权限 0600；旧版浏览器 localStorage 数据会在首次升级后按稳定 source/request id 一次性导入。

错过了 cron 触发点会补跑吗？

不会。Host 停机、系统睡眠或长暂停期间错过的触发点全部跳过，nextRunAt 直接从当前 Host 时间向后滚动。

能不能唤醒已经睡眠的电脑？

不能。电源保护只在「系统即将因空闲进入睡眠」时持锁，不会创建唤醒定时器，也不拦截合盖、手动睡眠、休眠或低电量强制睡眠。

任务执行会消耗 API 额度吗？

会。每次执行都创建独立的 DSH agent 会话，消耗与普通会话相同的 API 配额。

Linux 上需要什么前置？

需要 systemd-logind 并且当前用户被允许取得 idle block lock；容器、WSL、无 system bus 或非 systemd 系统会显示 unsupported，不启用桌面替代方案。

怎么通过反向代理暴露？

把 DSH Web 绑定到 loopback，设置 trustedProxyHosts 白名单，把高熵 token 放进 proxyTokenEnv 指定的 env，由代理在完成认证后替换 X-Dsh-Task-Board-Proxy-Token；修改后需重启 Host。

如何完全卸载？

dsh plugin --profile web remove @linxin666/dsh-client-ui-task-board，然后重启 dsh web；ledger 文件不会被插件自动删除。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.8（peerDependencies: @deepseek-ai/dsh-agent / @deepseek-ai/dsh-commands）
• Node: 源码未声明 engines；monorepo 约定 ^22.19 || >=24（package.json#devDependencies @types/node ^22.20.0）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则