i-have-adhd：易读回答、适配器与证据
安装与分发 i-have-adhd：不要混淆不同助手的配置
区分 Markdown 技能和可执行适配器，固定审阅版本，并在全局安装前准备小范围回退。
你将学会
- 这里的部署指助手集成
- 修改共享环境前先审阅文件
- 验收包含发现、行为与恢复
开始前需要
- 基础 Git 与命令行知识
- 能够区分观测行为与未经测试的主张
解释已检查的机制，设计可撤销试验，并在不把风格当正确性的前提下理解证据。
先看结论
- Markdown 导入和可执行插件属于不同部署方式。
- 不能从 package.json 推断存在公开 npm 包。
- 回退只应针对本次引入的改动。
这里的部署指助手集成
这个项目不是需要数据库、容器集群或公开端口的 Web 服务。部署的含义是让特定助手发现经过审阅的技能或适配器。仓库包含多个 manifest、hook 和扩展入口，但文件存在并不能证明所有当前宿主版本都接受同一条安装命令。
应阅读固定版本 INSTALL.md 中与你实际使用的助手对应的章节，核对前提和验证步骤。部分集成明确注明尚未测试，在本地验证前应作为待验证流程。手动导入 Markdown 与在会话启动时运行 Node 代码的插件，也具有不同的执行风险范围。
修改共享环境前先审阅文件
先记录准确 Git 提交，再查看核心技能、插件 manifest 和可执行入口。package.json 带有 private 以及 Pi/OMP 元数据，不能根据包名编造 npm 安装方式。团队分发应使用宿主支持的机制，固定已批准版本，并记录实际包含哪些文件。
Node hook 使用 CLAUDE_CONFIG_DIR 或默认 Claude 配置目录寻找标记；OpenCode 适配器使用 XDG_CONFIG_HOME 或自己的默认配置目录。把一个宿主的标记复制到另一个宿主，并不是通用启用方式。应核对源码及宿主文档，而不是假设所有插件共享一个开关。
验收包含发现、行为与恢复
将三项检查分开：宿主能发现插件，目标规则进入受控会话，以及关闭或回退后不再重新启用。插件列表里出现名称只能验证第一项。我们的 fixture 直接执行源码组件，并不认证宿主发现流程、宿主 API 版本或模型的实际回答。
保存上一个批准版本以及修改过的配置键。回退只针对新增的插件条目或选择加入设置，之后启动干净会话，不要清空整个助手配置目录。本系列没有执行全局安装、调用模型服务或修改用户日常配置。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
选择固定版本中的宿主安装章节。
- 2
检查 manifest、规则和可执行入口。
- 3
使用一次性配置试验集成。
- 4
分别记录发现、行为和回退检查。
可复制示例
# 在已经审阅的仓库副本中执行；以下只读检查不安装插件。
git rev-parse HEAD
git show 6f1f982d0a47c65899af3c5a7450b7098bc65325:package.json
git show 6f1f982d0a47c65899af3c5a7450b7098bc65325:hooks/hooks.json常见问题
需要 Docker 吗？
项目结构并未要求服务器部署；它集成到助手宿主。
离线 fixture 能认证所有宿主吗？
不能；它没有运行真实助手中的发现机制和宿主 API。
资料来源
- i-have-adhd / INSTALL.md来源核查 2026-09-12
- i-have-adhd / package.json来源核查 2026-09-12
- i-have-adhd / hooks/hooks.json来源核查 2026-09-12
- i-have-adhd / .codex-plugin/plugin.json来源核查 2026-09-12