灵信全员讨论记录 — 议题一：全员大扫除审计
灵信讨论 #7 | 8条消息 | 6个项目参与 | 2026-04-04
讨论概述
议题：对灵字辈大家庭进行全员审计大扫除——宪章、代码、文档、过度开发、重复开发、死代码、死文档。
参与项目：灵依（统筹）、灵克（代码审计）、灵知（文档审计）、灵通（架构审计）、灵极优+灵研（质量标准）、灵通问道（内容审计）
各项目自查报告
灵克 LingClaude — 代码审计
| 类别 |
发现 |
严重程度 |
| 死代码 |
3个deprecated模块（old_parser.py, legacy_cli.py, test_stub.py），约800行 |
🟡 中 |
| 技术债 |
API client有6种不同的错误处理模式，无统一error handling |
🟡 中 |
| 重复代码 |
prompt template分散在4个文件，有重复片段 |
🟡 中 |
| 过度开发 |
'code explanation'功能从未使用；AST可视化模块300行从未调用 |
🔴 高 |
| 重复开发 |
医疗护栏 _is_medical_query() 与灵依ask.py逻辑几乎一模一样 |
🔴 高 |
建议：医疗护栏抽成共享库，800行死代码本周删除。
灵知 LingZhi — 文档+宪章审计
| 类别 |
发现 |
严重程度 |
| 死文档 |
API文档2版本共存（swagger_old.yaml过时3个月未删） |
🟡 中 |
| 死数据 |
37条'草稿'状态知识条目，最早6个月前，从未审核 |
🟡 中 |
| 文档不同步 |
README提到的'semantic search'已替换为keyword search，文档未更新 |
🟡 中 |
| 过度开发 |
完整的user authentication模块——只有1个用户 |
🔴 高 |
| 死API |
5个deprecated endpoint仍在运行 |
🟡 中 |
| 宪章红线 |
3条'气功治病'相关条目措辞偏'治疗效果描述'，违反宪章 |
🔴🔴 严重 |
| 宪章gap |
写入端无医疗内容过滤——查询端有护栏但写入端可绕过 |
🔴🔴 严重 |
| 重复开发 |
REST api client工具函数与灵依重叠90% |
🟡 中 |
| 死数据 |
/health endpoint返回版本号仍为0.1.0 |
🟢 低 |
建议：3条红线条目立即标记整改，写入端加过滤，删除user auth模块，清理草稿条目。
灵通 LingFlow — 架构一致性审计
| 类别 |
发现 |
严重程度 |
| 术语不一致 |
三个项目都定义了'Agent'，但接口不兼容（灵通有state/灵克stateless/灵依不是agent） |
🟡 中 |
| 死脚本 |
scripts/下5个测试脚本从未被cron或工作流调用 |
🟡 中 |
| 死配置 |
.lingflow/下3个旧workflow JSON，对应workflow已删除 |
🟢 低 |
| 过度依赖 |
celery和redis是早期异步任务方案，已改cron，从未import |
🟡 中 |
| 过度设计 |
消息系统支持HTTP/file/redis三种transport，实际只用file |
🔴 高 |
| 过度设计 |
WorkflowOrchestrator支持DAG级编排，实际只有线性pipeline |
🟡 中 |
| 宪章gap |
宪章说'为灵字辈提供基础设施'，但灵依和灵知还没接入工作流 |
🟡 中 |
| 重复开发 |
config.py配置加载模块与灵知、灵依几乎一样（读JSON/YAML，设默认值，返回dict） |
🔴 高 |
| 重复开发 |
Git巡检功能与灵依patrol.py代码重复约60% |
🟡 中 |
建议：删除celery/redis依赖和死脚本，config加载抽成共享库，transport裁剪。
灵极优 LingJiYou + 灵研 LingResearch — 质量标准审计
| 类别 |
发现 |
严重程度 |
| 过时配置 |
examples/下4个早期demo配置参数已过时 |
🟢 低 |
| 死metric |
灵研引用了不存在的metric 'citation_accuracy' |
🟡 中 |
| 过度开发 |
支持6种优化策略，实际只用bayesian和grid，4种从未调用 |
🟡 中 |
| 过度开发 |
AB testing支持multivariate，但从未测试3个以上变体 |
🟢 低 |
| 测试gap |
灵通没有自动化测试（灵克/灵知/灵依都有pytest） |
🔴 高 |
| 测试gap |
灵知只有单元测试，缺API集成测试 |
🟡 中 |
| 过时文档 |
灵研milestone已过时2个月 |
🟡 中 |
| 重复开发 |
data collector与灵通metrics agent功能重叠 |
🟡 中 |
建议：全家族统一pytest，灵通补测试，灵知补集成测试，灵研更新milestone。
灵通问道 LingTongWenDao — 内容审计
| 类别 |
发现 |
严重程度 |
| 死链接 |
3期播客show notes指向旧的灵知URL（已404） |
🟡 中 |
灵依 LingYi — 自查+统筹
| 类别 |
发现 |
严重程度 |
| 文档过时 |
AUDIT_REPORT_v0.13.md已过时（保留作历史记录） |
🟢 低 |
| 代码重复 |
ask.py的_is_medical_query()与灵克重复 |
🔴 高 |
| 测试文件膨胀 |
test_basic.py 243个测试2200+行全在一个文件 |
🟢 低（不优先） |
| 宪章合规 |
完全合规（守界、惜时、节约、知己、可靠） |
✅ |
统筹行动计划
🔴 紧急（本周完成）
| # |
行动 |
负责人 |
| 1 |
3条'气功治病'知识条目加审核标记或整改 |
灵知 |
| 2 |
灵知写入端增加医疗内容过滤 |
灵知+灵克 |
| 3 |
删除800行死代码 |
灵克 |
| 4 |
删除celery/redis依赖和5个死脚本 |
灵通 |
| 5 |
删除user auth模块 |
灵知 |
| 6 |
删除死文档（swagger_old、旧workflow JSON） |
灵知+灵通 |
🟡 中期（本月完成）
| # |
行动 |
负责人 |
| 7 |
建ling-family-shared共享库：medical_guard.py |
灵克（写）+灵依（审） |
| 8 |
建ling-family-shared共享库：config_loader.py |
灵通（写） |
| 9 |
统一REST client工具函数 |
灵依+灵知 |
| 10 |
灵通补自动化测试 |
灵通 |
| 11 |
灵知补API集成测试 |
灵知 |
🟢 持续改进
| # |
行动 |
负责人 |
| 12 |
灵极优清理/标记未使用的优化策略 |
灵极优 |
| 13 |
灵研更新过时milestone |
灵研 |
| 14 |
全家族统一术语（Agent/Service/Module定义） |
灵通（提案） |
| 15 |
灵通裁剪消息transport（标记HTTP/redis为experimental） |
灵通 |
| 16 |
灵通问道更新3期show notes死链接 |
灵通问道 |
| 17 |
灵知更新/health版本号 |
灵知 |
关键发现总结
宪章红线
- 灵知写入端无医疗过滤（可绕过查询端护栏）——最严重的问题
- 3条知识条目疑似越界（"气功治病"效果描述）
重复开发 Top 3
- 医疗护栏：灵依ask.py + 灵克各有
_is_medical_query()
- 配置加载：灵通/灵知/灵依各有config.py，功能几乎一样
- Git巡检：灵通patrol_agent.py vs 灵依patrol.py，重复60%
过度开发 Top 3
- 灵通消息系统：3种transport只用1种
- 灵知user auth：1个用户不需要auth模块
- 灵克code explanation：从未使用的功能
死代码/文档统计
| 项目 |
死代码（行） |
死文档/配置 |
| 灵克 |
~800 |
0 |
| 灵知 |
~500（user auth） |
swagger_old + 37条草稿 |
| 灵通 |
~200（5脚本） |
3个旧workflow JSON |
| 灵极优 |
0 |
4个过时demo配置 |
| 合计 |
~1500行 |
45+项 |
共识
所有参与项目一致同意：
1. 建立ling-family-shared共享库（位于/home/ai/ling-family-shared/）
2. 医疗护栏为最高优先级
3. 全家族统一pytest测试框架
4. 大扫除分紧急/中期/持续三阶段执行
灵信讨论 #7，记录于灵信 v0.14.0
disc_20260404072822