安全与参考

命令行（CLI）

日常请用桌面工作台。命令行适合在终端里查状态、改频道、跑诊断，或把 CogineWork 接到其他编辑器。桌面已经能完成的事，不必再学一套命令。

如果你的组织已通过受信任渠道提供 CogineWork 命令行，先看当前安装版本的帮助：

bash

coginework --help

不要从未知来源安装命令行包，也不要把包含凭据的终端输出直接发送到支持渠道。

启动服务与旧 workers 参数

手动启动服务时可以先查看当前参数：

bash

coginework app --help
coginework app --host 127.0.0.1 --port 8088

旧的 --workers 参数已移除。它此前被忽略，服务始终使用一个 worker；移除后仍为一个 worker。升级前请修改启动脚本、容器命令和服务管理配置：

bash

# 旧命令：现在会报 No such option: --workers，服务不会启动
coginework app --host 127.0.0.1 --port 8088 --workers 4

# 新命令：删除 --workers 及其值，其余参数保留
coginework app --host 127.0.0.1 --port 8088

这次移除不提供多 worker 替代配置。不要把此前被忽略的数值当作实际并发进程数。

自动化

普通 Automation、Reminder 和 Monitor 使用产品级命令：

bash

coginework automation --help
coginework automation create --help
coginework automation monitor --help

用 --agent-id 选择拥有任务的智能体。创建 Automation 或 Reminder 时，如果不指定外部渠道，服务端会投递到当前 Console。需要完整 Cron JSON、高级字段或兼容入口时使用：

bash

coginework cron --help

Automation 与 Reminder 不提供相互转换命令；需要另一种类型时请创建新任务。界面路径见自动化。

诊断

只读检查本机配置、依赖和常见损坏：

bash

coginework doctor
coginework doctor --deep

默认检查配置结构、必需凭据和本地依赖。
--deep 对支持的频道做有界连通性探测。这不是生产消息验证，也不能替代平台权限或真实机器人验收。

需要保守修复时，先预览再动手。修复会先备份，不会靠删除智能体、工作区、凭据或备份来“成功”：

bash

coginework doctor fix --dry-run --help

终端界面（TUI）

在已经装好命令行的机器上，可以直接进入终端对话：

bash

coginework tui --help

TUI 会在当前解释器里拉起 ACP 会话，用来继续某一次终端对话，不是桌面工作台的替代品。桌面用户请继续用 Work。

ACP

把 CogineWork 当作 ACP 智能体、通过标准输入输出接到其他客户端时：

bash

coginework acp --help

可以指定 --agent 和 --workspace。工作台里的「编码智能体」也使用 ACP runner，但 Node 运行时在 设置 → 开发者 统一管理，不必为了日常对话去开这条命令。

守护进程

查看本机服务状态、版本、日志，或要求重新读取配置：

bash

coginework daemon --help
coginework daemon status --agent-id default

命令行里的 restart 只会打印如何重启，它本身没有桌面那种可杀的图形进程。改完配置后，优先在工作台里保存并观察智能体是否重新加载。

频道

频道配置按智能体隔离。未指定时，查询和交互配置默认使用 default。

bash

coginework channels list --agent-id default
coginework channels config --agent-id default

输出包含内建和插件注册的频道，并遮罩已知凭据字段。CLI 会在构建菜单前加载已安装的频道插件。 show_tool_details 是根级全局配置，不属于每频道字段。显示默认值和主动发送步骤见频道。

主动发送前必须先查询真实会话，再使用稳定用户和会话 ID：

bash

coginework chats list --agent-id default --channel feishu

coginework channels send \
  --agent-id default \
  --channel feishu \
  --target-user '<user-id>' \
  --target-session '<session-id>' \
  --text '通知内容'

--agent-id、--channel、--target-user、--target-session 和 --text 都是必需参数。不要猜测 ID，也不要用显示昵称替代查询结果。

如服务不在默认地址，可以使用 --base-url 覆盖 API 地址；凭据不应放进 URL query。

安全边界

CLI 能显示或修改某项，不表示当前角色一定有相应权限；服务端策略仍会执行。
自定义 gateway、代理、非 loopback OneBot 监听和远程媒体路径属于高风险配置，必须经过策略与验证。
命令失败时可以共享经过脱敏的错误类型和 correlation ID；不要复制 token、secret、完整配置或原始 Provider/transport body。
配置迁移不会通过删除 Agent、Workspace、session、skill、plugin、model、secret 或 backup 来成功。

相关页面：工作台 · 频道 · 工作台配置 · 自动化 · 插件 · 开发频道插件

单轮任务权限

agents chat --approval-level ask_for_approval|approve_for_me|full_access|strict 显式设置本轮权限，适用于 final、stream 和 background。省略参数使用目标 Agent 默认，不读取浏览器 localStorage，也不更改 Agent 配置。插件应通过 host.getTaskPermission({agentId, chatId}) 取得选择再传入。

--chat-id 可与 --background 一起使用，仍要求匹配的 --session-id 和 --from-agent 用户身份；宿主复用聊天入口的任务身份与运行冲突校验。权限模式不替代询盘、发布等业务确认。