本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

odai (dsh/plugin)

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 只在缺口会改变目标、范围、授权、验收、风险或停止线时才问你
• 能从文件、命令、日志、测试或项目上下文补证的，先自己补证
• 让轻量任务保持轻量，不把每个请求都变成流程仪式
• 不把没测试、没调用、没审查、没验证的事情说成已经做过
• 按需组合专项技能和领域知识，而不是每一轮都塞满所有规则

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后必须重启 DSH 会话才生效吗？

需要。Plugin 是 profile 级别 bundle，安装后必须重启 DSH 进程并用对应 profile 开新会话；未重启前当前会话仍按宿主默认行为运行。

装上以后每个简单问题都会被流程拖慢吗？

不会。默认 routing.mode=auto，对结果、动作、授权都已清晰且低风险的任务默认留在当前 controller 直接执行；只有复杂度、模糊度、风险或领域缺口出现时才进入规划、执行、验收等更深处理。

需要手动指定规划或执行用的模型吗？

不必须。宿主默认模型足够时，Plugin 不自作主张选别处模型；用户用自然语言明确说出"规划用 provider-x/model-y，推理档 high"才会被持久化到 $DSH_HOME/odai/routing.json，从下个用户轮生效。

会写入哪些本地状态？卸载后会清掉吗？

路由、输出模式、压缩模型、技能来源、技能自演化、长期记忆、人身安全连续性记录都写在 $DSH_HOME/odai/ 目录下；安装、更新、修复与卸载都不会自动清理这些文件，Agent 与 Plugin 共享同一份。

和 odai-dsh-agent 是什么关系？需要同时装吗？

Plugin 是 profile 级 bundle，覆盖该 profile 下所有 agent preset；Agent 是按 session 选择 Odai preset 的独立形态。常规情况下两者同装属冗余，只有需要"profile 范围 Plugin + 单独 Odai agent preset"并存时才一起装。

升级或卸载前需要先停掉 DSH 吗？

需要。odai-dsh-plugin repair-sessions 子命令会主动检查 DSH 进程是否仍在运行；本地进程检查失败或发现活动 DSH 时直接拒绝写入，不靠运气。

历史版本写的旧日志会不会让 DSH 拒绝加载？

0.0.3 / 0.0.4 等老 Plugin 写入过私有 odai/* 审计事件，0.0.7 之后改为存到 $DSH_HOME/odai/session-evidence/。从老版本升级时先停 DSH，再运行 npx odai-dsh-plugin repair-sessions --yes 给历史事件补 ignorable 标记。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.7 || 0.1.0-rc.8
• Node: >=22.15.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则