配置

全部有默认值，默认即可用。部署相关的路径留在你自己的 profile patch 层里，不要写进这个包的 cordis.patch.yml——loader 会在每个 bundle 层之后应用 profile 层，所以覆盖是安全的。

键	默认	说明
`registryPath`	`''` → `${DSH_HOME:-~/.dsh}/note-boards.json`	附加登记表
`maxBytes`	`262144`	字符上限：既截断返回正文，也约束底层读取（≤ `maxBytes*4+4` 字节）；硬钳 4M
`auditLimit`	`20`	审计判决最多列几条（上限 500；只读最新的 N 份）
`injectBudget`	`6000`	每轮注入的字符上限（吸收线据此判断是否分叉）
`scanRoots`	`[]` → `~/Workspace`	目录扫描根
`scanDepth`	`3`	向下层数（3 层刚好到 `//notes/`，不会走进源码树；上限 8，不跟随符号链接目录）
`catalogTtlMs`	`30000`	扫描结果缓存时长（上限 10 分钟）
`ledgerFiles`	`[]` → `['notes/ledger.md', '.notes/ledger.md', 'ledger.md']`	逐级向上查找的相对路径，按顺序
`auditInboxName`	`''` → `.note-audit-inbox`	审计收件箱目录名（位置固定在笔记同级）
`placement`	`'last'`	注入 section 落在 `'first'` 还是 `'last'`；仅影响呈现顺序，不影响权威
`delivery`	`'section'`	正文走哪条通道：`'section'` 渲染进系统提示；`'snapshot'` 作为 durable user-role 快照投递（见下）

注入开关不是配置项——它是按会话的运行时状态（POST /note-board/api/injection），写在 registry 里。

覆盖示例（放在 ~/.dsh/profiles/ /cordis.patch.yml）：

- id: note-board
  config:
    scanRoots: ['/srv/work']
    ledgerFiles: ['docs/definitions.md', 'notes/ledger.md']
    auditInboxName: '.review-inbox'
    injectBudget: 8000

@suxeca/dsh-note-board

インストール

ドキュメント

配置