Back to Details

duoduo-admin

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Duoduo Admin

Duoduo 管理

Use this skill as the host-mode entrypoint for users who do not yet have a clear mental model of duoduo.
对于尚未对duoduo形成清晰认知模型的用户，可将本技能作为主机模式相关操作的入口。

Start With Discovery

从探查开始

  1. Confirm the runtime mode with 
    duoduo daemon status
    .
  2. If the runtime is not in host mode, explain that this skill automates host-mode operations only and limit container-mode work to inspection unless the user explicitly asks for container-specific changes.
  3. Read 
    duoduo daemon config
    before making persistent changes. Treat that output as the source of truth for paths and active settings.
  4. If the daemon is down, start there. If the machine is not onboarded yet, explain that the user must finish 
    duoduo
    onboarding first.
  5. If the user says something is broken, first decide whether it is local misconfiguration, operator error, channel/plugin setup error, or a likely duoduo product bug.
  1. 用
    duoduo daemon status
    命令确认运行时模式。
  2. 如果运行时不在主机模式下，说明本技能仅自动化处理主机模式操作，除非用户明确要求容器专属变更，否则容器模式下的工作仅限制为检查操作。
  3. 进行持久化变更前先读取
    duoduo daemon config
    的输出，将其作为路径和生效设置的唯一可信来源。
  4. 如果守护进程已停止，先启动守护进程。如果机器尚未完成初始化接入，说明用户必须先完成
    duoduo
    的初始化接入流程。
  5. 如果用户表示有功能异常，首先判断是本地配置错误、操作人失误、通道/插件设置错误，还是可能属于duoduo的产品bug。

Explain Duoduo In Host-Mode Terms

用主机模式术语解释duoduo

Keep the explanation concrete and filesystem-first.
  • stdio
    is the default direct operator surface after onboarding.
  • duoduo daemon ...
    manages the long-lived runtime process.
  • duoduo channel ...
    manages installable external channel plugins.
  • ~/.config/duoduo/.env
    is the persistent host-mode settings file.
  • kernel/config/<kind>.md
    stores per-channel-kind defaults and kind prompts.
  • var/channels/<channel_id>/descriptor.md
    stores per-channel-instance overrides and instance prompts.
  • The host daemon is a detached background process. Updating package files alone does not replace the running process.
  • Re-opening 
    duoduo
    from the same real workspace path re-attaches the same stdio session key instead of creating a brand-new conversation surface.
Read references/host-mode-map.md when the user needs a fuller explanation of how these surfaces fit together.
解释内容要具体，优先从文件系统角度说明：
  • stdio
    是初始化接入后默认的直接操作入口。
  • duoduo daemon ...
    命令用于管理长期运行的运行时进程。
  • duoduo channel ...
    命令用于管理可安装的外部通道插件。
  • ~/.config/duoduo/.env
    是主机模式下的持久化设置文件。
  • kernel/config/<kind>.md
    存储各类通道的默认配置和类别提示词。
  • var/channels/<channel_id>/descriptor.md
    存储各通道实例的覆盖配置和实例提示词。
  • 主机守护进程是一个分离的后台进程，仅更新包文件不会替换正在运行的进程。
  • 从同一个实际工作区路径重新打开
    duoduo
    会重新绑定同一个stdio会话密钥，而不是创建全新的对话入口。
当用户需要更全面地解释这些入口如何协同工作时，请阅读references/host-mode-map.md。

Upgrade And Restart

升级和重启

When the user asks to update duoduo itself in host mode, use this sequence:
bash
npm install -g @openduo/duoduo@latest
duoduo daemon restart
Explain why the restart matters: the daemon is already running as a detached background process, so installing a newer CLI package does not hot-swap the existing daemon process.
当用户要求在主机模式下更新duoduo本身时，使用以下步骤：
bash
npm install -g @openduo/duoduo@latest
duoduo daemon restart
解释重启的必要性：守护进程已经作为分离的后台进程运行，因此安装更新版本的CLI包不会热替换现有守护进程。

Find Problems And Escalate

排查问题与升级反馈

When the user is reporting a bug or unexpected behavior:
  1. Reproduce or at least restate the exact symptom.
  2. Inspect the live state with the smallest useful commands, usually 
    duoduo daemon status
    , 
    duoduo daemon config
    , 
    duoduo daemon logs
    , and any relevant 
    duoduo channel ... status/logs
    .
  3. Separate local setup mistakes from probable product defects.
  4. If it looks like a duoduo bug or docs gap, prepare a public-safe issue summary for 
    openduo/duoduo
    .
Read references/issue-reporting.md when the user wants to file an issue or asks you to prepare one.
当用户报告bug或意外行为时：
  1. 复现问题，或者至少重述确切的故障现象。
  2. 使用最精简的有效命令检查实时状态，通常是
    duoduo daemon status
    、
    duoduo daemon config
    、
    duoduo daemon logs
    ，以及任何相关的
    duoduo channel ... status/logs
    命令。
  3. 区分本地设置错误和可能的产品缺陷。
  4. 如果看起来是duoduo的bug或文档缺口，准备一份可公开的问题摘要，提交到
    openduo/duoduo
    仓库。
当用户想要提交问题或要求你准备问题报告时，请阅读references/issue-reporting.md。

Route The Request

请求路由

  • Channel installation, channel lifecycle, Feishu setup, WeChat packaging, or channel prompt/workspace changes: read ../duoduo-channel-admin/SKILL.md and let that workflow own the implementation.
  • Runtime flags such as Codex, debug logs, telemetry, cadence, or daemon diagnostics: read ../duoduo-runtime-admin/SKILL.md and let that workflow own the implementation.
  • Confirmed bug report or docs gap that should be escalated publicly: use references/issue-reporting.md.
  • Mixed or vague requests: explain the mechanism first, then move into the smallest concrete change.
  • 通道安装、通道生命周期、飞书设置、微信打包，或是通道提示词/工作区变更：请阅读../duoduo-channel-admin/SKILL.md，交由该工作流处理具体实现。
  • 运行时标志，如Codex、调试日志、遥测、执行节奏，或是守护进程诊断：请阅读../duoduo-runtime-admin/SKILL.md，交由该工作流处理具体实现。
  • 确认需要公开上报的bug报告或文档缺口：使用references/issue-reporting.md。
  • 混杂或模糊的请求：先解释运行机制，再推进到最小粒度的具体变更。

Operating Rules

操作规则

  • Prefer live inspection over defaults. Use the actual daemon config, actual files, and actual channel list before claiming how the system is set up.
  • After editing 
    ~/.config/duoduo/.env
    , tell the user to run 
    duoduo daemon restart
    unless they explicitly asked for an edit-only change.
  • When the user asks to "understand duoduo", answer in terms of files, commands, and lifecycle rather than abstract architecture jargon.
  • Do not pretend a raw Git repository can be installed as a channel plugin. Duoduo's channel installer accepts npm package specs or 
    .tgz
    tarballs.
  • 优先使用实时探查结果而非默认值。在说明系统设置情况前，先使用实际的守护进程配置、实际文件和实际通道列表作为依据。
  • 编辑
    ~/.config/duoduo/.env
    后，告知用户运行
    duoduo daemon restart
    ，除非用户明确要求仅做编辑不生效。
  • 当用户要求「了解duoduo」时，用文件、命令和生命周期相关的内容作答，而非抽象的架构术语。
  • 不要误以为原始Git仓库可以作为通道插件安装。Duoduo的通道安装器仅接受npm包规范或
    .tgz
    压缩包。