96 lines
3.3 KiB
Go
96 lines
3.3 KiB
Go
// Copyright 2026 Alibaba Group
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package helpers
|
|
|
|
import (
|
|
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd/contract"
|
|
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/executor"
|
|
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/pkg/cmdutil"
|
|
"github.com/spf13/cobra"
|
|
)
|
|
|
|
func init() {
|
|
RegisterPublic(func() Handler {
|
|
return devHandler{}
|
|
})
|
|
}
|
|
|
|
// devHandler mounts the developer umbrella command `dws dev`, grouping the
|
|
// three developer-facing pillars under one entry:
|
|
//
|
|
// dev app application lifecycle (CRUD / credentials / permission /
|
|
// member / security / webapp / robot / version)
|
|
// dev connect link an existing robot to the local agent for debugging
|
|
// (promoted out of the robot subtree: it is a local-dev entry,
|
|
// not a robot configuration)
|
|
// dev doc open-platform developer doc search (bridges the devdoc
|
|
// product; `dws devdoc` keeps working independently)
|
|
//
|
|
// Future developer capabilities (event subscription, MCP tooling, ...) join
|
|
// as new subtrees here instead of new top-level commands.
|
|
type devHandler struct{}
|
|
|
|
func (devHandler) Name() string {
|
|
return "dev"
|
|
}
|
|
|
|
func (devHandler) Command(runner executor.Runner) *cobra.Command {
|
|
// Product-level Agent routing Decl (migrated from selection/dev.json
|
|
// products.dev). Catalog assembly stamps provenance contract_final.
|
|
contract.RegisterProductDecl(contract.ProductDecl{
|
|
ID: "dev",
|
|
Selection: contract.ProductSelectionDecl{
|
|
AgentSummary: "管理开放平台应用、权限、机器人、版本发布与本地连接器",
|
|
UseWhen: []string{
|
|
"创建/配置开放平台应用、机器人、权限、事件订阅或发布版本",
|
|
},
|
|
AvoidWhen: []string{
|
|
"只查开放平台文档用 devdoc；业务聊天/邮信用 chat/mail",
|
|
},
|
|
},
|
|
})
|
|
root := &cobra.Command{
|
|
Use: "dev",
|
|
Short: "开放平台开发者能力",
|
|
Long: "钉钉开放平台开发者命令组：应用生命周期管理（app）、机器人本地调试建联（connect）、开发文档搜索（doc）。",
|
|
Args: cobra.NoArgs,
|
|
TraverseChildren: true,
|
|
DisableAutoGenTag: true,
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
return cmd.Help()
|
|
},
|
|
}
|
|
cmdutil.MarkGroup(root)
|
|
|
|
doc := &cobra.Command{
|
|
Use: "doc",
|
|
Short: "开放平台文档搜索",
|
|
Args: cobra.NoArgs,
|
|
TraverseChildren: true,
|
|
DisableAutoGenTag: true,
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
return cmd.Help()
|
|
},
|
|
}
|
|
cmdutil.MarkGroup(doc)
|
|
doc.AddCommand(newDevDocSearchCommand(runner))
|
|
|
|
root.AddCommand(
|
|
newDevAppCommand(runner),
|
|
newDevAppRobotConnectCommand(runner),
|
|
doc,
|
|
)
|
|
return root
|
|
}
|