feishu-aide MCP Server
by mmw-devs
README.md
# feishu-aide
为 [mmw-tools](https://github.com/mmw-devs/mmw-tools) / DeepSeek Harness agent 提供飞书文档与知识库访问的工具项目:联网读取飞书文档、wiki 知识库内容,增量缓存到本地,并提供检索/读取能力,帮助 agent 定位用户需要的信息。
Status: P1 (2026-11-15) — 仓库骨架、离线 CI、secret scan、分支清理、路径安全单测、文档块映射已落地;飞书客户端、同步和检索尚未实现。方案见 [CI 与仓库工程设计复用方案](docs/CI-REUSE-PLAN.md)。
## 目标能力(尚未实现)
<!-- src: none -->
- 连接飞书开放平台,读取 wiki 空间、节点与 docx 文档内容;
- 增量同步到本地缓存,处理分页、限流、删除、权限与路径安全;
- 本地索引与检索(先 SQLite FTS5,语义检索后置);
- 以 core library + stdio MCP server 提供给 agent 调用,CLI 后加。
## 当前已落地
<!-- src: src/core/path-safety.ts, src/index.ts -->
<!-- src: scripts/check-secrets.mjs, scripts/prune-merged-branches.mjs -->
<!-- src: scripts/check-docs.mjs, scripts/doc-impact.mjs -->
<!-- src: .github/workflows/ci.yml, .github/workflows/branch-cleanup.yml, .github/dependabot.yml -->
- `.github/workflows/ci.yml`:ubuntu + windows 双 OS;secret scan、文档块检查、策略单测、typecheck、unit test、build;PR 不读取任何飞书凭证。
- `.github/workflows/branch-cleanup.yml` + `scripts/prune-merged-branches.mjs`:只删除证据齐全的已合并分支,默认 dry run。
- `scripts/check-secrets.mjs`:扫描飞书/GitHub/AWS 凭证形态,并拒绝 `.env`、私钥、本地 `.db` 被跟踪。
- 工作流里的 action 固定到完整 commit SHA(行尾注释版本),Dependabot 每周检查 pin;仓库的 `sha_pinning_required` 已打开,新 workflow 写 `@vN` 会直接失败。
- `scripts/check-docs.mjs` + `scripts/doc-impact.mjs`:校验文档块的 `src` 标注、引用有效性与 `src/` 覆盖率,生成并比对 `docs/doc-map.json`;支持反查“改某个文件影响哪些文档块”。
- `src/core/path-safety.ts`:不可信文档标题的路径清洗与根目录逃逸防护,含单测。
## 本地验证
<!-- src: none -->
需要 Node 24 + pnpm 10。
```sh
pnpm install
pnpm check # secret scan + 文档块映射 + typecheck + unit + policy tests
pnpm build
```
查某次改动会影响哪些文档块(改 `src/**` 前先跑):
```sh
pnpm docs:impact src/core/path-safety.ts
```
## 文档
<!-- src: none -->
- [CI 与仓库工程设计复用方案](docs/CI-REUSE-PLAN.md) — 哪些 CI / 工程约束可复用、飞书场景新增哪些测试、按什么顺序落地。
- [仓库设置基线](docs/repo-settings.md) — 分支规则、合并方式、Actions allowlist 等不在 git 里的设置,以及核对命令。
- 文档块的 `src` 标注与 `doc-map.json` 约定见 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可
<!-- src: none -->
MIT © 2026 mmw-devs。见 [LICENSE](LICENSE)。