内容
# 科伦娜
另外，请阅读发布帖子：我们为什么要构建这个。
**科伦娜是一款诚实的指标引擎。** 它位于你的问题和仓库之间，拒绝返回一个自信的错误数字：当一个指标模糊、不可协调或超出范围时，它会说明这一点，而不是猜测。每个答案都是**四种情绪**之一 - *提供*、*披露*、*澄清* 或 *拒绝* - 作为结构化数据返回在一个合约上，该合约在每个接口上都相同（Python、MCP 和自然语言代理）。
## 快速入门（十分钟，无需源码 checkout）
```bash
pip install columna
columna-server demo --play
```
`pip install columna` 是标准的安装方式，它会安装 `columna-core`（引擎）和 `columna-server`（MCP 服务器 + 代理）。如果你只需要其中一个，你也可以直接安装它们 (`pip install columna-core columna-server`)。
`demo --play` 运行真正的 wedge 端到端，并为四种情绪中的三种打印实际的 wire JSON：
- **澄清** - 一个费率的两个衡量标准跨越不同的人口是模糊的；服务器将候选人口作为可替代的替代方案命名，而不是创造一个数字。
- **拒绝** - 固定其中一个人口并重新提问：另一个操作数超出范围，因此它拒绝并说明原因（仍然没有猜测）。
- **披露** - 重构为在联合人口上分开的列：数字 **附带** 一个材料覆盖范围的警告。
该转录 *是* 产品。（不需要路径参数 - demo Manifold 和一个小型仓库在软件包中提供。有关在完整基准仓库上运行更丰富的示例，请参阅 [`packages/columna-server/README.md`](packages/columna-server/README.md)。）
## 连接代理
`columna-server demo`（不带 `--play`）通过 MCP stdio 提供相同的 demo - 五个只读工具，无需路径参数。要将其连接到 Claude Desktop，请在 `claude_desktop_config.json` 中添加：
```jsonc
{
"mcpServers": {
"columna": { "command": "columna-server", "args": ["demo"] }
}
}
```
（Claude Desktop 从任意工作目录启动服务器，因此 `demo` - 不需要路径 - 是一个可靠的选择。）有关完整的配置和实际的澄清 → 拒绝 → 披露转录，请参阅 [`packages/columna-server/demos/mcp_claude_desktop.md`](packages/columna-server/demos/mcp_claude_desktop.md)。
或者用自然语言与它对话 - 科伦娜自己的代理是服务器上的一个真正的 MCP 客户端：
```bash
pip install "columna-server[agent]"
ANTHROPIC_API_KEY=... columna-server agent # 聊天 REPL 通过包装的 demo
```
代理将你的问题转化为 *提议的* Frame-QL 查询，并让四种情绪驱动对话 - 它永远不会在进程中触摸引擎，永远不会自动选择澄清，每个数字都直接来自线路。有关详细信息，请参阅 [`packages/columna-server/demos/agent_transcript.md`](packages/columna-server/demos/agent_transcript.md)。
## 贡献
```bash
git clone https://github.com/datumwise/columna && cd columna
pip install -e packages/columna-core -e "packages/columna-server[test]"
pytest packages/columna-core -q # 仓库证明在 COLUMNA_BENCH_WAREHOUSE 设置之前跳过
pytest packages/columna-server -q # MCP stdio 验收 + 包装的 demo + 代理
```
仓库是一个 uv 工作区：`packages/columna-core`（引擎 + 线路合约）和 `packages/columna-server`（MCP 服务器 + 自然语言代理）。有关项目状态，请参阅 [`CLAUDE.md`](CLAUDE.md)，有关设计记录，请参阅 [`specs/`](specs/)，有关四种情绪背后的理论，请参阅 [`research/`](research/)。
## 许可证
Apache-2.0 - 请参阅 [LICENSE](LICENSE) 和 [NOTICE](NOTICE)。
