@milisp/keke 0.1.9 → 0.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -36
- package/README.zh-CN.md +8 -21
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -5,15 +5,12 @@
|
|
|
5
5
|
keke is a local terminal coding agent built for zero-vendor lock-in.
|
|
6
6
|
Works with subscriptions you already have, standard API keys, or self-hosted local models.
|
|
7
7
|
|
|
8
|
-
**Status: early (v0.1.x), usable day to day.** Good fit for personal daily
|
|
9
|
-
driving, scripted/CI use, and small-team trials. Not yet the right choice for
|
|
10
|
-
a regulated or uninterruptible production pipeline — see
|
|
11
|
-
[Production & safety](#production--safety).
|
|
12
|
-
|
|
13
8
|
## Why keke?
|
|
14
9
|
|
|
15
10
|
- **Protocol: ACP for every client**
|
|
16
11
|
Speaks the open Agent Client Protocol for both external client integrations and its internal TUI/agent seam.
|
|
12
|
+
- **Multi-Account & Per-Directory Routing**
|
|
13
|
+
Login to multiple subscription accounts (e.g., work and personal) and automatically route requests based on workspace directory path.
|
|
17
14
|
- **Script & CI First (`keke exec`)**
|
|
18
15
|
Supports one-shot execution out of the box for non-interactive scripting and automated CI pipelines.
|
|
19
16
|
- **Vendor-Isolated Engine**
|
|
@@ -61,6 +58,14 @@ keke resume # pick the last conversation back up
|
|
|
61
58
|
Provider routes, API keys, local models, gateways, per-directory accounts, and
|
|
62
59
|
all other settings are documented in [`docs/config.md`](docs/config.md).
|
|
63
60
|
|
|
61
|
+
## Safety
|
|
62
|
+
|
|
63
|
+
- **Sandboxing & approvals** — `approval_policy` and `sandbox_mode` are
|
|
64
|
+
configurable to match how you run it ([`docs/config.md`](docs/config.md)).
|
|
65
|
+
- **Plugin trust** — repository-provided plugins (hooks, MCP servers) never
|
|
66
|
+
execute on `git clone` alone; a person must approve them, keyed to their
|
|
67
|
+
exact contents, not their path. There's no flag to turn that gate off.
|
|
68
|
+
|
|
64
69
|
## Status
|
|
65
70
|
|
|
66
71
|
Usable day to day. `keke exec`, the TUI, and the ACP server all run real
|
|
@@ -72,36 +77,9 @@ agent can spawn subagents — isolated child sessions given one task that
|
|
|
72
77
|
report back a single answer instead of their whole search trace. See
|
|
73
78
|
[`docs/ROADMAP.md`](docs/ROADMAP.md) for what's next.
|
|
74
79
|
|
|
75
|
-
## Production & safety
|
|
76
|
-
|
|
77
|
-
Fine for personal use, local/self-hosted models, and CI one-shots today.
|
|
78
|
-
Before trusting it with anything you can't afford to break, weigh in:
|
|
79
|
-
|
|
80
|
-
- **Sandboxing & approvals** — default `approval_policy` and `sandbox_mode`
|
|
81
|
-
are conservative, but you should confirm they match what you're running
|
|
82
|
-
([`docs/config.md`](docs/config.md)).
|
|
83
|
-
- **Plugin trust** — repository-provided plugins (hooks, MCP servers) never
|
|
84
|
-
execute on `git clone` alone; a person must approve them, keyed to their
|
|
85
|
-
exact contents, not their path. There's no flag to turn that gate off.
|
|
86
|
-
- **Maturity** — early (v0.1.x), single-maintainer, no formal security audit
|
|
87
|
-
or SLA. Remaining roadmap gaps (full end-to-end MCP tool-call verification)
|
|
88
|
-
are tracked in [`docs/ROADMAP.md`](docs/ROADMAP.md).
|
|
89
|
-
|
|
90
|
-
**Good fit:** you want no vendor lock-in, script/CI-friendly one-shot runs,
|
|
91
|
-
local models, or ACP integration into your own editor/client.
|
|
92
|
-
**Not yet a fit:** you need turnkey OAuth for every vendor, an established
|
|
93
|
-
plugin ecosystem, or vendor support contracts.
|
|
94
|
-
|
|
95
|
-
## Where it comes from
|
|
96
|
-
|
|
97
|
-
keke is a fresh implementation informed by OpenAI's **codex**, xAI's
|
|
98
|
-
**grok-build**, and **deepseek-harness**. A few pieces are ported and
|
|
99
|
-
attributed in-crate; most of the code is original. Design rationale and
|
|
100
|
-
CI-enforced invariants: [`docs/architecture.md`](docs/architecture.md),
|
|
101
|
-
[`AGENTS.md`](AGENTS.md).
|
|
102
|
-
|
|
103
80
|
## License
|
|
104
81
|
|
|
105
|
-
Apache-2.0. See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE)
|
|
106
|
-
|
|
107
|
-
|
|
82
|
+
Apache-2.0. See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE). Design rationale
|
|
83
|
+
and source attribution are documented in
|
|
84
|
+
[`docs/architecture.md`](docs/architecture.md#why-it-is-shaped-this-way) and
|
|
85
|
+
`THIRD_PARTY_NOTICES.md` files in the relevant crates.
|
package/README.zh-CN.md
CHANGED
|
@@ -5,12 +5,12 @@
|
|
|
5
5
|
keke 是一个专为“零厂商锁定”打造的本地终端编码 agent。
|
|
6
6
|
可直接搭配你已有的付费订阅、标准 API Key 或自托管的本地模型使用。
|
|
7
7
|
|
|
8
|
-
**当前状态:早期阶段(v0.1.x),已可用于日常开发。** 适合个人日常主力使用、脚本/CI 自动化及小团队试用。目前尚不适合用于强监管或要求不可中断的生产流水线——详见[生产与安全性](#生产与安全性)。
|
|
9
|
-
|
|
10
8
|
## 为什么选择 keke?
|
|
11
9
|
|
|
12
10
|
- **协议:为所有客户端提供 ACP 支持**
|
|
13
11
|
无论是外部客户端集成,还是内部 TUI 与 agent 之间的解耦边界,统一基于开放的 Agent Client Protocol (ACP)。
|
|
12
|
+
- **多账户与按目录路由**
|
|
13
|
+
登录多个订阅账户(例如工作账户和个人账户),并根据工作区目录路径自动路由请求。
|
|
14
14
|
- **脚本与 CI 优先(`keke exec`)**
|
|
15
15
|
开箱即用支持非交互式一次性执行,专为脚本自动化与 CI 流水线设计。
|
|
16
16
|
- **与厂商隔离的引擎核心**
|
|
@@ -24,7 +24,7 @@ keke 是一个专为“零厂商锁定”打造的本地终端编码 agent。
|
|
|
24
24
|
curl -fsSL https://raw.githubusercontent.com/milisp/keke-agent/main/scripts/install.sh | sh
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
该脚本会下载适合你平台的最新预编译二进制文件至 `~/.local/bin
|
|
27
|
+
该脚本会下载适合你平台的最新预编译二进制文件至 `~/.local/bin`,也可以通过 `KEKE_INSTALL_DIR` 指定安装目录。
|
|
28
28
|
|
|
29
29
|
### npm 安装
|
|
30
30
|
|
|
@@ -37,7 +37,7 @@ npm install -g @milisp/keke
|
|
|
37
37
|
## 快速试用(30 秒)
|
|
38
38
|
|
|
39
39
|
```sh
|
|
40
|
-
keke doctor #
|
|
40
|
+
keke doctor # 检查 provider 和登录配置
|
|
41
41
|
|
|
42
42
|
# 使用已有付费订阅登录……
|
|
43
43
|
keke login codex
|
|
@@ -52,25 +52,12 @@ keke resume # 恢复上一次的对话
|
|
|
52
52
|
|
|
53
53
|
配置文件位置、Provider 声明、API Key、本地模型、多账号、按目录切换账号及其他设置,详见 [`docs/config.md`](docs/config.md)。
|
|
54
54
|
|
|
55
|
-
##
|
|
56
|
-
|
|
57
|
-
日常开发已完全可用。`keke exec`、TUI 和 ACP 服务器均支持端到端完整运行会话;运行时插件(skills、commands、hooks、MCP servers)遵循 Claude Code 格式安装,仓库自带的插件在你显式批准前会保持非激活状态。在运行中的会话内可通过 `/model` 切换模型(模型与 provider 绑定,避免配置持久化无效组合),并且 agent 支持生成子 agent——分配独立任务的子会话,仅汇总返回最终结果而不会污染完整的搜索 trace。后续规划请参见 [`docs/ROADMAP.md`](docs/ROADMAP.md)。
|
|
58
|
-
|
|
59
|
-
## 生产与安全性
|
|
60
|
-
|
|
61
|
-
目前非常适合个人使用、本地/自托管模型以及 CI 一次性任务。在将其托付给任何不容出错的关键场景前,请评估以下事项:
|
|
62
|
-
|
|
63
|
-
- **沙盒与审批** — 默认的 `approval_policy` 和 `sandbox_mode` 策略较为保守,但建议确认其符合你的运行环境与需求([`docs/config.md`](docs/config.md))。
|
|
64
|
-
- **插件信任机制** — 仓库自带的插件(hooks、MCP servers)在单纯 `git clone` 后绝不会自动执行;必须由人工确认批准,且该授权基于命令的具体内容而非文件路径。系统未提供任何可全局绕过此门控的开关。
|
|
65
|
-
- **成熟度** — 项目处于早期阶段(v0.1.x),目前由单人维护,暂无正式的安全审计或 SLA。路线图中的待补齐项(完整的端到端 MCP 工具调用校验)记录在 [`docs/ROADMAP.md`](docs/ROADMAP.md) 中。
|
|
66
|
-
|
|
67
|
-
**适合的场景:** 希望摆脱厂商锁定、需要脚本/CI 友好的一次性运行模式、使用本地模型,或希望将 ACP 集成至自己的编辑器/客户端中。
|
|
68
|
-
**暂不适合的场景:** 需要针对所有厂商的即插即用式开箱即用 OAuth、成熟的插件生态市场,或需要商业支持合同。
|
|
55
|
+
## 功能状态
|
|
69
56
|
|
|
70
|
-
|
|
57
|
+
keke 已支持日常开发所需的完整会话。你可以使用 `keke exec` 执行一次性任务,也可以通过 TUI 或 ACP 接入自己的编辑器和客户端。运行时插件(skills、commands、hooks、MCP servers)遵循 Claude Code 格式安装;会话中还可以使用 `/model` 切换模型,并生成独立的子 agent 处理分配的任务。
|
|
71
58
|
|
|
72
|
-
|
|
59
|
+
后续规划请参见 [`docs/ROADMAP.md`](docs/ROADMAP.md)。
|
|
73
60
|
|
|
74
61
|
## 许可证
|
|
75
62
|
|
|
76
|
-
Apache-2.0。详见 [`LICENSE`](LICENSE) 与 [`NOTICE`](NOTICE)
|
|
63
|
+
Apache-2.0。详见 [`LICENSE`](LICENSE) 与 [`NOTICE`](NOTICE)。设计背景与代码来源说明见 [`docs/architecture.md`](docs/architecture.md#why-it-is-shaped-this-way) 及相关 crate 中的 `THIRD_PARTY_NOTICES.md`。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@milisp/keke",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.11",
|
|
4
4
|
"description": "keke is a multi-vendor terminal coding agent.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"bin": {
|
|
@@ -18,11 +18,11 @@
|
|
|
18
18
|
"win32"
|
|
19
19
|
],
|
|
20
20
|
"optionalDependencies": {
|
|
21
|
-
"@milisp/keke-darwin-x64": "0.1.
|
|
22
|
-
"@milisp/keke-darwin-arm64": "0.1.
|
|
23
|
-
"@milisp/keke-linux-x64": "0.1.
|
|
24
|
-
"@milisp/keke-linux-arm64": "0.1.
|
|
25
|
-
"@milisp/keke-win32-x64": "0.1.
|
|
21
|
+
"@milisp/keke-darwin-x64": "0.1.11",
|
|
22
|
+
"@milisp/keke-darwin-arm64": "0.1.11",
|
|
23
|
+
"@milisp/keke-linux-x64": "0.1.11",
|
|
24
|
+
"@milisp/keke-linux-arm64": "0.1.11",
|
|
25
|
+
"@milisp/keke-win32-x64": "0.1.11"
|
|
26
26
|
},
|
|
27
27
|
"repository": {
|
|
28
28
|
"type": "git",
|