跳到正文

orziz/odai

8416最近提交 2026年8月15日

odai DSH 插件

odai 是一个基于治理的通用任务执行框架，专为 AI 智能体设计。它将治理嵌入执行：对齐真实目标、事实、假设、授权、风险和验收标准；然后选择最短的足够路径，组合合适的能力，执行、验证，并持续推进，直到任务真正可交付。它不会用僵化的工作流取代模型的判断。

developer-toolsskills-workflows

如何安装 odai DSH 插件

dsh plugin --profile web add odai-dsh-plugin

复制不会执行命令。安装 odai DSH 插件前请核对仓库和版本。

odai DSH 插件数据来源

odai DSH 插件快照日期：2026年8月16日

discovered

odai DSH 插件能做什么

  • 持续评估任务的复杂度、清晰度、授权和验证需求，以决定处理深度。
  • 支持主机能力路由：用户确定每个责任应由谁负责，odai 根据主机的实际能力目录推荐映射。
  • 提供三种输出模式：简洁软输出、正常输出和经济模式（用户可调整提供商输出上限）。
  • 在询问用户之前，从文件、命令、日志、测试或项目上下文中验证可验证的内容。
  • 仅在任务需要时组合专业技能和领域指导，避免在每个回合塞入所有规则。

odai DSH 插件适合哪些场景

  • 更新引导流程文案，明确目标，不改变行为，先提供提案文案和风险。
  • 为项目安装并验证能力路由，使用 odai 从主机能力目录自动映射。
  • 重构代码并应用治理：理解真实目标，验证变更，确保交付物真实可靠。
  • 生成带约束的报告：odai 根据任务和项目证据推断所需深度、能力和领域知识。
  • 管理项目护栏：odai 尊重项目声明的只读路径和验收命令。

odai DSH 插件适合谁

  • 希望智能体自主行动但又不盲目自信的 AI 智能体开发者。
  • 使用 DeepSeek Harness 的用户，希望为每个智能体预设应用治理层，或选择可选的会话级智能体预设。

odai DSH 插件的限制

  • 需要 DSH（DeepSeek Harness）运行时才能使用插件集成；Agent 安装器目前需要 dsh@0.1.0-rc.6。
  • 主机能力路由受限于主机；仅凭技能文本无法机械地保证其生效。如果主机无法验证模型切换或委派，odai 将使用一个足够的控制器。
  • 经济模式的输出上限是按回合的，提供商可能超出或忽略此上限。
  • 同时安装 Plugin 和 Agent 通常是冗余的，仅用于有意的范围组合。

odai DSH 插件的仓库 README 摘录

以下文字摘自 odai DSH 插件的上游仓库 orziz/odai 的 README，版权归原作者，仅作引用。

**English** · [中文](README.zh-CN.md) # odai <p align="center"> <img src="assets/odai-readme-badge.png" alt="Dai, the odai mascot" width="720"> </p> `odai` is a governance-powered general task-execution framework for AI agents. It embeds governance into execution: align the real objective, facts, assumptions, authorization, risks, and acceptance; then choose the shortest sufficient path, combine the right capabilities, act, verify, and keep moving until the task is genuinely deliverable. It does not replace the model's judgment with a rigid workflow. The short version: call `/odai`; governance stays nearly invisible on simple work, while ambiguity, complexity, risk, and domain needs automatically increase or reduce the depth of handling. ## Why Use It `odai` is for people who want agents to move with autonomy, but not with false confidence. It helps an agent: - ask only when the missing answer would change the goal, scope, authorization, acceptance, risk, or stop line - verify what it can verify from files, commands, logs, tests, or project context before asking you - keep lightweight tasks lightweight instead of turning every request into ceremony - avoid claiming that so

阅读完整 README仓库许可: MIT

odai DSH 插件常见问题

如何将 odai 安装为 DSH 插件？

在终端中运行 `dsh plugin --profile web add odai-dsh-plugin`。这需要 `pnpm` 在 PATH 中。或者，你也可以通过 `npx odai-dsh-agent install` 安装 Agent 预设，这需要 `dsh@0.1.0-rc.6`。Plugin 将 Odai 应用于一个配置文件中的所有智能体预设；Agent 则提供一个可选的、会话范围的智能体预设。

Plugin 和 Agent 包有什么区别？

Plugin (odai-dsh-plugin) 将 Odai 治理应用于配置文件中的每个智能体预设。Agent (odai-dsh-agent) 安装一个可选的、会话范围的 Odai 智能体预设。两者都包含标准的 Odai 技能和共享的 DSH 运行时。通常只选择一个；同时安装是冗余的，仅用于有意的范围组合。

安装后如何使用 odai？

在支持斜杠命令的客户端中，使用 `/odai` 调用。如果客户端不支持斜杠命令，你也可以直接说 'odai'。自然地描述你的任务，例如：`/odai 更新引导流程文案。目标：让新用户更清楚。`

odai 是否需要特定的模型或提供商？

不需要。odai 不选择规划器、执行器或审查模型。你只需自然告知，例如 '使用 provider/model 进行规划，需要高推理能力'。模型会记住这个显式选择。如果某个职责未配置，odai 会指出并要求你提供模型，而不是声称该路线已运行。

我可以在没有 DSH 的情况下使用 odai 吗？

是的，odai 也作为独立技能提供，通过 `npx skills add https://github.com/orziz/odai --skill odai` 安装。这是与提供商无关的入口点，适用于支持 'skills' 协议的主机。DSH 包专门针对 DeepSeek Harness 用户。