# @chosengeneration/light-code 中文文档

规范地址：https://npmcn.com/package/%40chosengeneration/light-code/

版本：0\.185\.0
npm 元数据更新时间：2026-11-07T04:31:25.056Z
中文译文更新时间：2026-11-09T14:33:43.568Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chosengeneration/light-code
原文对照：https://npmcn.com/package/%40chosengeneration/light-code/?lang=original
项目主页：https://github.com/chosengenerationdev/light-code#readme
源码仓库：https://github.com/chosengenerationdev/light-code

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：23.3 MB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=17\.0\.0
- 运行依赖：0 个
- 首次发布：2026-08-12T08:02:19.265Z
- 最新版本发布：2026-11-07T04:31:24.884Z
- 近 30 天下载量：7629（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：88（近 12 个月 88 个）

## 中文简介

一个最小代理编码助理, 从本地节点服务器服务到您的浏览器

## 安装

```sh
npm install @chosengeneration/light-code
```

也可以使用：`pnpm add @chosengeneration/light-code`、`yarn add @chosengeneration/light-code`、`bun add @chosengeneration/light-code`

## README

# 轻码

一个最小代理编码助理,从本地节点服务器向您的浏览器服务.

同名探员 [轻码 VS 码扩展](https://marketplace.visualstudio.com/items?itemName=ChosenGeneration.light-code-vscode), (中文(简体) ), 相同的配置格式,不需要编辑器 .

```bash
npx @chosengeneration/light-code
```

启动服务器 `127.0.0.1`,打开您的浏览器,并在当前文件夹中工作.

```bash
npx @chosengeneration/light-code --workspace /path/to/repo
npx @chosengeneration/light-code --port 7100 --no-open
npx @chosengeneration/light-code --help
```

### 机器上没有需要的注册?

```bash
light-code --export-pkg light-code-pkg   # then: node light-code-pkg
light-code --export-code light-code-src  # the source, to work on it there
```

第一个将运行的捆绑作为单一文件写出副本. 随心所欲 节点和运行它 - 不 `npm install`,没有 `node_modules`,没有网络。 第二个写出 源此创建自, 包含锁定文件 。 见 [操作指南](https://github.com/chosengenerationdev/light-code/blob/main/docs/hosting.md) 或者说 `light-code --guide`。 。 。 .

## 设置它

对于笔记本电脑,上面的命令是整个设置:打开浏览器,在 **设置 – 供应商**,开始打字。 其余部分是给服务器的,在 命令棋子实际上彼此依赖.

### 1\. 检查旗帜

服务器所研究的关于它的环境的一切在它开始的时候都会被打印出来,它是 值得一读,这是你能得到的最便宜的诊断.

```
Light Code 0.44.0
  workspace  /srv/work
  data       /home/svc/.local/share/light-code
  listening  http://127.0.0.1:7100
  proxy      HTTPS_PROXY=http://proxy.corp:3128, NO_PROXY=.corp.internal
  user       identity from whoami.py — emp0042
  secrets    creds.py — values stored as tool:<name> are fetched from it
```

### 2\. 如果你的外出通过代理

无可配置 : `HTTPS_PROXY`, (中文(简体) ), `HTTP_PROXY`, (中文(简体) ), `ALL_PROXY` 财务报告和审定财务报表 `NO_PROXY` 他们是受优待的, 有卷曲规则 `NO_PROXY` 和回转从不代理。 横幅显示路线.

这比听起来更重要 节点的 HTTP 堆栈 _没有_ 读取这些变量 默认, 因此一个服务器, 其所有其他程序都可以到达网关 坐在那里——一个代理网络放弃了直接连接而不是拒绝连接,a 空出连接等待操作系统,需要几分钟。 如果你曾经 看到一个旋转器 从来没有解决 `curl` 工作很好,就是这样.

### 3\. 告知用户是谁(可选)

默认情况下,本地服务器有一个用户,并且将所有文件保存在一个目录下。 狦 环境有一个库,知道谁登录,写一个函数:

```python
# whoami.py
def run():
    return "emp0042"
```

```bash
light-code --identity-tool whoami.py --identity-python python3
```

设置、 秘密和任务历史将按它返回的任何内容归档 。 它运行一次 启动, 在任何会话之前, 如果失败, 服务器仍会启动, 横幅显示 为什么 —— 这些功能会到达并非总在上层的库, 以及不会在上层的服务器 回来比回来解释更糟糕.

它必须返回非空字符串 . `None` 被拒绝,而不是变成一个用户 `None`,而任何关于导入的库打印都会被忽略,而不是被误认为 答话.

### 4\. 说明全权证书来自何处(可选)

相同的形状, 名称 :

```python
# creds.py
def run(name):
    entry = corporate_vault.lookup(name)
    return {"username": entry.user, "password": entry.secret}
```

```bash
light-code --credential-tool creds.py
```

现在,无论哪里 光码要求一个秘密,存储字符串 `tool:<name>` 代替 隐藏本身 :

| 您输入 | 它会获取 |
| --- | --- |
| `tool:gateway` | 整个值,或 `password`编号 :`secret`编号 :`token`编号 :`value`编号 :`key` 从命令 |
| `tool:opensearch#username` | 准确的字段 |
| `tool:opensearch#password` | 准确的字段 |

秘密档案中只有 _名称_ 东西去要求。 获取值 当它们被使用和缓存几秒钟, 所以旋转一个在你的金库里到达 下一个请求,这里没有 任何被清除.

**助理不能调用此功能 .** 它是一个秘密的来源,只有 已经允许解决一个问题的代码——这个模型可以使用的工具将您放在 密码在笔录.

### 5\. 增加一个提供者

**设置 – 供应商.** 任何OpenAI相容,Anthropic或双子座端点. 几个名字 剖面图,可以从作曲家切换. 公司的共同-TLS和客户证书认证 网关和a **测试连接** 按钮 _哪个_ 步骤失败——证书, 符号,或列出模型.

如果您配置了证书函数,请设置 `tool:<name>` 在 API 键字段中.

### 6\. 可选额外项目

-   **专家** - 设置您的一个简介作为第二个意见 助理可以就硬咨询 问题 您所配置的任何模型; 没有要安装的 .
-   **搜索** 用于编码库索引的 OpenSearch、Qdrant 或 Chroma 连接 文档.
-   **Python 工具** - 默认关闭。 在启用前,请先阅读项目CLAUDE.md的第13节: 它使 _机构_ 工具模型编写.
-   **一个 Jupyter 内核** 开始 `--jupyter-kernel $(python -c "from ipykernel import get_connection_file; print(get_connection_file())")` 从笔记本里面, Python 工具运行 _内核_: 他们通过一个 `session` 下诏. 这个 笔记本上写着它自己的内核 因为除了内核之外 没有任何东西能分辨出它要问的是什么. 见指南(`light-code --guide`关于细节.

## 它会做什么

一个带有小套代理工具的聊天UI,没有其他工具:

-   **阅读和搜索** —— 说 `read_file`, (中文(简体) ), `list_files`, (中文(简体) ), `search_files` (卢比支持)
-   **编辑** —— 说 `write_to_file` 财务报告和审定财务报表 `apply_diff`,在任何东西前显示一个计算 diff 写入
-   **运行命令** 一个真正的贝壳,一个一个批准
-   **MCP工具** —— stdio和Streamable HTTP服务器,每个工具可单独切换
-   **问一个更强大的模型** ——可选;查询您配置的提供者配置

## 它不会做的

没有遥测、更新检查、没有远程资产 **无默认终点** - 新鲜的 在配置提供者之前,不安装任何联系人。 每一个主机,它曾经交谈过 是一个 你输入.

没错 **没有** 沙盒 它运行的代码。 壳牌命令、MCP服务器和任何其他 代理执行指令时使用权限运行, 就像您输入过一样 他们。 批准门是车型和机器之间的东西,没有 第二层后面.

Excel和Outlook集成——包括编组带有附件并嵌入的邮件 图像,它显示你而不是发送—— 和索引邮件搜索,需要 **视窗和 您自己的桌面**。它们附加在您会话中已经运行的应用程序上, 因此运行此程序用于 在Windows上,你得到了所有三个, 正是在扩展。 开始于 `--server` 他们缺席:服务账户没有通往任何人桌面的路线,邮箱属于 程序运行为:.

## 警卫

Loopback 不是一个安全边界——任何您打开的页面都可以发送请求到 `127.0.0.1`。因此,会话得到适当的保护:

-   绑在字面上 `127.0.0.1`永远 `localhost`
-   URL 片段中的单用途发射令牌,交换一个仅会话令牌 曾经在一次 `Authorization` 头-从不吃饼干,这是中国证监会利用的
-   `Origin` 财务报告和审定财务报表 `Host` 在每次请求中分别检查CSRF和DNS重新绑定
-   一个严格的CSP `connect-src 'self'` 财务报告和审定财务报表 `img-src 'self' data:` 停止模型输出 通过图像 URL 过滤屏幕

配置、秘密和历史在您的 OS 应用程序数据目录下直播,每个用户. **机密存储在一个只拥有者的文件,而不是OS密钥链中** ——扩展得到 DPAPI/Keychain通过VS代码,没有本地模块的服务器不具有等同性,以及 uI说哪个后端是活跃的 而不是更强大的 证书 函数(步骤4)完全避免了问题,因为没有存储.

## 为团队主办

可能,而身份接合是构建的——但 **读取 [文件/东道主,md](https://github.com/chosengenerationdev/light-code/blob/main/docs/hosting.md) 先说.** 代理运行命令为 _服务账户_,所以单签给你 归属和每个用户存储,但不是特权隔离。 直到有一个OS账户 或每个会话的容器,只有在每个用户都处于 已信任其他用户所能达到的一切.

## 许可证

麻省理工学院.

## 常见问题

### @chosengeneration/light-code 是什么？

一个最小代理编码助理, 从本地节点服务器服务到您的浏览器

### 如何安装 @chosengeneration/light-code？

在项目目录运行 npm install @chosengeneration/light-code，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 light-code，可以用 npx light-code 直接运行。

### @chosengeneration/light-code 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chosengeneration\_\_light-code 是否存在。

### @chosengeneration/light-code 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @chosengeneration/light-code 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=17\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chosengeneration/light-code 可以商用吗？

@chosengeneration/light-code 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chosengeneration/light-code 的下载量有多少？

根据 npm 官方下载统计，@chosengeneration/light-code 在 2026/10/10 – 2026/11/08 这 30 天内被下载 7,629 次，日均约 254 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chosengeneration/light-code 还在维护吗？

最新版本 0\.185\.0 发布于 2026/11/07（2 天前）；至今共发布 88 个版本，其中过去 12 个月发布了 88 个；首次发布于 2026/08/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。