Publish a tracking index of the deferred integration seams #18

New Issue

2026-07-28T12:22:25+09:00

FLYEMOJ1 commented

2026-07-28 12:22:25 +09:00

(Migrated from github.com)

问题

代码里有一批标了 INTEGRATION-ONLY / KNOWN-LIMITATION 的接缝，各自在注释里写清楚了边界，但没有任何地方汇总。想知道"还有哪些东西没接线"，只能 grep 整个仓库，而且 grep 出来的结果里混着已经完成的和从设计上就不打算做的。

证据

Identified by Claude Opus 5 (claude-opus-5) while enumerating the deferred surfaces on 2026-07-28.

grep -rn "INTEGRATION-ONLY" --include=*.go . 至少覆盖这些面：

cmd/felis/tui_edge_apply.go:246,274,295 — nft 防火墙、cloudflared
internal/api/console.go:39、internal/api/logstream.go:236 — 需要活集群
internal/api/handlers_access.go:170,490 — vanilla 命令输出解析、LuckPerms
internal/api/handlers_updates.go:21,28 — felis update runner / CronJob（注释写着 "task #38 remainder"）
internal/api/api.go:514 — 更新窗口的 runner/executor

另有几处在别的记录里而不在代码注释里：S3 归档、submit 传输、NetworkPolicy、quota 的 TOCTOU 窗口。

验收

有一份索引（文档或 issue 列表），能一眼看出每个接缝的状态：待接、有意不做、已完成。

备注

这条本身是文档工作，价值在于避免同一个接缝被重复调查。internal/updater/doc.go 已经在做类似的事（gatherer 的注释指向它），可以按同样的模式扩展，而不是新开一套。

## 问题代码里有一批标了 `INTEGRATION-ONLY` / `KNOWN-LIMITATION` 的接缝，各自在注释里写清楚了边界，但没有任何地方汇总。想知道"还有哪些东西没接线"，只能 grep 整个仓库，而且 grep 出来的结果里混着已经完成的和从设计上就不打算做的。 ## 证据 Identified by Claude Opus 5 (claude-opus-5) while enumerating the deferred surfaces on 2026-07-28. `grep -rn "INTEGRATION-ONLY" --include=*.go .` 至少覆盖这些面： - `cmd/felis/tui_edge_apply.go:246,274,295` — nft 防火墙、cloudflared - `internal/api/console.go:39`、`internal/api/logstream.go:236` — 需要活集群 - `internal/api/handlers_access.go:170,490` — vanilla 命令输出解析、LuckPerms - `internal/api/handlers_updates.go:21,28` — `felis update` runner / CronJob（注释写着 "task `#38` remainder"） - `internal/api/api.go:514` — 更新窗口的 runner/executor 另有几处在别的记录里而不在代码注释里：S3 归档、submit 传输、NetworkPolicy、quota 的 TOCTOU 窗口。 ## 验收有一份索引（文档或 issue 列表），能一眼看出每个接缝的状态：待接、有意不做、已完成。 ## 备注这条本身是文档工作，价值在于避免同一个接缝被重复调查。`internal/updater/doc.go` 已经在做类似的事（gatherer 的注释指向它），可以按同样的模式扩展，而不是新开一套。

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: FelisMC/Felis#18