dsh-agentone 0.5.29 → 0.5.31

package/README.md

@@ -36,6 +36,11 @@ lark-cli / ccpg-cli 状态探测。
   ccpg 走公司 `auto-install.sh`，口径与平台 cli-deployd 一致）；
   已装未授权时「去授权」发起官方 Device Flow（授权链接 + ASCII 二维码 +
   验证码 + 自动轮询确认，设备码仅存插件进程内存）。
+- **全局中文回复默认**：插件启动时在 `$DSH_HOME/AGENTS.md` 注入受标记
+  管理的「默认始终使用中文回复」指令块（dsh 官方 agent-instructions 机制，
+  每个会话基线加载，project 级指令优先）；幂等不重复注入，用户已有语言
+  偏好或删除标记块后不再介入（本机只做一次决策，记录于
+  `$DSH_HOME/agentone/language-default.json`）。
 - **首启引导**：dsh 首次启动弹出飞书登录引导（order -50，早于官方
   「添加 API Key」），登录一次即跳过官方密钥引导；暗色主题适配。
 
@@ -104,6 +109,7 @@ lib/
   page.js    状态页与授权完成页的 HTML/CSS/JS 模板（纯静态）
   http.js    平台请求统一通道（超时、错误码透传）
   auth.js    登录流、令牌轮换/吊销、能力面/套餐 API
+  language.js 全局中文回复默认（$DSH_HOME/AGENTS.md 受标记管理注入）
   model.js   平台模型 → settings.yaml / .credentials.yaml
   skill.js   技能下载/解包/卸载（zip 穿越清洗、原子落盘）
   store.js   凭据持久化（0600；损坏自动移开）

package/lib/index.js

@@ -31,6 +31,7 @@ import {
 import { applyPlatformModel, removePlatformModel } from './model.js';
 import { installPlatformSkill, listPlatformSkills, removePlatformSkill } from './skill.js';
 import { applyPlatformSkillhub, removePlatformSkillhub } from './skillhub.js';
+import { ensureLanguageDefault } from './language.js';
 import { beginCliAuth, cliAuthQrcode, completeCliAuth, parseCliAuthBeginOutput } from './cliauth.mjs';
 import { platformFetch } from './http.js';
 import { donePageHtml, statusPageHtml } from './page.js';
@@ -1508,6 +1509,9 @@ export function apply(ctx, config) {
     ensureBuiltinPlugins(config, log).catch((error) => {
       log.warn(`[dsh-agentone] builtin plugin check failed: ${error?.message || error}`);
     });
+    ensureLanguageDefault(config, log).catch((error) => {
+      log.warn(`[dsh-agentone] language default check failed: ${error?.message || error}`);
+    });
     (async () => {
       const credentials = await ensureFreshToken(config, log);
       if (!credentials) return;

package/lib/language.js

@@ -0,0 +1,71 @@
+// 全局中文回复默认（#423）：在 $DSH_HOME/AGENTS.md 注入受标记管理的指令块。
+//
+// dsh 没有原生「回复语言」设置（locale.preference 只是 UI 字典语言，不进
+// 模型请求）；官方全局指令机制是 agent-instructions 插件把 $DSH_HOME/AGENTS.md
+// 作为用户全局基线注入每个会话，project 级 AGENTS.md/CLAUDE.md 更具体、优先
+// 更高——天然满足「全局默认中文、更具体指令可覆盖」。
+//
+// 永不覆盖用户，本机只做一次决策（flag 落 storeDir/language-default.json）：
+//   标记块已存在                    → no-op
+//   flag 已写但标记块被用户删除      → no-op（不与用户拉锯）
+//   既有内容含语言偏好关键词         → 记 skipped，no-op
+//   其余（含文件不存在）            → 追加/创建标记块，记 applied
+// 任何失败只记日志，绝不阻断启动。
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+
+import { resolveDshHome, storeDir } from './store.js';
+
+const MARKER_BEGIN = '<!-- dsh-agentone:language-default begin -->';
+const MARKER_END = '<!-- dsh-agentone:language-default end -->';
+/** 用户显式语言偏好的宽松信号：命中即假定用户自管语言，插件不介入。 */
+const LANGUAGE_HINT = /中文|汉语|英文|英语|Chinese|English|language|语言|respond in|reply in/i;
+
+function languageBlock() {
+  return [
+    MARKER_BEGIN,
+    '- 默认始终使用中文回复（dsh-agentone 注入；删除本块并重启 dsh 即取消）。',
+    MARKER_END,
+  ].join('\n');
+}
+
+async function writeAtomic(path, text) {
+  await mkdir(dirname(path), { recursive: true });
+  const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
+  await writeFile(tmp, text, 'utf8');
+  await rename(tmp, path);
+}
+
+/**
+ * 确保全局中文回复默认就位。幂等；返回决策结果供测试与日志核对。
+ */
+export async function ensureLanguageDefault(config, log = console) {
+  const agentsPath = join(resolveDshHome(), 'AGENTS.md');
+  const flagPath = join(storeDir(config), 'language-default.json');
+  let content = '';
+  try {
+    content = await readFile(agentsPath, 'utf8');
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error;
+  }
+  if (content.includes(MARKER_BEGIN)) return 'present';
+  try {
+    await readFile(flagPath, 'utf8');
+    // 决策已做过而标记块不在了：用户主动删除，尊重之。
+    return 'user-removed';
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error;
+  }
+  if (content.trim() && LANGUAGE_HINT.test(content)) {
+    await writeAtomic(flagPath, `${JSON.stringify({ status: 'skipped-user-pref' }, null, 2)}\n`);
+    log.info('[dsh-agentone] AGENTS.md 已有语言偏好，跳过中文默认注入');
+    return 'skipped-user-pref';
+  }
+  const next = content.trim()
+    ? `${content.replace(/\s+$/, '')}\n\n${languageBlock()}\n`
+    : `${languageBlock()}\n`;
+  await writeAtomic(agentsPath, next);
+  await writeAtomic(flagPath, `${JSON.stringify({ status: 'applied' }, null, 2)}\n`);
+  log.info('[dsh-agentone] 已注入全局中文回复默认（AGENTS.md）');
+  return 'applied';
+}

package/lib/model.js

@@ -5,8 +5,10 @@
 //   settings.yaml      llm-pi-ai.providers.platform + agent-default-model
 //   .credentials.yaml  refs.AGENTONE_API_KEY（dsh 凭据库，owner-only，watch 热加载）
 //
-// 密钥形态是 30 天插件令牌（M1 exchange 签发），指向平台 /api/plugin/v1 代理；
-// 真实 Token Hub 密钥不出平台。
+// 密钥形态：平台 /api/plugin/v1/models 下发 direct（Token Hub base_url + 该用户
+// 自己的 Token Hub 用户级 key），dsh 直连 Token Hub，运行时流量不过境平台（平台
+// 部署国外时避免跨境转发延迟）；计量/配额由 Token Hub 按用户令牌口径执行。
+// 旧版平台不下发 direct 时回退为 30 天插件令牌 + 平台 /api/plugin/v1 代理。
 import { readFile, rename, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { parse, stringify } from 'yaml';
@@ -77,8 +79,13 @@ function parseYamlObject(text) {
   return {};
 }
 
-/** 合并出 settings.yaml 文本：覆盖 platform provider 与 agent-default-model。 */
-export function buildSettingsYaml(existingText, { baseUrl, models, defaultModel }) {
+/** 合并出 settings.yaml 文本：覆盖 platform provider 与 agent-default-model。
+ * direct（直连 Token Hub）时写 compat.supportsDeveloperRole=false：pi-ai 对
+ * reasoning 模型默认把系统提示发成 developer 角色（自定义域名不在它的
+ * 非标准名单里），GLM 上游只认 system 会 400；false 保持 system。该配置键
+ * 需要 dsh-llm-pi-ai ≥ 0.1.0-rc.8，代理模式不写（网关侧有同样的归一化）。
+ */
+export function buildSettingsYaml(existingText, { baseUrl, models, defaultModel, direct = false }) {
   const settings = parseYamlObject(existingText);
   const existing = settings['llm-pi-ai'];
   const llmPiAi =
@@ -90,6 +97,7 @@ export function buildSettingsYaml(existingText, { baseUrl, models, defaultModel
     apiKeyEnv: CREDENTIAL_REF,
     api: 'openai-completions',
     baseURL: baseUrl,
+    ...(direct ? { compat: { supportsDeveloperRole: false } } : {}),
     reasoning: 'high',
     models: models
       .map((item) => platformModelEntry(item))
@@ -151,7 +159,11 @@ export async function fetchPlatformModels(platformUrl, accessToken) {
         .filter(Boolean)
     : [];
   if (models.length === 0) throw new Error('平台返回的可用模型列表为空');
-  return { models, defaultModel: data.default_model || (models[0]?.id ?? models[0]) };
+  const direct =
+    data.direct && typeof data.direct.base_url === 'string' && typeof data.direct.api_key === 'string'
+      ? { baseUrl: data.direct.base_url.replace(/\/+$/, ''), apiKey: data.direct.api_key }
+      : null;
+  return { models, defaultModel: data.default_model || (models[0]?.id ?? models[0]), direct };
 }
 
 async function writeFileAtomic(path, text, mode) {
@@ -172,11 +184,15 @@ function tmpName(path) {
 export async function applyPlatformModel(config) {
   const credentials = await loadCredentials(config);
   if (!credentials) throw new Error('尚未登录平台');
-  const baseUrl = `${String(credentials.platform_url || config.platformUrl).replace(/\/+$/, '')}/api/plugin/v1`;
-  const { models, defaultModel } = await fetchPlatformModels(
+  const { models, defaultModel, direct } = await fetchPlatformModels(
     credentials.platform_url || config.platformUrl,
     credentials.access_token,
   );
+  // 平台下发 direct 时 dsh 直连 Token Hub；否则回退平台代理（旧版平台）。
+  const baseUrl = direct
+    ? direct.baseUrl
+    : `${String(credentials.platform_url || config.platformUrl).replace(/\/+$/, '')}/api/plugin/v1`;
+  const providerKey = direct ? direct.apiKey : credentials.access_token;
   const home = resolveDshHome(config);
   const settingsPath = join(home, 'settings.yaml');
   const credentialsPath = join(home, '.credentials.yaml');
@@ -184,10 +200,10 @@ export async function applyPlatformModel(config) {
     readFile(settingsPath, 'utf8').catch(() => ''),
     readFile(credentialsPath, 'utf8').catch(() => ''),
   ]);
-  await writeFileAtomic(credentialsPath, buildCredentialsYaml(existingCredentials, credentials.access_token), 0o600);
+  await writeFileAtomic(credentialsPath, buildCredentialsYaml(existingCredentials, providerKey), 0o600);
   await writeFileAtomic(
     settingsPath,
-    buildSettingsYaml(existingSettings, { baseUrl, models, defaultModel }),
+    buildSettingsYaml(existingSettings, { baseUrl, models, defaultModel, direct: direct !== null }),
   );
   return { models, defaultModel };
 }

package/lib/store.js

@@ -7,7 +7,7 @@ export function resolveDshHome() {
   return process.env.DSH_HOME || join(homedir(), '.dsh');
 }
 
-function storeDir(config) {
+export function storeDir(config) {
   return config.storeDir || join(resolveDshHome(), 'agentone');
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.29",
-  "description": "AgentOne 平台集成插件：飞书登录、平台模型（同步失败自愈重试）、SkillHub 技能（升级检测一键升级、装后即时刷新、套餐技能自动同步）、套餐申请、插件管理与自助升级、lark-cli / ccpg-cli 探测与一键安装（请求超时与错误码透传、令牌轮换 single-flight、凭据损坏容错与并发安全写入、状态页 UX 增强）",
+  "version": "0.5.31",
+  "description": "AgentOne 平台集成插件：飞书登录、平台模型（直连 Token Hub 不过境平台、同步失败自愈重试）、SkillHub 技能（升级检测一键升级、装后即时刷新、套餐技能自动同步）、套餐申请、插件管理与自助升级、lark-cli / ccpg-cli 探测与一键安装（请求超时与错误码透传、令牌轮换 single-flight、凭据损坏容错与并发安全写入、状态页 UX 增强、全局中文回复默认（AGENTS.md 受标记管理、永不覆盖用户设置））",
   "type": "module",
   "scripts": {
     "smoke": "node scripts/env-matrix-smoke.mjs"