feat(drivers/alidoc): add DingTalk Docs driver

README.md

@@ -95,6 +95,7 @@ Thank you for your support and understanding of the OpenList project.
   - [x] [OpenList](https://github.com/OpenListTeam/OpenList)
   - [x] [Teldrive](https://github.com/tgdrive/teldrive)
   - [x] [Weiyun](https://www.weiyun.com)
+  - [x] [DingTalk Docs](https://alidocs.dingtalk.com/)
 - [x] Easy to deploy and out-of-the-box
 - [x] File preview (PDF, markdown, code, plain text, ...)
 - [x] Image preview in gallery mode

README_cn.md

@@ -95,6 +95,7 @@ OpenList 是一个由 OpenList 团队独立维护的开源项目，遵循 AGPL-3
   - [x] [OpenList](https://github.com/OpenListTeam/OpenList)
   - [x] [Teldrive](https://github.com/tgdrive/teldrive)
   - [x] [微云](https://www.weiyun.com)
+  - [x] [钉钉文档](https://alidocs.dingtalk.com/)
 - [x] 部署方便，开箱即用
 - [x] 文件预览（PDF、markdown、代码、纯文本等）
 - [x] 画廊模式下的图片预览

README_ja.md

@@ -94,6 +94,7 @@ OpenListプロジェクトへのご支援とご理解をありがとうござい
   - [x] [OpenList](https://github.com/OpenListTeam/OpenList)
   - [x] [Teldrive](https://github.com/tgdrive/teldrive)
   - [x] [Weiyun](https://www.weiyun.com)
+  - [x] [DingTalk ドキュメント](https://alidocs.dingtalk.com/)
   - [x] [MediaFire](https://www.mediafire.com)
 - [x] 簡単にデプロイでき、すぐに使える
 - [x] ファイルプレビュー（PDF、markdown、コード、テキストなど）

README_nl.md

@@ -95,6 +95,7 @@ Dank u voor uw ondersteuning en begrip
   - [x] [OpenList](https://github.com/OpenListTeam/OpenList)
   - [x] [Teldrive](https://github.com/tgdrive/teldrive)
   - [x] [Weiyun](https://www.weiyun.com)
+  - [x] [DingTalk-documenten](https://alidocs.dingtalk.com/)
 - [x] Eenvoudig te implementeren en direct te gebruiken
 - [x] Bestandsvoorbeeld (PDF, markdown, code, platte tekst, ...)
 - [x] Afbeeldingsvoorbeeld in galerijweergave

drivers/alidoc/driver.go

@@ -0,0 +1,147 @@
+package alidoc
+
+import (
+	"context"
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/OpenListTeam/OpenList/v4/drivers/base"
+	"github.com/OpenListTeam/OpenList/v4/internal/driver"
+	"github.com/OpenListTeam/OpenList/v4/internal/model"
+	"github.com/go-resty/resty/v2"
+)
+
+type AliDoc struct {
+	model.Storage
+	Addition
+
+	client *resty.Client
+}
+
+func (d *AliDoc) Config() driver.Config {
+	return config
+}
+
+func (d *AliDoc) GetAddition() driver.Additional {
+	return &d.Addition
+}
+
+func (d *AliDoc) Init(ctx context.Context) error {
+	d.Cookie = strings.TrimSpace(d.Cookie)
+	d.RootFolderID = strings.TrimSpace(d.RootFolderID)
+	if d.Cookie == "" {
+		return fmt.Errorf("cookie is empty")
+	}
+	if d.RootFolderID == "" {
+		return fmt.Errorf("root folder id is empty")
+	}
+	d.client = newClient()
+	if err := d.checkCookie(ctx); err != nil {
+		return err
+	}
+	return nil
+}
+
+func (d *AliDoc) Drop(ctx context.Context) error {
+	d.client = nil
+	return nil
+}
+
+func (d *AliDoc) List(ctx context.Context, dir model.Obj, args model.ListArgs) ([]model.Obj, error) {
+	items, err := d.list(ctx, dir.GetID())
+	if err != nil {
+		return nil, err
+	}
+
+	objs := make([]model.Obj, 0, len(items))
+	for _, item := range items {
+		if strings.TrimSpace(item.DentryUUID) == "" || strings.TrimSpace(item.Name) == "" {
+			continue
+		}
+		objs = append(objs, toObj(item))
+	}
+	return objs, nil
+}
+
+func (d *AliDoc) Link(ctx context.Context, file model.Obj, args model.LinkArgs) (*model.Link, error) {
+	if file.IsDir() {
+		return nil, fmt.Errorf("alidoc does not support directory links")
+	}
+	resp, err := d.download(ctx, file.GetID())
+	if err != nil {
+		return nil, err
+	}
+	url, err := firstDownloadURL(resp)
+	if err != nil {
+		return nil, err
+	}
+	return &model.Link{
+		URL: url,
+		Header: http.Header{
+			"User-Agent": []string{base.UserAgent},
+			"Referer":    []string{apiBase + "/"},
+		},
+	}, nil
+}
+
+func (d *AliDoc) MakeDir(ctx context.Context, parentDir model.Obj, dirName string) (model.Obj, error) {
+	err := d.post(ctx, "/box/api/v2/dentry/createfolder", map[string]string{
+		"dentryType":             "folder",
+		"name":                   dirName,
+		"parentDentryUuid":       parentDir.GetID(),
+		"conflictHandleStrategy": "auto_rename",
+	})
+	if err != nil {
+		return nil, err
+	}
+	return nil, nil
+}
+
+func (d *AliDoc) Move(ctx context.Context, srcObj, dstDir model.Obj) (model.Obj, error) {
+	err := d.post(ctx, "/box/api/v2/dentry/move", map[string]interface{}{
+		"targetParentDentryUuid": dstDir.GetID(),
+		"sourceDentryUuid":       srcObj.GetID(),
+		"operateFrom":            1,
+	})
+	if err != nil {
+		return nil, err
+	}
+	return srcObj, nil
+}
+
+func (d *AliDoc) Rename(ctx context.Context, srcObj model.Obj, newName string) (model.Obj, error) {
+	err := d.post(ctx, "/box/api/v2/dentry/rename", map[string]string{
+		"dentryUuid": srcObj.GetID(),
+		"name":       newName,
+	})
+	if err != nil {
+		return nil, err
+	}
+	srcObj.(*model.Object).Name = newName
+	return srcObj, nil
+}
+
+func (d *AliDoc) Copy(ctx context.Context, srcObj, dstDir model.Obj) error {
+	return d.post(ctx, "/box/api/v2/dentry/copy", map[string]interface{}{
+		"sourceDentryUuid":       srcObj.GetID(),
+		"targetParentDentryUuid": dstDir.GetID(),
+		"operateFrom":            1,
+		"onlyCopyMeta":           false,
+	})
+}
+
+func (d *AliDoc) Remove(ctx context.Context, obj model.Obj) error {
+	return d.post(ctx, "/box/api/v1/dentry/recycle", map[string]string{
+		"dentryUuid": obj.GetID(),
+	})
+}
+
+var (
+	_ driver.Driver       = (*AliDoc)(nil)
+	_ driver.MkdirResult  = (*AliDoc)(nil)
+	_ driver.MoveResult   = (*AliDoc)(nil)
+	_ driver.RenameResult = (*AliDoc)(nil)
+	_ driver.Copy         = (*AliDoc)(nil)
+	_ driver.Remove       = (*AliDoc)(nil)
+)

drivers/alidoc/meta.go

@@ -0,0 +1,23 @@
+package alidoc
+
+import (
+	"github.com/OpenListTeam/OpenList/v4/internal/driver"
+	"github.com/OpenListTeam/OpenList/v4/internal/op"
+)
+
+type Addition struct {
+	driver.RootID
+	Cookie string `json:"cookie" type:"text" required:"true" help:"钉钉文档网页 Cookie"`
+}
+
+var config = driver.Config{
+	Name:        "AliDoc",
+	LocalSort:   true,
+	DefaultRoot: "",
+}
+
+func init() {
+	op.RegisterDriver(func() driver.Driver {
+		return &AliDoc{}
+	})
+}

drivers/alidoc/types.go

@@ -0,0 +1,87 @@
+package alidoc
+
+type apiResp struct {
+	Status    int    `json:"status"`
+	IsSuccess bool   `json:"isSuccess"`
+	Message   string `json:"message"`
+	Msg       string `json:"msg"`
+}
+
+func (r apiResp) ErrMessage() string {
+	if r.Message != "" {
+		return r.Message
+	}
+	if r.Msg != "" {
+		return r.Msg
+	}
+	return ""
+}
+
+type listResp struct {
+	apiResp
+	Data listData `json:"data"`
+}
+
+type listData struct {
+	Children []dentry `json:"children"`
+}
+
+type dentry struct {
+	DentryType       string `json:"dentryType"`
+	DentryUUID       string `json:"dentryUuid"`
+	ParentDentryUUID string `json:"parentDentryUuid"`
+	Name             string `json:"name"`
+	Path             string `json:"path"`
+	FileSize         int64  `json:"fileSize"`
+	CreatedTime      int64  `json:"createdTime"`
+	UpdatedTime      int64  `json:"updatedTime"`
+	ContentType      string `json:"contentType"`
+	Extension        string `json:"extension"`
+	DentryStatistic  struct {
+		ChildrenCount int `json:"childrenCount"`
+	} `json:"dentryStatistic"`
+	URL struct {
+		PCChildAppPreviewURL string `json:"pcChildAppPreviewUrl"`
+		PCChildAppURL        string `json:"pcChildAppUrl"`
+	} `json:"url"`
+}
+
+type downloadResp struct {
+	apiResp
+	Data downloadData `json:"data"`
+}
+
+type downloadData struct {
+	OSSURLPreSignatureInfo struct {
+		PreSignURLs []string `json:"preSignUrls"`
+	} `json:"ossUrlPreSignatureInfo"`
+}
+
+type uploadInfoResp struct {
+	apiResp
+	Data uploadInfoData `json:"data"`
+}
+
+type uploadInfoData struct {
+	CurrentTimestamp         int64                  `json:"currentTimestamp"`
+	FileUploadProtocolConfig uploadProtocolConfig   `json:"fileUploadProtocolConfig"`
+	STSSignatureInfo         uploadSTSSignatureInfo `json:"stsSignatureInfo"`
+	UploadKey                string                 `json:"uploadKey"`
+	UploadType               string                 `json:"uploadType"`
+}
+
+type uploadProtocolConfig struct {
+	MinPartSize int64 `json:"minPartSize"`
+}
+
+type uploadSTSSignatureInfo struct {
+	AccelerateCname       string `json:"accelerateCname"`
+	AccessKeyID           string `json:"accessKeyId"`
+	AccessKeySecret       string `json:"accessKeySecret"`
+	AccessToken           string `json:"accessToken"`
+	AccessTokenExpiration int64  `json:"accessTokenExpiration"`
+	Bucket                string `json:"bucket"`
+	Cname                 string `json:"cname"`
+	EndPoint              string `json:"endPoint"`
+	ObjectKey             string `json:"objectKey"`
+}