dsh-kanweave
KanWeave（织板）——可自行托管的项目管理产品（项目、列表、卡片、图片/视频附件、钉钉登录、按项目设置的角色、实时同步），既可作为独立 Web 应用运行，也可作为 DeepSeek Harness 插件运行。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Yeezone/kanweave#b41a9a262f1d7e41332061f7e93478623cea2f39Kanweave 以 dsh-kanweave 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
一个可以自己部署、也可以装进 DeepSeek Harness的项目管理产品：项目 → 栏目 → 卡片，卡片里能贴图、传视频、写 Markdown 评论；支持钉钉扫码登录、按项目邀请成员并设置管理员；多人同时看看板会实时同步。
零运行时 npm 依赖：数据库用 Node 内置的 node:sqlite，HTTP 用 node:http，构建产物是几个 .js 文件，拷到服务器上 node lib/standalone.js 就能跑。
LAUNCH-12）。Range 流式播放（可以拖进度条）。(corpId, unionId) 绑定）、邀请链接自带注册。需要 Node.js 24+（或 22.19+）和 pnpm。
git clone https://github.com/<your-account>/kanweave.git
cd kanweave
pnpm install
pnpm build
pnpm start # http://localhost:4280/kanweave/ui/
首次打开会要求创建初始管理员账号，随后在左侧 + 新建项目即可。数据默认在 ./.data（可用 KW_DATA_DIR 改）。
不想装 Node？用 Docker：
docker build -t kanweave .
docker run -d --name kanweave -p 4280:4280 -v kanweave-data:/data kanweave
连构建都省了：从 Releases 下载 kanweave-<版本>-standalone.zip，
解压后直接 node lib/standalone.js（压缩包里已含 lib/ 与 public/，无需 pnpm install）。
目标形态：一台云服务器 + 一个域名，任何设备打开同一个看板，DSH 插件也指向它。
cp .env.example .env # 填 KW_PUBLIC_URL / 钉钉应用 / KW_DATA_DIR
docker compose up -d --build
# 反代（自动 HTTPS）
sudo cp deploy/Caddyfile /etc/caddy/Caddyfile && sudo systemctl reload caddy
插件端只需一个文件让侧边栏面板连到云端：
// ~/.dsh/kanweave/cloud.json
{ "url": "https://pm.example.com" }
完整步骤（服务器/域名、HTTPS、钉钉回调、备份升级、排错表）：
# 方式一：脚本（写 profile 的依赖与 bundles，然后重启 DSH）
node scripts/install-dsh-plugin.mjs --profile desktop
# 方式二：命令行
dsh plugin --profile desktop add link:E:/Projects/ProjectEdit # 换成你自己的仓库路径
重启 DeepSeek Harness 后，侧边栏出现「织板」入口，面板内就是完整的看板。卸载：node scripts/install-dsh-plugin.mjs --profile desktop --remove。
插件默认使用本机数据目录 ~/.dsh/kanweave；配好 cloud.json 后改为转发到云端，本机不存项目数据（见 docs/deploy-cloud.md 第 4 节）。
按钮出现需要三个条件同时成立：
KW_DINGTALK_* 环境变量，或数据目录里的 dingtalk.json（插件/桌面端推荐后者，因为桌面启动器不便设环境变量）；开关脚本（插件数据目录默认 ~/.dsh/kanweave，独立站默认 ./.data）：
node scripts/set-dingtalk.mjs --status # 当前是否启用
node scripts/set-dingtalk.mjs --mock # 离线演示：按钮可点，不需要钉钉应用，只用于确认 UI
node scripts/set-dingtalk.mjs --clear # 关闭
接真实钉钉（企业内部应用，免审核，扫码登录不需要发布到工作台）：
node scripts/set-dingtalk.mjs \
--app-key dingxxxxxxxxxxxx \
--app-secret 你的AppSecret \
--corp-id dingyyyyyyyyyyyy \
--redirect-uri https://pm.example.com/kanweave/api/auth/dingtalk/callback
脚本写入的就是这个文件（权限 0600，字段名同时接受钉钉控制台的 appKey/appSecret 和 OAuth2 的 clientId/clientSecret）：
{
"appKey": "dingxxxxxxxxxxxx",
"appSecret": "你的AppSecret",
"corpId": "dingyyyyyyyyyyyy",
"redirectUri": "https://pm.example.com/kanweave/api/auth/dingtalk/callback"
}
重定向 URL 选哪个：云端部署后固定用
https://<域名>/kanweave/api/auth/dingtalk/callback，任何设备、任何插件实例都能回调，推荐。 本机直连http://127.0.0.1:<端口>/kanweave/api/auth/dingtalk/callback也能回调（钉钉允许 localhost），但 DSH 每次启动端口会变，要同步改配置，只适合临时调试。 改完文件后必须重启 DeepSeek Harness（或独立站进程）才生效；GET /kanweave/api/health的dingtalk字段（configured/mock）可以直接确认，登录页是否有按钮取决于api/auth/state的capabilities.dingtalkLogin。
| 变量 | 默认 | 说明 |
|---|---|---|
KW_PORT / KW_HOST | 4280 / 127.0.0.1 | 独立站点监听地址 |
KW_DATA_DIR | ./.data（插件为 ~/.dsh/kanweave） | SQLite + 附件目录 |
KW_PUBLIC_URL | 空 | 公网地址；https:// 开头会自动给会话 Cookie 加 Secure |
KW_COOKIE_SECURE | 跟随 KW_PUBLIC_URL | 纯 HTTP 演示需显式设 0 |
KW_MAX_ATTACHMENT_BYTES | 1 GiB | 单附件上限（反代要同步放宽） |
KW_ALLOW_REGISTRATION | 开 | 自助注册；外网可关掉只留邀请链接 |
KW_CLOUD_URL | 空 | 插件反向代理到云端部署的地址 |
KW_DINGTALK_CLIENT_ID / _CLIENT_SECRET / _CORP_ID / _REDIRECT_URI | 空 | 钉钉扫码登录 |
完整清单见 .env.example。
| 动作 | 观察者 | 成员 | 管理员 | 拥有者 |
|---|---|---|---|---|
| 查看项目 / 卡片 | ✅ | ✅ | ✅ | ✅ |
| 新建/编辑卡片、评论、上传附件 | ❌ | ✅ | ✅ | ✅ |
| 删除他人的卡片/评论/附件 | ❌ | ❌ | ✅ | ✅ |
| 管理栏目、项目设置 | ❌ | ❌ | ✅ | ✅ |
| 邀请成员、改角色 | ❌ | ❌ | ✅（不能授予管理员） | ✅ |
| 归档/删除项目、转让 | ❌ | ❌ | ❌ | ✅ |
src/core/ 协议类型、错误码、权限矩阵、媒体类型、Markdown 渲染（纯函数，浏览器可用）
src/host/ HTTP 路由、SQLite 存储、鉴权、钉钉 OAuth2、媒体存储、SSE、云端代理
src/client/ DeepSeek Harness 面板（React，iframe 承载同一个 SPA）
src/standalone/ 浏览器 SPA（React，无框架依赖，构建成 public/app.js）
public/ SPA 外壳（index.html + CSS）
/kanweave/* 的 HTTP 与存储；浏览器 SPA 只依赖 src/core 的类型与纯函数。src/core/protocol.ts，业务错误统一返回 HTTP 200 + {ok:false,error:{code,message}}。media/ 文件目录，备份就是复制这两样。pnpm typecheck # 零错误
pnpm test # vitest：真实 HTTP 集成测试 + 纯函数单测
pnpm build # tsdown 打包 lib/ 与 public/app.js，并跑客户端产物护栏
node scripts/smoke.mjs # 起真实服务跑冒烟
node scripts/check-client-bundle.mjs
工程约定见 AGENTS.md；参与贡献见 CONTRIBUTING.md；安全问题见 SECURITY.md。
Apache-2.0 © 2026 KanWeave contributors