面向开发团队的AI原生任务与文档管理工具，作为AI的持久化记忆层，通过本地Markdown文件系统管理任务、文档和决策，利用MCP协议让AI助手获得项目的长期上下文理解能力，解决会话状态丢失问题。
核心定位#
Knowns 是一个基于 TypeScript 构建的 CLI 工具及 Web 平台，旨在成为 AI 原生开发的"记忆层"。它解决了大语言模型在辅助编程时的"无状态性"痛点——传统 AI 助手在每次会话中都会丢失项目上下文，导致开发者需要反复解释架构、粘贴文档和重申约定。
核心能力#
持久化项目记忆#
- 为AI提供代码库和工作流程的长期理解
- 解决AI会话之间状态丢失的问题
- 连接规范、任务、文档和决策，形成统一的上下文层
开发流程增强#
- 任务管理：创建、跟踪任务，支持验收标准检查
- 文档管理：嵌套文件夹结构，支持Markdown + Mermaid图表
- 语义搜索：基于本地AI模型的语义搜索（离线可用）
- 时间跟踪：内置计时器和报告功能
- 上下文链接：支持
@task-42和@doc/patterns/auth引用格式 - 验证系统：检查损坏的引用链接
- 模板系统：使用Handlebars (.hbs)模板生成代码
- 导入系统：从git、npm或本地导入文档/模板
AI原生集成#
- 完整的MCP Server，支持AC/plan/notes操作
- 深度集成Claude Code工作流
- 智能上下文交付，自动筛选相关上下文
Claude Code 技能命令#
/kn-init- 初始化会话，读取项目文档/kn-plan <id>- 制定实施计划/kn-implement <id>- 执行计划并检查验收标准/kn-research- 搜索代码库，探索模式/kn-commit- 创建规范的提交/kn-spec- 创建功能规范文档（SDD）/kn-verify- 运行SDD验证和覆盖率报告/kn-doc- 创建或更新文档/kn-extract- 提取可复用模式/kn-template- 列出、运行或创建代码模板
架构设计#
核心原则#
- 文件即数据库：无SQLite、无JSON数据库，仅使用Markdown文件
- Markdown + Frontmatter：人类可读、机器可解析的标准格式
- 本地优先：数据默认不离开本机，完全自主控制
技术实现#
采用分层架构：用户层（CLI/Web UI/MCP Server）→ 命令层 → 存储层 → 文件系统
项目结构#
.knowns/
├── config.json # 项目配置
├── tasks/ # 任务Markdown文件
├── docs/ # 文档Markdown文件
└── .versions/ # 版本历史（隐藏）
适用场景#
- 长期项目开发：团队需要AI持续理解项目上下文
- 知识管理：维护项目规范、决策和最佳实践
- AI辅助编程：提升AI助手的上下文理解能力
- 团队协作：未来支持自托管的团队同步
- 离线工作：本地优先，数据完全自主控制
安装与使用#
# 使用npm全局安装
npm install -g knowns
# 或使用bun
bun install -g knowns
# 初始化项目
knowns init
# 启动Web UI
knowns browser
系统要求#
- Node.js >= 20.0.0
- 开发环境需要 Bun